Recruits Use Boomsticks

Recruits Use Boomsticks

A compatibility mod that lets Villager Recruits crossbowmen use, reload, and fire Medieval Boomsticks weapons with dedicated combat AI.

620 downloads 0 followers

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:

  1. Pour powder
  2. Insert physical ammunition
  3. Ram the shot
  4. Use a Ramrod or Iron Ramrod
  5. Perform weapon-specific bare-hand loading
  6. Cock the weapon
  7. Finish its native loaded state
  8. 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

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.


Form ranks. Load. Aim. Fire.

No gallery available for this project.

Version Minecraft Loader Download

Recruits Use Boomsticks 2.1.0

2.1.0

1.20.1
forge
Download

Recruits Use Boomsticks 2.0.0

2.0.0

1.20.1
forge
Download

Recruits Use Boomsticks 1.0.1

1.0.1

1.20.1
forge
Download