Recruits - Scorched Guns Compatibility

Ever wanted your Recruits Crossbowmen to use Scorched Guns 2 firearms without randomly running around, ignoring orders, or firing in completely wrong direction? Well, now they can!

This compatibility addon connects the two mods into a more complete combat system. Crossbowmen can use Scorched Guns 2 firearms while continuing to obey their normal Recruits commands and navigation behavior.

What does it do?

It fixes the behavior/goal conflict between the two mods + other minor fixes here and there.

Recruits remains responsible for commands such as Wander, Follow, Hold, Hold Fire, Fire At Will, Strategic Fire, Hold Strategic Fire, and other group commands while Scorched Guns 2 keeps control of its normal firing, projectile, magazine, and reload behavior.

The addon also includes:

Finite ammunition taken from the recruit’s own inventory (to enable set "RangedRecruitsNeedArrowsToShoot = true" in official Villager Recruits server-config file)
Support for each gun’s correct ammunition type and alternate ammo modes
Partial magazines when the recruit does not have enough ammunition for a full reload
Persistent reload progress during brief target loss or target switching
Ammunition restocking through the Recruits upkeep inventory
Fourteen configurable weapon profiles with separate engagement ranges and accuracy values
Small, configurable range and precision improvements as recruits level up
Nearest-visible-target prioritization and reduced target-switching flicker
Aim-before-fire synchronization so recruits do not shoot before their body and weapon face the target
Native colored Scorched Guns 2 laser beams instead of generic white projectile trails
Configurable heavy-laser beam width
Heavy laser beams anchored directly to the exact muzzle-flash center
Custom two-handed poses for heavy-weapons
Corrected heavy-weapon barrel and muzzle-flash placement

The mod does not replace Scorched Guns 2 projectile damage or collision handling. Its normal projectiles remain responsible for actual hits and damage.

NOTE: The projectile trajectory of heavy weapons is set to the same height as other firearms (higher than the barrel of heavy-weapons) so that single block barricade wont get in a way (or at least do so less frequently). Since projectiles generally move fast I figured that its trajectory wont feel too odd, however, depending on player feedback this might be changed. The only exception from this rule so far are heavy-laser weapons since their trajectory is quite obvious. Therefore the trajectory of heavy-laser firearms is set to center of the muzzle flash.

Server configuration

A synchronized config is created for each world:

<world>/serverconfig/recruitsscgunscompat-server.toml

Server owners can configure:

Heavy lasers beam width
Weapon acquisition range
Preferred firing range
Minimum accuracy
Maximum recruit-level range multiplier
Maximum recruit-level precision multiplier

The default maximum-level bonuses are:

Range: 1.25x
Precision: 1.10x

Either type of level growth can be disabled by setting its multiplier to 1.00.

Required versions

This release is designed specifically for:

Minecraft: 1.20.1
Forge: 47.4.0
Villager Recruits: 1.15.2
Scorched Guns 2: 0.5.5

The supported version ranges are intentionally narrow because the addon integrates directly with specific AI, weapon, and rendering systems from these releases.

Installation

Install the compatibility JAR together with the supported versions of Villager Recruits and Scorched Guns 2.

The same compatibility JAR should be installed on both the client and server.

Remove any older versions of this compatibility addon before installing the current release.

Beta status

Beta1.0 has completed its main gameplay, configuration, visual-alignment, and performance testing. The final test sessions showed no compatibility-related crashes, repeated logging spam, or sustained server lag.

The project remains marked as beta while it receives broader public testing with larger recruit battles, dedicated servers, additional weapons, and unusual model or resource-pack combinations.

Disclaimer

This is an unofficial compatibility addon and is not affiliated with or endorsed by the developers of Villager Recruits or Scorched Guns 2.

Scorched Recruits