Configuration de Xsolla Launcher

Questions générales

Pourquoi devrais-je utiliser Xsolla Launcher alors que je peux créer mon propre lanceur ?

Xsolla Launcher vous fait gagner du temps et économiser des ressources en fin de développement ou une fois le jeu terminé. Gratuit pour les partenaires, hors frais de paiement, il bénéficie régulièrement de nouvelles fonctionnalités et s’intègre aux solutions Xsolla, notamment Web Shop et Xsolla PC Suite. Il prend également en charge l’authentification des utilisateurs dans le jeu. Xsolla suit les tendances du marché.

Combien va me coûter Xsolla Launcher ?

Le prix de Xsolla Launcher est déjà inclus dans les frais Xsolla. Des frais supplémentaires peuvent s’appliquer à la livraison des jeux. Toutefois, l’utilisation d’un système d’équilibrage P2P permet de réduire les frais de distribution de 80 % en moyenne.

Comment puis-je envoyer des mises à jour de jeu à Steam si j’utilise Xsolla Launcher ?

Si vous utilisez le lanceur Steam, vous téléchargez le build du jeu et le lanceur directement sur Steam. Dans ce cas, Steam livre et met à jour le jeu. Si vous souhaitez fournir du contenu en utilisant Xsolla Launcher et son CDN sur Steam, veuillez contacter votre chef de projet ou envoyer un e-mail à [email protected].

Dois-je maintenir deux builds distincts, pour Steam et pour l’autonome ? Ou est-ce le même build qui est téléchargé sur Steam ?

Le nombre de builds dépend de la méthode d’intégration avec Steam. Toutefois, un seul build suffit dans la plupart des cas. Launcher vous permet de collecter les données utilisateur dans une seule base de données si vous proposez des jeux sur différentes plateformes. De plus, Launcher prend en charge l’enregistrement de bout-en-bout : si un utilisateur lance le jeu via Steam pour la première fois, il n’a pas besoin d’entrer ses données.

Dans ce cas, l’utilisateur peut visiter votre site en dehors du système Steam. Il peut s’authentifier en utilisant son Steam OpenID et rejoindre votre communauté officielle. Ensuite, l’utilisateur pourra participer aux discussions sur les forums, lire les nouvelles, découvrir de nouveaux jeux, etc.

J’utilise des outils Steam, y compris son lanceur, et je n’ai pas de frais de CDN. Qu’est-ce qui changera si j’utilise Xsolla Launcher ?

L’ajout de Xsolla Launcher à Steam avec un jeu ne change pas la logique de distribution ; Steam demeure responsable de la distribution et de la mise à jour des jeux. Le CDN de Launcher n’est pas utilisé dans ce cas.

Si vous souhaitez distribuer le jeu vous-même et utiliser Launcher de manière indépendante de la plateforme, Xsolla Launcher distribue les builds et les mises à jour du jeu en utilisant son CDN (G-core par défaut) ou tout autre que vous spécifiez. Le frais de trafic ne sont pas inclus dans la commission standard et sont facturés séparément sur une base mensuelle.

Xsolla propose un prix spécial entreprise pour G-core qui s’applique à tous ses clients.

Avez-vous une liste des CDN pré-intégrés avec Xsolla Launcher ? Dois-je contacter les entreprises qui fournissent des CDN pour une intégration supplémentaire ? Puis-je utiliser un CDN qui ne figure pas sur votre liste ?

Si vous souhaitez utiliser un autre fournisseur de CDN, contactez votre responsable de la réussite client ou envoyez un e-mail à [email protected].

Quels jeux sont affichés dans la liste des jeux dans Xsolla Launcher ? Tous les jeux ajoutés ou seulement ceux achetés par l’utilisateur ?

La liste répertorie tous les jeux intégrés à Xsolla Launcher. Les jeux achetés par l’utilisateur affichent le bouton Play, tandis que les autres jeux affichent le bouton Buy ou un autre bouton selon le type de distribution de jeu.

