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

NOTE:

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

The projectile trajectory of heavy weapons is set to the same height as other firearms (higher than the barrel of heavy-weapons) so that obstacles with height of one block 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 your feedback this might be changed. The only exception from this rule so far are heavy-laser weapons since their trajectory is quite obvious due to continous beam. Therefore the trajectory of heavy-laser firearms is set to center of the muzzle flash. 

Next release will focus on porting Scorched Guns 2 poses to other firearms (currently, crossbowmen use the standard crossbow pose for most weapons, and only heavy weapons have the new poses applied). I'll also fix grenade launcher projectiles, tweak the muzzle flash for some firearms, and polish the targeting AI.

Also, since the accuracy and range config values were pretty rushed (pulled them straight out of my ass) just to get the first release out, I highly encourage you to play around with them and share your profiles in the comments.

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.

Disclaimer

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