Join the Discord

Manhunt AI Bot v1.0.2

A Real AI Hunter for Minecraft Bedrock

Turn any Minecraft Bedrock world into a complete single-player Manhunt challenge.

Manhunt AI Bot adds one or more intelligent hunters that can track you, gather resources, craft tools, upgrade equipment, build routes, survive dangerous terrain and fight using player-like tactics.

This is not a normal mob with increased speed.

The hunter has its own decision system and can change its goal depending on what is happening in the world. It may chase you directly, stop to gather blocks, craft a missing tool, mine iron, escape a trap, build upward or prepare better equipment before attacking again.

Version v1.0.2 is a major rebuild of the original v0.7.0 addon.

How to Start a Hunt

Install and activate both the Behavior Pack and Resource Pack.
Enter the world in Creative Mode.
Get the Hunter Compass:

/give @s manhunt:hunter_compass

Use the compass to open the Manhunt configuration menu.
Select the hunter count, difficulty, mode, preparation style and other options.
Start the hunt and survive.

The addon handles the countdown, hunter spawning, tracking, win conditions, deaths, respawns and end-of-hunt statistics.

Intelligent Goal-Based AI

The hunter now uses a central decision system instead of following only one chase script.

Possible goals include:

Chase the runner
Attack the runner
Gather wood
Gather food
Gather building blocks
Mine stone
Mine ores
Craft tools
Smelt resources
Upgrade equipment
Build a route
Climb toward the runner
Escape water
Escape lava
Heal and eat
Follow a portal
Share resources with another hunter
Recover from being stuck

The hunter commits to its selected task and can temporarily disable normal chase behaviour while gathering, crafting, mining or building.

If an action fails repeatedly, the AI can abandon it and generate a different plan.

Resource Gathering and Progression

Hunters can begin with an empty inventory and progress through the world naturally.

The normal progression includes:

Logs → Planks → Crafting Table → Sticks → Wooden Tools → Stone Tools → Furnace → Iron Equipment

Hunters can gather:

Logs
Planks
Dirt
Stone
Cobblestone
Food
Coal
Raw iron
Gold
Flint
Obsidian
Building blocks
Other progression resources

The AI understands tool requirements.

Examples:

Uses an axe for logs
Uses a pickaxe for stone
Requires a stone pickaxe or better for iron
Requires suitable tools for valuable ores
Avoids mining blocks that cannot produce the expected resource
Avoids mining directly beneath itself without a safe plan
Rejects unreachable or completely buried targets
Avoids exposed lava, unstable sand and dangerous gravel

Advanced mining can be enabled or disabled in the settings.

Complete Crafting System

Hunters can craft and manage their own progression.

Supported equipment includes:

Wooden sword
Wooden axe
Wooden pickaxe
Stone sword
Stone axe
Stone pickaxe
Iron sword
Iron axe
Iron pickaxe
Crafting table
Furnace
Shield
Iron helmet
Iron chestplate
Iron leggings
Iron boots
Bucket
Water bucket
Flint and steel
Bow
Arrows
Boat
Torches
Cooked food
Golden apple when enough resources are available

The crafting planner reserves important materials instead of spending everything immediately.

For example, the hunter can preserve iron for a shield, bucket or pickaxe before using the remaining iron on armour.

Building and Vertical Pursuit

The hunter can build when normal pathfinding cannot reach the runner.

Building options include:

Horizontal bridging
Diagonal staircase building
Spiral staircase planning
Controlled vertical pillaring
Reusing existing bridges
Reusing existing staircases
Breaking runner pillars
Emergency block clutching
Safe route recovery

Vertical pursuit follows a priority system.

The hunter first looks for:

A normal walkable route
Natural hills or terrain
An existing staircase
A diagonal staircase
A spiral staircase
A safe pillar-breaking opportunity
Controlled vertical pillaring

The hunter also estimates how many blocks are needed before starting a climb.