Puis-je octroyer des clés de jeu gratuites à des utilisateurs spécifiques ? Comment peuvent-ils les utiliser ?

Les utilisateurs peuvent-ils s’authentifier automatiquement dans les jeux après s’être authentifiés dans Xsolla Launcher ?

Oui, c’est possible. Pour transférer les données utilisateur de Xsolla Launcher vers le jeu, utilisez le paramètre –xsolla-login-token. Pour accéder aux données utilisateur, vous devez décoder la valeur du paramètre.

Que puis-je faire si l’icône de Xsolla Launcher dans la barre d’état système n’a pas changé après avoir modifié et recompilé Xsolla Launcher ?

Réinstaller Xsolla Launcher.

Où puis-je trouver les fichiers journaux du lanceur ?

Pour trouver les fichiers journaux du lanceur :

1. Ouvrez le lanceur.
2. Accédez aux paramètres du lanceur.
3. Cliquez sur Browse logs dans la section General.

Comment un jeu s’intègre-t-il à Xsolla Launcher ?

Existe-t-il une solution IPC dans le SDK ?

Il n’y a actuellement pas d’IPC, car Xsolla Launcher ne possède pas de fonctionnalités qui nécessitent une communication IPC. Mais nous prévoyons d’ajouter des fonctionnalités telles que le streaming en direct et un magasin de jeux dans la superposition, qui nécessiteront l’IPC (via le SDK), et nous l’ajouterons à ce moment-là.

Xsolla Launcher est-il pris en charge sur mobile ou Mac ?

Xsolla Launcher est compatible avec Windows et macOS.

Comment le contenu de la page d’un jeu est-il alimenté dans Xsolla Launcher ?

Les informations relatives au contenu se remplissent dans les paramètres de chaque jeu dans la section Game Info. Vous pouvez également saisir des informations pour la page du jeu dans la section Game Titles de Xsolla Launcher. Pour en savoir plus, consultez les instructions.

Build Loader

Lorsque je télécharge un correctif de jeu via Build Loader, je reçois l’erreur suivante : « Attention! File path longer than 260 characters. ». Comment puis-je résoudre ce problème ?

Sous Windows, en raison d’une limite sur la longueur maximale du chemin complet, il est recommandé de déplacer le répertoire du jeu vers un emplacement plus proche de la racine ; par exemple, C:/Patch. Ensuite, passez le chemin mis à jour au build du jeu en utilisant la commande –game-path <path-to-game>. Pour en savoir plus, reportez-vous aux instructions.

Je n’arrive pas à exécuter Build Loader. Que faire ?

Build Loader est un utilitaire en ligne de commande. Pour l’exécuter, ouvrez un interpréteur de commandes tel que cmd.exe dans le répertoire contenant le fichier build_loader.exe, et utilisez la commande ./build_loader.exe. Pour plus d’informations, référez-vous aux instructions.

Je rencontre un problème inconnu avec Build Loader. Que faire ?

La génération du lanceur est bloquée. Comment y remédier ?

Comment puis-je voir rapidement les modifications que j’ai effectuées dans Xsolla Launcher ?

Comment puis-je distribuer mon jeu free-to-play avec microtransactions via Xsolla Launcher ?

Customisation

Le plugin Figma tokens ne fonctionne pas correctement. Comment y remédier ?

Accédez aux paramètres de Figma Tokens et changez le stockage des tokens en document local.

Que puis-je personnaliser dans Figma ?

Est-il possible de télécharger le code source du lanceur Xsolla pour apporter des modifications directes, plutôt que de se limiter aux options du site Web ?

J’aimerais désactiver la fonctionnalité de connexion sur le lanceur. Comment procéder ?

Je n’arrive pas à modifier le nom du lanceur. Que faire ?

