
大厅经理
一个用于fabric生存服务器的lobby manager模组。
Lobby Manager
一个适用于 Minecraft 26.3 的服务端 Fabric 模组,会在玩家加入时将玩家传送到受保护的大厅,允许玩家返回生存模式,并使大厅和生存模式的物品栏相互独立。专为使用 **Worlds(Fabric 版的 Multiverse)**并可选使用 Easy NPC 的服务器设计。
Beta 源码发布 —— 请先构建并测试,再用于生产环境。 本仓库包含源代码,并非经过验证、可直接用于服务器的 JAR。安装或升级前请备份你的世界和玩家数据。与物品栏相关的模组可能不兼容。
功能特性
- 加入时进入大厅: 玩家连接时会被传送到大厅维度中自定义的
/setlobby位置(在配置/setlobby之前则传送到大厅世界出生点)。 - 独立出生点:
/setlobby设置登录/大厅传送点,而不会更改主世界的/setworldspawn。 - 死亡后在主世界重生: 当启用
respawnAtOverworldSpawn时,死亡会将玩家送往通过/setworldspawn设置的主世界出生点,绝不会送往大厅;这会覆盖床和重生锚。 - 返回生存模式: 玩家可以返回到上次保存的生存位置,包括下界、末地或其他已加载维度中的位置。没有保存位置的玩家会使用默认生存世界出生点。
- 独立物品栏: 分别保存大厅和生存模式的主物品栏、盔甲/装备/副手、末影箱、经验值、饥饿值、生命值和游戏模式。生存维度共享一组物品栏。
- 大厅保护: 为访客启用冒险模式,并阻止常见的破坏方块、方块交互、物品使用、实体攻击、实体交互(带有标签的 NPC 除外)、伤害、掉落物品和拾取。饥饿值保持全满。
- 管理员建造模式: 管理员可以在大厅内临时在创造模式和冒险模式之间切换。
- 自定义命令消息: 在 JSON 配置文件中编辑所有面向玩家的命令反馈。消息默认使用英文,但可以更改为任何语言。
- 自动保存: 定期保存玩家记录,在维度组变更时以及断开连接时保存。
命令
| 命令 | 谁可以使用 | 作用 |
|---|---|---|
/lobby |
所有玩家 | 传送到由 /setlobby 保存的位置(在设置之前则为大厅世界出生点)。 |
/setlobby |
拥有 Game Master 命令权限的管理员 | 将你当前的位置和视线方向保存为大厅出生点。请在配置的大厅维度内使用。 |
/setworldspawn |
原版 Minecraft 权限规则 | 站在主世界时设置主世界出生点。这不会更改自定义大厅出生点。 |
/returntosurvival |
所有玩家 | 从大厅返回到你保存的生存位置,或默认生存出生点。 |
/buildmode |
拥有 Game Master 命令权限的管理员 | 临时切换创造模式以便在大厅中建造。仅在处于大厅内时有效。 |
这些是顶层命令;不需要子命令前缀。如果其他已安装的模组提供了同名命令之一,可能会发生冲突。
需求
- Minecraft 26.3
- Fabric Loader 0.19.5 或更新的兼容版本
- Fabric API 0.162.0+26.3
- Java 25
- Worlds(Fabric 版的 Multiverse),用于创建和加载大厅世界
- Easy NPC 为可选,用于点击即可返回生存模式的 NPC
Fabric 元数据表明需要 Worlds,而不是要求某个特定的 Worlds 模组 ID;请先配置并加载大厅维度,然后再让玩家加入。
快速设置
备份整个服务器,包括物品栏数据、世界存档和旧模组配置数据。请在副本上进行测试。
将构建好的 Lobby Manager JAR 及必需的 Fabric 组件安装到服务器的
mods/文件夹中。使用 Worlds 创建大厅世界(如果尚不存在):
/worlds create lobby /worlds tp lobby在大厅维度中,设置其在服务器启动时加载:
/worlds settings loadOnStartup true在大厅世界中,应用下方推荐的游戏规则。命令可能取决于你的 Worlds/Minecraft 版本。
启动/重启服务器。模组会在首次启动时创建
config/lobbymanager.json。检查lobbyDimension是否与实际世界 ID 匹配(通常为minecraft:lobby),如果更改,请重启。在大厅世界中,站在玩家应当到达的准确位置并运行:
/setlobby你的精确坐标和朝向会被立即写入
config/lobbymanager.json。这不会更改原版世界出生点。前往主世界,独立设置死亡重生点:
/setworldspawn当
respawnAtOverworldSpawn: true时,死亡后总是重生在主世界世界出生点,包括在其他维度死亡的玩家。死亡重生会忽略床和重生锚。可选的/returntosurvivalNPC 仍会将玩家返回到其之前的生存位置,只是死亡后保存的返回位置会更新为主世界出生点。使用测试玩家加入,确认加入后传送到
/setlobby位置、在生存模式中死亡后重生在/setworldspawn,以及从 NPC 返回时物品栏正确。
推荐的大厅游戏规则
在大厅世界内运行这些命令,而非在生存世界中:
/gamerule spawn_mobs false
/gamerule spawn_monsters false
/gamerule pvp false
/gamerule keep_inventory true
/gamerule fire_spread_radius_around_player 0
/gamerule tnt_explodes false
Worlds 支持世界专属游戏规则。重要: 配置中的 noMobSpawning 在此版本中仅是一个占位设置;模组不会自动强制阻止生物生成。请使用大厅专属游戏规则来实现。模组生成的刷怪笼和管理命令可能表现不同。
Easy NPC:点击 NPC 进入生存模式
NPC 是可选的。玩家始终可以直接使用 /returntosurvival;NPC 只是一个可点击的快捷方式。
安装与你的 Minecraft/Fabric 环境兼容的 Easy NPC 版本,并在大厅内创建一个生存 NPC。
大厅会阻止正常的实体交互。要使你的 NPC 可点击,请为其分配配置的计分板标签。靠近 NPC 并运行:
/tag @e[sort=nearest,limit=1,type=!minecraft:player] add lobbymanager_npc请仔细检查选中的实体。 当你知道 NPC 实体类型时,使用更具体的
type=过滤器更安全。字符串lobbymanager_npc必须与config/lobbymanager.json中的allowedNpcTag设置匹配。在 NPC 的 Actions 设置中,将命令
returntosurvival(如果字段要求斜杠,则为/returntosurvival)附加到点击动作或 NPC 对话按钮。将命令配置为以点击 NPC 的玩家身份运行。如果以 NPC 或控制台身份运行,命令将没有正确的玩家上下文。
以非管理员玩家身份点击 NPC 进行测试。确认玩家以正确的物品栏返回生存模式。
如果 NPC 仍无法点击,请验证其计分板标签、交互设置以及与 Easy NPC 的兼容性。其他模组可能以不同方式处理 NPC 点击。
自定义消息和设置
在服务器停止时编辑 config/lobbymanager.json,然后重启服务器。完整的可编辑消息集包含在 config-example.json 中。
例如:
{
"lobbyDimension": "minecraft:lobby",
"respawnAtOverworldSpawn": true,
"messages": {
"prefix": "[Lobby Manager] ",
"lobbySuccess": "Welcome to the lobby!",
"setLobbySuccess": "Lobby position saved at {x}, {y}, {z}.",
"buildModeEnabled": "You can now build in the lobby.",
"buildModeDisabled": "Build mode is off.",
"survivalSuccess": "Have fun in survival!"
}
}
这是摘录,并非整个配置的替代。现有设置可以保持不变。所有默认消息均为英文;你可以翻译任何值。要隐藏单个通知,将其消息文本设置为 ""。更改 messages.prefix 以调整通知前打印的标签,或将其设置为 "" 以不显示前缀。lobbyWorldUnavailable 中的 {dimension} 占位符会被替换为配置的大厅世界 ID。setLobbySuccess 中的 {x}、{y} 和 {z} 占位符显示保存的大厅出生点坐标。消息设置在重启后生效,而非立即生效。
lobbySpawn 位置由 /setlobby 命令管理;你无需手动编辑其坐标。它存储在同一 JSON 文件中,并会在服务器重启后保留。当 lobbySpawn 缺失或为 null 时,/lobby 和自动加入会回退到大厅世界自身的出生点。respawnAtOverworldSpawn 默认为 true;将其设置为 false 可恢复原版死亡重生行为,包括床和重生锚。更改此布尔设置需要重启。/setlobby 和 /lobby 都不会更改主世界出生点,更改 /setworldspawn 也不会移动大厅出生点。
其他设置包括 lobbyOnJoin、lobbyAdventure、noBlockBreak、noBlockPlaceOrUse、noPlayerAttacks、noDamage、noHunger、noItemPickup、noItemDrop、separateInventories、backupIntervalTicks 和 joinDelayTicks。
玩家存档文件
- 配置:
config/lobbymanager.json - 玩家记录:
config/lobbymanager/players/<uuid>.json - 默认 NPC 标签:
lobbymanager_npc
从早期版本升级: 模组 ID、配置路径、Java 包和玩家存档目录均已更改。不要删除以前的玩家记录。 在服务器离线时,将现有玩家 JSON 文件从旧版本的玩家存档目录复制到 config/lobbymanager/players/,并在 config/lobbymanager.json 中重新创建新设置。请保留完整备份,并先在测试服务器上验证物品栏恢复。仅重命名代码包不会迁移数据。
构建模组
本项目包含 GitHub Actions 工作流和 Gradle 构建文件。不包含 Gradle wrapper。
使用 Java 25 以及与所配置 Fabric Loom 插件兼容的 Gradle 版本(当前工作流使用 Gradle 9.7.0)。
在项目文件夹中运行:
gradle clean build构建成功后,找到
build/libs/lobby-manager-0.4.0-beta.jar。将此主 JAR 用于服务器的mods/文件夹(而非-sources.jar)。或者,将源代码推送到 GitHub,选择 Actions,并运行 Build Fabric 26.3 mod 工作流。构建成功后下载其 JAR 产物。
仍然需要成功编译和游戏内测试。 如果 Minecraft/Fabric 发生变化,依赖项和 API 方法可能需要更新。
限制和安全说明
- 请始终先在备份服务器上测试,尤其是在更改模组 ID 或升级现有世界之后。
- 物品栏切换期间发生意外崩溃可能会导致保存的快照与 Minecraft 的
player.dat不同步;自动保存不能替代服务器备份。 - 其他模组可能绕过大厅保护回调或干扰自定义物品栏管理。
- 当启用
respawnAtOverworldSpawn时,模组会明确将死亡玩家送往主世界出生点;配置的床和重生锚将不会被使用。禁用时,应用标准 Minecraft 重生规则。 - 如果服务器没有已加载的主世界,模组会记录错误,并保留原版重生位置。
- NPC 兼容性取决于已安装的 Easy NPC 版本及其命令执行上下文。
noMobSpawning目前不由 Java 代码强制执行;请使用世界专属游戏规则。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。