TeamLifeBind

TeamLifeBind

TeamLifeBind — это командный режим на выживание в Minecraft, где главное правило — «судьба одна на всех: умер один — погибла вся команда».

Минимум два игрока, рекомендуется от четырёх. В дальнейшем будут добавлены новые предметы и механики.

Этот репозиторий поддерживает реализации для четырёх платформ — Paper, Fabric, Forge и NeoForge — с общим модулем common, в котором хранятся основные правила, языковые тексты и часть общей логики.

Особенности

• Поддержка от 2 до 32 команд, каждой команде при старте выделяется отдельная зона появления.
• Правило привязки жизней: смерть любого участника команды приводит к淘汰 всей команды.
• Поток готовности в лобби: игроки ждут в лобби, вводят /tlb ready, после чего запускается автоматический отсчёт до старта.
• После входа на арену начинается 10-секундная фаза наблюдения, в которой можно только вращать камеру, но нельзя двигаться.
• По умолчанию включён режим измерений без возрождения: смерть в настроенном измерении сразу переводит игрока в наблюдатели.
• В комплекте меню лобби, таблица очков, информация во вкладке, оповещения команды и другой UI, согласованный на всех четырёх платформах.
• Условие победы по умолчанию — «побеждает команда, первой убившая Ender Dragon».

Ход матча

1. Игроки заходят в лобби и готовятся через меню лобби или /tlb ready.
2. Когда все готовы, начинается отсчёт до старта.
3. По окончании отсчёта все игроки телепортируются на арену.
4. После входа начинается 10-секундная фаза наблюдения, чтобы осмотреться и оценить окружение.
5. Когда фаза наблюдения заканчивается, движение и бой становятся доступны.
6. Команды добывают ресурсы и сражаются, пока не останется единственный победитель или одна из команд не убьёт Ender Dragon.

Платформы и структура

• 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.

命令 / Commands

所有平台通用命令 / Commands available on all platforms:

• /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 额外命令 / Paper-only extra commands:

• `/tlb setspawn `
• /tlb clearspawns
• /tlb reload

配置 / Configuration

Paper

• 队伍数量：team-count
  Team count: team-count
• 血量预设：health-preset
  Health preset: health-preset
• 随机出生范围：random-spawn-radius
  Random spawn radius: random-spawn-radius
• 队伍最小间距：min-team-distance
  Minimum team distance: min-team-distance
• 开局准备倒计时：ready-countdown-seconds
  Ready countdown seconds: ready-countdown-seconds

• 计分板 / Tab / 成就播报开关：
  Scoreboard / tab / advancement toggles:

  • scoreboard.enabled
  • tab.enabled
  • advancements.enabled
• 禁复活维度列表：no-respawn.blocked-dimensions
  No-respawn dimension list: no-respawn.blocked-dimensions

Fabric / Forge / NeoForge

模组端会把常用设置保存到 settings.properties，目前主要包括：
The mod loaders save their common settings to settings.properties, including:

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

构建 / Build

构建全部模块 / Build all modules:

./gradlew build

只构建某个平台 / Build a single platform:

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

本地运行 / Local Development Runs

根项目已经提供了便捷任务。
The root project already provides convenience tasks.

启动本地 Paper 测试服 / Start the local Paper test server:

./gradlew runPaperServer

启动各平台客户端 / Start platform clients:

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

启动各平台服务端 / Start platform servers:

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

补充说明 / Notes:

• runPaperServer 会自动准备 run/paper-server，下载对应版本的 Paper 服务端，并复制最新插件到 plugins/。
  runPaperServer prepares run/paper-server, downloads the matching Paper server jar, and copies the latest plugin into plugins/.
• run*Client 现在会正常启动到客户端，而不会再自动连接本地服务器。
  run*Client now starts the client normally and no longer auto-connects to a local server.
• 各平台开发运行目录分别位于 run/paper-server、run/fabric-client、run/fabric-server、run/forge-client、run/forge-server、run/neoforge-client、run/neoforge-server。
  Development run directories live under run/paper-server, run/fabric-client, run/fabric-server, run/forge-client, run/forge-server, run/neoforge-client, and run/neoforge-server.

开发说明 / Development Notes

• 这个项目虽然有 common 公共层，但大量完整玩法逻辑仍然分别存在于 paper、fabric、forge、neoforge 四端。
  Even though the project has a common layer, a large portion of the gameplay logic still lives separately in paper, fabric, forge, and neoforge.
• 如果要改规则枚举、文本、血量预设这类基础内容，通常先看 common。
  For core enums, text assets, and health preset changes, common is usually the first place to update.
• 如果要改 UI、计分板、Tab、菜单、开局流程、重生、床逻辑、维度流转，通常需要同步四个平台。
  For UI, scoreboard, tab, menu flow, match start flow, respawn, bed logic, or dimension flow, expect to sync changes across all four platforms.
• 当前仓库没有完整的自动化玩法测试，平台同步主要依赖人工比对和编译验证。
  The repository does not yet have full gameplay automation tests, so platform sync still relies mostly on manual comparison and compile verification.
• 部分代码由AI辅助完成。
  Some of the code was assisted by AI

许可证 / License

本项目使用 MIT License。
This project is licensed under the MIT License.