Nous pouvons effectuer la modification de notre côté, mais cette action impactera la mise à jour automatique du lanceur. Les utilisateurs devront réinstaller le lanceur à partir du programme d’installation. Nous déconseillons de modifier le nom des lanceurs actifs.

Comment modifier l’ordre des jeux dans le lanceur ?

Pour l’instant, l’ordre des jeux ne peut être modifié.

Puis-je déplacer le bouton Download ?

Installateur

Dois-je intégrer un lien de téléchargement du lanceur sur mon site Web ? Puis-je permettre l’enregistrement des utilisateurs via le lanceur plutôt que le site Web ?

Oui, c’est le principal canal de distribution des lanceurs pour tous nos partenaires. Mais ces derniers doivent mettre à jour ce lien à chaque nouvelle génération de lanceur. Le lanceur dispose également d’une fonction d’enregistrement.

Puis-je inclure le lien de téléchargement du lanceur dans l’e-mail de confirmation d’inscription ?

Actuellement, cette option n’est pas prise en charge, car le lien de téléchargement du lanceur change à chaque nouvelle version générée.

Comment puis-je modifier le nom du fichier d’installation ?

Pour modifier le nom du fichier d’installation, reportez-vous aux instructions.

Puis-je récupérer les informations sur l’installation du lanceur par un utilisateur ?

Malheureusement non, et pour l’instant, nous ne disposons pas d’une telle fonctionnalité.

L’installation du lanceur échoue alors que le programme d’installation Web exécute un installateur autonome. Comment y remédier ?

Voici quelques solutions populaires à ce problème :

• Essayez de changer le répertoire d’installation.
• Si le changement de répertoire sur le lecteur actuel n’a pas fonctionné, essayez d’installer le lanceur sur un autre lecteur.
• Désactivez votre antivirus, redémarrez votre ordinateur, puis essayez d’installer le lanceur.
• Essayez d’installer le lanceur via un installateur hors ligne.

Comment puis-je obtenir un installateur hors ligne ?

Je rencontre l’erreur « Your internet connection seems to be not permitted or dropped out ». Comment y remédier ?

Essayez de désactiver votre antivirus et votre pare-feu, redémarrez votre ordinateur et réessayez.

Lancement des jeux

Le jeu nécessite-t-il l’exécution de Xsolla Launcher pour fonctionner ?

Xsolla Launcher est toujours en cours d’exécution. Lorsqu’il est utilisé pour lancer le jeu, il se cache dans la barre d’état système afin de ne pas utiliser de ressources. Le joueur peut mettre fin au processus de Xsolla Launcher sans affecter le jeu, car il n’y a pas de connexion pendant la session de jeu.

Existe-t-il une solution pour connecter des PC sur le même LAN via une connexion P2P, de telle sorte que les données ne soient transférées qu’au sein de ce LAN ?

Non, il n’y a pas de telle solution pour l’instant.

Lorsque l’utilisateur démarre un jeu dans le lanceur, existe-t-il un moyen de récupérer les informations de connexion au jeu ?

Oui. Le lanceur passe le JWT comme argument de ligne de commande.

Je souhaite configurer une version Prod du lanceur et disposer de plusieurs branches de test pour mon jeu. Combien d’environnements pouvez-vous prendre en charge ?

Pour l’instant, chaque jeu se limite à un seul build du lanceur. Un autre build du jeu peut être utilisé pour la version de brouillon du lanceur, mais celle-ci ne peut être partagée avec les utilisateurs finaux.

Lorsqu’un utilisateur télécharge un jeu, l’antivirus affiche une fenêtre d’avertissement ou bloque le processus. Comment résoudre ce problème ?

Cette réaction de l’antivirus au téléchargement en P2P (pair-à-pair) est un faux positif. Pour télécharger des fichiers de jeu, le lanceur utilise des connexions P2P via une adresse IP publique partagée par plusieurs utilisateurs ou sites Web.
Si vous utilisez le logiciel Malwarebytes, référez-vous à leur commentaire officiel à ce sujet.
Cette erreur se corrige dans les paramètres du lanceur en désactivant l’option Use P2P (peer-to-peer) network.

