New Gun Loader (super beta)

• []

  ve

  r

  s

  i

  o

  n

  2. 0. 0

  [/]

Major update: the mod has been rewritten for the current game version (7. 0. 1) and the new RshLib 3. 0. 0.

Compatibility

• []Full rewrite for the new RshLib 3. 0. 0 API. Previous builds no longer loaded due to changes in how items are registered — this is now fixed.[/]

  []Verified against all current in-game weapon parameters.[/]

Multiplayer (KrokMP)

• []Custom guns now sync correctly in multiplayer — weapons are visible and functional for all players.[/]

  []Note: every player in the session must have the mod and identical gun configs installed.[/]

Fire sound

• []Fixed the long-standing issue — custom fire sounds now fully work. The sound plays natively on every shot (correct volume, positioning and fire rate).[/]

  []Added optional rack/unrack sounds:

  rackSound and

  unrackSound.[/]

  []Reworked WAV loader — files with non-standard headers are now supported.[/]

New config options (all optional)

• []baseItem — base prefab the item is built from.[/]

  []tags — item tags.[/]

  []slotRotation — sprite rotation in the inventory slot.[/]

  []muzzle — muzzle flash:

  none.[/]

  []rackSound /

  unrackSound — custom bolt sounds.[/]

  []startChambered — round in the chamber on spawn.[/]

  []startWithMag — spawn with a magazine.[/]

  []startRounds — rounds in the magazine on spawn.[/]

  []startSafe — spawn with the safety on.[/]

Backwards compatibility

• []Existing configs work unchanged — all new fields are optional.[/]

  Description

  New Gun Loader (Beta). Adds custom guns via subfolders and JSON config files. No coding required. Already includes the FN SCAR assault rifle. Custom fire sounds are currently not supported and will be fixed in a future update.

  Installation instructions

  • []Install BepInEx 5 and RshLib.[/]

    []Extract the mod into BepInEx/plugins.[/]

  Adding a new gun:

  • []Go to BepInEx/plugins/NewGun/ and create a new folder (e.g., MyPistol).[/]

    []Place four PNG sprites inside (weapon must face RIGHT):

    []normal.png (default view, magazine in, bolt closed)[/]

    []racked.png (bolt open after firing)[/]

    []normal_nomag.png (magazine removed, bolt closed)[/]

    []racked_nomag.png (magazine removed, bolt open)[/]

  [/]

  []Create config.json in the same folder. Copy the example from the FN_SCAR folder and edit values.[/]

  []Launch the game, open console, type: spawn my_weapon cursor[/]

  How to use config.json

  "itemId": "unique item ID (e.g., myscar.scar)",

  "fullName": "displayed weapon name in-game",

  "description": "in-game description text",

  "category": "inventory category (usually 'utility')",

  "weight": "item weight",

  "value": "trader value (integer)",

  "recognition": "stealth rating (higher = less visible)",

  "ammoType": "ammo type: Pistol, Rifle, Shotgun",

  "firingMode": "fire mode: Auto, SemiAuto, Pump",

  "feedType": "feed type: Mag, Direct, revolver",

  "magCapacity": "magazine capacity (rounds)",

  "knockBack": "recoil strength",

  "structureDamage": "damage to structures",

  "animalDamage": "damage to creatures",

  "loudness": "gunshot loudness",

  "desiredGasTime": "time between shots in seconds",

  "shotsPerFire": "projectiles per shot (e.g., 8 for shotgun)",

  "verticalSpread": "bullet spread",

  "conditionLossPerShot": "condition loss per shot (0 to 1)",

  "pixelsPerUnit": "sprite scale (higher = smaller in hand)",

  "fireSound": "custom fire sound file name without extension (currently unsupported)"

  Main features

  [*]Add custom guns without programming.