classroadout

职业配装

一个适用于 Minecraft 1.20.1（Forge）的独立配装系统——不依赖任何小队/队伍模组。每个玩家通过将物品分配到五个槽位（主武器 / 副武器 / 投掷物 / 道具 / 近战武器）来构建自己的个人配装，但只能使用管理员为特定槽位列入白名单的物品。玩家当前配装中的任何物品在设置完成的那一刻都会立即装备到快捷栏的 0-4 槽位，并在每次重生时再次装备。

管理员还可以通过 GUI 编辑器定义预设，玩家可以应用这些预设作为起点，然后逐个槽位进行调整。此外，管理员还可以策划一个全局出生套件（每次重生时所有玩家都会获得的物品）以及一个死亡时保留物品清单。

功能特性

• 自助式个人配装 — 5 个槽位（主武器 / 副武器 / 投掷物 / 道具 / 近战武器），玩家可以从死亡界面或可放置的配装站方块中选择（无需通过死亡来重新配装）。
• 管理员策划的白名单 — 按槽位配置的允许清单在服务器端强制执行，不仅是 GUI 过滤器。
• 预设 — 管理员定义的初始套件，玩家可以应用并继续自定义。
• 弹药发放 — 将弹药物品及数量附加到任何白名单物品上；装备该物品时，也会在重生时发放相应的弹药。
• 出生套件 — 管理员配置的物品/数量，会在每次重生时无条件交给所有玩家，独立于配装系统。
• 补给道具 — 可放置和可投掷的医疗包/弹药包，可随时间治疗或补给附近的玩家。
• 掩体 — 可放置的 1000 HP 蹲伏屏障，用于战场掩护。
• 可选的死亡时背包清空 — 重生时清空全部背包（配合 keepInventory true 使用），管理员策划的受保护清单中的物品除外。
• TACZ / SuperbWarfare 集成（可选） — 可选择特定的 TACZ 枪支（不仅仅是通用物品）或单个 TACZ 弹药类型用于配装槽位；补给道具会自动为这两个模组补充弹药/弹匣。这两个模组都不是必需的——Class Loadout 在没有它们的情况下也能正常运行。

工作原理

• 一切均由 /class 命令树和游戏内 GUI 编辑器驱动——日常使用无需编辑外部配置文件。
• 服务器权威性：所有配装/白名单/预设/出生套件数据都保存在世界存档数据中，每次修改都会在服务器端验证，因此手动输入的命令无法绕过 GUI 允许的操作。
• 轻量级网络：只有几个微小的“打开此 GUI”触发数据包；其他一切都基于原版命令。

需求

• Minecraft 1.20.1，Forge 47.3.12+
• 客户端和服务器均需安装（GUI 界面 + 服务器权威逻辑）
• 可选的软依赖：TACZ、SuperbWarfare（如果安装了，则启用枪支/弹药特定功能；该模组在没有任何一方的情况下也能正常运行）

配置

服务器配置文件位于 world/serverconfig/classloadout-server.toml — 包含补给半径/间隔/数量、补给包/掩体寿命和每玩家限制、投掷冷却时间、死亡时背包清空开关。完整列表和默认值请参阅 README。

链接

• 源代码与完整文档（命令、GUI 参考、配置、设计说明）：https://github.com/okonomiyak/classloadout
• 问题 / 功能请求：https://github.com/okonomiyak/classloadout/issues
• 许可证：GNU GPL-3.0-only