BO2 Zombies

================================================================
  BO2 ZOMBIES — FULL GUIDE
  Minecraft Forge 1.20.1 mod by waaqs
================================================================

----------------------------------------------------------------
WHAT IS THIS MOD?
----------------------------------------------------------------
BO2 Zombies turns ANY Minecraft map into a Black Ops 2 style
Zombies game mode. There is no map included and no code to edit:
the whole mode is driven by admin commands and JSON config files.

You (the server operator) place the spawns, doors, weapons, perks,
mystery box and Pack-a-Punch directly in your own map, then start
the game. Players survive endless rounds of zombies, earn points,
buy guns and perks, and try to reach the highest round.

- Minecraft Forge 1.20.1 (Java 17)
- Multiplayer server for 2 to 5 players (also works solo)
- REQUIRES TaCZ (Timeless and Classics Zero). This mod is built around
  TaCZ firearms: the wall weapons, the Mystery Box, the Pack-a-Punch
  upgrades and the perks all work through TaCZ guns. Without TaCZ the
  mod falls back to plain vanilla items, so those systems are pointless
  — install TaCZ (and a gun pack) for the mod to work as intended.
- Fully bilingual: every player sees the game in their own client
  language (English / French), English is the fallback

>>> IMPORTANT: install TaCZ alongside this mod. <<<

----------------------------------------------------------------
CORE FEATURES (HOW IT WORKS)
----------------------------------------------------------------

ENDLESS ROUNDS
- Round 1 starts with ~10 zombies. Every round the count, health,
  speed and damage scale up.
- A short break (configurable, ~20s) happens between rounds with a
  countdown title.

POINTS
- Every player has their own point total.
- +100 per kill, +10 per hit, +400 at the end of each round
  (all amounts configurable). Starting points are configurable too.
- Points are spent to open doors and buy weapons, ammo, perks,
  the mystery box and Pack-a-Punch.

REAL-TIME SCOREBOARD (sidebar)
- Shows: current round, zombies remaining, players alive, your
  personal points, your perks, and "DOWNED" timer if you are down.

ZOMBIE SPAWNS
- Zombies only appear on the spawn points YOU register.
- Vanilla mob spawning is blocked inside the arena.
- The mod path-validates spawns: zombies won't spawn behind a
  closed door (they spawn where they can actually reach players).
- Anti-stuck: if zombies can't reach anyone for a while, they are
  teleported closer to the players.

DOORS (buyable)
- The admin selects a region with the selection stick, sets a price,
  and the area is filled with iron bars + a floating price sign.
- A player right-clicks the bars to pay the price and open the door
  for everyone.

WALL WEAPONS
- Place a gun on a wall for a price. Players right-click to buy it.
- First buy = the gun + full ammo. Re-buying when already owned =
  ammo refill only.

AMMO BOXES (wall)
- A wall buy that refills ALL of a player's weapons to full ammo.

BARRICADES (repairable)
- Fill a selection with slabs/boards. Zombies tear them off over
  time; players right-click to repair them and earn points.

MYSTERY BOX
- 950 points (configurable). Right-click to spin; you get a random
  weapon by weighted rarity (common / rare / legendary).
- The box can teleport between registered spots (totem), and a
  Fire Sale power-up makes it cheap for everyone temporarily.

PERKS (Black Ops style)
- Juggernog (more health), Speed Cola, Double Tap (more damage),
  Stamin-Up (sprint stamina + speed), Quick Revive (self-revive),
  Mule Kick (carry a 3rd weapon).
- Bought from a floor machine or a wall machine. Effects are applied
  instantly and saved per player.

PACK-A-PUNCH
- Place the machine (default 5000 points). Right-click to open a GUI,
  click the weapon you want to upgrade.
- Up to 3 levels: more damage, bigger magazine, level 3 = effectively
  infinite ammo. The weapon gets renamed and a glint.

POWER-UPS (random drops from zombies)
- Insta-Kill, Double Points, Max Ammo, Nuke (kills all zombies),
  Fire Sale (cheap mystery box), Zombie Blood (zombies ignore you),
  Carpenter. Timed power-ups show a boss bar with the remaining time.

DOWNED / REVIVE SYSTEM
- When your health runs out you go "down": you crawl, keep a pistol,
  and bleed out over ~30s.
- A teammate revives you by looking at you up close (hold position).
  Taking damage can interrupt the revive.
- If you bleed out you become a spectator until the next round.
- Quick Revive lets you self-revive once per round.

BOSSES
- A special boss every 5 rounds and a major boss every 10 rounds,
  with extra health/damage and bonus points when defeated.

GAME OVER
- When all players are dead: a Game Over screen, end stats
  (kills / revives / downs per player) and everyone returns to lobby.

AUTO-SAVE
- The game state (round + points + perks) is saved periodically and
  restored after a server crash/restart.