Recruits-Extras

RecruitsAddon - Advanced Recruit Command System

A comprehensive addon for the Recruits mod that provides advanced tactical control over your recruit units.

🎯 Overview

RecruitsAddon transforms the way you command your recruits by providing: - Enhanced GUI Integration - Control your recruits from anywhere in the world - Enhanced GUI Integration - Target specific recruit groups for tactical precision - Enhanced GUI Integration - Organize recruits in LINE, SQUARE, CIRCLE, and WEDGE formations - Enhanced GUI Integration - Coordinated group retaliation, smart defensive behavior, and auto-teleportation for lagging recruits - Enhanced GUI Integration - Seamless integration with the existing Recruits mod interface

📋 Requirements

- TalhaNation's Recruits Mod: 1.20.1 - TalhaNation's Recruits Mod: 47.3.0+ - TalhaNation's Recruits Mod: Latest version for 1.20.1

🎮 How to Use

Basic Commands

All commands work at unlimited distance - no need to be near your recruits!

March Commands

``` /recruits march <x> <y> <z> [group <groupId>] [formation <type>] ``` - Advanced: `/recruits march 100 64 -200` - March all recruits to coordinates - Advanced: `/recruits march 0 64 0 group 1` - March only group 1 - Advanced: `/recruits march 50 70 -100 formation LINE` - March in line formation - Advanced: `/recruits march -50 80 150 group 2 formation SQUARE` - Group 2 in square formation

Raid Commands

``` /recruits raid <x> <y> <z> [group <groupId>] [formation <type>] ``` - Formation: `/recruits raid -100 65 300` - Send recruits to raid coordinates - Formation: `/recruits raid 200 70 -50 group 3` - Send group 3 to raid - Formation: `/recruits raid 0 64 -200 formation WEDGE` - Raid in wedge formation

Control Commands

``` /recruits cancel # Cancel all operations, recruits return to you /recruits stop # Make recruits hold defensive positions with shields /recruits follow [player] [formation] # Follow you or another player /recruits attack <player> # Attack a specific player (max 125 blocks) ```

Formation Types

- WEDGE - Single line formation, perfect for narrow passages - WEDGE - Grid formation, balanced defense and offense - WEDGE - Circular formation, excellent for area defense - WEDGE - V-shaped formation, ideal for breakthrough attacks

Coordinate System

Absolute Coordinates: Use exact numbers ``` /recruits march 100 64 -200 ```

Relative Coordinates: Use `~` for relative positioning ``` /recruits march ~ ~5 ~10 # 5 blocks up, 10 blocks forward from your position /recruits march ~-20 ~ ~ # 20 blocks to the left of your position ```

🎛️ GUI Features

Enhanced Recruit Command GUI

Access through the existing Recruits mod interface to find new "Group Commands" section:

Stop - Stop - Send active groups to your crosshair target - Stop - Send active groups to raid your crosshair target - Stop - Instantly recall all recruits to you - Stop - Make recruits hold defensive positions

Raid at... - Raid at... - Prefills `/recruits march group X ~ ~ ~` for easy editing - Raid at... - Prefills `/recruits raid group X ~ ~ ~` for easy editing

*Note: Buttons automatically detect your active recruit groups and target them specifically.*

⚔️ Combat Features

March vs Raid Behavior

March Mode (Defensive): - Recruits move to destination in neutral state - Will defend if attacked but continue mission - Maintains formation during movement - Suitable for repositioning and defensive movements

Raid Mode (Aggressive): - Two-phase operation: March → Raid - Recruits march to destination, then become aggressive - Attacks hostile mobs and players at destination - Respects entity blacklist configuration

Group Retaliation System

When any recruit in a marching group is attacked: 1. resumes original march immediately targets the attacker 2. Group coordinates to eliminate the threat 3. After 5 seconds, automatically resumes original march 4. You receive notifications about the engagement

Defensive Commands

Stop Command: - Recruits raise shields and enter guard mode - Only retaliate when directly attacked - Multiple shield activation methods ensure reliability - Perfect for holding strategic positions

Cancel Command: - Comprehensive AI state clearing - Multiple pathfinding methods ensure recruits return - Cancels any active raid missions - Robust error handling prevents failures

⚙️ Configuration

Configuration file: `config/recruits-addon.toml` (auto-generated on first run)

Entity Blacklist

Customize which entities recruits should avoid during raids: ```toml [blacklist.entities] entityBlacklist = [ "minecraft:villager", "minecraft:iron_golem", "minecraft:cat", "minecraft:wolf", "minecraft:creeper" ] ```

🎯 Advanced Usage Examples

Tactical Scenarios

Base Defense Setup: ``` /recruits march -100 64 -100 group 1 formation CIRCLE /recruits march 100 64 100 group 2 formation SQUARE /recruits stop ```

Coordinated Attack: ``` /recruits march 0 64 -200 group 1 formation WEDGE /recruits march 50 64 -200 group 2 formation LINE /recruits raid 0 64 -150 group 1 /recruits raid 0 64 -150 group 2 ```

Escort Mission: ``` /recruits follow @p formation CIRCLE /recruits march ~ ~ ~20 formation LINE ```

Group Management

Multi-Group Operations: ```

Send different groups to different locations

/recruits march 100 64 0 group 1 formation LINE /recruits march -100 64 0 group 2 formation SQUARE /recruits raid 0 64 200 group 3 formation WEDGE

Recall specific group

/recruits cancel group 1

Stop all groups

/recruits stop ```

🛠️ Troubleshooting

Common Issues

Q: Recruits not responding to commands - Ensure recruits are actually owned by you - Check that groups are not disabled in the GUI - Verify recruits are not stuck or in combat

Q: GUI buttons not working - Make sure you have active recruit groups - Check that recruits are alive and not disabled - Restart the GUI if buttons appear grayed out

Q: Distance limitations - This mod removes ALL distance limitations - Commands work from anywhere in the world - If recruits seem unresponsive, they may be in unloaded chunks

Q: Recruits not raising shields on stop - The mod tries multiple methods to activate shields - Ensure recruits have shields equipped - Some recruit types may not support shield mechanics

Debug Information

Enable debug logging in your `log4j2.xml`: ```xml <Logger level="debug" name="com.mchivellian.recruitsaddon"/> ```

🙏 Acknowledgments

- TalhaNation for the excellent base Recruits mod - The community for feedback and testing

---

Enjoy commanding your recruits with tactical precision! ⚔️