Contribuer au projet

Outils nécessaires

Godot Engine 4.6.2 : téléchargez depuis https://godotengine.org/download
Git : version 2.x ou supérieure
Accès au dépôt Gitea de DauphinCraft

Cloner le dépôt

git clone http://<gitea-host>/dauphincraft/dauphincraft.git
cd dauphincraft

Note

Remplacez <gitea-host> par l’adresse du serveur Gitea communautaire.

Ouvrir le projet dans Godot

Lancez Godot Engine 4.6.2.
Dans le gestionnaire de projets, cliquez sur Import.
Naviguez jusqu’au dossier cloné et sélectionnez project.godot.
Cliquez sur Import & Edit.

Le projet s’ouvre directement dans l’éditeur. Appuyez sur F5 pour lancer le jeu en mode éditeur.

Build et export

Les présets d’export sont configurés dans export_presets.cfg.

Exporter pour Windows :

Menu Projet → Exporter.
Sélectionnez le préset Windows Desktop.
Cliquez sur Exporter le projet et choisissez un dossier de sortie.

Exporter le serveur Linux :

Menu Projet → Exporter.
Sélectionnez le préset Linux Server.
Cliquez sur Exporter le projet.

Note

Pour exporter vers Linux, vous devez avoir installé le template d’export Linux dans Godot (Éditeur → Gérer les modèles d’exportation).

Style de code

Typage strict : déclarez toujours les types explicitement (var x: int = 0).
Pas de TODO laissé dans le code soumis — ouvrez une issue à la place.
Nommage : snake_case pour les variables et fonctions, PascalCase pour les classes.
Commentaires : en français, concis.
Signals : préfixez les signaux avec le nom du composant (dolphin_died, chunk_loaded).

Exemple de code conforme :

class_name DolphinController
extends CharacterBody3D

@export var speed: float = 5.0
var _oxygen: float = 1.0

func take_damage(amount: int) -> void:
    # Réduit les PV et déclenche le signal si mort
    health -= amount
    if health <= 0:
        emit_signal("dolphin_died")

Soumettre une contribution

Créez une branche depuis main :
```
git checkout -b feat/ma-fonctionnalite
```

Faites vos modifications et committez :

git add .
git commit -m "feat: description courte"

Poussez votre branche :
```
git push origin feat/ma-fonctionnalite
```
Ouvrez une Pull Request sur le Gitea de DauphinCraft.
Un mainteneur relit et fusionne après validation.

Discussion et support

Rejoignez le serveur Discord communautaire et consultez le canal #dauphincraft-dev pour poser vos questions, proposer des idées ou signaler des bugs.