Turn the Night Into a Living Threat

Threat Director transforms vanilla hostile mobs into coordinated, adaptive threats.

Instead of simply giving mobs more health or damage, the mod evaluates each player individually and directs encounters based on player progression, equipment, combat activity and environmental danger.

A quiet village can remain safe early in a playthrough, then gradually become the center of a coordinated assault once the players are prepared enough.

Threat Director is designed for Minecraft 1.20.1 with Fabric and works primarily on the server.

Core Features

• Individual threat evaluation for every player.
• Coordinated hostile encounters instead of random mob piles.
• Difficulty-scaled AI and abilities.
• Tactical positioning, flanking and escape-route interception.
• Reinforcement waves with lifetime threat budgets.
• Multiplayer encounters with diminishing group scaling.
• Server-side authority for dedicated servers, singleplayer and LAN.
• Optional threat HUD visible to operators.
• Optional debug logging directly in operator chat.
• Performance governor with automatic degradation under server load.
• Compatibility safeguards for claims, spawn protection and mob griefing rules.
• No custom blocks, items, dimensions or registered mobs.

Adaptive Threat

Threat is tracked individually for every player.

The system considers progression, equipment, health, inventory, recent combat, environmental danger, XP and playtime. A player who remains poorly equipped cannot permanently avoid progression pressure simply by refusing to upgrade.

Playtime contributes gradually to the threat system, while death reduces part of the accumulated time-based pressure:

• The first death retains approximately 85% of the time progression.
• The second death retains approximately 70%.
• Repeated deaths never reduce the retained contribution below 35%.
• New playtime can gradually recover the lost progression.

This creates a recovery window after losing equipment without completely resetting the world’s difficulty.

Encounter Director

Threat Director controls encounters through a state machine:

• STALKING
• POSITIONING
• ENGAGING
• SEARCHING
• CLIMAX
• RELIEF
• RETREATING

Each encounter can contain:

• A primary target.
• Nearby multiplayer participants.
• Shared tactical information.
• Assigned mob roles.
• Threat budget and reinforcement reserve.
• Tactical sectors around the players.
• Cooldowns and safety conditions.

Tactical Roles

Mobs can be assigned different roles:

• Vanguard — frontline attackers.
• Flanker — side and rear pressure.
• Harasser — ranged or disruption support.
• Interceptor — blocks escape routes and predicts movement.

The director uses vanilla navigation with bounded pathfinding attempts, tactical sectors, replanning intervals and global work budgets.

Encounters can execute patterns such as:

• Pincer formations.
• Exit-route closures.
• Rotating melee attackers.
• Ranged pressure from protected positions.
• Reinforcement waves from multiple directions.

Threat Budget and Hordes

Every encounter receives a lifetime threat budget.

The budget controls:

• Initial population.
• Mob type costs.
• Reinforcement waves.
• Population caps.
• Tactical reservations.
• Replacements after deaths.

Mob deaths do not refund their cost. This prevents unlimited respawning and keeps encounters predictable for server performance.

In Hard difficulty, encounters can sustain multiple reinforcement waves while the budget and server performance allow it. The system creates the feeling of a continuous horde without spawning an unlimited number of entities in one tick.

Mob Abilities

Skeletons

Skeletons become increasingly precise and dangerous as difficulty rises.

• Extended detection and attack range.
• Predictive aiming based on player movement.
• Server-side projectile correction.
• Defensive retreat behavior.
• Hard difficulty dash to create distance.
• Long-range attacks up to approximately 128 blocks in Hard.
• Special arrows that can apply:
  • Slowness
  • Poison
  • Nausea
  • Blindness
• Effects last between 1 and 30 seconds, with an average duration close to 8 seconds.

Easy difficulty keeps vanilla skeleton behavior.

Zombies

Zombies are designed to create persistent, escalating hordes.

• Long-range detection and aggro.
• Up to approximately 96 blocks of targeting range in Hard.
• Aggro can remain active after line of sight is lost.
• Damaging one zombie can alert nearby zombies.
• Detection may trigger a lightning signal and summon additional zombies.
• Normal difficulty summons smaller groups.
• Hard difficulty can summon approximately 5–10 zombies.
• Newly summoned zombies spawn with the player already marked as their target.
• Zombies can spawn with swords, axes, shovels, pickaxes and shields.
• Compatible tools allow limited obstruction breaking.
• Block breaking respects mobGriefing, claims, spawn protection, chunks and safety guards.

Creepers

Creepers become less predictable and more dangerous during high-threat encounters.

• Reduced movement noise in Hard.
• Increased rear-pressure speed.
• Defensive or pursuit dashes.
• Randomized fuse time.
• Hard difficulty fuse can vary between approximately 30% and 100% of the vanilla fuse.
• Can ignite near a breakable wall when opening the route would benefit the encounter.
• Explosions still respect mobGriefing and server safeguards.

Spiders

• Speed and Jump Boost in Normal.
• Regeneration and Strength in Hard.
• Improved movement and jumping.
• Can generate up to two cave spiders on death.
• Hatchlings are marked to prevent recursive spawning.
• Rare cobweb-on-hit effect.
• Cobweb placement has a long cooldown and low probability.
• Claims and mobGriefing rules are respected.

Endermen

• Can alert nearby endermen when damaged.
• Hard difficulty can coordinate larger responses.
• Can use a lower combat posture in confined spaces.
• Can teleport near players attempting to escape by building a low pillar.
• Teleport responses are bounded by cooldowns and safety checks.

Other Hostile Mobs

Other vanilla hostile families receive limited thematic pressure:

• Witches and illagers: weakening and coordinated ranged pressure.
• Blazes, ghasts and phantoms: projectile and aerial pressure.
• Guardians: aquatic pressure and fatigue.
• Drowned and husks: persistent pursuit and attrition.
• Silverfish, endermites and slimes: swarm behavior.
• Ravagers and piglin brutes: stronger charge pressure in Hard.

The mod does not add custom entities or require content mods.

Difficulty Profiles

Multiplayer

Threat is calculated individually, but encounters can be shared by nearby players.

Multiplayer groups receive:

• Diminishing-return scaling instead of linear mob multiplication.
• Shared encounter pressure.
• Target distribution across visible players.
• Rotating target assignments to avoid predictable focus.
• Separate individual progression and threat values.
• Shared tactical coordination without making every mob attack one player simultaneously.

Threat HUD

The optional HUD displays a text-free threat bar:

• Located between the XP bar and hotbar.
• Uses a Minecraft-style segmented texture.
• Uses a green, yellow, red and purple threat palette.
• Visible to operators by default.
• Can be enabled for specific players.
• Requires the mod on the client that wants to see the overlay.
• Does not affect server-side AI behavior.