About

Magma is the next generation of hybrid minecraft server softwares.

Magma is based on Forge and Paper, meaning it can run both Craftbukkit/Spigot/Paper plugins and Forge mods.

We hope to eliminate all issues with craftbukkit forge servers. In the end, we envision a seamless, low lag Magma experience with support for newer 1.12+ versions of Minecraft.

Java 8

Magma for 1.12 requires Java 8. Java 9 or higher do not work due to Forge 1.12.

If you need a higher version of Java for other applications, you can install both versions and use "<path to java.exe>" -jar magma.jar instead of java -jar magma.jar.

BungeeCord/Velocity

Magma is compatible with Velocity, but it does not support modern forwarding.

If you want to use Magma in a BungeeCord network, we recommend to use Waterfall/Travertine or HexaCord instead since it has better Forge support than BungeeCord.

In order to use Magma with BungeeCord, you have to enable forge-support in the BungeeCord config, set online-mode to false in server.properties and bungeecord to true in spigot.yml.

1.16+

Magma for Minecraft 1.16 and above can be found in their own repositories. Click here to visit the 1.16 repository.

Deployment

Installation

1. Download the recommended builds from the Releases section (Do not use the "-installer" version as it is broken right now)
   1. Download Beta builds from the CI
2. Make a new directory(folder) for the server
3. Move the jar that you downloaded into the new directory
4. Run the jar with your command prompt or terminal, going to your directory and entering java -jar Magma-[version]-server.jar. Change [version] to your Magma version number.

Building the sources

• Clone the Project
  • You can use Git GUI (like GitHub Desktop/GitKraken) or clone using the terminal using:
    • git clone https://github.com/MagmaFoundation/Magma
  • Next, clone the submodules using:
    • git submodule update --init --recursive
• Building
  • First you want to run the build command
    • ./gradlew outputJar
  • Now go and get a drink this may take some time
  • Navigate to build/distributions directory of the compiled source code
  • Copy the Jar to a new server directory (see Installation) or run ./gradlew launchServer

Plugin Development

• Clone the Project
  • You can use Git GUI (like GitHub Desktop/GitKraken) or clone using the terminal using:
    • git clone https://github.com/MagmaFoundation/Magma
  • Next, clone the submodules using:
    • git submodule update --init --recursive
• Building Jar
  • First you want to run the plugin gen command
    • ./gradlew genPluginJar
  • Now go and get a drink this may take some time
  • Navigate to build/distributions directory
  • You should have a jar like Magma-xxxxxx-plugin.jar
  • Now create a plugin with that jar.

Contributing

If you wish to inspect Magma, submit PRs, or otherwise work with Magma itself, you're in the right place!

Please read the CONTRIBUTING.md to see how to contribute, setup, and run.

Chat

You are welcome to visit Magma's Discord server here (recommended).

You could also go to Magma's subreddit here.

Partners

YourKit

YourKit, makers of the outstanding java profiler, support open source projects of all kinds with their full featured Java and .NET application profilers.