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

Optional

Epic Knights: Artilleries and Firearms — 1.11–1.13.4
BetterRecruitFormations
Epic Knights: Addon

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:

GitHub Issues

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.

Recruits Use Boomsticks

介绍