COD Pattern

*Release Status: Beta. Validate in a staging environment before production deployment, and back up world data/configuration first.

Overview

COD Pattern is built around TaCZ + an embedded FPSM-compatible core, providing a COD-like workflow for:

Loadout presets and respawn equipment distribution
In-match weapon refit with attachment presets
Frontline / TeamDeathMatch rooms, maps, and match flow
Localized UI and system messages (zh_cn / zh_tw / en_us / ja_jp)

The project follows a server-authoritative design with client synchronization to keep multiplayer state consistent.

Main Features

1) Loadout Management and Equipment Distribution

Supports create/clone/rename/delete/select operations for loadouts, up to 10 per player.
Each loadout contains four slots: primary / secondary / tactical / lethal.
Loadout-related UIs use a fixed text-scaling baseline across different GUI Scale settings to keep readability more consistent.
Default loadout names, clone suffixes, and equipped notifications are now localized by client language.
On respawn, the selected loadout is distributed automatically (normal flow applies to joined room/match players).
Player loadout/filter data is persisted on server side and synced on login.
Admin commands can force immediate distribution for all online players or selected targets.

2) In-Match Weapon Refit and Attachment Presets

Supports slot-level editing for primary, secondary, and throwable slots from the loadout UI.
Uses TaCZ weapon capabilities, with server-side validation and persistence.
Attachment presets are now stored directly inside the loadout config by loadout id and slot.
Supports result feedback and rollback handling to reduce client/server state drift.

3) Rooms, Maps, and Match Flow (Embedded FPSM Compatibility Layer)

Adds a unified room entry in pause menu for room list, join/leave, and team selection.
Supports both frontline and teamdeathmatch under the same room system, map data model, and persistence flow.
Maps now support area creation, spawn-point setup, match-end teleport setup, and persistence.
TDM room screens use the same fixed text-scaling baseline across different GUI Scale settings for more consistent list/panel/button readability.
Supports auto team assignment with balance constraints (maxTeamDiff).
Supports ready state, start vote, and end vote with threshold and timeout logic.
Full phase pipeline: WAITING -> COUNTDOWN -> WARMUP -> PLAYING -> ENDED.
teamdeathmatch includes dynamic respawn candidates and spawn safety validation.
Includes kill feed, score tracking, respawn delay, invincibility frames, combat regen, death cam, HUD phase feedback, ally/enemy highlights, and enemy health bars.
Exports JSON match records automatically when a match ends.

4) Filtering, Compatibility, and Localization

Primary/secondary category filtering via primaryWeaponTabs and secondaryWeaponTabs.
Gunpack namespace blocking and exact weapon blacklist support via blockedItemNamespaces / blockedWeaponIds.
Attachment namespace blocking and exact attachment blacklist support via blockedAttachmentNamespaces / blockedAttachmentIds.
Throwable and ammo multiplier controls via throwablesEnabled and ammunitionPerMagazineMultiple.
Optional integrations for LR Tactical and Physics Mod with graceful fallback when absent.
Includes compatibility handling for tacz-addon 1.1.6 in backpack refit flow to prevent unload-button lockups.
TaCZ native refit UI is globally disabled and redirected to the COD Pattern backpack refit flow.
Bundles zh_cn / zh_tw / en_us / ja_jp language resources for core UI, notices, and error messages.

Commands and Entrypoints

`/cdp` Commands

/cdp screen
- Opens the backpack/loadout UI (debug entrypoint).
/cdp update
- Syncs weapon filter and loadout config to all online players (OP required).
/cdp distribute [target]
- Forces equipment distribution for all online players or selected players (OP required).

`/cdp map` Command Chain

/cdp map list [type]
- Lists registered game types or maps under a given type.
/cdp map create <frontline|teamdeathmatch> <name> <from> <to>
- Creates a map area and persists it immediately.
/cdp map delete <type> <name>
- Removes a map and its persisted data.
/cdp map spawn <list|add|remove|clear> ...
- Manages team spawn points and dynamic respawn candidates.
/cdp map endtp <show|set|clear> <map> [pos]
- Manages match-end teleport points.

