Simple FPS Weapon System 1.8 3D Tools 4.4 Community

Submitted by user Jeheno; MIT; 2026-05-27

! All informations are on the readme of the Github repository : https://github.com/Jeh3no/Godot-Simple-FPS-Weapon-System-Asset


A simple yet complete FPS weapon system asset for Godot 4

-------------------------------------------------------------------------------------------

This asset provides a simple, fully commented, weapon system for FPS games.

A test map with a shooting range, as well as a character controller are provided (the character controller is another asset i made some mounths ago : https://github.com/Jeh3no/Godot-Simple-State-Machine-First-Person-Controller).

The weapon system is resource based, designed to easely customize weapons.

The weapons are monitored by a weapon manager, designed to easely add/remove weapons to the game.

Each component of the weapon (shoot, reload, animation, ammunition) has his own script, neatly arranged in separate compartments.

The asset is 100% written in GDScript.

The code has been written in a way to be easely understandable and modifiable/editable, and he's as well fully commented.

You can see this asset as some sort of demo, for a possible, much bigger (and better) asset, which will be may more advanced, and will have a ton of new features.

-------------------------------------------------------------------------------------------

Compatibility :

- Godot 4.4, 4.5 and 4.6: Fully supported.
- Godot 4.0 - 4.3: Should work, but you will need to delete the .uid files.

-------------------------------------------------------------------------------------------

Features :

Weapon system:

- Resource based weapons
- Weapon switching
- Weapon shooting
- Weapon reloading
- Weapon bobbing
- Weapon tilting
Weapon swaying
- Hitscan and projectile types
- Physics behavior for both hitscan and projectile
- Shared ammo between weapons
- Ammo refilling

World:

- Test map, with shooting range, and hitable boxes (physics behavior)
- Shooting range with immobile and moving targets

Player character:

- State machine based character controller (https://github.com/Jeh3no/Godot-Simple-State-Machine-First-Person-Controller)
- Input action checker

Camera:

- Viewport camera to render weapons
- Camera procedural recoil
- Camera bobbing
- Camera tilting

Visual effects:

- Muzzle flash
- Bullet hole/decal
- Explosion effect

UI:

- Properties HUD for both player character and weapon system