Le lanceur prend-il en charge l’exécution de jeux par navigateur ?

Oui, pour configurer le lancement des jeux par navigateur, reportez-vous aux instructions.

Peut-on intégrer des arguments supplémentaires dans le fichier exécutable pour son lancement ?

Lorsque je démarre le jeu dans le lanceur, je rencontre l’erreur « Game files are missing or damaged ». Comment y remédier ?

Puis-je fournir des clés gratuites aux joueurs possédant déjà le jeu sur d’autres plateformes (par exemple Steam, Epic Games) pour les transférer sur la plateforme Xsolla ?

Puis-je télécharger une archive SFX en tant que fichier redistribuable ?

L’archive SFX peut se compacter en fichier EXE.

Quand un fichier redistribuable s’installe-t-il ?

Les redistribuables ne s’installent que lors de l’installation du jeu. Lorsque le jeu est mis à jour ou réparé, les redistribuables ne sont pas réinstallés.

Est-il possible d’ajouter les distinctions au lanceur ?

Launcher ne dispose pas encore de la fonctionnalité de distinctions.

Le magasin de jeux du lanceur prend-il en charge les coupons ?

Seuls les codes promo sont acceptés dans le panier d’achat.

Puis-je vendre des abonnements via le lanceur ?

Pour l’instant, le lanceur ne prend pas en charge les abonnements. Si vous avez besoin de cette fonctionnalité, veuillez nous en informer.

Launcher prend-il en charge les mods de jeu ?

Pour l’instant, Launcher ne prend pas en charge les mods de jeu. Si vous avez besoin de cette fonctionnalité, veuillez nous en informer.

Migration de Launcher v 2.x vers Launcher v 3.x

Puis-je créer une demande de fonctionnalité pour Launcher 2.x ?

Pour l’instant, nous n’acceptons les demandes de fonctionnalités que pour Launcher 3.x.

Puis-je télécharger Launcher depuis Github et le paramétrer via des fichiers de configuration ?

Les nouvelles de Launcher 2.x se transfèrent-elles de manière automatique dans les tuiles de contenu de Launcher 3.x ?

Pour l’instant, Launcher ne dispose pas d’une telle fonctionnalité. Il s’agit de deux systèmes de nouvelles distincts.

Onglets

Les utilisateurs rencontrent l’erreur « Try again » lorsqu’ils ouvrent un onglet dans le lanceur. Comment résoudre ce problème ?

Voici une raison possible : votre site Web renvoie le paramètre x-frame-options: SAMEORIGIN, ce qui bloque l’affichage du site dans le lanceur. Supprimez l’en-tête x-frame-options et ajoutez l’en-tête Content-Security-Policy: frame-ancestors file://*.

Propriété et clés

Comment les utilisateurs de Xsolla Launcher accèdent-ils aux jeux ? Les jeux peuvent-ils être distribués par le biais d’abonnements, de coupons ou de codes promo ?

Actuellement, l’accès aux jeux est uniquement possible avec une clé de jeu. Nous prévoyons d’ajouter des abonnements à Xsolla Launcher en 2024.

Les utilisateurs de Xsolla Launcher peuvent-ils télécharger des mises à jour de jeux s’ils n’ont pas acheté de clés de jeu ?

Non. Les jeux et les mises à jour ne sont pas disponibles sans l’achat de clés de jeu. Si vous avez des jeux free-to-play, c’est possible.

Que se passe-t-il avec l’accès de l’utilisateur au jeu si l’utilisateur effectue un remboursement ?

L’utilisateur perd l’accès au jeu. Toutefois, il pourra acheter à nouveau le jeu via Xsolla Launcher en utilisant le bouton Buy.