-
Notifications
You must be signed in to change notification settings - Fork 0
Home
(Don't worry why it says god eye army, it is because that is how I initially named the mod..anyways)
Welcome to the official documentation for the Bot Army Mod! This mod allows you to summon an elite army of PvP-capable bots to defend your base, patrol your world, or hunt down your enemies.
Unlike standard Minecraft mobs, these bots utilize advanced 1.9+ combat mechanics, dynamic pathfinding, and survival instincts to fight exactly like real players.
Because this mod utilizes advanced player-simulation logic, it requires a few dependencies to run properly on your server or single-player world.
- [Fabric Loader](https://fabricmc.net/) (0.18.4 or higher)
- [Fabric API](https://modrinth.com/mod/fabric-api)
- [Carpet Mod](https://modrinth.com/mod/carpet) (Required! The Army Mod uses Carpet's backend engine to physically spawn the fake players).
- Download the latest version of the Bot Army Mod from Modrinth.
- Download the required dependencies listed above.
- Drop all
.jarfiles into your Minecraftmodsfolder. - Launch the game!
All army controls are handled through the /army command. You must have OP permissions (Level 2+) to use these commands.
| Command | Description |
|---|---|
/army spawn <count> |
Spawns a specified number of bots (up to 100) at your current location. |
/army state idle |
Orders all bots to halt and hold their current position. |
/army state patrol |
Orders all bots to begin roaming and securing the perimeter. |
/army attack <target> |
Orders the entire army to swarm and eliminate a specific player/entity. |
/army stop |
Cancels the current attack order and returns the army to the IDLE state. |
The Bot Army bots are programmed with a State Machine and survival logic.
When a bot spawns, it is randomly assigned a combat class:
- Shield Users (50%): These bots will hold a shield in their offhand. They actively "block-hit," raising their shield while waiting for their weapon cooldown to recharge.
- Totem Users (50%): These bots rely on a Totem of Undying. They play hyper-aggressively and focus entirely on offensive pressure.
Bots do not fight to the death blindly.
- Tactical Retreat: If a bot falls below 4 hearts, it will turn its back to the enemy, sprint away, and eat a Golden Apple to heal.
- Cornered Rat Logic: If you chase a healing bot and get too close (< 3 blocks), it will instantly cancel its healing, turn around, and strike you to create distance before running again.
Bots actively monitor their own movement to ensure they never get trapped.
- Ender Pearl Escapes: If a bot is trapped in a 1x1 hole for more than 2 seconds, or gets stuck in water, it will equip an Ender Pearl, aim into the air, and teleport out of the trap.
- Wind Charge Jumping: If a target is towering up or standing on a high wall, the bot will look straight down and fire a Wind Charge to launch itself upward.
To ensure maximum immersion, bots do not use generic names. The mod features a built-in, hardcoded database of names (I know hardcoding is bad in general, I will improve this in later versions!!)
When you use /army spawn, the mod pulls from this list, guaranteeing that every bot in your army has a unique name and a high-quality, real Minecraft skin. The mod also features an infinite-spawning loop to dynamically handle large numbers without duplicate-name errors.