Recruits-Extras - Advanced Recruit Command System

A powerful addition to the Recruits mod that provides advanced tactical control over your recruit squads.

🎯 Feature Overview

Recruits-Extras fundamentally changes the approach to recruit management by offering:

• Unlimited Range Commands - Control recruits from anywhere in the world
• Group Operations - Precise control over specific groups for tactical accuracy
• Formation System - Organize recruits in LINE, SQUARE, CIRCLE, and WEDGE formations
• Advanced Combat AI & Auto-Teleport - Coordinated group response, intelligent defensive behavior, and automatic teleportation for lagging recruits
• Enhanced Interface Integration - Seamless operation with the existing Recruits mod interface

📋 Requirements

• Minecraft: 1.20.1
• Minecraft Forge: 47.3.0+
• TalhaNation's Recruits Mod: Latest version for 1.20.1

🎮 Usage

Basic Commands

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

Movement Commands

/recruits march <x> <y> <z> [group <groupId>] [formation <type>]

• Basic Usage: /recruits march 100 64 -200 - Sends all recruits to coordinates
• Group: /recruits march 0 64 0 group 1 - Moves only group 1
• With Formation: /recruits march 50 70 -100 formation LINE - Movement in line formation
• Combined: /recruits march -50 80 150 group 2 formation SQUARE - Group 2 in square formation

Attack Commands

/recruits raid <x> <y> <z> [group <groupId>] [formation <type>]

• Basic Attack: /recruits raid -100 65 300 - Sends recruits to attack coordinates
• Group Attack: /recruits raid 200 70 -50 group 3 - Only group 3 attacks
• Attack with Formation: /recruits raid 0 64 -200 formation WEDGE - Attack in wedge formation

Control Commands

/recruits cancel     # Cancels all operations, recruits return to you
/recruits stop       # Recruits take defensive positions with shields
/recruits follow [player] [formation]  # Follows you or another player
/recruits attack <player>  # Attacks a specific player (max 125 blocks)

Formation Types

• LINE - Linear formation, perfect for narrow passages
• SQUARE - Square formation, balanced defense and attack
• CIRCLE - 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

🎛️ Interface Features

Enhanced Command Interface

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

Quick Action Buttons:

• Move Here - Sends active groups to crosshair target
• Attack Here - Sends active groups to attack crosshair target
• Cancel - Instantly recalls all recruits to you
• Stop - Recruits take defensive positions

Chat Prefill Buttons:

• Move to... - Prefills /recruits march group X ~ ~ ~ for easy editing
• Attack at... - Prefills /recruits raid group X ~ ~ ~ for easy editing

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

⚔️ Combat Features

Movement vs Attack Behavior

Movement Mode (Defense):

• Recruits move to destination in neutral state
• Defend when attacked but continue mission
• Maintain formation during movement
• Suitable for repositioning and defensive maneuvers

Attack Mode (Aggression):

• Two-phase operation: Movement → Attack
• Recruits move to destination, then become aggressive
• Attacks hostile mobs and players at destination
• Respects entity blacklist configuration

Group Response System

When any recruit in a moving group is attacked:

1. Entire group immediately targets the attacker
2. Group coordinates to eliminate the threat
3. After 5 seconds, automatically resumes original movement
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:

• Complete AI state clearing
• Multiple pathfinding methods ensure recruit return
• Cancels any active attack 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 attacks:

[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:

# Sending 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

# Recalling specific group
/recruits cancel group 1

# Stopping all groups
/recruits stop

🛠️ Troubleshooting

Common Issues

Q: Recruits not responding to commands

• Ensure recruits actually belong to you
• Check that groups are not disabled in the interface
• Verify recruits are not stuck or in combat

Q: Interface buttons not working

• Make sure you have active recruit groups
• Check that recruits are alive and not disabled
• Restart the interface 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 uses multiple shield activation methods
• Ensure recruits have shields equipped
• Some recruit types may not support shield mechanics

Debug Information

Enable debug logging in your log4j2.xml:

<Logger level="debug" name="com.mchivellian.recruitsaddon"/>

Enjoy tactical control over your recruits! ⚔️