The U.R.S.T weapon system is designed to be as flexible as possible. Instead of duplicating complex code for every gun, weapons are created using Custom Resources. This means you can create a brand new shotgun, rocket launcher, or melee weapon just by export settings available in the inspector.

The system is split into two parts: the Weapon Resource (which holds the gun's stats and visuals) and the Weapon Manager (the gun logic).

Brief Video Guide: https://youtu.be/NXXjCRtxo6U

⚒ Creating a New Weapon

To make a new gun, you don't need to create a new scene. You just create a new resource file:

1. In your FileSystem dock, right-click inside your Your_Assets folder (or wherever you want to save your weapon).
2. Select Create New > Resource.
3. In the search bar, type RetroWeapon and select it.
4. Name your file (for example, Shotgun.tres) and click Save.
5. Double-click your new .tres file to open its settings in the Inspector.

<aside>

Weapon Resource (Inspector)

</aside>

📊 Configuring The Weapon

With your new RetroWeapon resource selected, you will see several categories in the Inspector. Here is how you can utilize them for your weapon:

🔫Weapon Settings & Stats:

These settings are all about the weapon stats, name, and keybind:

• Weapon Name & Bind Key: Give your gun a name and bind it to a number key (1-9) for quick switching.

  💡 Note: In case two weapons shares the same key, it will act similar to Half-Life weapon system (aka, press the number button again to switch to other weapons).

• Ammo Type: Choose which ammo pool this weapon draws from (Pistol, Shells, Rockets, etc.).

• Magazine & Reloading: Check Requires Reloading for modern shooters, or uncheck it for classic DOOM style bottomless magazines. Set your Mag Ammo and Max Ammo.