Manhunt Mode

​

Overview

• Share Soul Link mechanics (health, hunger, stats)
• Benefit from enabled chaos modes (Shared Potions, etc.)
• Win by completing the run objective (defeating the Ender Dragon)
• Get a 30-second head start at the beginning

• Use vanilla Minecraft mechanics (independent health/hunger)
• Receive tracking compasses that point to Runners
• Respawn after death and can continue hunting
• Win by eliminating all Runners

​

How to Enable

1. Run /chaos to open the Chaos Modes GUI
2. Click on the Ender Eye/Compass icon (“Manhunt Mode”)
   • Ender Eye = Disabled
   • Compass = Enabled (dark purple color)
3. Click the emerald “Confirm” button
4. Run /start to open the Runner/Hunter selector GUI
5. Click player heads to toggle between Runner (green) and Hunter (red)
6. Click the emerald to confirm roles and start the run

​

Role Selection

​

Selector GUI

• Player heads fill the center area (up to 34 players supported)
• Each head shows current role: Runner (green) or Hunter (red)
• Click any head to toggle that player’s role
• Emerald at bottom shows role counts and starts the run
• Barrier appears if role requirements aren’t met

Runner | PlayerName    (Green prefix)
Hunter | PlayerName    (Red prefix)

​

Default Roles

• All players default to Runner role (SpeedrunnerSelectorGui.java:54-56)
• You must manually assign at least one Hunter
• Roles are announced to all players when confirmed

​

Tracking Compasses

​

How Tracking Works

1. Compasses automatically point to the currently tracked Runner
2. Right-click the compass to cycle between Runners
3. Tracking works across dimensions
4. If the target is in another dimension, compass points to their last known location in your dimension

​

Cross-Dimension Tracking

1. Same Dimension: Compass points directly to Runner’s current position
2. Different Dimension: Compass points to Runner’s last known position in your dimension
3. Position history is updated every second for each dimension
4. Switching dimensions lets you follow their trail

• Runner enters the Nether
• Your compass (Overworld) points to where they entered the portal
• You can follow to the same portal location

​

Gameplay Mechanics

​

Runner Mechanics

• Shared health and hunger across all Runners
• One Runner dies = all Runners die (game over)
• Benefit from chaos modes (Shared Potions, Synced Inventory, etc.)
• Get 30-second head start before Hunters can move
• Normal respawn rules (respawn at world spawn)

​

Hunter Mechanics

• Vanilla health and hunger (not shared)
• Unlimited respawns at world spawn
• Not affected by chaos modes (Shared Potions, etc.)
• Cannot damage each other (team damage prevention)
• Receive tracking compass automatically

​

Head Start Timer

• Hunters spawn but cannot move/act immediately
• Timer is displayed on action bar
• Runners can gather resources, find shelter, or travel
• After 30 seconds, Hunters are released and tracking begins

​

Teams and Display

​

Scoreboard Teams

• Prefix: Runner | (Green, Bold)
• Name color: White
• Team name: soullink_runners

• Prefix: Hunter | (Red, Bold)
• Name color: White
• Team name: soullink_hunters

​

Role Announcements

[Soul Link] Runners: Player1, Player2, Player3
[Soul Link] Hunters: Player4, Player5

​

Strategy Guide

​

Runner Strategies

​

Hunter Strategies

​

Advanced Mechanics

​

Target Cycling

1. System gets list of all online Runners
2. Finds current target in the list
3. Cycles to next Runner in order
4. If current target is offline, selects first available Runner
5. Displays “Now tracking: [Name]” message
6. Updates compass lodestone tracking immediately

​

Position Tracking

Map<UUID, Map<RegistryKey<World>, GlobalPos>> lastKnownPositions

• Each Runner has a map of dimension → last position
• Updated every 20 ticks (1 second)
• Used for cross-dimension tracking
• Cleared when run ends

​

Action Bar Suppression

• Compass messages suppress timer display for 3 seconds (60 ticks)
• Hunters see “Now tracking: [Name]” without interruption
• Timer resumes after suppression period expires

​

Mode Interactions

​

Chaos Modes (Runners Only)

​

Implementation Details

​

Team Management

private final Set<UUID> runners = new HashSet<>();
private final Set<UUID> hunters = new HashSet<>();

public boolean isSpeedrunner(ServerPlayerEntity player) {
    return runners.contains(player.getUuid());
}

public boolean isHunter(ServerPlayerEntity player) {
    return hunters.contains(player.getUuid());
}

​

Compass Registration

UseItemCallback.EVENT.register((player, world, hand) -> {
    ItemStack stack = player.getStackInHand(hand);
    if (!stack.isOf(Items.COMPASS)) return ActionResult.PASS;
    
    if (manhunt.isHunter(serverPlayer)) {
        cycleTarget(serverPlayer, server);
        return ActionResult.SUCCESS;
    }
    return ActionResult.PASS;
});

​

Related Modes