Saltar a contenido

Eggs de Pelican

Los eggs son templates que definen cómo instalar y ejecutar un servidor de juego. Incluyen:

  • Imagen Docker a usar
  • Script de instalación (descarga del juego via SteamCMD, etc.)
  • Comando de inicio
  • Variables configurables (mapa, contraseñas, mods, etc.)

Repositorios oficiales

Los eggs se alojan en GitHub bajo pelican-eggs:

Repo Contenido
games-steamcmd Juegos que usan SteamCMD (ARK, Rust, Satisfactory, etc.)
games-standalone Juegos standalone (Terraria, Factorio, etc.)
minecraft Minecraft (Paper, Fabric, Vanilla, etc.)

Importar eggs

Por API (recomendado)

curl -sL "$URL_DEL_EGG_JSON" \
  | curl -s -X POST "https://pelican.matias7235.com.ar/api/application/eggs/import" \
    -H "Authorization: Bearer papp_..." \
    -H "Content-Type: application/json" \
    -d @-

Por panel web

Admin → Nests → botón Import Egg → pegar URL del JSON raw.

Eggs instalados actualmente

ID Nombre Imagen default Repositorio
3 Paper ghcr.io/pelican-eggs/yolks:java_25 minecraft/java/paper
Ark: Survival Evolved (pendiente) ghcr.io/pelican-eggs/steamcmd:debian games-steamcmd/ark_survival_evolved

Paper — Notas importantes

  • Minecraft 26.1+ (Paper 26.1+) requiere Java 25 como mínimo
  • El egg oficial de Paper usa Java 21 por defecto → hay que reimportarlo con Java 25 como imagen default
  • Para forzar Java 25: en el YAML de import, poner "Java 25" como primera key en docker_images
  • Imágenes disponibles: Java 25, 21, 17, 16, 11, 8
  • Puerto: 25565 (TCP)

Ark — Pendiente (cuando llegue el disco HDD)

  • Egg: games-steamcmd/ark_survival_evolved
  • Puertos: Game (7777-7801 UDP), Query (27015-27040 UDP)
  • Plan: instalar una vez en /mnt/hdd_2tb/ark/, usar mounts para compartir binarios entre servers