Awesome Open Source
Awesome Open Source
Magma logo

Stable Builds Dev-Builds

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

If you want to use Magma in a BungeeCord network, we recommend to use HexaCord or Waterfall/Travertine 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 1.16 is in beta and not stable enough to be used on a public server. Beta releases for testing and private playing can be found here.

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 launch4j
    • 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.

You could also go to Magma's subreddit here.

Unstable/Test builds

For unstable/test builds you can check the CI

Partners

YourKit

YourKit-Logo

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


Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Java (709,723
Minecraft (7,349
Spigot (1,596
Bukkit (1,149
Forge (675
Jar (387
Related Projects