Configuration

Server configuration is stored under world save path: serverconfig/codpattern/

backpack_rules/backpack_config.json
- Player loadout data (JSON).
- Attachment presets are now embedded on each loadout slot via the attachmentPreset field.
backpack_rules/weapon_filter.json
- Weapon filter config (JSON).
- Key fields:
  - primaryWeaponTabs / secondaryWeaponTabs
  - blockedItemNamespaces
  - blockedWeaponIds (format: namespace:gunid)
  - blockedAttachmentNamespaces
  - blockedAttachmentIds (format: namespace:attachmentid)
  - throwablesEnabled
  - ammunitionPerMagazineMultiple
tdm_rules/config.json
- TDM runtime parameters (time, score, respawn, voting, join policy, balance policy).
- In-match enemy/ally display is now fixed to highlights plus enemy health bars; the old marker-dot style toggle has been removed.
tdm_match_records/
- Exported match records (.json) after each match.
Legacy paths backpackconfig / filterconfig / attachment_preset/ / tdmconfig/
- Deprecated and no longer read by this version; existing worlds require manual migration.

Default Parameters in `tdm_rules/config.json`

Field	Default	Description
`timeLimitSeconds`	`420`	Match duration in seconds
`scoreLimit`	`75`	Kill score to win
`invincibilityTicks`	`30`	Post-respawn invincibility ticks
`respawnDelayTicks`	`40`	Respawn delay ticks
`warmupTimeTicks`	`400`	Warmup duration ticks
`preGameCountdownTicks`	`200`	Pre-game countdown ticks
`blackoutStartTicks`	`60`	Countdown blackout ticks
`deathCamTicks`	`30`	Death cam duration ticks
`minPlayersToStart`	`1`	Minimum players required to start
`votePercentageToStart`	`60`	Start vote pass threshold (%)
`votePercentageToEnd`	`75`	End vote pass threshold (%)
`combatRegenDelayTicks`	`120`	Delay before regen starts after taking damage (ticks)
`combatRegenHalfHeartsPerSecond`	`5.0`	Half-hearts restored per second while regenerating
`allowJoinDuringPlaying`	`true`	Allow joining during active match
`joinAsSpectatorWhenPlaying`	`true`	Join as spectator during active match
`maxTeamDiff`	`1`	Max allowed team size difference
`markerFocusHalfAngleDegrees`	`30.0`	Enemy health-bar focus cone half-angle (degrees)
`markerFocusRequiredTicks`	`20`	Ticks required in the focus cone before the enemy health bar appears
`markerBarMaxDistance`	`96.0`	Max distance for enemy health-bar detection (blocks)
`markerVisibleGraceTicks`	`3`	Anti-flicker grace ticks while the enemy health bar remains visible

Compatibility and Dependencies

Minecraft: 1.20.1
Forge: 47.4.0+
Java: 17
Required Dependencies:
- TaCZ 1.1.6+
Embedded Component:
- FPSM-compatible core (no external fpsmatch.jar required)
Optional Integrations:
- LR Tactical (throwable/melee content path)
- Physics Mod (ragdoll/retained death entity presentation)
- tacz-addon 1.1.6 (backpack refit unload flow compatibility included)

Deployment Notes

Non-forced distribution applies only to players joined in room/match flow.
If no match-end teleport point is configured, end phase warns but does not auto-teleport back.
If tacz-addon is enabled and attachment unload behaves abnormally in refit UI, ensure /gamerule liberateAttachment false.
Before production rollout, verify:
- tdm_rules/config.json values match your server pacing
- backpack_rules/weapon_filter.json matches your gunpack filtering policy
- maps include team spawn points and a match-end teleport point

Issue Reporting

When reporting issues, include:

Reproduction steps
Relevant log excerpts
Full mod list and versions

Changelog

Current version: v0.6.5b
See CHANGES.md for detailed history.

License

Licensed under GPL-3.0-only. See LICENSE.txt for details.

Author

Author: popura404
Contact: gzyoung2330351551@163.com