One infected hunter at the start. Every speedrunner death converts them to the infected team. Beat the Ender Dragon before the infection spreads across your entire server.

---

---

🎮 What Makes This Different

In standard manhunt, teams stay the same size throughout the game. In Infected Manhunt, the hunter team grows with every speedrunner death, creating natural escalation:

• Early Game: 1 infected vs 4-5 speedrunners. Fair chase.
• Mid Game: 2-3 infected. Speedrunners must play more carefully.
• Late Game: Most of the server is infected. Survival becomes extremely difficult.
• End Game: Final speedrunner(s) face the entire server in the dragon fight.

This creates a natural difficulty curve perfect for content creation and competitive events.

---

✨ Core Features

🦠 Infection Spreads on Death Any speedrunner death—PvP, mobs, fall damage, lava—permanently converts them to the infected team. Once infected, players stay infected.	📈 Natural Difficulty Scaling Games start balanced and become progressively harder as more players join the infected team. Creates organic tension throughout the match.
🧭 Automatic Tracking Compass Every infected player receives an auto-updating compass that tracks the nearest speedrunner. No setup or commands required.	🏆 Clear Win Conditions Speedrunners win by killing the Ender Dragon. Infected win by eliminating all speedrunners. Simple and unambiguous.
⚡ Quick Setup Install the plugin, run /infected start, and you're ready to play. Advanced configuration options available if needed.	🎥 Content-Friendly Format Based on the viral Infected Manhunt format. Games typically last 15-30 minutes with natural story progression.

---

🎮 How It Actually Works

Game Flow

1. Server starts with 5 players total
   ├─ 1 Player selected as INFECTED (random or manual)
   └─ 4 Players start as SPEEDRUNNERS

2. Speedrunners race to beat the game
   └─ Infected hunt with tracking compass

3. First speedrunner dies to infected player
   ├─ They respawn instantly
   ├─ They're now INFECTED (2 hunters, 3 runners)
   └─ They receive tracking compass automatically

4. Pattern repeats...
   ├─ 3 infected vs 2 runners
   ├─ 4 infected vs 1 runner (the clutch moment)
   └─ Game ends when:
       ├─ Ender Dragon dies (runners WIN)
       └─ Last runner dies (infected WIN)

The Infected Experience

When you start as infected:

• Receive tracking compass automatically
• Right-click compass to lock onto nearest speedrunner
• Compass updates every few seconds
• Hunt down speedrunners and spread the infection

When you die as a speedrunner:

• Respawn instantly as infected
• Team automatically switches
• Receive tracking compass
• Now hunting your former teammates

---

📊 Infected vs Standard Manhunt

Feature	Standard Manhunt	Infected Manhunt
Team sizes change during game	❌	✅
Deaths have lasting impact	⚠️	✅
Difficulty increases over time	❌	✅
Betrayal mechanic	❌	✅
Automatic tracking compass	✅	✅
Works on vanilla servers	✅	✅

---

🎥 Content Creator Friendly

Infected Manhunt works well for video content:

• Natural Story Arc: Games build tension naturally as more players become infected
• Betrayal Moments: Former teammates hunting each other creates engaging content
• Ideal Length: Most games last 15-30 minutes, perfect for YouTube videos
• Viewer Engagement: Easy for viewers to follow team counts and root for survivors
• High Replayability: Every game plays differently based on death order

This format has generated millions of views across Sapnap, Dream SMP members, and indie creators.

---

⚙️ Commands & Permissions

Essential Commands

Command	Description	Permission
/infected start	Begin a new Infected Manhunt round	infected.admin
/infected stop	Force-end the current game	infected.admin
/infected setinfected <player>	Manually infect a specific player	infected.admin
/infected setrunner <player>	Convert infected back to runner (admin override)	infected.admin
/infected status	Check current team counts and game state	infected.play
/infected reload	Reload config without restart	infected.admin

Permissions

infected.admin   # Full control (start, stop, force teams)
infected.play    # Join and participate in games

Default setup: Ops get infected.admin, all players get infected.play

---

Click to view Advanced Configuration

⚙️ Full Config Options

# Core Game Settings
game:
  # How to pick the first infected
  initial_infected_selection: RANDOM  # RANDOM or MANUAL
  
  # Minimum players needed to start
  min_players: 2
  
  # Auto-start when enough players join
  auto_start: false
  
  # Countdown before game begins (seconds)
  start_countdown: 10

