Skip to main content

​
Prise en main de 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 services XBOX 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 moteur et de la place du GDK dans chacune d’elles, 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 qui montre comment créer une extension Godot intégrant le Microsoft GDK, les services XBOX et PlayFab. Il vous permet de créer votre titre pour XBOX sur PC sans quitter le moteur que vous appréciez déjà. Cet exemple fournit une référence modulaire qui explique 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 conversation 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 des API du GDK à 100 %, en plus de correctifs signalés par la communauté. Pour plus de détails sur ces versions, consultez Notes de publication.
[!NOTE] La v0.3.0 contient une modification avec rupture de compatibilité. Tous les types visibles par les scripts de l’addon GDK ont été renommés : par exemple, GDKUser est désormais XboxUser, et l’espace de noms C# GodotGdk est désormais GodotXbox. Aucun alias déprécié n’est fourni ; les projets existants doivent donc mettre à jour leurs références de types pour pouvoir se charger. Le singleton du moteur s’appelle toujours GDK, de sorte que les appels tels que GDK.initialize() ne sont pas affectés. L’exemple fournit un codemod pour automatiser la majeure partie de la modification. Pour plus de détails, consultez Modification avec rupture de compatibilité : renommage des types de l’addon 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 illustrées dans :
  • Les services de plateforme du Microsoft GDK
  • Les services XBOX
  • 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 services XBOX à GameInput, cet exemple vous montre comment intégrer la connexion, la prise en charge des manettes et bien plus encore dans votre jeu avec Godot. Il inclut des informations 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 spécifiques 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. La couche de wrappers est sous licence MIT ; les dépendances GDK et PlayFab nécessitent toujours leurs propres installations et l’acceptation de leurs licences, comme pour nos autres exemples XBOX.
  • Il n’existe pas de cadence de mise à jour définie pour le support 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 proposer 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 XBOX One ci-dessous.

​
Prise en main

Utilisez ces ressources pour cloner le dépôt, générer l’extension et commencer l’intégration avec votre projet Godot :
  • XBOX Godot Sample : XBOX Godot Sample - Un exemple d’implémentation liant le Microsoft GDK, PlayFab et GameInput à Godot.
  • Microsoft GDK : microsoft/GDK - GDK public de Microsoft.
  • SDK PlayFab : PlayFab Unified SDK - 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 - Documentation de l’exemple Godot XBOX.
  • Problèmes : XBOX Godot Issues - Signalez des bogues, demandez des fonctionnalités ou contribuez.
Une fois le Microsoft GDK intégré à votre projet Godot, suivez le reste du guide de bout en bout pour 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 addons de l’exemple XBOX Godot. Publié le 10 septembre 2026, il montre le GDK, les services XBOX et PlayFab fonctionnant ensemble dans un 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. Vous pouvez ainsi voir l’ordre des appels, la gestion des échecs et le travail lié au cycle de vie qu’un titre publié 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 outre le 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 v0.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, 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 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. Godot étant open source et sous licence MIT, la Godot Foundation ne gère pas officiellement de modèles d’exportation pour console. Les SDK de console sont distribués sous NDA et nécessitent des contrats juridiques et un accès restreint, incompatibles avec le modèle de développement ouvert du moteur. Pour obtenir des informations à jour sur le processus de portage sur console, la liste des fournisseurs de middleware 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, contactez votre représentant XBOX. Si vous n’êtes pas encore inscrit, consultez S’inscrire au programme ID@XBOX pour commencer.

​
Rubriques connexes

Last modified on October 6, 2026