COD Pattern

COD Pattern

Статус релиза: Beta. Этот документ описывает 0.8.8b. Перед обновлением существующего мира сделайте резервную копию сохранения мира и папки fpsmatch/ в каталоге игры. Шаги миграции см. в GUIDE.md.

警告：

自版本 0.8.8b 起，新版主模组将地图与规则统一存放于

<世界>/serverconfig/codpattern/maps/

旧数据需手动迁移。升级前请停服备份完整世界存档及游戏目录下的 fpsmatch/；启动后确保相关模式内所有地图均无玩家和进行中的对局，以权限等级 4 执行 /cdp map migrate check，处理报告中的问题后执行 /cdp map migrate confirm，完成后重启服务端或重新进入单人世界。成功迁移的旧文件会被移除，请保留备份和迁移记录，勿随意更改存档路径；迁移仅调整存储位置，不保证旧配置完全兼容。

warning:

Начиная с версии 0.8.8b основной мод теперь хранит карты и правила в

<world>/serverconfig/codpattern/maps/

Старые данные требуют ручной миграции. Перед обновлением остановите сервер и сделайте резервную копию всего мира и папки fpsmatch/ в каталоге игры. После запуска убедитесь, что все карты в затронутых режимах пусты и ни один матч не идёт. С уровнем прав 4 выполните /cdp map migrate check, устраните все найденные проблемы, затем выполните /cdp map migrate confirm. После этого перезапустите сервер или заново войдите в одиночный мир. Успешно перенесённые исходные файлы удаляются, поэтому сохраняйте резервные копии и записи о миграции и не меняйте расположение мира. Миграция лишь переносит данные, но не гарантирует совместимость со старыми конфигурациями.

Обзор

COD Pattern — это мод для Forge, построенный вокруг TaCZ + встроенного ядра, совместимого с FPSM, и предоставляющий пресеты снаряжения в стиле COD, переоснащение оружия, управление комнатами и командные бои.

Основной мод самостоятельно предоставляет режимы frontline (FTL) и teamdeathmatch (TDM). Zombies — это отдельный аддон: его игровая реализация не входит в основной мод, и основной мод может запускаться без него. При установке аддон регистрирует свой режим через общие точки входа.

Снаряжение, фильтры оружия, состояние комнат, правки карт и фазы матча проверяются на сервере и синхронизируются с клиентами. Мод включает языковые ресурсы для упрощённого китайского, традиционного китайского, английского и японского.

Основные возможности

Управление снаряжением и выдача экипировки

• Создание, клонирование, переименование, удаление и выбор снаряжения — до 10 наборов на игрока.
• При первой инициализации данных снаряжения игрок получает 3 набора по умолчанию.
• Каждый набор хранит четыре категории экипировки: primary / secondary / tactical / lethal.
• Выдача экипировки в комнате и снабжение при возрождении используют выбранный набор; отдельные режимы могут задавать собственные правила выдачи.
• Администраторы могут принудительно выдать снаряжение командой /cdp distribute [target]. Без указания цели оно применяется ко всем игрокам онлайн.
• Без LR Tactical связанные опции ближнего боя, варианты метательных предметов, отдельные слоты для метательных предметов и выдача метательных предметов по умолчанию отключаются автоматически. При установленном LR метательные предметы по-прежнему подчиняются настройке фильтра сервера.

Выбор оружия, фильтрация и переоснащение

• Сервер проверяет слоты экипировки, ID предметов, NBT, категории оружия и чёрные списки.
• Основное и дополнительное оружие поддерживает установку обвесов. Пресеты сохраняются вместе с набором снаряжения в attachmentPreset.
• Чёрные списки обвесов применяются к спискам кандидатов, удалению установленных обвесов и проверке при сохранении.
• Встроенный экран переоснащения TaCZ отключён; используйте экран переоснащения из набора снаряжения COD Pattern.
• Кандидаты на обвесы объединяют обвесы, имеющиеся у игрока, с совместимыми кандидатами из tacz-addon. Окончательное решение об установке принимает сервер.

Комнаты и ход матча

• Меню паузы предоставляет вход в комнаты для просмотра карт, присоединения к комнатам, выбора команды и готовности.
• Комнаты FTL/TDM принимают игроков только во время WAITING, с голосованиями за начало и завершение и синхронизированными фазами матча.
• FTL и TDM используют собственные правила возрождения. TDM поддерживает динамические точки возрождения-кандидаты и их объединение.
• Возможности включают разминку, предматчевый отсчёт, счёт и ленту убийств, камеру смерти, неуязвимость при возрождении, восстановление здоровья в бою, подсветку союзников и врагов, полоски здоровья врагов в мировом пространстве и экран результатов.
• Перед голосованием за начало комната проверяет, что настроена точка завершения. Непригодная точка назначения выдаёт сообщение об ошибке при попытке телепортации.
• Принудительное завершение возвращает игроков и очищает ресурсы режима. Комнаты с незавершённым восстановлением показывают соответствующий статус.

Создание и управление картами

• Инструмент создания карт выбирает регион и создаёт карты FTL/TDM.
• Инструмент точек возрождения показывает слои точек и областей, поддерживаемые каждым режимом, с предпросмотром, добавлением, удалением, очисткой и динамическим объединением кандидатов.
• Инструмент управления картами предоставляет отфильтрованные списки, измерения и границы, статус, переименование, настройки конечных точек, принудительное завершение и удаление.
• Переименование требует бездействующей карты с завершённым восстановлением. Оно проверяет имена и конфликты, затем обновляет идентификатор карты и каталог хранения.
• Удаление сначала завершает матч, восстанавливает и удаляет участников и наблюдателей, затем архивирует каталог карты и снимает регистрацию карты после очистки. Ожидающее восстановление сохраняет карту; его прогресс, повтор и отмена доступны в управлении картами.
• Конечная точка карты, глобальное значение по умолчанию для будущих карт и команда, обновляющая существующие карты, имеют отдельные области действия. Изменение глобального значения по умолчанию не перезаписывает существующие карты.

