A beginner-friendly, modular, free and open-source FPS (first-person shooter) template built by bukkbeek for the Godot community.
Includes player movement, aim-down-sights (ADS), a complete hitscan weapon system, ammo, health, a test level, vehicles, and common FPS utilities you can strip or extend.
Work in progress: This project is still under development. You may encounter bugs, incomplete code.
The README currently includes a brief tutorial for understanding the project structure. A more comprehensive tutorial is planned for a future update.
Feature video:
This feature list is not completed but I will update and migrate all descriptions into following table as the project ongoing.
ID
Category
Description
Status
Version
1.1
Gameplay: player
Player movement and control systems at res://player/player.tscn
complete
0.1
1.2
Gameplay: input
Input handled at res://common/managers/input_manager.gd
complete
0.1
1.3
Gamplay: global autoload
res://common/autoloads/global.gdComplete
0.1
2.0
Weapons: base
weapons inherited from res://common/weapon/weapon_base.tscn managed using res://common/managers/weapons_manager.gd
complete
0.1
2.0.1
Weapons: ammo refill
tracked using autoload: res://common/autoloads/bullets.gd, ammo loot can use: res://common/utils/ammo_refil.gd
Complete
0.1
2.1
Weapons: knife
res://weapons/knife.tscn (using hitscan)complete
0.1
2.2
Weapons: Pistol
res://weapons/pistol.tscncomplete
0.1
2.3
Weapons: Assault rifle
res://weapons/assualt_rifle.tscncomplete
0.1
2.4
Weapons: Assault burst rifle
res://weapons/assualt_burst.tscncomplete
0.1
2.5
Weapons: LMG
res://weapons/lmg.tscncomplete
0.1
2.6
Weapons: SMG
FPS arms animations done/ needs implementation
in progress
-
2.7
Weapons: Shotgun
FPS arms animations done/ needs implementation
in progress
-
2.8
Weapons: Sniper
FPS arms animations done/ needs implementation
in progress
-
2.9
Weapons: Rifle
FPS arms animations done/ needs implementation
in progress
-
2.10
Weapons: Railgun
FPS arms animations done/ needs implementation
in progress
-
2.11
Weapons: Flamethrower
FPS arms animations done/ needs implementation
-
2.12
Weapons: Grenade launcher
FPS arms animations done/ needs implementation
in progress
-
2.13
Weapons: Hand grenade
FPS arms animations done/ needs implementation
in progress
-
2.14
Weapons: Smoke grenade
FPS arms animations done/ needs implementation
in progress
-
2.15
Weapons: Medi kit
FPS arms animations done/ needs implementation
in progress
-
3.0
Enemy: base
Enemies inherit res://common/enemy/enemy_base.tscn - these are patrol-see-chase-attack type zombie enemies
Complete
0.1
3.1
Enemy: undead
res://enemies/undead.tscnComplete
0.1
4
Interactives
World interactable gameplay items path: res://world/interactive_items/
Complete
0.1
4.1
Interactives: Ammo refill pickup
res://common/utils/ammo_refil.tscnComplete
0.1
4.2
Interactives: auto door
res://world/auto_door/door.tscnComplete
0.1
4.3
Interactives: Exploding barrel
res://world/interactive_items/exploding_barrel.tscnComplete
0.1
4.4
Interactives: Vehicle
Drivable vehicle system (drive, steering, brake, enter/exit)
res://resources/vehicle/vehicle.gdComplete
4.4.1
Interactives: Vehicle: jeep
Vehicle camera + engine audio tuning
res://resources/vehicle/jeep.tscn note: needs tuningcomplete
5
UI: HUD and feedback systems
res://common/hud/Basic
0.1
5.1
UI: Gameplay HUD (health/weapon/ammo)
res://common/hud/gameplay_hud.tscn, res://common/hud/hud.gdBasic
0.1
5.2
UI: Crosshair behaviors
res://common/hud/crosshair.gdBasic
0.1
5.3
UI: Damage display feedback
res://common/hud/damage_display.gdBasic
0.1
6
SFX
res://resources/sfx/, res://player/sfx/Basic
0.1
6.1
SFX: Weapon sounds (fire/reload/switch/empty)
res://resources/sfx/weapons/Basic
0.1
6.2
SFX: Movement and interaction sounds
res://player/sfx/, res://resources/sfx/door_open.wav.importBasic
0.1
6.3
SFX: Enemy and other
res://resources/undead/sfx/Basic
0.1
7
VFX
Visual effects systems and assets res://resources/vfx/, res://resources/undead/vfx/
Complete
0.1
7.1
VFX Muzzle flashes
res://resources/vfx/muzzle_flash/vfx_muzzle_1.tscnComplete
0.1
7.2
VFX Bullet decals / bullet holes
res://resources/vfx/bullet_decal.tscnComplete
0.1
7.3
VFX Explosion effects
res://resources/vfx/explosions/vfx_standard_explosion.tscnComplete
0.1
7.4
VFX Enemy death VFX
res://resources/undead/vfx/undead_death_vfx.tscnComplete
0.1
8
Utils: spawner
res://common/spawner/spawner.tscnComplete
0.1
Action
Default Binding
Move
W A S D
Look
Mouse
Fire
Left Mouse
Aim (ADS)
Right Mouse
Jump
Space
Sprint
Shift
Crouch
Ctrl
Reload
R
Previous / Next Weapon
Mouse Wheel Up / Down
Interact / Use
F
Exit / Menu
Esc
Vehicle Brake
Space (when driving)
Remap everything under Project → Project Settings → Input Map .
Path
Role
main.tscnEntry scene
common/Shared scripts: autoloads, weapons base, managers, utilities
player/Player scene + movement, health, camera
weapons/Individual weapon scenes (pistol, rifles, knife, etc.)
world/Levels and interactive props
resources/Meshes, materials, vehicles, VFX, audio
Autoloads (see Project -> Project Settings -> Autoload ):
Global — common/autoloads/global.gd: player reference, game state, UI signals (health, weapons, aim, etc.).Bullets — ammo pools / types used by weapons and refill stations.
Player (player/player.gd)
Variable
Purpose
walk_speedBase move speed
sprint_speedSprint multiplier speed
jump_velocityJump strength
sensitivityMouse look sensitivity
Health is defined in script (MAX_HEALTH, current_health); adjust there for different max HP or regen behavior.
Weapons Manager (WeaponsManager on Player)
Variable
Purpose
follow_speedHow fast the weapon rig follows the camera
weapons_arrayOrder and list of equipped weapon node paths
Per-Weapon (common/weapon/weapon.gd)
Group / Variable
Purpose
Weapon settings is_melee_weapon, is_projectile, firing_distance
Bullets bullet_type, damage, cooldown, burst_mode, consume, reload_required, mag_capacity, reload_time
Gameplay connections focused_aim_fov, focused_aim_angle, standard_aim_angle
SFX / VFX Audio nodes, firing_vfx, bullet_decal, muzzle marker
Ammo Refill Pickup (common/utils/ammo_refil.gd)
Variable
Purpose
pistol_ammo, assault_ammo, lmg_ammo, …Reserve ammo granted per type when the player presses Interact
outline_meshOptional highlight mesh while designing
Vehicle (resources/vehicle/vehicle.gd)
Group
Variables
Engine engine_force_value, max_rpm, brake_strength
Steering steering_limit, steering_speed
Camera camera_sensitivity, camera_pitch_min, camera_pitch_max
Audio engine_audio, engine_min_pitch, engine_max_pitch, engine_max_speed
Visuals Door / outline meshes, animation_player, get_in_animation
Global Flags (common/autoloads/global.gd)
Variable
Purpose
debug_modeToggle for debug behavior if you extend the autoload
in_vehicleDriving state (used to block some interactions)
New weapon: Inherit from the base weapon in weapons/, configure Weapon script exports, add the instance under WeaponsManager, and append its NodePath to weapons_array.New level: Duplicate world/test_level.tscn or set Main Scene to your level; ensure the player and UI are spawned as in main.tscn if you rely on that flow.Render layers: Check Project → Project Settings → Layer Names → 3D Render (e.g. weapon layer vs world) when adding cameras or culling masks.
Version
Notes
v0.1Initial release.
This project is under MIT license. You can fork, edit, use the repo as you want.
But you are prohibited to resell any asset originating from this project including 3D assets, VFX, SFX (credits: Pixabay ) and animations (Credits: Mesh2Motion )
Godot FPS Template by bukkbeek
