Godot 3D Multiplayer Template

Godot 4.7 starter project for building a 3D multiplayer game with player movement, sessions, inventory, equipment, chat, and dedicated-server support.

This template is also available on the Godot Asset Library and Godot Asset Store.

Key Features

• Multiplayer Sessions: Host, join, test multiple local instances, or run a headless dedicated server with support for up to 10 players.
• Character Controller: Camera-relative movement, sprinting, double jumping, synchronized animations, and switchable first- and third-person views.
• Player Profiles: Four selectable character skins and in-world name tags for every player.
• Chat and Player List: Communicate with connected players and view the current session members.
• Server-Authoritative Inventory: 16 base slots, 4 backpack slots, stacking, drag and drop, context actions, and server-validated changes.
• Synchronized Equipment: Hats, weapons, and backpacks are visible on every player's character.
• World Items: Drop, push, and collect physics-based items.
• Integrated Interfaces: Inventory, chat, player list, and pause menu coordinate gameplay input and mouse capture.

Project Structure

• assets/: Imported models, textures, icons, fonts, and third-party asset attribution files.
• scenes/items/: World-drop scenes organized into backpacks, hats, miscellaneous items, and weapons.
• scenes/level/: Main level, arena, and multiplayer player scenes.
• scenes/ui/: Inventory, menus, chat, and online-player-list scenes.
• scripts/autoload/: Global Network and ItemDatabase singletons.
• scripts/inventory/: Item data, inventory slots, and player inventory state.
• scripts/items/: World-item behavior.
• scripts/level/: Level and multiplayer session coordination.
• scripts/player/: Player controller, character model, and camera support.
• scripts/ui/: User-interface behavior.

How to Run the Project

Follow these simple steps to get the template up and running:

1. Clone or Download: Obtain the repository by cloning it via Git or downloading the ZIP file.
2. Open in Godot Engine: Load the project in Godot Engine 4.7.
3. Execute: Press F5 or click Run Project in the Godot editor.

For local multiplayer testing, open Debug > Customize Run Instances, enable Enable Multiple Instances, choose the desired number of instances, and run the project.

Dedicated Server

From the project directory, start a headless server with:

godot --headless --path .

Then start another project instance, choose Join, and connect to 127.0.0.1. The server listens on UDP port 8080. Press Ctrl+C in the server terminal to stop it.

On Linux or macOS, the provided wrapper can also locate the Godot executable and handle shutdown:

./run_headless_server.sh

Ensure the script has execution permissions (chmod +x run_headless_server.sh) and that the godot binary is in your system PATH. If Godot is installed under another command or path, set GODOT_BIN when starting the server:

GODOT_BIN=/path/to/godot ./run_headless_server.sh

Controls

• W A S D to move.
• Shift to run.
• Space to jump or double jump.
• Left mouse button to play the attack animation (visual only, without damage).
• E to collect a nearby item.
• Esc to open or close the pause menu.
• T to hide/show chat.
• I to toggle inventory.
• Hold Tab to show the online player list.
• V to switch between first-person and third-person views.
• F1 to add a random test item (debug builds, host only).
• F2 to print the local inventory (debug).

Contributing

If you want to contribute to this project, please refer to our Contributing Guidelines.

Credits

• 3D Godot Robot Platformer Character, by AGChow, licensed under CC0. See assets/characters/player/ATTRIBUTIONS.md.
• Item models and icons by Poly by Google and Quaternius. See assets/items/ATTRIBUTIONS.md.
• Prototype environment textures by Kenney, licensed under CC0. See assets/environment/ATTRIBUTIONS.md.

License

The project source code is available under the MIT License. Third-party assets are excluded from that license and remain available under the terms documented in their respective attribution files.