If the runner is far above and the hunter has too few blocks, it can gather more blocks first instead of standing below the tower.

Block placement is plan-controlled. The hunter should not place blocks simply because it briefly appears stuck.

Failed placements can be removed, refunded and blacklisted so the same bad route is not repeated forever.

Route Memory

Every hunter has navigation memory.

The AI can remember:

Successful paths
Failed paths
Places where it fell
Failed pillar positions
Existing bridges
Existing staircases
Water traps
Lava hazards
Cave entrances
Safe climbing locations
Safe descent locations
The runner's last movement direction
Portal locations
Resource locations

When the same route fails repeatedly, the hunter temporarily blacklists it and attempts another direction.

Old memories are automatically cleaned to prevent the world save and AI memory from growing forever.

Player-Like Combat

The hunter uses more than basic mob attacks.

Combat behaviour includes:

Distance-aware movement
Sprint pursuit
Weapon cooldown timing
Line-of-sight checking
Reach checking
Sword combat
Axe selection against shields
Shield defence
Sprint-reset movement
Side-stepping
Natural jump attacks
Bow combat
Movement prediction for ranged attacks
Retreating to eat
Re-engaging after healing
Avoiding lava and cliffs during combat
Fighting hostile mobs only when they become an immediate danger

The hunter does not need to swing continuously when the runner is out of range or behind a wall.

Difficulty changes reaction time, planning quality, aggression and recovery behaviour.

Survival Intelligence

Hunters can react to environmental danger.

Supported survival behaviour includes:

Water-bucket MLG attempts
Emergency block clutching
Lava escape
Fire escape
Water-trap escape
Drowning prevention
Searching for air pockets
Searching for the nearest shore
Powder-snow escape
Fall-distance evaluation
Safer cliff descent
Avoiding dangerous lava edges
Eating before risky actions
Boat crafting for large water crossings
Breaking out of enclosed traps

MLG and fall-safety checks run separately from slower long-term planning so the hunter can react quickly while falling.

Anti-Cheese Intelligence

The hunter can recognise many common Manhunt tricks and select a counter-plan.

Examples include:

Runner towers upward
Runner bridges over lava
Runner traps the hunter in water
Runner repeatedly closes doors
Runner escapes using a boat
Runner hides inside a two-block tunnel
Runner blocks the path behind itself
Runner camps in a tree
Runner uses cobwebs
Runner jumps from a cliff
Runner digs underground
Runner enters the Nether
Runner enters the End

The AI does not use the same response for every situation. Each detected trick can activate a different plan.

Portal and Dimension Tracking

The hunter can follow the runner between dimensions.

Supported systems include:

Remembering portal locations
Following the portal used by the runner
Overworld and Nether coordinate estimation
Remembering the runner's last dimension
Searching for a remembered portal
Portal-resource planning
Obsidian and flint-and-steel preparation
Reacquiring the runner after changing dimensions
Nether support
End support

Emergency relocation can be used as a fallback when enabled, but normal portal following is preferred.

Multiple Hunters

Manhunt AI Bot supports one to four hunters.

Available roles include:

Chaser

Keeps pressure on the runner and focuses on pursuit and close combat.

Gatherer

Collects wood, food, stone and progression resources.

Builder

Carries building blocks and helps create bridges, stairs and climbing routes.

Archer

Prioritises ranged equipment and attacks from safer positions.

Hunters can share:

Runner information
Route memory
Resource locations
Portal locations
Danger zones
Resource requirements

Gatherers and Builders can also deliver resources to other hunters.

Hunter updates are staggered to reduce lag when several hunters are active.

Hunt Modes

Choose how the runner can win.

Limited Lives

The hunter has a configurable number of lives. The runner wins after exhausting all hunter lives.

Time Limit

Survive until the configured timer ends.

Kill Count

Defeat the hunter the required number of times.

Infinite

The hunter continues respawning and the hunt has no normal final life.

