Skip to content

Instantly share code, notes, and snippets.

@semick-dev
Last active April 30, 2026 22:10
Show Gist options
  • Select an option

  • Save semick-dev/b36dc8f4a7f9a9cb1ae1fa581bd1b552 to your computer and use it in GitHub Desktop.

Select an option

Save semick-dev/b36dc8f4a7f9a9cb1ae1fa581bd1b552 to your computer and use it in GitHub Desktop.
Running a minecraft server

Running a Minecraft NeoForge arcana server

Unless otherwise noted, all operations should be completed on the raspberry pi aka server-side.

Download prereqs

You basically only need OpenJDK 21. So I can't test this because my test machine is a ubuntu machine, but this is what chatgpt says about installing it.

# download, extract, and move to under a tools directory
wget https://github.com/adoptium/temurin21-binaries/releases/download/jdk-21.0.2%2B13/OpenJDK21U-jdk_aarch64_linux_hotspot_21.0.2_13.tar.gz
tar -xzf OpenJDK21U-jdk_aarch64_linux_hotspot_21.0.2_13.tar.gz
sudo mv jdk-21.0.2+13 /opt/jdk-21

# update PATH
sudo update-alternatives --install /usr/bin/java java /opt/jdk-21/bin/java 100
sudo update-alternatives --install /usr/bin/javac javac /opt/jdk-21/bin/javac 100

# verify
java -version

# create a place for the downloaded Arcana files
mkdir ~/minecraft-forge

If you hit issues with this there will be something for certain.

Download Arcana Server pack using Curseforge client.

THIS STEP IS ON YOUR WINDOWS MACHINE

If you get the UI working on your pi go directly here and use the server files about midway down the page on the right.

server_pack_link

If you can't download it directly on the Pi, you'll need to download it locally then secure copy it to the Pi.

This is how you copy from your windows machine to the raspberry pi (on local network). Where you see mars here, put the LAN ip address for the raspberry pi.

# from a pwsh terminal (I think regular powershell will work? Not certain)
scp 'Arcana Server 0.7.zip' semick@mars:/home/semick/minecraft-forge
#     ^source local file   ^user  ^pwd  ^path on remote server

I think you can intuit what's going on there with the comments.

successful_copy

Extract the Server Pack

Back to linux and will stay there for the rest of the steps.

Create a new folder and unzip the server pack:

# notice that unzipping doesn't destroy your original zip
cd ~/minecraft-forge
mkdir ~/arcana-server
unzip 'Arcana Server 0.7.zip' -d ~/arcana-server
cd ~/arcana-server

Verify it contains:

  • mods/
  • config/
  • kubjs/

etc/

Accept the EULA

echo "eula=true" > eula.txt

Make the launch script runnable

chmod +x startserver.sh

Launch it!

./startserver.sh

On first run it will:

  • Install the appropriate NeoForge version
  • Generate server.properties
  • Possibly generate world/
  • Load all mods from mods/

Open Firewall (if needed)

Allow port 25565 for Minecraft:

sudo ufw allow 25565

Connect from your client!

Final Folder Structure Example

arcana-server/
├── banned-ips.json
├── journeymap
├── mods
├── patchouli_books
├── startserver.bat
├── world
├── banned-players.json
├── kubejs
├── neoforge-21.1.162-installer.jar
├── run.bat
├── startserver.sh
├── config
├── libraries
├── neoforge-21.1.162-installer.jar.log
├── run.sh
├── usercache.json
├── defaultconfigs
├── local
├── ops.json
├── server-icon.png
├── user_jvm_args.txt
├── eula.txt
├── logs
├── packmenu
├── server.properties
└── whitelist.json
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment