团队生命绑定

团队生命绑定

TeamLifeBind是一个基于共享生命的Minecraft团队生存PvP模式:当一名队友死亡时,整个团队都会被淘汰。

cm_teamlifebind

TeamLifeBind

TeamLifeBind 是一个面向 Minecraft 的团队生存对抗玩法,核心规则是“队友共享生死,一人死亡,全队连坐”。

最低两个人,推荐四个人及以上人数游玩,后续会添加更多的道具以及机制。

这个仓库同时维护 Paper、Fabric、Forge、NeoForge 四个平台实现,并通过 common 模块共享核心规则、语言文本和部分通用逻辑。

特性速览

  • 支持 2-32 队,开局会为每支队伍分配独立出生区。
  • 生命绑定规则:任意一名队员死亡,会触发整队淘汰。
  • 大厅准备流:玩家在大厅待命,使用 /tlb ready 后进入自动开局倒计时。
  • 进入比赛场地后会有 10 秒观察阶段,此阶段只能转视角、不能移动。
  • 默认启用禁复活维度机制,在配置的维度中死亡会直接变为旁观者淘汰。
  • 自带大厅菜单、计分板、Tab 信息、队伍通报等 UI,并已对齐四个平台表现。
  • 胜利条件默认为“首支击杀末影龙的队伍获胜”。

对局流程

  1. 玩家进入大厅并使用大厅菜单或 /tlb ready 准备。
  2. 所有人准备完成后,系统开始开局倒计时。
  3. 倒计时结束后,所有玩家被传送到比赛区域。
  4. 进场后先进入 10 秒观察阶段,方便确认地形和周边环境。
  5. 观察阶段结束后,正式开放移动与战斗。
  6. 推进资源与战斗,直到只剩最后赢家,或有队伍击杀末影龙。

平台与目录

  • common 公共规则层,包含 TeamLifeBindEngine、血量预设、语言文本等共享逻辑。
  • paper Paper 插件实现,使用插件配置和每局独立比赛世界。
  • fabric Fabric 模组实现,使用专用大厅/战斗维度和模组配置文件。
  • forge Forge 模组实现,结构与 Fabric/NeoForge 基本同步。
  • neoforge NeoForge 模组实现,和 Forge/Fabric 一起维护模组端行为。

平台差异

  • Paper 每局会创建新的比赛世界,并在对局结束后清理旧世界。
  • Fabric / Forge / NeoForge 使用固定维度组来承载大厅和战斗。
  • 模组端当前使用的关键维度为:
    • teamlifebind:lobby_overworld
    • teamlifebind:battle_overworld
    • teamlifebind:battle_nether
    • teamlifebind:battle_end
  • Paper 的主要配置入口是 paper/src/main/resources/config.yml。
  • 模组端运行后会把设置写入 config/teamlifebind/settings.properties。

命令

所有平台通用命令:

  • /tlb help
  • /tlb menu
  • /tlb ready
  • /tlb unready
  • /tlb start
  • /tlb stop
  • /tlb status
  • /tlb teams <2-32>
  • /tlb health <ONE_HEART|HALF_ROW|ONE_ROW>
  • /tlb norespawn
  • /tlb norespawn on
  • /tlb norespawn off
  • /tlb norespawn add <namespace:path>
  • /tlb norespawn remove <namespace:path>
  • /tlb norespawn clear

Paper 额外命令:

  • /tlb setspawn <teamId>
  • /tlb clearspawns
  • /tlb reload

配置

Paper

  • 队伍数量:team-count
  • 血量预设:health-preset
  • 随机出生范围:random-spawn-radius
  • 队伍最小间距:min-team-distance
  • 开局准备倒计时:ready-countdown-seconds
  • 计分板 / Tab / 成就播报开关:
    • scoreboard.enabled
    • tab.enabled
    • advancements.enabled
  • 禁复活维度列表:no-respawn.blocked-dimensions

Fabric / Forge / NeoForge

模组端会把常用设置保存到 settings.properties,目前主要包括:

  • team-count
  • health-preset
  • announce-team-assignment
  • scoreboard-enabled
  • tab-enabled
  • advancements-enabled

构建

构建全部模块:

./gradlew build

只构建某个平台:

./gradlew :paper:build
./gradlew :fabric:build
./gradlew :forge:build
./gradlew :neoforge:build

本地运行

根项目已经提供了便捷任务。

启动本地 Paper 测试服:

./gradlew runPaperServer

启动各平台客户端:

./gradlew runFabricClient
./gradlew runForgeClient
./gradlew runNeoForgeClient

启动各平台服务端:

./gradlew runFabricServer
./gradlew runForgeServer
./gradlew runNeoForgeServer

补充说明:

  • runPaperServer 会自动准备 run/paper-server,下载对应版本的 Paper 服务端,并复制最新插件到 plugins/。
  • run*Client 现在会正常启动到客户端,而不会再自动连接本地服务器。
  • 各平台开发运行目录分别位于 run/paper-server、run/fabric-client、run/fabric-server、run/forge-client、run/forge-server、run/neoforge-client、run/neoforge-server。

开发说明

  • 这个项目虽然有 common 公共层,但大量完整玩法逻辑仍然分别存在于 paper、fabric、forge、neoforge 四端。
  • 如果要改规则枚举、文本、血量预设这类基础内容,通常先看 common。
  • 如果要改 UI、计分板、Tab、菜单、开局流程、重生、床逻辑、维度流转,通常需要同步四个平台。
  • 当前仓库没有完整的自动化玩法测试,平台同步主要依赖人工比对和编译验证。
  • 部分代码由AI辅助完成。

许可证

本项目使用 MIT License。