GameMasterMC
GameMasterMC 是一款 PaperMC 插件,它将 Minecraft 聊天与兼容 OpenAI 的聊天补全 API 连接起来。玩家可以通过聊天与 GameMaster 对话,该模型可以检查实时服务器状态,并通过 JSON 工具协议执行由服务器授权的操作。
它适用于任何支持 OpenAI 风格 /v1/chat/completions 端点的 API,包括托管 API、自托管网关和本地模型服务器。
要求
- PaperMC
1.21.x
- Java
21
- 一个兼容 OpenAI 的聊天补全端点
安装
- 下载
GameMasterMC-1.0.0.jar。
- 将 jar 文件放入 Paper 服务器的
plugins 文件夹中。
- 启动服务器一次以生成配置文件。
- 停止服务器并编辑:
plugins/GameMasterMC/config.yml
- 再次启动服务器。
配置
在 plugins/GameMasterMC/config.yml 中设置你的 API 端点和模型:
llm:
endpoint: "https://your-api-host.example.com/v1/chat/completions"
model: "your-model-name"
api-key: "your-api-key-if-needed"
timeout-seconds: 300
temperature: 0.4
max-tokens: 1200
如果你的端点不需要 API 密钥,请将 api-key 留空:
api-key: ""
玩家聊天访问权限由 chat.allowed-players 控制:
chat:
prefix: "@gm "
allowed-players:
- "*"
使用 * 允许所有人,或列出特定的玩家名称/UUID:
allowed-players:
- "PlayerName"
- "00000000-0000-0000-0000-000000000000"
操作访问权限在此处控制:
access:
allow-actions: true
require-player-tool-permission: false
allow-console-commands: false
allow-console-commands 允许模型运行服务器控制台可以运行的任何命令。仅在你完全信任模型端点以及被允许使用 GameMasterMC 的玩家时启用它。
用法
玩家可以使用配置的发送前缀与 GameMaster 对话:
@gm what is happening on the server?
@gm put me in survival mode
命令:
/gm <message>
/gm reload
/gm status
/gm ping
从服务器控制台使用时,省略斜杠:
gm reload
gm status
gm ping
权限
gamemaster.chat:允许使用聊天桥接,默认为 true。
gamemaster.admin:允许使用 reload、status 和 ping 命令,默认为 op。
gamemaster.tool.execute:当 require-player-tool-permission: true 时的可选操作门控。
拥有 gamemaster.admin 权限的玩家可绕过 chat.allowed-players 的限制。
GameMaster 以服务器权限执行操作。除非启用 require-player-tool-permission,否则玩家权限不会限制模型的操作。
模型工具
模型接收实时服务器上下文,并可请求以下操作:
broadcast, say, give_item, teleport_player, set_time, set_weather, effect,
gamemode, heal, feed, set_health, set_food, set_xp, clear_inventory,
set_inventory_slot, kick_player, ban_player, pardon_player, op_player,
deop_player, set_block, fill_area, spawn_entity, remove_entities,
strike_lightning, create_explosion, generate_tree, kill_entity, tame_entity,
mount_player, set_entity_target, give_mob_equipment, apply_entity_effect,
rename_entity, debug_summary, recent_logs, list_plugins, list_world_entities,
run_console
安全性
GameMasterMC 可以为模型提供对你服务器的强大控制权。在启用公开使用前请仔细审查你的配置:
- 使用
allowed-players 限制谁可以与 GameMaster 对话。
- 除非你明确希望获得完整的控制台级别访问权限,否则保持
allow-console-commands: false。
- 使用可信的 API 端点,因为服务器状态和玩家信息会发送到其中。
- 在测试新模型或提示词时检查服务器日志。
评论 0
登录后参与评分
还没有评论,来抢沙发吧