You can support me through- https://ko-fi.com/knightmare61825
Recruits QoL is an addon mod for the Recruits mod on Forge 1.20.1. It adds quality-of-life commands, map helpers, recruit behavior fixes, training support, mounted unit improvements, and claim management tools while leaving the base Recruits mod files untouched.
Requirements
- Minecraft Forge
1.20.1
- Java
17
- Recruits mod installed
- Server and client should both have this addon installed for client-side map and command features
Features
Training Bottles
Experience bottles can now be used to train individual recruits.
Throwing experience bottles at a recruit gives that recruit progress toward leveling up. By default, 32 XP bottles equal 1 recruit level, this affects only the recruit that is hit or closest to the bottle impact. It does not level all nearby recruits.
Lost Recruit Map Markers
Owned recruits that are far away and have not been seen by their owner for a while can appear on the Recruits map, when recruits are considered lost, their owner sees an iron sword icon on the Recruits map with a number showing how many recruits are grouped at that location.
This is owner-only. Other players do not see your lost recruit markers, also the marker will not appear if the server restarts until that recruit is rendered again.
Recruit Water Floating
Recruits no longer drown helplessly in water, when a recruit is in water, the addon helps keep them afloat and refreshes their air supply so they have a much better chance of surviving.
Captain Behavior Improvements
Captains receive fixes intended to reduce cases where they ignore orders, get stuck, or fail to engage properly.
The addon helps captains recover from invalid combat/patrol states and can retarget hostile entities when they are in aggressive mode, though it still has bugs.
Group Commands
Group Training Command
Use:/recruitsqol train <group_name>
This sends all recruits in the named group into a training behavior:
- Sets them to neutral
- Makes them wander freely
- Makes them target the nearest armor stand when one is nearby
This is useful for training setups where recruits attack armor stands.
Group Mount Command
Use:/recruitsqol mount <group_name>
This makes recruits in the named group attempt to mount the nearest valid mountable entity, such as a horse, if they are not already mounted.
Mass Recruit Command
Use:/recruitsqol massrecruit <unit_type> <group_name>
Supported unit types:
- recruit
- bowman
- crossbowman
- shieldman
- horseman
- nomad
Example:/recruitsqol massrecruit bowman Archers
The command searches nearby unowned hireable units of the selected type, checks that you have enough recruit slots and currency, then recruits them into the chosen group.
The command uses the Recruits mod's normal hiring logic and currency system.
Horse Armor Support
- If a recruit has horse armor in their inventory and mounts a horse without armor, they will automatically equip the horse armor.
- If the recruit has an upkeep chest and does not already have horse armor in their inventory, they can pull horse armor from the upkeep chest.
Bulk Claim Extension
The Recruits map supports selecting multiple connected chunks when extending an existing claim.
How to use:
- Open the Recruits map.
- Hold Ctrl.
- Left-click connected chunks to select them.
- Valid chunks are shown with a blue outline.
- Invalid chunks are shown with a red outline.
- Press Ctrl + Enter to claim all selected chunks at once.
- Press Esc to clear the selection.
The server validates the claim request before applying it.
Validation includes:
- Only multiple chunks connected to already existing claim can be made.
- The chunks must be connected.
- The chunks must be unclaimed.
- The chunks must be valid for the claim owner.
- The player must have permission to edit the claim.
- The player must be close enough.
- The claim must not exceed the max claim size.
- The player must have enough currency.
Disconnected Claim Cleanup
- If a claim is split by removing a chunk from the middle, disconnected claim pieces are automatically removed (to prevent data corruption).
- The connected part containing the claim center is kept. Detached extensions are deleted so claims cannot remain split into separate islands.
Low Passage Sneaking
- Recruits can automatically crouch when they are blocked by a low passage and there is a possible path through by sneaking.
- This helps recruits move through spaces like slab-topped tunnels.
Configuration
The config is server-side.
Training
Controls how many experience bottles are required to give one recruit level.
Default: 32
Range: 1 to 1024
Lost Recruits
distanceBlocks
How far a recruit must be from its owner before it can be considered lost.
Default: 100
unseenSeconds
How long the recruit must be unseen before it appears on the owner's Recruits map.
Default: 60
syncSeconds
How often the server rebuilds and sends lost recruit markers.
Default: 5
Mass Recruit
Controls the search radius for /recruitsqol massrecruit.
Default: 32
You can support me through- https://ko-fi.com/knightmare61825
