# RecruitsAddon – Advanced Recruit Command System<\/p>\n
**A comprehensive addon for the Recruits mod that provides advanced tactical control over your recruit units.**<\/p>\n
## \ud83c\udfaf Overview<\/p>\n
RecruitsAddon transforms the way you command your recruits by providing:
\n– **Unlimited Range Commands** – Control your recruits from anywhere in the world
\n– **Group-Based Operations** – Target specific recruit groups for tactical precision
\n– **Formation System** – Organize recruits in LINE, SQUARE, CIRCLE, and WEDGE formations
\n– **Advanced Combat AI & Auto-Teleport** – Coordinated group retaliation, smart defensive behavior, and auto-teleportation for lagging recruits
\n– **Enhanced GUI Integration** – Seamless integration with the existing Recruits mod interface<\/p>\n
## \ud83d\udccb Requirements<\/p>\n
– **Minecraft**: 1.20.1
\n– **Minecraft Forge**: 47.3.0+
\n– **TalhaNation’s Recruits Mod**: Latest version for 1.20.1<\/p>\n
## \ud83c\udfae How to Use<\/p>\n
### Basic Commands<\/p>\n
All commands work at **unlimited distance** – no need to be near your recruits!<\/p>\n
#### March Commands #### Raid Commands #### Control Commands ### Formation Types<\/p>\n – **LINE** – Single line formation, perfect for narrow passages ### Coordinate System<\/p>\n **Absolute Coordinates**: Use exact numbers **Relative Coordinates**: Use `~` for relative positioning ## \ud83c\udf9b\ufe0f GUI Features<\/p>\n ### Enhanced Recruit Command GUI<\/p>\n Access through the existing Recruits mod interface to find new “Group Commands” section:<\/p>\n **Quick Action Buttons:** **Chat Prefill Buttons:** *Note: Buttons automatically detect your active recruit groups and target them specifically.*<\/p>\n ## \u2694\ufe0f Combat Features<\/p>\n ### March vs Raid Behavior<\/p>\n **March Mode (Defensive)**: **Raid Mode (Aggressive)**: ### Group Retaliation System<\/p>\n When any recruit in a marching group is attacked: ### Defensive Commands<\/p>\n **Stop Command**: **Cancel Command**: ## \u2699\ufe0f Configuration<\/p>\n Configuration file: `config\/recruits-addon.toml` (auto-generated on first run)<\/p>\n ### Entity Blacklist<\/p>\n Customize which entities recruits should avoid during raids: ## \ud83c\udfaf Advanced Usage Examples<\/p>\n ### Tactical Scenarios<\/p>\n **Base Defense Setup**: **Coordinated Attack**: **Escort Mission**: ### Group Management<\/p>\n **Multi-Group Operations**: # Recall specific group # Stop all groups ## \ud83d\udee0\ufe0f Troubleshooting<\/p>\n ### Common Issues<\/p>\n **Q: Recruits not responding to commands** **Q: GUI buttons not working** **Q: Distance limitations** **Q: Recruits not raising shields on stop** ### Debug Information<\/p>\n Enable debug logging in your `log4j2.xml`: ## \ud83d\ude4f Acknowledgments<\/p>\n – **TalhaNation** for the excellent base Recruits mod —<\/p>\n **Enjoy commanding your recruits with tactical precision! \u2694\ufe0f** <\/p>\n","protected":false},"excerpt":{"rendered":" This Recruits Addon Mod adds a few commands as well as Group control<\/p>\n","protected":false},"featured_media":130512,"template":"","meta":{"_minecraft_slug":"recruits-extras","_minecraft_project_id":"zamftVey","_minecraft_author":"Machiavellian","_minecraft_license":"MIT","_minecraft_downloads":1985,"_minecraft_follows":2,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"recruits-extras.zip","_minecraft_size_bytes":119414,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T01:32:16.453119Z","_minecraft_date_created":"2025-07-26T02:59:24.606159Z","_minecraft_date_modified":"2025-07-22T10:33:50.123197Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/recruits-extras","_minecraft_icon_attachment_id":130512,"_minecraft_imported_at":"2026-06-07T16:31:21+00:00","_minecraft_import_hash":"9cd9fbabe4d131c18cab4a9428ca3c54","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[104],"mod_loader":[106],"minecraft_version":[36,60,93,94,101,102],"class_list":["post-130511","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-forge","mod_loader-forge","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6"],"yoast_head":"\n
\n“`
\n\/recruits march
\n“`
\n– **Basic**: `\/recruits march 100 64 -200` – March all recruits to coordinates
\n– **Group**: `\/recruits march 0 64 0 group 1` – March only group 1
\n– **Formation**: `\/recruits march 50 70 -100 formation LINE` – March in line formation
\n– **Advanced**: `\/recruits march -50 80 150 group 2 formation SQUARE` – Group 2 in square formation<\/p>\n
\n“`
\n\/recruits raid
\n“`
\n– **Basic**: `\/recruits raid -100 65 300` – Send recruits to raid coordinates
\n– **Group**: `\/recruits raid 200 70 -50 group 3` – Send group 3 to raid
\n– **Formation**: `\/recruits raid 0 64 -200 formation WEDGE` – Raid in wedge formation<\/p>\n
\n“`
\n\/recruits cancel # Cancel all operations, recruits return to you
\n\/recruits stop # Make recruits hold defensive positions with shields
\n\/recruits follow [player] [formation] # Follow you or another player
\n\/recruits attack
\n“`<\/p>\n
\n– **SQUARE** – Grid formation, balanced defense and offense
\n– **CIRCLE** – Circular formation, excellent for area defense
\n– **WEDGE** – V-shaped formation, ideal for breakthrough attacks<\/p>\n
\n“`
\n\/recruits march 100 64 -200
\n“`<\/p>\n
\n“`
\n\/recruits march ~ ~5 ~10 # 5 blocks up, 10 blocks forward from your position
\n\/recruits march ~-20 ~ ~ # 20 blocks to the left of your position
\n“`<\/p>\n
\n– **March Here** – Send active groups to your crosshair target
\n– **Raid Here** – Send active groups to raid your crosshair target
\n– **Cancel** – Instantly recall all recruits to you
\n– **Stop** – Make recruits hold defensive positions<\/p>\n
\n– **March to…** – Prefills `\/recruits march group X ~ ~ ~` for easy editing
\n– **Raid at…** – Prefills `\/recruits raid group X ~ ~ ~` for easy editing<\/p>\n
\n– Recruits move to destination in neutral state
\n– Will defend if attacked but continue mission
\n– Maintains formation during movement
\n– Suitable for repositioning and defensive movements<\/p>\n
\n– Two-phase operation: March \u2192 Raid
\n– Recruits march to destination, then become aggressive
\n– Attacks hostile mobs and players at destination
\n– Respects entity blacklist configuration<\/p>\n
\n1. **Entire group** immediately targets the attacker
\n2. Group coordinates to eliminate the threat
\n3. After 5 seconds, automatically **resumes original march**
\n4. You receive notifications about the engagement<\/p>\n
\n– Recruits raise shields and enter guard mode
\n– Only retaliate when directly attacked
\n– Multiple shield activation methods ensure reliability
\n– Perfect for holding strategic positions<\/p>\n
\n– Comprehensive AI state clearing
\n– Multiple pathfinding methods ensure recruits return
\n– Cancels any active raid missions
\n– Robust error handling prevents failures<\/p>\n
\n“`toml
\n[blacklist.entities]
\nentityBlacklist = [
\n “minecraft:villager”,
\n “minecraft:iron_golem”,
\n “minecraft:cat”,
\n “minecraft:wolf”,
\n “minecraft:creeper”
\n]
\n“`<\/p>\n
\n“`
\n\/recruits march -100 64 -100 group 1 formation CIRCLE
\n\/recruits march 100 64 100 group 2 formation SQUARE
\n\/recruits stop
\n“`<\/p>\n
\n“`
\n\/recruits march 0 64 -200 group 1 formation WEDGE
\n\/recruits march 50 64 -200 group 2 formation LINE
\n\/recruits raid 0 64 -150 group 1
\n\/recruits raid 0 64 -150 group 2
\n“`<\/p>\n
\n“`
\n\/recruits follow @p formation CIRCLE
\n\/recruits march ~ ~ ~20 formation LINE
\n“`<\/p>\n
\n“`
\n# Send different groups to different locations
\n\/recruits march 100 64 0 group 1 formation LINE
\n\/recruits march -100 64 0 group 2 formation SQUARE
\n\/recruits raid 0 64 200 group 3 formation WEDGE<\/p>\n
\n\/recruits cancel group 1<\/p>\n
\n\/recruits stop
\n“`<\/p>\n
\n– Ensure recruits are actually owned by you
\n– Check that groups are not disabled in the GUI
\n– Verify recruits are not stuck or in combat<\/p>\n
\n– Make sure you have active recruit groups
\n– Check that recruits are alive and not disabled
\n– Restart the GUI if buttons appear grayed out<\/p>\n
\n– This mod removes ALL distance limitations
\n– Commands work from anywhere in the world
\n– If recruits seem unresponsive, they may be in unloaded chunks<\/p>\n
\n– The mod tries multiple methods to activate shields
\n– Ensure recruits have shields equipped
\n– Some recruit types may not support shield mechanics<\/p>\n
\n“`xml
\n
\n“`<\/p>\n
\n– The community for feedback and testing<\/p>\n