Peripheral

模组

· 作者 Sl0oth_

使用 Python 脚本控制 Minecraft。自动化任务、构建 HUD(抬头显示)和创建自定义 GUI——无需服务器。

0 本站下载 0 关注 更新于 6 个月前

最新 1.1.0 · 26.1.2 · Fabric

一键开服(送7天)

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 键显示/隐藏。界面打开期间,脚本会保持数据实时更新。

`An example of custom GUI.

导航

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 提问,AI 在聊天中回答
server_status.py ping Minecraft 服务器并显示玩家数量和 MOTD
weather_display.py 获取真实世界天气并在游戏中显示
web_dashboard.py 浏览器仪表盘——在局域网内的任意标签页查看游戏状态
clickable_links.py 展示如何发送带有可点击 URL 和悬停文本的富文本消息

仍在开发中

此模组正在积极开发中。如果遇到任何错误、问题或有建议,请在 github.com/Sl0oth/peripheral/issues 提交 Issue。


快速入门

  1. 安装模组(Fabric,1.21.11 - 26.1)
  2. 启动 Minecraft——示例脚本和 PERIPHERAL_API.md 会自动写入 config/peripheral/scripts/
  3. 按 G 键打开 Peripheral 面板
  4. 点击任意示例脚本旁边的 Run 按钮
  5. 使用 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 指导完成。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源