
外围设备
用Python脚本控制Minecraft。自动化任务、构建HUD和创建自定义GUI——无需服务器。
Peripheral
用 Python 为 Minecraft 编写脚本。
编写 .py 脚本,读取实时游戏数据、控制你的玩家、构建自定义 GUI,并渲染常驻 HUD 叠加层——全程无需接触 Java。把脚本放进文件夹,点击运行,然后看它跑起来。
功能简介
Peripheral 在 Minecraft 内部运行一个轻量级 HTTP 服务器(localhost:25585),并向每个脚本注入一个名为 mc 的辅助模块。脚本在你游玩时于后台运行——读取你的生命值、发送聊天消息、在你的屏幕上绘制内容,或用脚本移动。
无需额外依赖。无需手动编辑配置文件。一切通过简洁的游戏内 GUI(按 G)管理。
特性
Python 脚本
- 脚本位于
config/peripheral/scripts/——可用任意文本编辑器或游戏内编辑器修改 - 自动注入
mc模块。只需from mc import *即可开始。 - 脚本在后台运行——可同时启动多个,并可独立停止
AI 脚本构建器
打开 Build 标签页,输入脚本名称,描述你想要的脚本,AI 会直接将其写入文件。使用你自己的 Claude 或 OpenAI API 密钥。聊天历史会被保存,方便你从中断处继续;可将日志发回给 AI 以修复错误,并可从会话菜单管理多个脚本。
玩家控制
say() · look() · use_item() · equip() · jump() · sprint() · sneak() · move() · click_block() · attack() · drop_item()
游戏数据
state() · pos() · health() · inventory() · chat_log()
HUD 叠加层
在你游玩时直接在游戏画面上渲染常驻元素:
- 标签(Labels)——带颜色和阴影的文本
- 进度条(Bars)——进度条(生命值、耐久度、经验值,任何内容)
- 矩形(Rects)——可带边框的背景面板
- 物品图标(Item sprites)——按 ID 渲染任意 Minecraft 物品图标
- 锚定到任意屏幕角落或中心——位置随分辨率缩放
自定义游戏内界面
open_gui() 用 Python 构建真正的 Minecraft 界面——按钮、文本输入框、标签、滑块、复选框。游戏内按 H 显示/隐藏。界面打开时,脚本保持数据实时更新。
`
导航
goto(x, z) · nav_status()
HTTP API
mc 模块使用的每个端点也可通过 localhost:25585 从外部访问。可接入浏览器仪表盘或本地工具——全程无需接触游戏。
附带的示例脚本

| 脚本 | 功能 |
|---|---|
hello_world.py |
显示位置、生命值、附近实体——验证一切正常 |
armor_hud.py |
屏幕右侧的垂直物品图标 + 耐久度 HUD |
auto_eat.py |
饥饿值下降时自动进食 |
auto_mine.py |
让玩家自动挖掘目标矿石 |
welcome_bot.py |
玩家加入时向其打招呼 |
follow_on_command.py |
玩家在聊天中说“follow me”时跟随该玩家 |
custom_gui.py |
完整的交互式 GUI 示例——按钮、输入框、实时更新 |
api_server.py |
启动本地 HTTP 服务器,让外部应用可读取游戏状态 |
openai_chat.py |
玩家向已配置的 AI API 私聊提问,它在聊天中回答 |
server_status.py |
Ping Minecraft 服务器并显示玩家数量和 MOTD |
weather_display.py |
获取现实世界天气并在游戏内显示 |
web_dashboard.py |
浏览器仪表盘——可从本地网络的任意标签页查看游戏状态 |
clickable_links.py |
展示如何发送带可点击 URL 和悬停文本的富文本消息 |
仍在开发中
本模组仍在积极开发中。如果你遇到任何 bug、问题或有建议,请在 github.com/Sl0oth/peripheral/issues 提交 issue。
快速开始
- 安装模组(Fabric,1.21.11 - 26.1)
- 启动 Minecraft——示例脚本和
PERIPHERAL_API.md会自动写入config/peripheral/scripts/ - 按 G 打开 Peripheral 面板
- 点击任意示例脚本旁边的 Run
- 想用 AI 构建自己的脚本:打开 Build 标签页,输入脚本名称并开始对话
外部连接
Peripheral 的 HTTP 服务器仅监听 localhost,自身绝不会连接任何远程服务器。Build 标签页使用你自己的密钥向 Anthropic 或 OpenAI API 发送消息——除非你主动发起,否则不会发送任何内容。部分示例脚本会向第三方 API 发起出站 HTTP 请求;这只在你明确运行它们时发生,且端点可在脚本源码中清晰看到。
多人游戏
Peripheral 为你提供可自动执行玩家操作的工具。你有责任确保你运行的任何脚本符合你所在服务器的规则。 许多服务器禁止自动化模组。如有疑问,请在多人游戏中运行自动化脚本前与服主确认。
要求
- Minecraft 1.21.11 - 26.1
- Fabric Loader 0.18.4+
- Fabric API
仅客户端
Peripheral 完全在客户端运行。无需安装到服务器。支持单人游戏、多人游戏和 Realms。
免责声明
本模组按“原样”提供,不附带任何担保。作者不对物品或游戏进度丢失、存档损坏、服务器封禁、你编写或运行的脚本造成的损害,或因将模组连接到外部服务而产生的任何后果负责。你对创建或执行的任何脚本负全部责任。在多人服务器上使用本模组风险自负——请务必先查看服务器规则。完整条款见 github.com/Sl0oth/peripheral。
模组代码 100% 由 Claude Code(Anthropic 的 AI 编程助手)编写,由 Sl0oth 指导。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。