# COD Pattern<\/p>\n
* > ****Release Status: Beta. Validate in a staging environment before production deployment, and back up world data\/configuration first.***<\/p>\n
## Overview<\/p>\n
COD Pattern is built around **TaCZ + an embedded FPSM-compatible core**, providing a COD-like workflow for:<\/p>\n
* Loadout presets and respawn equipment distribution
\n* In-match weapon refit with attachment presets
\n* `Frontline \/ TeamDeathMatch` rooms, maps, and match flow
\n* Localized UI and system messages (`zh_cn \/ zh_tw \/ en_us \/ ja_jp`)<\/p>\n
The project follows a server-authoritative design with client synchronization to keep multiplayer state consistent.<\/p>\n
## Main Features<\/p>\n
### 1) Loadout Management and Equipment Distribution<\/p>\n
* Supports create\/clone\/rename\/delete\/select operations for loadouts, up to `10` per player.
\n* Each loadout contains four slots: `primary \/ secondary \/ tactical \/ lethal`.
\n* Loadout-related UIs use a fixed text-scaling baseline across different `GUI Scale` settings to keep readability more consistent.
\n* Default loadout names, clone suffixes, and equipped notifications are now localized by client language.
\n* On respawn, the selected loadout is distributed automatically (normal flow applies to joined room\/match players).
\n* Player loadout\/filter data is persisted on server side and synced on login.
\n* Admin commands can force immediate distribution for all online players or selected targets.<\/p>\n
### 2) In-Match Weapon Refit and Attachment Presets<\/p>\n
* Supports slot-level editing for primary, secondary, and throwable slots from the loadout UI.
\n* Uses TaCZ weapon capabilities, with server-side validation and persistence.
\n* Attachment presets are now stored directly inside the loadout config by loadout id and slot.
\n* Supports result feedback and rollback handling to reduce client\/server state drift.<\/p>\n
### 3) Rooms, Maps, and Match Flow (Embedded FPSM Compatibility Layer)<\/p>\n
* Adds a unified room entry in pause menu for room list, join\/leave, and team selection.
\n* Supports both `frontline` and `teamdeathmatch` under the same room system, map data model, and persistence flow.
\n* Maps now support area creation, spawn-point setup, match-end teleport setup, and persistence.
\n* TDM room screens use the same fixed text-scaling baseline across different `GUI Scale` settings for more consistent list\/panel\/button readability.
\n* Supports auto team assignment with balance constraints (`maxTeamDiff`).
\n* Supports ready state, start vote, and end vote with threshold and timeout logic.
\n* Full phase pipeline: `WAITING -> COUNTDOWN -> WARMUP -> PLAYING -> ENDED`.
\n* `teamdeathmatch` includes dynamic respawn candidates and spawn safety validation.
\n* Includes kill feed, score tracking, respawn delay, invincibility frames, combat regen, death cam, HUD phase feedback, ally\/enemy highlights, and enemy health bars.
\n* Exports JSON match records automatically when a match ends.<\/p>\n
### 4) Filtering, Compatibility, and Localization<\/p>\n
* Primary\/secondary category filtering via `primaryWeaponTabs` and `secondaryWeaponTabs`.
\n* Gunpack namespace blocking and exact weapon blacklist support via `blockedItemNamespaces` \/ `blockedWeaponIds`.
\n* Attachment namespace blocking and exact attachment blacklist support via `blockedAttachmentNamespaces` \/ `blockedAttachmentIds`.
\n* Throwable and ammo multiplier controls via `throwablesEnabled` and `ammunitionPerMagazineMultiple`.
\n* Optional integrations for LR Tactical and Physics Mod with graceful fallback when absent.
\n* Includes compatibility handling for `tacz-addon 1.1.6` in backpack refit flow to prevent unload-button lockups.
\n* TaCZ native refit UI is globally disabled and redirected to the COD Pattern backpack refit flow.
\n* Bundles `zh_cn \/ zh_tw \/ en_us \/ ja_jp` language resources for core UI, notices, and error messages.<\/p>\n
## Commands and Entrypoints<\/p>\n
### `\/cdp` Commands<\/p>\n
* `\/cdp screen`
\n * Opens the backpack\/loadout UI (debug entrypoint).
\n* `\/cdp update`
\n * Syncs weapon filter and loadout config to all online players (OP required).
\n* `\/cdp distribute [target]`
\n * Forces equipment distribution for all online players or selected players (OP required).<\/p>\n
### `\/cdp map` Command Chain<\/p>\n
* `\/cdp map list [type]`
\n * Lists registered game types or maps under a given type.
\n* `\/cdp map create
\n * Creates a map area and persists it immediately.
\n* `\/cdp map delete
\n * Removes a map and its persisted data.
\n* `\/cdp map spawn
\n * Manages team spawn points and dynamic respawn candidates.
\n* `\/cdp map endtp