# Compass Behavior
compass:
  # Auto-update or require right-click
  auto_update: true
  
  # How often compass updates (ticks)
  update_interval: 40  # 2 seconds
  
  # Track nearest or specific target
  tracking_mode: NEAREST  # NEAREST or LOCKED
  
  # Max tracking range (0 = unlimited)
  max_range: 0

# Death & Infection Rules
infection:
  # Types of death that cause infection
  infect_on_pvp: true
  infect_on_mob: true
  infect_on_fall: true
  infect_on_lava: true
  infect_on_void: true
  infect_on_explosion: true
  
  # Respawn settings for newly infected
  instant_respawn: true
  spawn_at_death_location: false
  
  # Give infected players effects on conversion
  infected_effects:
    - SPEED:1:999999  # Permanent Speed I
    - NIGHT_VISION:1:999999

# Win Conditions
win_conditions:
  # What counts as a speedrunner victory
  dragon_death: true
  
  # What counts as an infected victory
  all_runners_infected: true
  
  # End game immediately or allow cleanup
  instant_end: false

# Messaging & Titles
messages:
  # Broadcast when someone gets infected
  announce_infection: true
  infection_message: "&c{player} has been INFECTED!"
  
  # Title screen for newly infected
  show_infection_title: true
  infection_title: "&4&lINFECTED"
  infection_subtitle: "&cYou are now hunting your former team"
  
  # Team count updates
  show_team_counts: true
  team_count_interval: 60  # Every 60 seconds

# Performance & Compatibility
performance:
  # Async compass updates for better TPS
  async_tracking: true
  
  # Limit simultaneous tracking calculations
  max_concurrent_updates: 50

# Advanced Features
advanced:
  # Allow spectators to watch after game ends
  spectator_mode: true
  
  # Prevent runners from attacking infected
  runners_can_damage_infected: false
  
  # Infected can damage each other (friendly fire)
  infected_friendly_fire: false
  
  # Save game stats to database
  save_statistics: true

---

🎨 Customization Examples

Example 1: Speed Demon Mode

compass:
  update_interval: 10  # Update every 0.5s
  
infected_effects:
  - SPEED:2:999999  # Speed II
  - JUMP_BOOST:1:999999

Example 2: Hardcore Infection

infection:
  infect_on_mob: true
  infect_on_fall: true
  infect_on_lava: true
  # Even accidental deaths spread the virus
  
win_conditions:
  instant_end: true  # Game ends the second last runner dies

Example 3: Content Creator Mode

messages:
  announce_infection: true
  show_infection_title: true
  show_team_counts: true
  team_count_interval: 30  # Frequent updates for chat

advanced:
  spectator_mode: true  # Let dead players watch the finale

---

🔧 Technical Details

Compatibility

Platform	Status
Paper 1.21+	✅ Fully Supported & Recommended
Spigot 1.21+	✅ Supported
Purpur 1.21+	✅ Supported
Bukkit 1.21+	✅ Supported

Performance

• Async compass tracking prevents TPS lag
• Event-driven infection (no constant polling)
• Optimized for 2-20 players (tested up to 50)
• Zero overhead when game isn't running

Dependencies

None. Just drop it in your plugins folder.

---

📊 Comparison: Infected vs Standard Manhunt

Feature	Standard Manhunt	Infected Manhunt
Hunter count changes over time	❌	✅
Deaths have permanent consequences	❌	✅
Late-game intensity increases	❌	✅
Natural content story arc	❌	✅
Speedrunner betrayal mechanic	❌	✅
Zero-config setup	⚠️	✅
Built-in tracking compass	✅	✅

Infected Manhunt isn't just different. It's what manhunt should have been from the start.

---

📈 Roadmap

✅ Current Features

• Core infection mechanics
• Automatic compass tracking
• Win condition detection
• Team management
• Full configuration system

⏳ Planned Updates

• Statistics tracking (K/D, infection time, survival time)
• Leaderboard integration
• Custom team colors & prefixes
• Discord webhook notifications
• Infection "variants" (different hunter abilities)
• API for developers to hook into events

Want a feature? Open an issue and let us know.

---

🐛 Support & Bug Reports

Found a bug? Have a suggestion? Want to request a feature?

1. Check the Issues page first
2. Include:
   • Server version (Paper 1.21.3, etc.)
   • Plugin version
   • Full error logs
   • Steps to reproduce

Response time: Usually within 24 hours.

---

📝 License & Usage

• Free for all servers (small, large, network)
• Commercial use allowed (monetized videos, servers with donations)
• Modification allowed (but please share improvements!)
• Credit appreciated but not required

Just make great content and have fun.

---