Aller au contenu principal

🥚 Créer un Egg sur Pterodactyl

Les Eggs sont des modèles de serveurs qui définissent comment Pterodactyl installe et gère un jeu ou une application.
Chaque Egg appartient à un Nest et contient des informations comme :

  • L’image Docker à utiliser
  • Les variables de configuration (ex. : version du jeu, token d’un bot, motd, etc.)
  • Les scripts d’installation et de lancement

1. Accéder à la création d’un Egg​

  1. Connectez-vous à votre panel administrateur (https://votre_panel.fr/admin).
  2. Dans le menu latéral, cliquez sur Nests.
  3. Sélectionnez le Nest dans lequel vous voulez créer l’Egg.
  4. Cliquez sur Create New Egg.

2. Remplir les informations générales​

Name​

  • Nom de l’Egg (exemple : PaperMC, Bot Discord Node.js).

Description​

  • Courte description de ce que fait l’Egg.

Docker Image​

  • Image Docker utilisée pour exécuter le serveur.
  • Exemple : ghcr.io/pterodactyl/yolks:java_17 pour un serveur Minecraft moderne.
Important

Utilisez uniquement des images Docker officielles ou de confiance, afin d’éviter tout risque de sécurité.

3. Configuration de l’Egg​

Startup Command​

  • Commande utilisée pour lancer le serveur.
  • Exemple pour un serveur Minecraft : 
    java -Xms128M -Xmx{{SERVER_MEMORY}}M -jar server.jar

Variables​

  • Permettent de personnaliser l’Egg sans modifier directement les fichiers.
  • Exemples :
    • VERSION → version du jeu
    • SERVER_JARFILE → fichier .jar utilisé
    • TOKEN → clé API d’un bot
Astuce

Utilisez les variables pour rendre vos Eggs flexibles et réutilisables par vos utilisateurs.

4. Script d’installation​

Définissez le script qui sera exécuté lors de la première installation du serveur.
Exemple pour télécharger PaperMC :

#!/bin/bash
curl -o server.jar https://api.papermc.io/v2/projects/paper/versions/{{VERSION}}/builds/{{BUILD}}/downloads/paper-{{VERSION}}-{{BUILD}}.jar

5. Finaliser la création​

Cliquez sur Create Egg pour sauvegarder.

remarque

Votre Egg est maintenant disponible dans le Nest choisi et pourra être utilisé lors de la création de serveurs.

✅ Conclusion​

Vous savez désormais créer un Egg personnalisé pour Pterodactyl.
C’est une étape essentielle pour proposer de nouveaux jeux ou applications à vos utilisateurs.