# NonKungCh Anniversary — 5th Anniversary Party Minigames
Celebrate **5 years of NonKungCh** with a full party-game plugin for **Paper 1.21**! One room, up to 24 players, hidden troublemakers, voting, and **5 rotating minigame stages** — playable on **Java and Bedrock** (Geyser / Floodgate friendly).
## Overview
Admins create a room, players join, and `/nka start` assigns secret troublemaker roles and opens minigame voting. Every round follows the same rhythm: lobby preparation with a BossBar countdown, warp into the arena, play the stage, return to the lobby, vote out the troublemaker, then vote for the next stage. After all 5 stages the plugin announces final scores on a Top-10 hologram board.
## The 5 stages & per-stage commands
> Stand where you want the point and run the command. Repeat `source` / `point` commands to add extra spots.
### 1. Collect — gift rush
**Goal:** Right-click glowing gift heads to collect gift boxes (1 per click), then right-click the drop chest to open your **personal scoring GUI** and submit boxes before time runs out (delivery overtime included).
**Commands:** `/nka setup collect player` · `/nka setup collect source` (repeatable) · `/nka setup collect drop` · `/nka setmap collect`
**Scoring:** +1 per submitted box, plus a winner bonus.
### 2. Maze — labyrinth escape
**Goal:** Reach the `END_PORTAL_FRAME` exit and right-click it (or walk into it). Escapers become spectators. **If everyone escapes, the stage ends early.**
**Commands:** `/nka setup maze player` · `/nka setup maze exit` · `/nka setup maze trap` · `/nka setmap maze`
**Scoring:** every escaper **+3**.
### 3. Circuit — light the Copper Bulbs
**Goal:** Right-click each unlit **Copper Bulb**, memorize the 4-color order shown, and press the colors in order. Each repair is **+2** and lights the bulb. **Wrong color = explosion + 5s of darkness!** Repair every machine to finish instantly.
**Commands:** `/nka setup circuit player` · `/nka setup circuit point` (repeatable, places unlit Copper Bulbs; old chests auto-convert) · `/nka setmap circuit`
**Scoring:** +2 per repair, +3 to everyone on full repair.
### 4. Cargo — load the train
**Goal:** Right-click `source` chests for supplies (compass points to the drop), then deliver full sets of **20 Oak Log + 10 Coal + 5 Iron** into the `drop` chest.
**Commands:** `/nka setup cargo player` · `/nka setup cargo source` (repeatable) · `/nka setup cargo drop` · `/nka setmap cargo`
**Scoring:** +1 per delivered set.
### 5. Boss — 400 HP anniversary boss
**Goal:** Team up and kill the boss. Rotating skills every 10 seconds: **darkness → summon minions (max 5) → fireball**. The stage only ends when the boss dies.
**Commands:** `/nka setup boss player` · `/nka setup boss spawn` · `/nka setup boss weapon` (kit preview) · `/nka setup boss skill` · `/nka setmap boss`
**Scoring:** +3 to everyone on the kill. Fighter gear is collected back afterwards (impostor clocks are kept).
## Command reference
**Players:** `/nka` (menu) · `/nka join` · `/nka leave` · `/nka score` (alias `/nka top`) · `/nka help`
**Admins** (permission `nka.admin` or OP): `/nka admin` (GUI) · `/nka create <room>` · `/nka start` · `/nka vote` · `/nka setstart` (lobby) · `/nka setboard` (Top-10 hologram) · `/nka setmap <collect|maze|circuit|cargo|boss>` · `/nka setup <stage> <source|drop|trap|exit|point|item|spawn|player|weapon|skill>` · `/nka settime <stage|collect_deliver> <seconds>` · `/nka times` · `/nka lobby <stage>` · `/nka stage <stage>` · `/nka next` · `/nka stop` · `/nka status` · `/nka reload`
**Suggested first-time setup:** `/nka setstart` → all five `/nka setup <stage> player` → the stage points above → `/nka setboard` → `/nka start`.
## Notes
- **Anti-grief:** no PvP, no block breaking/placing, and no explosion block damage while a stage is running.
- **Disconnect-safe:** rejoining keeps your seat, role and score, and warps you back into the action.
- **Configurable:** stage timers, lobby prep time, meeting length and collect cooldowns in `config.yml`.
- **Requirements:** Paper 1.21 or newer, Java 17+. Geyser/Floodgate optional for Bedrock/mobile players.
