?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
Sun Manhunt

Sun Manhunt

Modular Manhunt for Paper 1.21–26.3: configurable objectives plus six stackable twist modes. Works out of the box, scales to any hunt.

14downloads
0followers
14downloads
0followers

Links

Buy Me a Coffee

Tags

Creators

Details

Licensed ARR
Published yesterday
Updated 14 hours ago
All versions

1.0.0

Alpha
Sun Manhunt 1.0.0last week 8
Download

Compatibility

Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
Platforms
Paper
Purpur

Changes

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