游戏模组

游戏模组

功能齐全的小游戏管理器,带倒计时显示、设置界面、自定义生成半径和世界边界控制。

冒险

⚔ GameMod

— Fabric 1.21.x

一个功能齐全的小游戏管理器,包含倒计时显示、设置界面、自定义出生点半径和世界边界控制。


必需依赖(需与本模组一同安装)

模组 下载
Fabric API https://modrinth.com/mod/fabric-api
Cloth Config https://modrinth.com/mod/cloth-config
ModMenu https://modrinth.com/mod/modmenu

命令(需要 OP 等级 2)

游戏控制

命令 效果
/game start 开始倒计时(如果已设置)然后启动游戏
/game stop 取消倒计时或结束正在进行的游戏
/game cooldown <time> 设置倒计时时长(例如 10s、5m、2h)
/game cooldown 显示当前冷却设置

设置

命令 效果
/game settings 或 /game settings list 打印所有当前设置
/game settings display actionbar 在动作栏中显示倒计时
/game settings display bossbar 在Boss 栏中显示倒计时
/game settings spawn here 将出生点设为你的当前位置
/game settings spawn <x> <y> <z> 将出生点设为精确坐标
/game settings radius <blocks> 将玩家分散到出生点周围 N 格范围内(0 = 精确位置)
/game settings border <size> 设置游戏的世界边界直径
/game settings cooldown <time> 同 /game cooldown <time>
/game settings reset 将所有设置重置为默认值

设置界面(ModMenu)

在游戏中打开 模组 界面 → 找到 Game Mod → 点击 ⚙ 按钮。

分类:

  • 显示 — Boss 栏与动作栏切换
  • 出生点位置 — X / Y / Z 坐标 + 分散半径
  • 世界边界 — 游戏尺寸和游戏结束后重置的尺寸
  • 冷却 — 时长,格式为 s / m / h

设置会自动保存到 config/gamemod.json。


工作原理

/game start 流程

  1. 检查是否有正在进行的倒计时或游戏(如果已在运行则阻止)
  2. 如果冷却 > 0:进行倒计时,并在所有玩家的屏幕上显示进度
  3. 倒计时归零时(或立即):将所有在线玩家传送到出生点半径内的随机位置,将世界边界设置为以出生点坐标为中心,并将所有人设为生存模式

随机半径传送

  • 如果 radius = 0:所有玩家落在精确的出生点上
  • 如果 radius > 0:每位玩家获得半径内随机角度和距离;Y 坐标通过地形高度图自动确定(玩家总是落在实心地面上,而不会悬空或处于地下)

被淘汰的玩家

当游戏进行中有玩家死亡时,他们会自动切换为旁观者模式。/game stop 会将所有旁观者恢复为生存模式。

倒计时显示

剩余时间 动作栏颜色 Boss 栏颜色
> 10s 🟢 绿色 绿色
6 – 10s 🟡 黄色 黄色
≤ 5s 🔴 红色 红色

配置文件

config/gamemod.json — 通过界面或命令编辑,在下次服务器启动时重新加载。

{
  "useBossBar": false,
  "spawnX": 0.0,
  "spawnY": 64.0,
  "spawnZ": 0.0,
  "spawnRadius": 25,
  "gameBorderSize": 200.0,
  "defaultBorderSize": 60000000.0,
  "cooldownSeconds": 30
}