@@ -76,7 +86,7 @@ Once the download is done, you must put `PGM.jar` inside the `plugins` folder (c
### Starting the Server
-Once you are done with the initial setup, you can double-click `start.bat` to let SportPaper create the necessary files for Minecraft and PGM.
+Once you are done with the initial setup, you can double-click `start.bat` to let the server create the necessary files for Minecraft and PGM.
You can now join the server from your Minecraft client at `localhost` or `127.0.0.1:25565`.
Also see [Additional Setup](#additional-setup) if you would like to make the most use out of your newly-created server.
@@ -91,9 +101,9 @@ This guide uses macOS 14 (Sonoma). Generally speaking, the process should be the
### Installing Java
-We recommend using Java 21. For this guide, we will be using [Amazon Corretto 21](https://aws.amazon.com/corretto/).
+We recommend using Java 25. For this guide, we will be using [Amazon Corretto](https://aws.amazon.com/corretto/).
However, you may choose to use [OpenJDK](https://openjdk.org/) or [Eclipse Adoptium](https://adoptium.net/) instead.
-If you already have Java 21 installed, you may skip this step.
+If you already have Java installed, you may skip this step.
@@ -116,10 +126,18 @@ If you already have Java 21 installed, you may skip this step.
-### Downloading SportPaper
+### Downloading the Server Software
-Get the latest version of SportPaper from the [Downloads](/downloads) page.
-Once the download is done, you must rename the file and put `SportPaper.jar` inside an empty folder.
+
+
+ Get the latest version of SportPaper from the [Downloads](/downloads) page.
+ Once the download is done, you must rename the file and put `SportPaper.jar` inside an empty folder.
+
+
+ Get the latest stable version of Paper from [PaperMC website](https://papermc.io/downloads/paper).
+ Once the download is done, you must rename the file and put `paper.jar` inside an empty folder.
+
+
Next, you must create a Terminal shell script file to be able to start your server and have access to its console.
Start by opening your preferred text editor, copy and paste the following example below, and save the file as `start.command`.
@@ -189,18 +207,26 @@ Otherwise, we trust that you know what you are doing.
### Installing Java
-We recommend using Java 21. For this guide, we will be using [OpenJDK](https://openjdk.org/).
-However, you may choose to use [Amazon Corretto 21](https://aws.amazon.com/corretto/) or [Eclipse Adoptium](https://adoptium.net/) instead.
-If you already have Java 21 installed, you may skip this step.
+We recommend using Java 25. For this guide, we will be using [OpenJDK](https://openjdk.org/).
+However, you may choose to use [Amazon Corretto](https://aws.amazon.com/corretto/) or [Eclipse Adoptium](https://adoptium.net/) instead.
+If you already have Java installed, you may skip this step.
```bash
-sudo apt update && sudo apt install openjdk-21-jdk
+sudo apt update && sudo apt install openjdk-25-jdk
```
-### Downloading SportPaper
+### Downloading the Server Software
-Get the latest version of SportPaper from the [Downloads](/downloads) page.
-Once the download is done, you must rename the file and put `SportPaper.jar` inside an empty folder.
+
+
+ Get the latest version of SportPaper from the [Downloads](/downloads) page.
+ Once the download is done, you must rename the file and put `SportPaper.jar` inside an empty folder.
+
+
+ Get the latest stable version of Paper from [PaperMC website](https://papermc.io/downloads/paper).
+ Once the download is done, you must rename the file and put `paper.jar` inside an empty folder.
+
+
Next, you must create a shell script file to be able to start your server and have access to its console.
Start by opening your preferred text editor, copy and paste the following example below, and save the file as `start.sh`.
@@ -234,39 +260,63 @@ Also see [Additional Setup](#additional-setup) if you would like to make the mos
## Additional Setup
-### Configure SportPaper
-
-Using your text editor of choice, you may edit `server.properties` and `sportpaper.yml`. We recommend changing the following options below to these values:
-
-```properties title="server.properties"
-allow-nether=false
-announce-player-achievements=false
-generate-structures=false
-```
-
-```yml title="sportpaper.yml"
-bukkit:
- settings:
- allow-end: false
-spigot:
- # Forcibly disable vanilla Minecraft achievements.
- stats:
- disable-saving: true
- forced-stats:
- achievement:
- openInventory: 1
- world-settings:
- anti-xray:
- enabled: false # Helps with reducing lag; public servers should utilize an anti-cheat plugin.
-paper:
- settings:
- empty-server-suspend: P100D # Prevent the server from immediately suspending itself due to inactivity.
- world-settings:
- fix-cannons: true # Stops ignited TNT from moving in flowing water. Recommended when making maps that involves TNT.
- game-mechanics:
- disable-chest-cat-detection: true # Helps with reducing lag.
- optimize-explosions: true # Recommended when making maps that involves TNT.
-```
+### Configure the Server Software
+
+
+
+ Using your text editor of choice, you may edit `server.properties` and `sportpaper.yml`. We recommend changing the following options below to these values:
+
+ ```properties title="server.properties"
+ announce-player-achievements=false
+ generate-structures=false
+ ```
+
+ ```yml title="sportpaper.yml"
+ spigot:
+ # Forcibly disable vanilla Minecraft achievements.
+ stats:
+ disable-saving: true
+ forced-stats:
+ achievement:
+ openInventory: 1
+ world-settings:
+ anti-xray:
+ enabled: false # Helps with reducing lag; public servers should utilize an anti-cheat plugin.
+ paper:
+ settings:
+ empty-server-suspend: P100D # Prevent the server from immediately suspending itself due to inactivity.
+ world-settings:
+ fix-cannons: true # Stops ignited TNT from moving in flowing water. Recommended when making maps that involves TNT.
+ game-mechanics:
+ disable-chest-cat-detection: true # Helps with reducing lag.
+ optimize-explosions: true # Recommended when making maps that involves TNT.
+ ```
+
+
+ Using your text editor of choice, you may edit `spigot.yml` and `/config/paper-world-defaults.yml`. We recommend changing the following options below to these values:
+
+ ```yml title="spigot.yml"
+ # Forcibly disable vanilla Minecraft advancements.
+ advancements:
+ disable-saving: true
+ disabled:
+ - '*'
+ ```
+
+ ```yml title="/config/paper-world-defaults.yml"
+ anticheat:
+ anti-xray:
+ enabled: false # Helps with reducing lag; public servers should utilize an anti-cheat plugin.
+ entities:
+ behavior:
+ disable-chest-cat-detection: true # Helps with reducing lag.
+ environment:
+ optimize-explosions: true # Recommended when making maps that involves TNT.
+ fixes:
+ prevent-tnt-from-moving-in-water: true # Stops ignited TNT from moving in flowing water. Recommended when making maps that involves TNT.
+ ```
+
+
### Configure PGM
@@ -295,14 +345,27 @@ experiments:
### Load and Configure WorldEdit
-Some servers may choose to use [WorldEdit](https://dev.bukkit.org/projects/worldedit). Since SportPaper is based on Minecraft 1.8 server software, the latest compatible version of WorldEdit is [6.1.9](https://dev.bukkit.org/projects/worldedit/files/2597538).
+Some servers may choose to use [WorldEdit](https://dev.bukkit.org/projects/worldedit).
-Once the download is done, place `worldedit-bukkit-6.1.9.jar` inside the `plugins` folder and restart the server. Afterwards, you can navigate to `/plugins/WorldEdit/config.yml` and change the following option below to this value:
+
+
+ Since SportPaper is based on Minecraft 1.8 server software, the latest compatible version of WorldEdit is [6.1.9](https://dev.bukkit.org/projects/worldedit/files/2597538).
-```yml title="/plugins/WorldEdit/config.yml"
-# PGM will give observers with OP the "Rabbit's Foot" item, which allows them to edit the world during a match.
-wand-item: 414
+ Once the download is done, place `worldedit-bukkit-6.1.9.jar` inside the `plugins` folder and restart the server. Afterwards, you can navigate to `/plugins/WorldEdit/config.yml` and change the following option below to this value:
-# On newer WorldEdit versions in combination with newer Minecraft versions, it will be the item's name.
-wand-item: minecraft:rabbit_foot
-```
+ ```yml title="/plugins/WorldEdit/config.yml"
+ # PGM will give observers with OP the "Rabbit's Foot" item, which allows them to edit the world during a match.
+ wand-item: 414
+ ```
+
+
+ You can get the latest version of WorldEdit for Paper from [Modrinth](https://modrinth.com/plugin/worldedit/versions?l=paper).
+
+ Once the download is done, place the WorldEdit jar inside the `plugins` folder and restart the server. Afterwards, you can navigate to `/plugins/WorldEdit/config.yml` and change the following option below to this value:
+
+ ```yml title="/plugins/WorldEdit/config.yml"
+ # PGM will give observers with OP the "Rabbit's Foot" item, which allows them to edit the world during a match.
+ wand-item: minecraft:rabbit_foot
+ ```
+
+
diff --git a/docs/modules/gear/classes.mdx b/docs/modules/gear/classes.mdx
index 8e9b74a36..26fd51ce4 100644
--- a/docs/modules/gear/classes.mdx
+++ b/docs/modules/gear/classes.mdx
@@ -16,7 +16,7 @@ Players can then change their class in game with the `/class` command.
|---|---|---|
| `
` | A single player class. |
Class Sub-elements |
-##### Class Attributes
+#### Class Attributes
| Attribute | Description | Value | Default |
|---|---|---|---|
@@ -29,7 +29,7 @@ Players can then change their class in game with the `/class` command.
| `default` | Specify if the class is the default class for new players.
*One class must be set as the default.* |
true/false | false |
| `restrict` | If set to `true`, only operators can use this class. |
true/false | false |
-##### Class Sub-elements
+#### Class Sub-elements
| Element | Description | Value |
|---|---|---|
diff --git a/docs/modules/gear/items.mdx b/docs/modules/gear/items.mdx
index 8a9a05f2d..9cc478237 100644
--- a/docs/modules/gear/items.mdx
+++ b/docs/modules/gear/items.mdx
@@ -17,7 +17,7 @@ or on the [bukkit docs - Material](https://hub.spigotmc.org/javadocs/bukkit/org/
|---|---|
| `
- ` | A single item stack. |
-### Sub-Elements
+#### Sub-Elements
| Element | Description |
|---|---|
@@ -27,7 +27,7 @@ or on the [bukkit docs - Material](https://hub.spigotmc.org/javadocs/bukkit/org/
| ` ` | Materials that can be mined with the item |
| ` ` | Materials that the item can be placed on |
-### Item Attributes
+#### Item Attributes
| Attribute | Description | Value | Default |
|---|---|---|---|
@@ -54,7 +54,7 @@ or on the [bukkit docs - Material](https://hub.spigotmc.org/javadocs/bukkit/org/
| `show-other` | Show various other things in the item tooltip. | true/false | true |
Items can be give custom names and lore with the `name` and `lore` attributes.
-Colors and fancy text in item names or lore can be specified with the grave symbol `` ` `` and then the [formatting code](/docs/reference/misc/formatting).
+Colors and fancy text in item names or lore can be specified with the grave symbol `` ` `` and the [formatting code](/docs/reference/misc/formatting).
You can specify multiple lines of lore using a pipe symbol `|` for line breaks.
```xml
@@ -63,7 +63,7 @@ You can specify multiple lines of lore using a pipe symbol `|` for line breaks.