Passer au contenu principal

​
Bien démarrer avec Godot

Cet article explique comment commencer à utiliser Godot pour créer des jeux XBOX pour PC avec le Microsoft Game Development Kit (GDK). Il vous oriente vers l’exemple XBOX Godot, qui montre comment intégrer le GDK, les XBOX services et PlayFab dans un projet Godot, et vers XBOX Godot NetRumble, un jeu multijoueur complet basé sur cet exemple. Il indique également où trouver des conseils pour publier un jeu Godot sur XBOX Series X|S ou XBOX One. Godot est l’un des nombreux moteurs que vous pouvez utiliser avec le GDK. Pour une vue d’ensemble des options de moteurs et de la façon dont le GDK s’intègre à chacun, consultez Microsoft Game Development Kit et moteurs de jeu.

​
Exemple XBOX Godot

L’exemple XBOX Godot est une référence publique, fournie uniquement sous forme de code source, sur GitHub. Il s’agit d’un exemple fonctionnel de la façon de créer une extension Godot qui intègre le Microsoft GDK, les XBOX services et PlayFab. Grâce à lui, vous pouvez créer votre titre pour XBOX sur PC sans quitter le moteur que vous aimez déjà. Cet exemple fournit une référence modulaire qui montre comment intégrer le Microsoft GDK et le SDK PlayFab ensemble ou séparément.
[!TIP] Les versions v0.2.0 et v0.3.0 ajoutent des indicateurs de clavardage PlayFab Party, des commandes vocales, la synthèse vocale et des diagnostics réseau, complètent les wrappers d’API XUser, ajoutent la prise en charge de Godot .NET (C#), élargissent la compatibilité avec les versions du GDK et de Godot et étendent la couverture de la référence de l’API du GDK à 100 %, en plus d’apporter des correctifs signalés par la communauté. Pour plus de détails sur ces versions, consultez Notes de publication.
[!NOTE] La v0.3.0 contient un changement non rétrocompatible. Chaque type visible par les scripts dans le module complémentaire GDK a été renommé; par exemple, GDKUser est maintenant XboxUser, et l’espace de noms C# GodotGdk est maintenant GodotXbox. Aucun alias déprécié n’est fourni; les projets existants doivent donc mettre à jour leurs références de types avant de pouvoir être chargés. Le singleton du moteur s’appelle toujours GDK; les appels comme GDK.initialize() ne sont donc pas touchés. L’exemple fournit un codemod pour automatiser la majeure partie du changement. Pour plus de détails, consultez Changement non rétrocompatible : renommage des types du module complémentaire GDK.

​
Contenu

L’exemple XBOX Godot couvre une part importante de ce dont un développeur de jeux Godot a besoin pour créer des jeux pour XBOX sur PC, avec des fonctionnalités clés présentées dans :
  • Services de plateforme du Microsoft GDK
  • XBOX services
  • PlayFab Core + Services
  • PlayFab Multiplayer (Lobby, Matchmaking, Party)
  • PlayFab Game Saves
  • GameInput (y compris le pont vers Input / InputMap de Godot)
À partir de la v0.2.0, l’exemple prend également en charge les projets Godot .NET (C#) au moyen d’un parcours C# managé, en plus de GDScript. Des XBOX services à GameInput, cet exemple vous montre comment intégrer à votre jeu Godot la connexion, la prise en charge des manettes de jeu et plus encore. Il comprend des renseignements utiles et du code d’intégration réutilisable, et prend en charge d’emblée un large éventail d’éditions du GDK et de versions de Godot. Pour connaître les éditions et versions précises validées dans chaque version, consultez Notes de publication.

​
Ce que c’est et ce que ce n’est pas

  • Il s’agit d’un exemple fourni uniquement sous forme de code source, et non d’un produit. Il est sous licence MIT au niveau de la couche d’encapsulation; les dépendances du GDK et de PlayFab nécessitent toujours leurs propres installations et l’acceptation de leurs licences, comme pour nos autres exemples XBOX.
  • Il n’y a pas de cadence de mise à jour établie pour le soutien ou la maintenance. Nous surveillerons le dépôt et les problèmes signalés, et nous apporterons des améliorations lorsque cela sera pertinent, mais il ne s’agit pas d’une version commerciale. Cela dit, nous avons hâte de recevoir vos commentaires et de voir les PR de la communauté, à mesure que nous faisons évoluer ce projet ensemble.
  • Il s’agit de la première étape pour offrir Godot pour XBOX sur PC. Nous prévoyons de le faire évoluer au fil du temps en fonction de ce que la communauté juge le plus utile.
  • Cet exemple est conçu spécifiquement pour XBOX sur PC. Il n’inclut pas la prise en charge de XBOX Series X|S ni de XBOX One. Pour plus d’informations sur la prise en charge des consoles, consultez la section sur la prise en charge de XBOX Series X|S et de XBOX One ci-dessous.

​
Commencer

Utilisez ces ressources pour cloner le dépôt, générer l’extension et commencer l’intégration à votre projet Godot :
  • Exemple XBOX Godot : XBOX Godot Sample - Un exemple d’implémentation qui lie le Microsoft GDK, PlayFab et GameInput à Godot.
  • Microsoft GDK : microsoft/GDK - Le GDK public de Microsoft.
  • SDK PlayFab : PlayFab Unified SDK - Le SDK unifié PlayFab.
  • GameInput : GameInput - Une API d’entrée de nouvelle génération qui expose des périphériques d’entrée de tous types au moyen d’une interface unique et cohérente.
  • Documentation : XBOX Godot Docs - La documentation de l’exemple Godot XBOX.
  • Problèmes : XBOX Godot Issues - Signalez des bogues, demandez des fonctionnalités ou contribuez au projet.
Après avoir intégré le Microsoft GDK à votre projet Godot, suivez le reste du guide de bout en bout sur PC pour inscrire votre titre, configurer votre produit dans Partner Center et publier votre jeu sur le Microsoft Store.

​
XBOX Godot NetRumble

XBOX Godot NetRumble est un jeu multijoueur Godot 4 complet et jouable, basé sur les modules complémentaires de l’exemple XBOX Godot. Publié le 10 septembre 2026, il montre le GDK, les XBOX services et PlayFab fonctionnant ensemble dans un même titre en cours d’exécution, plutôt que sous forme d’exemples isolés par API. La connexion, la découverte de sessions par code de participation, la mise en réseau Party, la voix et le texte saisi, les privilèges et la confidentialité, la modération, les succès et Game Save sont reliés de bout en bout dans un petit jeu d’arène, ce qui vous permet de voir l’ordre des appels, la gestion des échecs et le travail sur le cycle de vie qu’un titre commercialisé doit maîtriser. PlayFab Party est encapsulé sous la forme d’un MultiplayerPeer Godot prêt à l’emploi, de sorte que chaque @rpc de l’exemple reste un RPC Godot ordinaire et que votre code réseau existant continue de fonctionner. Chaque appel de plateforme se trouve derrière une façade de services unique avec un fichier par préoccupation, ce qui vous permet de reprendre l’élément dont vous avez besoin. L’exemple associe également chaque XBOX Requirement qu’il couvre au code qui l’implémente, ce qui vous donne une longueur d’avance pour la certification. Le même projet cible XBOX sur PC et XBOX Series X|S. L’exportation vers la console nécessite en plus la duplication (fork) console de Godot de W4 Games. Comme l’exemple XBOX Godot, NetRumble est une référence fournie uniquement sous forme de code source, sous licence MIT, et non un titre certifié. Pour plus de détails, consultez Version 0.1.0 de l’exemple XBOX Godot NetRumble.

​
Notes de publication

L’exemple XBOX Godot évolue au fil du temps en fonction des commentaires de la communauté. Les notes de chaque version décrivent les nouvelles fonctionnalités, les améliorations et les correctifs de chaque version, ainsi que les éditions du GDK et les versions de Godot validées pour cette version. Pour l’historique complet des versions et des téléchargements, consultez Versions de l’exemple XBOX Godot sur GitHub.

​
Prise en charge de XBOX Series X|S et de XBOX One

L’exemple XBOX Godot est conçu spécifiquement pour XBOX sur PC et n’inclut pas la prise en charge de XBOX Series X|S ni de XBOX One. Comme Godot est open source et sous licence MIT, la Godot Foundation ne maintient pas officiellement de modèles d’exportation pour console. Les SDK de console sont distribués sous NDA et exigent des contrats juridiques et un accès restreint, ce qui est incompatible avec le modèle de développement ouvert du moteur. Pour obtenir les détails à jour sur le processus de portage vers les consoles, la liste des fournisseurs d’intergiciels et des liens vers d’autres conseils de la Godot Foundation, consultez Godot and console porting sur le site Web officiel de Godot Engine. Si vous développez déjà pour XBOX Series X|S ou XBOX One, communiquez avec votre représentant XBOX. Si vous n’êtes pas encore inscrit, consultez S’inscrire au programme ID@XBOX pour commencer.

​
Rubriques connexes

Dernière modification le 6 octobre 2026

Sujets connexes

Utiliser le GDK avec Unity, Unreal et d'autres moteursUtiliser le GDK avec UnityUtiliser Clang/LLVM avec le GDKUtiliser le GDK avec Unreal EngineUtiliser le GDK avec GameMaker