Multi-server, single-world papermc implementation
GPL-3.0 License
MultiPaper is in public beta. Most features work for most players most of the time, however things can occasionally break.
1.20.1 Purpur fork that enables a server admin to scale a single world across multiple servers. Multiple MultiPaper servers run the same world and use a MultiPaper-Master to coordinate with each other and store server data. While the MultiPaper-Master is usually run as a standalone server, it can also be run as a BungeeCord or Velocity plugin, which has some benefits including being able to send players to the least busy server when they join.
MultiPaper 2.0:
Works like a CDN
MultiPaper-Master
How chunk syncing works:
For servers that wish to maintain all vanilla mechanics while scaling up, MultiPaper is for you. Usually when a Minecraft server chooses to scale their player count up, they have to sacrifice various mechanics such as render distance, mob spawning, and redstone.
With MultiPaper, there is no need to ruin the vanilla experience. All you need are new servers when you wish to scale. Instead of having 1 server handling 100 players, you can have 10 servers handling 10 players each. This allows you to keep expensive vanilla mechanics like a large render distance, mob farms, and massive redstone contraptions.
Perhaps 100 players isn't enough for you. You want to push the limits of your Minecraft server to the extreme with upwards of 1000 players online at once. Well, MultiPaper is also for you. With its ability to horizontally scale, the hardware's the limit.
MultiPaper includes a few commands mainly for debug purposes:
/servers
List all servers running on this MultiPaper cluster. Includes performance
indicators such as TPS, tick duration, and player count.
/slist
List all online players and what server they're on.
/mpdebug
Toggle a debug visualisation showing chunks that your server is ticking (aqua)
and chunks being ticked by another server (red). The server ticking the chunk
you are standing in is displayed above the action bar.
/mpmap
Show a map of nearby chunks and which server owns them. Up represents north. If
your server owns the chunk, the chunk is shown as aqua. If another server owns
the chunk, it's shown as red. If the chunk is in memory but not within
simulation range on your server, it's shown as white. Chunks not loaded on your
server are shown as grey.
java -jar multipaper-master.jar <port> [optionalProxyPort]
plugins/MultiPaperProxy/config.yml
plugins/multipaper-velocity/config.toml
multipaper.yml
bungeecordName
survival1
multipaperMasterAddress
localhost:35353
Command line options are provided that allow the config files server.properties, spigot.yml, paper.yml, and multipaper.yml to be overridden for easier scalability. For example:
java
-DbungeecordName=server1
-DmultipaperMasterAddress=127.0.0.1:35353
-Dproperties.view-distance=16
-Dpaper.global.proxies.proxy-protocol=true
-Dspigot.world-settings.default.entity-tracking-range.players=128
-Dmultipaper.sync-settings.files.files-to-sync-on-startup="myconfigfile.yml;plugins/MyPlugin.jar"
-jar multipaper.jar
MultiPaper provides a proxy (like Bungeecord or Velocity) that can be used to
hide the multipaper servers behind a single address. The proxy automatically
selects the multipaper server with the lowest load and forwards the player
to it. The proxy provides no extra features and is designed to be as fast and
light-weight as possible. When using the proxy, you will need to set
bungeecord
to true
in the multipapers' spigot.yml
.
This proxy is only available when running a standalone MultiPaper-Master installation and can be started by specifying a port for it to listen on:
java -jar multipaper-master.jar <port> [proxy port]
For example, to run the MultiPaper-Master on port 35353 and the proxy on port 25565, you'd run:
java -jar multipaper-master.jar 35353 25565
For a plugin to work with MultiPaper, it needs to support multiple servers. A good indication of this, but not a guarantee, is if a plugin uses a MySQL database.
To make a plugin compatible with MultiPaper, no data must be stored on the server itself and must instead be stored on an external server such as a MySQL database.
Some other things to look out for:
PlayerJoinEvent
and PlayerQuitEvent
will only be called on one server,Bukkit.broadcastMessage
will send the message to all players on allBukkit.getOnlinePlayers
will return the players only on your server. UseBukkit.getAllOnlinePlayers
to get the players across all servers.Player.isLocalPlayer
, Chunk.isLocalChunk
,Location.isChunkLocal
, Entity.isInLocalChunk
, Block.isInLocalChunk
If you want your plugin to still support regular Spigot and Paper servers, we recommend using MultiLib instead.
Add the following into your build.gradle:
repositories {
maven {
url "https://repo.clojars.org/"
}
}
dependencies {
compile "com.github.puregero:multipaper-api:1.20.1-R0.1-SNAPSHOT"
}
Or in your pom.xml:
<repositories>
<repository>
<id>clojars</id>
<url>https://repo.clojars.org/</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.puregero</groupId>
<artifactId>multipaper-api</artifactId>
<version>1.20.1-R0.1-SNAPSHOT</version>
</dependency>
</dependencies>
Requirements:
git
installed, with a configured user name and email.jdk
17+ installed to compile (and jre
17+ to run)Build instructions:
./gradlew applyPatches
./gradlew shadowjar createReobfPaperclipJar
build/libs
MultiPaper-Master/build/libs
Publish to your local maven repository with: ./gradlew publishToMavenLocal
Note for mac users: The latest macOS version includes an incompatible version of
diff and you'll need to install a compatible one. Use brew install diffutils
to install it, and then reopen the terminal window.
If diff --version
returns the following, it is incompatible and will not work:
Apple diff (based on FreeBSD diff)
All code is licensed under GPLv3 excluding MultiPaper-Master which is licensed under MIT.
MultiPaper includes optimisations from both Airplane and Pufferfish.
MultiPaper uses PaperMC's paperweight framework found here.