Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Links
Creators
Details
Recruits Use Boomsticks
Turn your Recruits into an organized gunpowder formation.
Recruits Use Boomsticks is a Minecraft 1.20.1 Forge compatibility mod that allows Villager Recruits crossbowmen to properly fight with firearms and throwing weapons from Ranged Knights: Medieval Boomsticks and Sharpsticks and selected weapons from Epic Knights: Artilleries and Firearms.
This is not just an item whitelist.
Recruits find weapons and physical ammunition in their inventories, perform real loading sequences, aim, compensate for projectile drop, fire native projectiles, coordinate volleys, protect allies from friendly fire, and follow company-wide weapon orders.
Version 2.0
2.0 is the biggest update the mod has received so far.
It adds:
- 18 supported Artillery firearm profiles
- 5 Artillery throwing weapons
- All 6 Medieval Boomsticks throwing weapons
- Real multi-step Artillery loading
- Physical powder and ammunition
- Ramrod and Iron Ramrod handling
- Native loading sounds and visible tools
- Tool durability
- Windlass Crossbow cocking
- Full 8-round Chu Ko Nu magazine loading
- Coordinated formation fire
- Ballistic compensation
- Mounted firing and reloading
- Improved aiming, recoil and reload presentation
- Weapons out! / Weapons away! company orders
- BetterRecruitFormations compatibility
- Dedicated-server support
Formation fire
Recruits do not blindly dump an entire firing line into the same half-dead enemy.
Shots are coordinated per target. Recruits reserve expected incoming volley damage while projectiles are still flying and can look for enemies that are not already covered by another shooter.
No more thirty muskets wasting ammunition on the same unlucky zombie.
Real loading
Supported Artillery weapons use their actual loading logic.
Depending on the weapon, a recruit may:
- Pour powder
- Insert physical ammunition
- Ram the shot
- Use a Ramrod or Iron Ramrod
- Perform weapon-specific bare-hand loading
- Cock the weapon
- Finish its native loaded state
- Aim and fire
A recruit will not begin a reload it cannot finish.
Reusable loading tools take durability damage normally, and ammunition is physically consumed from the recruit's inventory.
Weapons out! Weapons away!
Version 2.0 adds two commands to the Villager Recruits combat screen.
Weapons out!
Orders crossbowmen to draw a supported ranged weapon.
Weapons away!
Orders them to stow it and restore a Sword, Axe or Crossbow when available.
Commands work with selected groups. With no groups selected, they apply to all nearby recruits owned by the player.
Supported weapons
Medieval Boomsticks
Firearms
- Handgonne
- Arquebus
- Spiked Handgonne
- Arbalest
Throwing weapons
- Iron Throwing Knife
- Iron Throwing Axe
- Small Throwing Rock
- Large Throwing Rock
- War Dart
- Javelin
Throwing weapons use their native projectiles, speed, damage and sounds. Recoverable weapons remain collectible, and durable throwing weapons preserve their normal durability behavior.
Epic Knights: Artilleries and Firearms
Supported firearm profiles:
- Arquebus
- Matchlock Musket
- Matchlock Carbine
- Matchlock Pistol
- Toradar Rifle
- Mini Pistola
- Tiller Gun
- Handgonne
- Taccola Handgonne
- Noble Handgonne
- Markmengonne
- Bronze Handgonne
- Harquebus
- Hackbut
- Windlass Crossbow
- Hand Cannon
- Chu Ko Nu
- Double Barrel Gonne
Throwing weapons
- Francisca
- Hurlbat
- Throwing Cross
- Javelin
- Throwable Cobblestone
Slow throwing weapons move into effective range before attacking instead of repeatedly throwing into the ground.
Only tested weapon and ammunition branches are enabled.
Grenades are intentionally unsupported.
Combat features
- Dedicated firearm combat AI
- Real physical ammunition
- Native projectiles
- Coordinated volley fire
- Projectile ownership
- Owner and allied-recruit friendly-fire protection
- Mounted shooting
- Mounted reloading
- Projectile-drop compensation
- Strategic-fire positions
- Proper aiming direction
- Recoil direction preservation
- Reload animations
- Lowered empty/reloading weapon poses
- Configurable projectile damage
- Per-integration damage multipliers
- Configurable minimum projectile damage
- Optional volley hurt-cooldown bypass
- Smoke effects
- Debug logging
Requirements
Minecraft: 1.20.1 Loader: Forge Java: 17
Install Recruits Use Boomsticks on the client and server.
Required
- Villager Recruits
- Ranged Knights: Medieval Boomsticks and Sharpsticks
- GeckoLib
- Epic Knights: Shields Armor and Weapons
- Architectury API
- Cloth Config API
Optional
Artillery 1.14 is not supported on dedicated servers.
Use Artillery 1.11 through 1.13.4 for the supported dedicated-server setup.
Configuration
The mod creates:
config/recruits_use_boomsticks-common.toml
You can configure:
- Medieval Boomsticks integration
- Artillery integration
- Strategic fire
- Smoke particles
- Global projectile damage
- Per-mod damage multipliers
- Minimum projectile damage
- Volley hurt-cooldown behavior
- Debug logging
Compatibility
Version 2.0 includes compatibility with:
- BetterRecruitFormations
- Recruits Musket Mod combat goals
- Forge dedicated servers
Only Villager Recruits crossbowmen use supported ranged weapons.
Bugs & feedback
Found a compatibility problem?
Watched a recruit do something spectacularly stupid?
Report it here:
For useful bug reports, please include your exact mod versions, latest.log, whether the problem occurs on a dedicated server, and steps to reproduce it.
Source code
GitHub: https://github.com/iwosw/recruits-use-boomsticks
Recruits Use Boomsticks is free and open source under the MIT License.
Villager Recruits, Medieval Boomsticks, Epic Knights, Epic Knights: Artilleries and Firearms, BetterRecruitFormations and their assets belong to their respective authors.
This project does not redistribute their assets or source code.