Команды и точки входа

Уровни разрешений ниже — это уровни разрешений серверных команд. Игровые инструменты карт требуют уровень 2; настройки конечных точек в управлении картами также требуют уровень 2.

/cdp

`используетmode|map, передаётся как аргумент в кавычках, например "frontline|arena". Также используйте двойные кавычки вокруг названий карт, например "训练场"или"Training Arena"`, чтобы избежать ошибок разбора аргументов с не-ASCII символами, пробелами или специальными символами. Распределение снаряжения очищает и пересобирает инвентарь получателя; наблюдатели пропускаются.

/cdp map

endtp set не задаёт глобальное значение по умолчанию. Используйте управление картами, чтобы настроить значение по умолчанию для будущих карт.

Принудительное завершение и инструменты карт

• `/roomforceend : Требует уровень разрешения 2`; завершает матч и восстанавливает игроков, сохраняя членство в комнате. Управление картами также предоставляет это действие.
• codpattern:map_management_tool: ПКМ, чтобы открыть управление картами.
• codpattern:map_creator_tool: ЛКМ и ПКМ, чтобы выбрать два угла. Используйте Ctrl + ПКМ, чтобы открыть экран создания, выбрать режим и ввести название карты.
• codpattern:spawn_point_tool: Используйте Ctrl + ПКМ, чтобы открыть его настройки, затем выберите карту, команду и доступный слой точек или областей.
• Создание карт, редактирование точек возрождения и редактирование областей используют инструменты; прежние команды удалены. Развёртывание карт Zombies использует инструменты, предоставляемые аддоном.

Конфигурация и каталоги

Все пути ниже указаны относительно каталога текущего мира, а не каталога игры.

serverconfig/codpattern/backpack_rules/

• backpack_config.json: Снаряжения игроков, выбранное снаряжение и данные предметов в слотах. Пресеты вложений хранятся в attachmentPreset каждого слота.
• weapon_filter.json: Категории оружия, чёрные списки предметов и вложений, включение метательных предметов и множитель боеприпасов.

Основные поля фильтра: primaryWeaponTabs, secondaryWeaponTabs, blockedItemNamespaces, blockedWeaponIds, blockedAttachmentNamespaces, blockedAttachmentIds, throwablesEnabled и ammunitionPerMagazineMultiple. Используйте /cdp update, чтобы перезагрузить и синхронизировать фильтры после редактирования. Это не команда общей перезагрузки конфигурации: она синхронизирует кэшированные данные снаряжений, а не перечитывает backpack_config.json с диска.

serverconfig/codpattern/maps/

Закодированный суффикс каталога — это шестнадцатеричное представление байтов UTF-8 названия карты. Используйте управление картами для переименования карт. Каталоги карт и правил дополнений регистрируются соответствующими режимами; не каждый режим использует builtin/.

Старые карты fpsmatch/ и serverconfig/codpattern/tdm_rules/config.json переносятся через процесс миграции. Сначала сделайте резервную копию, затем запустите check, чтобы просмотреть источники, назначения и конфликты. Запустите confirm, когда затронутые комнаты опустеют и их матчи завершатся. Затронутые режимы остаются заблокированными до перезапуска сервера или повторного открытия мира в одиночной игре. Подробности восстановления см. в GUIDE.md.

Конфигурация матчей FTL/TDM

В таблице приведены значения по умолчанию для активных настроек в builtin/rules/config.json. Поля, оканчивающиеся на Ticks, используют игровые тики. Сохранённые поля warmupTimeTicks, preGameCountdownTicks и blackoutStartTicks в настоящее время не управляют соответствующими таймингами фаз PvP; см. GUIDE.md.

Документация

• Установка, настройка карты, матчи, управление картами, миграция и сборки: GUIDE.md
• Частые вопросы и решение проблем: QANDA.md
• История версий: CHANGES.md
• Документация на китайском: README.md

Совместимость и зависимости

• Minecraft: Целевая версия для разработки и сборки — 1.20.1.
• Forge: Проект собирается на 47.4.0; в метаданных мода указан минимум 47. Другие комбинации требуют проверки; заявленный диапазон не является полностью протестированным.
• Java: 17.
• Обязательная зависимость: TaCZ 1.1.6+ и на клиенте, и на сервере.
• Встроенный компонент: Ядро, совместимое с FPSM, не требует отдельного fpsmatch.jar.
• Опциональная интеграция: LR Tactical 0.3.0+. FTL/TDM остаются доступны и без LR.
• Опциональный режим: Аддон codpattern_zombies. Метаданные основного мода принимают 0.2.0b+; требования самого аддона к зависимостям также должны быть выполнены. Основной мод и аддон собираются и устанавливаются отдельно.
• Physics Mod и tacz-addon присутствуют в конфигурации среды разработки клиента. Ни один из них не заявлен как обязательная зависимость основного мода.

Клиентам и серверам следует использовать совпадающие комбинации основного мода и обязательных аддонов. О сборках из исходников и запуске для разработки с опциональной поддержкой LR см. GUIDE.md.

Лицензия

Лицензировано под GPL-3.0-only. См. LICENSE.txt и CREDITS.txt в корне репозитория.