ВЕРСИИ (2)

# SunManhunt 1.0.1 ## Release summary SunManhunt 1.0.1 is a bugfix release focused on match lifecycle reliability and saved-hunt recovery. It fixes the permanent Hunter freeze after the grace period and hardens startup, teardown, reset, mode resume, and reconnect handling. ## Added - No new commands or gameplay modes. ## Changed - Active-match checkpoints now include original game modes, disconnect deadlines, remaining grace, and mode resume state. - Imposter identity and detective state are restored across a restart. - Shrinking Border restores its current size, milestones, pause timing, and original world borders. - Rotating Prey rebuilds rotation candidates from the saved initial roles. - Advancement objectives re-check player advancement progress when a saved hunt is resumed. ## Fixed - Hunters no longer remain frozen forever after the grace period. The shared tick clock was clearing its own subscribers when the hunt started. - A throwing state-change listener can no longer abort a lifecycle transition halfway. - Match teardown now always stops the clock, clears the checkpoint, restores players, and leaves the ending state. - `/sm reset` can recover a match that was left in the ending state. - Reentrant start and stop calls can no longer activate a cancelled match or leak a tick task. - Disconnect deadlines are checked during grace, so a Runner quitting during the freeze no longer leaves Hunters frozen until grace expires. - A failed resume no longer blocks `/sm start`, `/sm join`, and `/sm joinall` forever. - Resuming with an offline Runner now arms a reconnect deadline. - Saved disconnect deadlines are rebased after server downtime instead of ending the hunt immediately. - Resume preserves remaining grace and paused state. - Resume preserves original game modes for participants who are offline at resume time. - Resume uses saved initial roles for result settlement and statistics. - Benched Rotating Prey Runners no longer stay spectators permanently after a resume. - Restarting no longer re-rolls the Imposter or Detective. - Restarting no longer resets the Shrinking Border to its starting diameter. - `/sm reset` no longer discards queued game-mode restores for offline players. - Queued game-mode restores are applied when a player rejoins during a later hunt. - `/sm stop` and `/sm pause` no longer print a missing message key. - A checkpoint is no longer offered when `persistence.save-active-match` is false. - The resumed hunt now records the correct initial roles, so end-of-match statistics do not treat a Ghost or eliminated Runner as their mid-match role. ## Migration notes - No configuration or permission changes. - Existing 1.0.0 checkpoints load with default values for the new resume fields. Mode-specific state saved by 1.0.0 is not present, so that state initializes on resume. - Replace the old jar with `SunManhunt-1.0.1.jar` and restart the server.

# SunManhunt 1.0.0 Initial Modrinth release. ## Release summary SunManhunt is a one-jar manhunt plugin for Paper servers. The default game works immediately: one Runner, a team of Hunters, a 60 second grace period, a tracked compass, and an Ender Dragon objective. Optional twist modes can be layered on when a group wants a different hunt. Built for Paper 1.21.x through 26.3. Primary target is 26.x. ## Added ### Core manhunt - Runner and Hunter role assignment, with optional explicit spectators. - 60 second default grace period with frozen Hunters and disabled PvP during grace. - Automatic hunter compass with distance display, configurable update interval, and cross dimension portal mapping. - One life per Runner by default, configurable Runner lives, and Hunter respawn delay. - Runner disconnect grace with a 30 second reconnect window before forfeit. - End of match results GUI, cleanup, gamemode restoration, and persistent player statistics. - Single TickBus for all recurring gameplay work. ### Objective engine - Kill entity objectives for the Ender Dragon, Wither, Warden, and other mobs. - Item objectives for single items or multi item sets. - Advancement objectives. - World, environment, and coordinate objectives. - Composite ANY and ALL objectives with cycle detection. - YAML-only objective presets, including Dragon or Wither, Dragon and Wither, and full Netherite. ### Modes - Base manhunt, always active. - Ghost mode with spectral pulses, interaction blocking, and multi Runner support. - Imposter mode with a traitor Runner, Detective accusation, fatal wrong accusations, a private hunter/imposter channel, and a traitor compass. - Rotating Prey mode with configurable inventory, health, and XP transfer. - Economy mode with Sun Coins, milestone and pressure rewards, role shops, cooldowns, and persistent balances. - Shrinking Border mode with milestone pauses and restoration of original world borders. - Scenario Roulette with Floor is Lava, Bounty Swap, Supply Drop, No Jump, and Randomizer Recipes. - Mode conflict validation for commands and GUI selection. ### Admin and UI - Four step setup wizard: roles, objective, modes, and review/start. - Mode selection GUI, role shop GUI, and end of match statistics GUI. - `/sm joinall` to force every online player into the lobby. - `/sm role all <role>` to force join and mass assign every online player. - Presets for objective and mode combinations. - Pause, resume, reset, reload, status, and saved match recovery. - PlaceholderAPI expansion with state, objective, role, time, balance, distance, and related placeholders. ### Permissions and storage - Granular permission for every command path. - Default player set covering help, status, join, leave, shop, ghost, accuse, and imposter chat. - Admin group with match management, roster management, setup, reload, and force join. - Active match checkpoints with configurable resume policy. - Async player profile and statistics storage. ## Compatibility - Requires Paper. Spigot is not supported. - Designed for Paper 1.21.x through 26.3, with 26.x as the primary target. - Jar is Java 21 bytecode. Use Java 21 for 1.21.x servers and Java 25 for 26.x servers. - No NMS and no shaded runtime libraries. - Boot verified on Paper 26.3 build 202 with Java 25. - 16 automated tests pass. The full real-server gameplay matrix remains a release gate and is tracked in the project's `docs/TEST_MATRIX.md`. ## Installation 1. Place `SunManhunt-1.0.0.jar` in the server's `plugins` folder. 2. Use Java 21 or Java 25, depending on the server version. 3. Restart the server. 4. Optional: install PlaceholderAPI. 5. Run `/sm setup`, or have at least two players online and run `/sm start`. ## Important behavior notes - Rotating Prey can replace the incoming Runner's inventory when inventory transfer is enabled. - Ghost mode needs another living Runner to keep the hunt going after a Runner death. - Imposter mode requires at least two Runners and disables itself otherwise. - Shrinking Border modifies and restores every loaded world's border. - Resume restores match roles, objective, modes, currency, and lives. Ephemeral mode state such as rotating order and active scenario state resets. ## File details - File: `SunManhunt-1.0.0.jar` - Size: `252332` bytes - SHA-256: `6D3CFAFD36C286DA8B47BF94D11644FF09FFDFD348CBBA05E3C93542F1ED23C3`