Hunter Customisation

Configure the hunt before it begins.

Options include:

Hunter count
Hunter names
Hunter skins
AI difficulty
Performance profile
Win condition
Hunter lives
Time limit
Kill target
Starting inventory
Preparation behaviour
Equipment persistence
Difficulty scaling
Boat behaviour
Taunt messages
Portal recovery
Advanced mining
Debug options

Settings are stored using world dynamic properties and can survive world reloads.

Hunter Skins

The addon includes multiple hunter appearances, including Steve-style and Alex-style models.

Custom skins can be added by editing the Resource Pack files in:

textures/entity/hunter/

Both the Behavior Pack and Resource Pack must be active for the complete hunter model, animation and equipment rendering.

Hunter Compass

The Hunter Compass is the main control item for the addon.

It can be used to:

Configure a new hunt
Start the countdown
Track hunt status
View hunter information
Restart using previous settings
Open developer diagnostics
Force an AI replan
Reset hunters
Reset route memory
Enable route particles
Give test resources
Export debug information

During an active hunt, the compass can display runner/hunter direction and distance information.

Developer Diagnostics

The addon includes an advanced status screen for testing the AI.

It can display:

Current goal
Current sub-goal
Goal-selection reason
Last executed goal
Current action plan
Current target block
Exact waypoint
Required materials
Reserved materials
Planned climbing height
Available building blocks
Last successful action
Last failed action
Failure count
Stuck duration
Movement speed
Attack cooldown
Hunter inventory
Equipped items
Runner visibility
Last-known runner position
Portal memory
Squad status
AI workload per second
Last caught script error

This information is especially useful when reporting bugs.

Performance Profiles

Three AI profiles are available.

Low-End

Designed for weaker phones and lower simulation distances.

Smaller scans
Slower background planning
Reduced route depth
Simplified distant-hunter logic

Balanced

Recommended for most devices.

Full normal AI
Moderate scan sizes
Normal route planning
Shared squad perception

Maximum AI

Designed for stronger devices.

Faster replanning
Larger scans
Deeper route alternatives
More detailed environmental memory

Heavy systems run on separate schedules, and resource scanning is processed incrementally to reduce sudden lag.

Installation

Requirements

Minecraft Bedrock Edition
Both the Behavior Pack and Resource Pack
A copied or backed-up world is recommended

Steps

Download the .mcaddon file.
Open it with Minecraft.
Wait for both packs to import.
Create a new world or edit an existing world.
Activate the Manhunt AI Bot Behavior Pack.
Activate the Manhunt AI Bot Resource Pack.
Enter the world.
Give yourself the Hunter Compass.
Configure and start the hunt.

Updating from v0.7.0

Version v1.0.3 replaces most of the old AI, navigation, gathering and progression systems.

Important Notes

This addon is mainly designed for single-player or host-controlled multiplayer worlds.
Some scripted behaviour may be different for non-host players.
The hunter is a custom entity, not a real server-authenticated player.
Minecraft Bedrock does not allow an addon to turn a custom entity into a real Player.
The addon recreates player-like behaviour using entity AI, scripts, inventories, equipment, memory and custom navigation.
Results can vary with world terrain, simulation distance and device performance.
Back up important worlds before testing major updates.
Use the Content Log when reporting script or pack errors.

Support and Feedback

Bug reports and gameplay feedback are welcome.

When reporting an issue, include:

Minecraft version
Addon version
AI performance profile
Hunter count
Current goal shown in diagnostics
What the hunter was expected to do
What the hunter actually did
Content Log errors
Screenshot or video when possible

Join the Discord

You can also report issues through the CurseForge comments.

Credits

Addon: Manhunt AI Bot
Version: v1.0.3 Developer: BUDGETGAMER1503
Platform: Minecraft Bedrock Edition Addon Settings: Maximum possible setting

You can run, build, hide or escape through another dimension — but the hunter will continue learning the route.