Skip to content

SpongeVanilla

SpongeVanilla is the implementation of the Sponge API on top of Vanilla Minecraft.

egg-spongevanilla.json

updated

Ports
25565
Runtime
Java 8 to 25
Variables
2

Ports

Add an allocation on the node for each port.

  • Game 25565

Install

Installer image
ghcr.io/ptero-eggs/installers:debian
Install script
50 lines

Images

New servers use the first image. Users can change it on the Startup page.

  • Java 8 default ghcr.io/ptero-eggs/yolks:java_8
  • Java 11 ghcr.io/ptero-eggs/yolks:java_11
  • Java 16 ghcr.io/ptero-eggs/yolks:java_16
  • Java 17 ghcr.io/ptero-eggs/yolks:java_17
  • java 21 ghcr.io/ptero-eggs/yolks:java_21
  • java 22 ghcr.io/ptero-eggs/yolks:java_22
  • Java 25 ghcr.io/ptero-eggs/yolks:java_25

Panel features

  • eula

    The Panel asks the user to accept the Minecraft EULA when the server needs it.

  • java_version

    The Panel lets the user change the Java version when the server needs a different one.

  • pid_limit

    The Panel tells the user when the server reaches its process or memory limit.

Startup

The Panel runs this command to start the server. It replaces each variable in the command with the value of that variable.

2 variables

Startup command

java -Xms128M -Xmx1024M -jar server.jar

Dotted values come from the server settings. These values are examples.

  • Example 1.12.2-7.1.6 If the version fails it defaults to recommended

    SV_VERSIONUsers can edit

    required|string

  • The name of the Jarfile to use when running Mod.

    SERVER_JARFILEUsers can edit

    required|regex:/^([\w\d._-]+)(\.jar)$/

Wings

Stop command
stop
Running when the console shows
)! For help, type

Files Wings edits

Wings sets these values in these files before each start.

server.properties properties

server-ip
0.0.0.0
server-port
{{server.build.default.port}}
query.port
{{server.build.default.port}}

Readme

SpongeVanilla

A community-driven open source Minecraft: Java Edition modding platform.

SpongePowered Website

Server Ports

The minecraft server requires a single port for access (default 25565) but plugins may require extra ports to enabled for the server.

Port default
Game 25565

Changes

  1. Adding java 25 to most minecraft eggs

    · Red-Banana-Official · fb0c032

  2. Updating MC docker images (#23)

    · Red Banana · 8f3fc4d

  3. Validate and update embedded URLs

    · Daniel Barton · bf9f3cb

  4. SteamCMD + Other fixes

    · yesBad · edbf925

  5. Minecraft Eggs

    · yesBad · d749608

  6. Add Minecraft eggs

    · Daniel Barton · 7322302

All changes on GitHub

Problem with this egg?

Open an issue on GitHub. Include your Panel and Wings versions.

Report an issue
Install script 50 lines bash in ghcr.io/ptero-eggs/installers:debian Show 
#!/bin/bash
# spongeVanilla Installation Script
#
# Server Files: /mnt/server
apt update
apt install -y jq curl

mkdir -p /mnt/server
cd /mnt/server

#Adding .jar when not eding by SERVER_JARFILE
if [[ ! ${SERVER_JARFILE} = *\.jar ]]; then
  SERVER_JARFILE="${SERVER_JARFILE}.jar"
fi

## check spongevanilla version and default to recommended if it's invalid
if [ -z ${SV_VERSION} ] || [ "$(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla/downloads/${SV_VERSION})" == "Unknown version" ]; then
    echo -e "defaulting to recommended"
    SV_VERSION="recommended"
fi

## handle getting download linsk for sponge
if [ "${SV_VERSION}" == "recommended" ]; then
    echo -e "using recommended spongevanilla version"
    SV_VERSION=$(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla/downloads/recommended | jq -r '.version')
    echo -e "found spongevanilla Version ${SV_VERSION}"
    SV_DL_LINK=$(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla/downloads/recommended | jq -r '.artifacts."".url')
elif [ "${SV_VERSION}" == "latest" ]; then
    echo -e "using latest SpongForge version"
    SV_VERSION=$(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla | jq -r '.buildTypes.stable.latest.version')
    echo -e "found spongevanilla Version ${SV_VERSION}"
else
    echo -e "found spongevanilla Version ${SV_VERSION}"
    SV_DL_LINK=$(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla/downloads/${SV_VERSION} | jq -r '.artifacts."".url')
fi

if [ -f ${SERVER_JARFILE} ] && [ $(sha1sum server.jar | awk '{ print $1 }') == $(curl -s https://dl-api.spongepowered.org/v1/org.spongepowered/spongevanilla/downloads/recommended | jq -r '.artifacts."".sha1') ]; then
    echo -e "Already have the correct spongevanilla version"
else
    echo -e "Downloading spongevanilla version ${SV_VERSION}"
    echo -e "running: curl -s ${SV_DL_LINK} -o /mnt/server/mods/spongevanilla-${SV_VERSION}.jar"
    curl -s ${SV_DL_LINK} -o /mnt/server/${SERVER_JARFILE}
fi

if [ ! -f server.properties ]; then
    echo -e "Downloading MC server.properties"
    curl -s -o server.properties https://raw.githubusercontent.com/ptero-eggs/game-eggs/main/minecraft/java/server.properties
fi

echo -e "Install for spongevanilla is complete"