Godot Setup

Stap-voor-stap handleiding om de ontwikkelomgeving op te zetten.

Vereisten

Godot Engine

Download en installeer Godot 4.5 of hoger:

• macOS: Download van godotengine.org
• Windows: Download .exe of gebruik Steam
• Linux: Download AppImage of via package manager

SpacetimeDB (voor multiplayer)

# SpacetimeDB CLI installeren
curl -fsSL https://install.spacetimedb.com | bash

# Verifieer installatie
spacetime --version

Project Openen

1. Start Godot
2. Klik "Import"
3. Navigeer naar milenas-cozy-treehouse-club/
4. Selecteer project.godot
5. Klik "Import & Edit"

Eerste Keer Setup

Addons Activeren

Na het openen, activeer de addons:

1. Ga naar Project → Project Settings → Plugins
2. Zet deze plugins aan:
   • SpacetimeDB
   • TileMapDual
   • TileCropper

Editor Settings

Aanbevolen instellingen:

Editor → Editor Settings:
  - Text Editor → Indent → Type: Tabs
  - Text Editor → Indent → Size: 4
  - Interface → Theme → Preset: Light (optioneel)

Zonder SpacetimeDB

De game kan ook standalone draaien:

1. Open scripts/game_state.gd
2. De offline_mode is automatisch actief als er geen verbinding is
3. Alle data wordt lokaal opgeslagen

Met SpacetimeDB (Multiplayer)

Lokale Server Starten

# Terminal 1: Start SpacetimeDB
cd server
spacetime start

# Terminal 2: Build en publish module
spacetime build
spacetime publish milenas-treehouse --clear-database

Verbinding Configureren

In addons/SpacetimeDB/config.gd:

const SERVER_URL = "ws://localhost:3000"
const MODULE_NAME = "milenas-treehouse"

Project Runnen

In Editor

• F5 - Run main scene (main_menu.tscn)
• F6 - Run current scene
• F7 - Pause
• F8 - Stop

Specifieke Scene Testen

1. Open de scene in de editor
2. Druk F6 om alleen die scene te runnen

Veelvoorkomende Problemen

"Addon not found" errors

Oplossing: Ga naar Project Settings → Plugins en activeer de plugins.

SpacetimeDB verbinding mislukt

Check:

1. Is spacetime start actief?
2. Is de module gepublished?
3. Klopt de SERVER_URL in de config?

Assets laden niet

Controleer of alle .import bestanden bestaan. Zo niet:

1. Sluit Godot
2. Open opnieuw (triggert reimport)

GDScript errors bij opstarten

Dit kan komen door missende autoloads:

1. Ga naar Project Settings → Autoload
2. Zorg dat GameState is toegevoegd

Editor Shortcuts

Shortcut	Actie
Ctrl+S	Save scene
Ctrl+Shift+S	Save all
F5	Run project
F6	Run current scene
Ctrl+F	Zoeken in script
Ctrl+Shift+F	Zoeken in alle bestanden
Ctrl+.	Go to definition
Ctrl+Click	Go to definition

Volgende Stappen

• Project Structuur - Begrijp de codebase
• SpacetimeDB SDK - Multiplayer setup