Auto-hébergement

Héberge tes fichiers de jeu. On s'occupe du reste.

Tu gardes le contrôle total sur tes mods, resource packs et assets. Le launcher et son API restent chez nous. Tu n'as aucun CMS à installer — juste une clé API à poser dans un fichier, et un endroit où stocker tes fichiers.

Comment ça marche

Trois briques, chacune à sa place. Tu n'héberges que les fichiers — tout le reste est géré par la plateforme Xyno.

Le launcher Installé chez tes joueurs
(Windows · macOS · Linux)
API Xyno Auth, config, news, updates
sur notre VPS
Ton stockage Mods, resource packs,
configs, skins…
En clair : le launcher des joueurs parle à notre API pour savoir quoi faire, et l'API lui indique où télécharger les fichiers — sur ton stockage. Tu ne gères jamais d'authentification, de base de données, de HTTPS ou de signatures.

1. Ce qu'il te faut

L'auto-hébergement Xyno est volontairement léger. Pas de VPS à configurer, pas de base de données, pas de PHP. Il te faut juste un endroit capable de servir des fichiers en HTTPS :

  • Un bucket S3 (AWS, Scaleway, OVH Object Storage…)
  • Ou un Cloudflare R2 / Bunny Storage — excellents rapports qualité/prix
  • Ou un simple VPS avec nginx qui sert un dossier statique
  • Ou une hébergement mutualisé classique (OVH, o2switch, PlanetHoster…)

Seule vraie contrainte : les fichiers doivent être accessibles via une URL publique en HTTPS, par exemple https://assets.ton-serveur.fr/mods/foo.jar.

Pas d'hébergement ? On peut aussi tout héberger pour toi. Ajoute l'option Hébergement Xyno au moment de créer ton launcher (+5 €/mois) et ignore les étapes 2 à 4.

2. Récupérer ta clé API

  1. Crée ton compte sur XynoLauncher et choisis une offre.
  2. Dans le builder, renseigne le nom de ton launcher et clique sur Créer.
  3. Ton dashboard affiche alors une section Intégration avec :
  • Une clé API (garde-la secrète)
  • L'URL de l'API Xyno à utiliser (ex : https://api.xynolauncher.fr)
  • Un fichier xyno.config.json pré-rempli à télécharger
La clé API identifie ton launcher — elle est valide tant que ton abonnement est actif. Si tu la renouvelles (depuis le dashboard), les joueurs n'auront rien à faire, le launcher reprendra tout seul.

3. Le fichier de base

C'est le seul fichier que tu déposes sur ton stockage. Il dit à l'API Xyno où trouver tes assets. Exemple :

{
  "launcher_id": "ln_8f2b...c3d",
  "api_key":     "xyno_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "api_base":    "https://api.xynolauncher.fr",
  "assets_base": "https://assets.ton-serveur.fr",
  "manifest":    "manifest.json"
}

Les trois lignes importantes :

  • api_key — celle donnée par le dashboard
  • assets_base — la racine où tu uploades tes mods / resource packs
  • manifest — le fichier d'index qui liste toutes les versions (on le génère pour toi à chaque release)

Dépose xyno.config.json à la racine de ton stockage, à côté de tes mods. Le launcher sait le retrouver automatiquement.

4. Uploader tes mods et assets

Organise les fichiers comme tu le souhaites, tant que la structure correspond au manifest. Une convention simple :

assets.ton-serveur.fr/
├── xyno.config.json
├── manifest.json
├── mods/
│   ├── fabric-api-0.100.jar
│   ├── sodium-0.5.jar
│   └── …
├── resourcepacks/
│   └── pack-xynorp.zip
└── configs/
    └── options.txt

À chaque mise à jour, tu ajoutes ou remplaces les fichiers, puis tu pousses une nouvelle release depuis le dashboard (voir étape suivante). Les joueurs reçoivent la mise à jour automatiquement au prochain lancement du launcher.

Astuce bande passante : active le cache côté stockage (Cache-Control 1 an) et utilise un CDN si ta communauté est grande. Cloudflare R2 + Cloudflare CDN donne un excellent résultat pour quelques euros par mois.

5. Publier une version

  1. Upload tes fichiers de jeu sur ton stockage.
  2. Va dans Dashboard → Ton launcher → Releases.
  3. Clique sur Nouvelle release, donne-lui un numéro (ex : 1.2.0) et un nom.
  4. L'API scanne ton assets_base, génère automatiquement un manifest.json signé, et le publie à côté de tes fichiers.
  5. Le launcher de tes joueurs détecte la nouvelle release au prochain lancement et met à jour silencieusement ce qui a changé.

Besoin d'automatiser ? Un webhook GitHub / une ligne de curl dans ton CI suffit :

curl -X POST https://api.xynolauncher.fr/v2/releases \
  -H "Authorization: Bearer $XYNO_API_KEY" \
  -d '{"version":"1.2.0","notes":"Bugfixes & new mod"}'

6. Ce qui reste chez nous

Pour que tu n'aies rien à maintenir côté serveur, la plateforme Xyno garde à sa charge :

  • Authentification des joueurs et gestion des sessions
  • Génération et signature des manifests
  • Auto-update du launcher lui-même (les exécutables Windows / macOS / Linux)
  • News, événements, analytics opt-in
  • Builds multi-OS via GitHub Actions (tu ne compiles rien)
  • Rotation des clés API, révocation, anti-abus

Toi, tu gardes le contrôle exclusif sur :

  • Tes fichiers de jeu (mods, resource packs, configs, skins, map…)
  • Leur organisation et leurs droits d'accès sur ton stockage
  • La possibilité de changer de fournisseur de stockage à tout moment — tu mets à jour assets_base dans le dashboard, c'est tout

7. Besoin d'aide ?

L'auto-hébergement Xyno est pensé pour rester simple. Si tu bloques sur la mise en place :

  • La FAQ du dashboard répond aux questions les plus courantes.
  • Le support répond par email (réponse best-effort).
  • Si tu préfères ne pas gérer le stockage, passe sur l'option Hébergement Xyno — c'est activable à tout moment depuis le dashboard, sans avoir à prévenir tes joueurs.