Godot FPS Template

A clean and modular First Person Shooter (FPS) template built with Godot 4.4.1, featuring a state-driven player system, modular weapons, and a debug interface — designed for rapid prototyping or as a base for FPS games.

Currently, only the player's movement system is fully implemented using a state machine.

✨ Features

• State Machine Architecture
  Each player behavior (idle, walking, sprinting, jumping, falling, crouching, sliding) is handled by its own state class. Transitions are cleanly managed via signals and encapsulated logic.

• Modular Weapon System
  Weapons are defined as custom resources and instantiated dynamically. You can easily add new weapons with their own models, animations, and properties without modifying core logic.

• Unified Input System
  All game inputs are centralized in a shared singleton (shared/input.gd). This simplifies management and allows easy key remapping.

• Debug Panel
  A customizable debug UI displays the current player state and runtime stats for easier testing and iteration.

🧠 Gameplay States

The player uses a finite state machine (core/state.gd) to handle core actions. Each state is implemented in its own script:

• Idle – Waiting state when no input is detected.
• Walking – Triggered when movement input is detected.
• Sprinting – Activated when movement + sprint input is held.
• Jumping – Triggered via jump input (supports jump delay and optional double jump).
• Falling – Active while in the air and not jumping.
• Crouching – Toggles via crouch input (need to maintain the key pressed for now).
• Sliding – Triggered when sprinting + crouch input is pressed.

States emit a transition signal to request moving from one state to another. Logic is modular and isolated, making behaviors easy to extend or override.

📁 Architecture

addons/ # Addons or external plugins
core/ # 
└─ state.gd # Base class for the state machine system
entities/
├─ ennemies/ # Placeholder for enemies
├─ npc/ # Placeholder for NPCs
├─ player/
│  ├─ assets/ # Player meshes, animations, sounds
│  ├─ states/ # All individual player states (idle, sprinting...)
│  ├─ player.gd # Main player controller
│  └─ player.tscn # Player scene
levels/
└─ main/ # Sample level and main scene
objects/
│  ├─ weapons/ # Weapons dir
│  │   ├─ ak47/
│  │   │   ├─ assets/ # Assets imported
│  │   │   ├─ ak47_resource.tres # Resource file
│  │   │   └─ ak_47.tscn # Scene file
shared/ # Autoloaded scripts (available from any nodes)
├── constants.gd # Constant values (player speed, jump velocity, etc.)
├── settings.gd # Placeholder for player settings (will change with save system)
├── global.gd # Player and DebugPanel Nodes references
└── input.gd # Centralized inputs
ui/

All scripts under shared/ are automatically loaded via Autoload (see Project Settings → Autoload).

🔫 Weapon System

Weapons are handled via a modular system. Each weapon should have a .tres resource that defines:

• Mesh or Scene
• Position, Rotation, Scale
• Sway properties
• And more to come like damage, recoil...

They are loaded dynamically using weapon_controller.gd script.

Add a new weapon:

1. Import your weapon scene/assets into the FileSystem.
2. Create a new scene for your weapon (with hierarchy, animations, sounds, etc.).
3. Create a new resource file (.tres) that extends the Weapon class.
4. In the resource assign the scene you created
5. In the Weapon Scene, assign your resource file to the Weapon Type field.

Adjust position, rotation, scale :

Once you have selected the resource in the Weapon Scene, you can open the Player scene and adjust the properties of the resource according to the transform properties

Presentation Video

TODO

🗒️ TODO

• Make sliding mechanic optional

• Finish weapon system

  • Implement reload mechanic
  • Add weapon switching
  • Add aiming and shooting logic
  • Add recoil system
  • Visual and sound FX

• Save user settings and progression system

• Game menus and user settings

• Interactable objects (like door or stuff)

• Add optional wall sliding mechanic

• Add own 3D Model

Credits

Assets

• Styloo - Guns Asset Pack
• Kenney - Input Prompts
• Doctortex - Soldier