Extension GDevelop 5 — Documentation Angon Cloud

L'extension officielle Angon Cloud pour GDevelop 5 vous permet d'intégrer l'ensemble des services (comptes joueurs, tables no-code, stockage, boutique, classements et mode hors-ligne) via des blocs d'événements visuels, sans écrire une seule ligne de code JavaScript.

1. Télécharger l'extension

Le fichier de l'extension porte le nom AngonCloud.json. Il contient l'ensemble des définitions d'actions, conditions, expressions et l'interface HTML native du panneau de connexion.

AngonCloud.json (Version officielle)

Compatible avec GDevelop 5.6+ · Plus de 100 fonctions prêtes à l'emploi

2. Importer dans GDevelop 5

Ouvrez votre projet dans GDevelop 5 (application de bureau ou version web).
Dans la barre latérale gauche (Gestionnaire de projet), dépliez la section Extensions.
Cliquez sur Importer ou créer une extension tout en bas.
Sélectionnez l'option Importer une extension depuis un fichier.
Choisissez le fichier AngonCloud.json que vous venez de télécharger.

Extension installée avec succès !

L'extension apparaît sous le nom Angon Cloud dans la liste. Toutes les actions, conditions et expressions sont désormais accessibles dans vos feuilles d'événements.

3. Variables de scène obligatoires

Dès le démarrage de la scène, l'extension lit automatiquement ses paramètres de connexion à partir des variables d'extension ou globales suivantes :

Variables globales ou de scène

Variable Texte AngonCloud::BaseURL = "https://votre-console.angon.cloud/api/public/v1"
Variable Texte AngonCloud::ApiKey  = "ak_live_votre_cle_api_ici"
Variable Texte AngonCloud::GameID  = "3c8f8697-3f30-4e31-8da3-6c84c6e91bf9"

Astuce pour les variables globales

Définir ces 3 variables dans les Variables globales du projet vous évite de devoir les renseigner à nouveau sur chaque nouvelle scène !

4. Cycle de vie dans les événements

Voici le patron d'événements recommandé à insérer dans votre scène de démarrage ou de menu :

Feuille d'événements — Scène MenuPrincipal

// 1. Initialisation et reconnexion automatique au démarrage
Condition : Au début de la scène (SceneJustBegins)
            La configuration d'Angon est valide (AngonCloud::EstConfigure)
Action    : // Tente de reconnecter le joueur si un jeton valide existe sur l'appareil
            Restaurer la session sauvegardée du joueur (AngonCloud::RestaurerSession)

// 2. Détection du succès de la connexion
Condition : Le joueur vient de se connecter (AngonCloud::VientDeSeConnecter)
Action    : Modifier le texte de PseudoLabel = "Bienvenue, " + AngonCloud::Pseudo()
            Modifier le texte de NiveauLabel = "Niveau " + ToString(AngonCloud::Niveau())

// 3. Clic sur le bouton de connexion pour ouvrir la pop-up native
Condition : Le curseur est sur BoutonConnexion
            Le bouton gauche de la souris a été relâché
Action    : Ouvrir le panneau de connexion Angon (mode: "connexion")

5. Catalogue des actions & expressions

L'extension comprend 122 fonctions réparties dans les catégories suivantes :

Authentification (11)

Connexion, inscription, Google OAuth, restauration de session, déconnexion, détection de connexion.

Profil Joueur (11)

Expressions Pseudo, Email, PhotoProfil, Pays, Statut, Niveau, Score, ID de compte.

Tables No-Code (24)

Création simple/double/JSON, lecture complète ou filtrée, tri, modification, suppression.

Mode Hors-Ligne (12)

Détection réseau, file d'attente d'écritures, politiques de tables, synchronisation forcée.

Stockage Cloud (11)

Téléversement texte/JSON, sélecteur natif de fichier, URLs directes et listing des fichiers.

Boutique & Classements (20)

Articles, devises, promotions, soumission de scores, consultation du Top 50 et rangs.

Multijoueur (19)

File d'attente par mode (1v1, 2v2...), statut du matchmaking, salon temps-réel et actions diffusées.

Suivant : Panneau Joueur & Authentification