MCGalaxy is a fully featured and customisable ClassiCube Server Software based on MCForge/MCLawl.

Setup

Download the latest MCGalaxy release from here

• Windows: You need to install .NET framework 4.0. Windows 8/10/11 already have this included.
• macOS: You need to install the Mono framework.
• Linux: You need to install the Mono framework. (or just apt install mono-complete if on Ubuntu)

Run MCGalaxy.exe for a graphical interface, or run MCGalaxyCLI.exe for command line only.

Joining your server

Run MCGalaxy.exe or MCGalaxyCLI.exe firstly. You'll see something like:

If you are signed in to classicube.net, you can copy this URL straight into your web browser and start playing.

Joining from the ClassiCube client

Click Direct connect at the main menu.

Type your username into Username, 127.0.0.1:25565 into IP:Port, and leave Mppass blank. Then click Connect.

Make yourself owner

After joining, you will want to rank yourself owner so you can use all commands.

Type /rank [your account] owner into the bottom text box, then press Enter.

Letting others join your server

LAN players

You need to find out your LAN/local IP address.

• Windows: Type ipconfig into Command Prompt. Look for IPv4 address in the output
• macOS: Type ipconfig getifaddr en0 or ipconfig getifaddr en1 into Terminal
• Linux: Type hostname -I into Terminal. Lan IP is usually the first address in the output

Joining from a web browser

Enter the server URL followed by ?ip=[lan ip] into the web browser.
(e.g. http://www.classicube.net/server/play/d1362e7fee1a54365514712d007c8799?ip=192.168.1.30)

Joining from the ClassiCube client

• Click Direct connect at the main menu
• Type your username into Username textbox
• Type [lan ip]:25565 into IP:Port textbox (e.g. 192.168.1.30:25565)
• Click Connect

Across the internet

You usually need to port forward in your router before other players can join.

Joining from a web browser

Enter the server URL into the web browser

Joining from the ClassiCube client

• Click Sign in
• Type/paste the hash (e.g. d1362e7fee1a54365514712d007c8799) into the classicube.net/server/play text box
• Click Connect

Show on classicube.net server list

Click Settings in the MCGalaxy window, then tick the Public checkbox. Then click Save.

This makes your server appear in the server list on classicube.net and in the ClassiCube client.

Compiling - mono and .NET framework

With an IDE:

• Visual Studio : Open MCGalaxy.sln, click Build in the menubar, then click Build Solution. (Or press F6)
• SharpDevelop: Open MCGalaxy.sln, click Build in the menubar, then click Build Solution. (Or press F8)

Command line:

• For Windows: Run MSBuild command prompt for VS, then type msbuild MCGalaxy.sln into command prompt
• Modern mono: Type msbuild MCGalaxy.sln into Terminal
• Older mono: Type xbuild MCGalaxy.sln into Terminal

Compiling - .NET 6 / .NET 7 / .NET 8

• Compiling for .NET 6: Navigate into CLI directory, and then run dotnet build MCGalaxyCLI_dotnet6.csproj
• Compiling for .NET 7: Navigate into CLI directory, and then run dotnet build MCGalaxyCLI_dotnet7.csproj
• Compiling for .NET 8: Navigate into CLI directory, and then run dotnet build MCGalaxyCLI_dotnet8.csproj

You will also need to copy libsqlite3.so.0 from system libraries to libsqlite3.so in the server folder

Copyright/License

See LICENSE for MCGalaxy license, and license.txt for code used from other software.

Docker support

Some unofficial dockerfiles for running MCGalaxy in Docker:

• using Mono
• using .NET core

Documentation

• General documentation
• API documentation