Difference between revisions of "Server installation/en"

Latest revision as of 02:28, 25 September 2023

Other languages:

English • ‎español • ‎français • ‎português • ‎português do Brasil

This guide will cover installing Pixelmon to a server.

If you are looking for instructions on installing Pixelmon client-side (for singleplayer or joining an existing server), check out the Installation page. If you plan on installing other mods alongside Pixelmon, be sure to check the incompatibilities list first to avoid issues.

Requirements

At least 3 GB of allocated memory, preferably more. Exact requirements will depend on player count and your exact mods/plugins.
A 64-bit Java 8 version. Earlier or later versions of Java will not work!

Notes

This guide is meant to explain local hosting, which generally means only people on your own local network can connect! See below.
- If you wish to open your local server to remote connections, check out this page.
- For bigger servers, using a paid hosting service is strongly recommended for performance, stability and safety. Steps may differ, there.
If you are using Turkish as your system language, you may see a Fatally missing registry entries error when trying to connect, and some things may not work correctly on the server's end. This is a Forge issue. Changing the system language to English should work around this issue.
The startup parameters mentioned in this guide were taken directly from Aikar's excellent startup flags guide, and are optimized for performance. Check out the linked post for an explanation on why these are worth using.

Versions

Pixelmon is compatible with several versions of Minecraft, shown in the table below. Each version of Minecraft requires a different version of Pixelmon to be used. Note that versions of Pixelmon for older versions of Minecraft will no longer receive updates or bug fixes.

There is no Pixelmon version for Minecraft version 1.11.

Players connecting to a server must use the same version of Pixelmon that the server is using. If their version differs, they will be shown a "Mod Rejection" error and will be unable to join.

Minecraft version	Pixelmon version
1.12.2	8.1.2
1.10.2	5.1.2
1.8.9	4.3.1
1.8	4.1.4
1.7.10	3.5.1

Step 1: Forge installation

Find the current recommended Forge build on this page.
Download the "Installer" file and run it.
- Note: Some Windows setups may need Forge 2847's "Installer-win" file from "Show all Versions" instead. Try this if nothing happens.
Select "Install server" and pick the location you want your server installed to, and then click "OK".
- Note: The location chosen here will contain your server's files. An easily accessible folder is recommended!
Open the folder that you installed Forge to. Proceed with the steps for your specific operating system.

Starting on Windows

If you haven't already, enable showing file extensions by following this guide.
Within the server's base ("root") folder, create a new file named start.bat or something similar.
- Note: You can give the file another name, but make sure it ends in .bat.
Right click this file, and click Edit.

Copy the following contents into the file:

java -Xms3G -Xmx3G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=100 -XX:+DisableExplicitGC -XX:TargetSurvivorRatio=90 -XX:G1NewSizePercent=50 -XX:G1MaxNewSizePercent=80 -XX:G1MixedGCLiveThresholdPercent=50 -XX:+AlwaysPreTouch -jar forge-[VERSION].jar nogui
PAUSE

Replace [VERSION] with the version of Forge you installed. Make sure the file name is an exact match!
If necessary, change the amount of allocated memory (-Xmx3G) and the minimum (-Xms3G) to your desired amount.
Save the file and double-click it to start the server.

Starting on macOS/Linux

Open the Terminal or its equivalent.
Navigate to the home folder by using cd ~. Use ls to show the folders accessible from your current location.
Find the folder you installed Forge to. Use cd FOLDERNAME to enter a folder, and cd .. to go back up one level.

In the Terminal, enter (copy and paste) the following command, but do not run it yet:

java -Xms3G -Xmx3G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=100 -XX:+DisableExplicitGC -XX:TargetSurvivorRatio=90 -XX:G1NewSizePercent=50 -XX:G1MaxNewSizePercent=80 -XX:G1MixedGCLiveThresholdPercent=50 -XX:+AlwaysPreTouch -jar forge-[VERSION].jar nogui

Replace [VERSION] with the version of Forge you installed. Make sure the file name is an exact match!
Copy the command somewhere safe for later use.
Run the command to start the server.

Step 2: Accepting the EULA

Check the console. You should see a message stating that the server has been stopped.
In the server's root folder, open the newly generated eula.txt file with a text editor.
Read Minecraft's End User License Agreement carefully.
If you agree, change eula=false to eula=true, and save the file.
Start the server again, and wait for it to create a fresh world.

Step 3: Installing Pixelmon

The -server jar is located on the main Pixelmon site underneath the downloads button. The red line indicates the link that is to be pasted into your browser for the download to commence.

Shut down the server by typing stop into the console and hitting the "Enter" key.
In the server's root folder, open the mods folder.
Download Pixelmon from this link and drop it in. Do not extract or otherwise change this file!
- Note: Pixelmon comes in both -universal and -server variants. The -server file (from the link below the buttons) is smaller and may include additional fixes, but will only work on servers.
Start the server again. Your server should now be running Pixelmon!

Step 4: Configuring Pixelmon

With Pixelmon running, you should now have a config folder in the server root. Open this.
Find and open the pixelmon.hocon file with a proper text editor, such as Notepad++.
Tweak to taste. Some settings will only apply to fresh chunks, so make sure you set those now.
- Note: To avoid loot drain over time, be sure to change spawnMode under PokeLoot now!
When done, use the /pokereload command. Some changes may require a server restart.

Optional: Sidemod installation

This section is optional. If you do not want to use any Pixelmon sidemods, skip this part of the guide.

View the sidemods page for a list of sidemods that are compatible with your version of Pixelmon.
If you find an interesting sidemod, check its wiki page for a list of requirements and fulfill them.
- Note: Sidemod configuration files are generally created alongside Pixelmon's own config.
Visit the Pixelmon downloads page to grab the files you want.
After downloading a sidemod, drop its .jar file into your server's mods folder.
- Note: You will need to restart the server for it to load up any new mods/sidemods.

Note that many sidemods require a plugin platform like SpongeForge (covered below) as well as a permissions plugin like LuckPerms. Be sure to check the requirements!

Optional: SpongeForge installation

This section is optional. If you do not want to use plugins or sidemods that rely on SpongeForge, skip this part of the guide.

Download the recommended SpongeForge build from this page.
Drop the downloaded SpongeForge .jar into your server's mods folder.
Restart the server again.

You can now install plugins and sidemods that rely on SpongeForge. To find plugins, please visit this page.

Troubleshooting

If you need any further help, head on over to the Pixelmon Discord and drop your questions in #server-support.
If you are using SpongeForge, be sure to read the SpongeForge documentation on the Sponge site.
If you are having issues with a site-listed sidemod, report the issue to the sidemods bug tracker.

@@ Line 1: / Line 1: @@
-<seo metakeywords="Pixelmon, Reforged, server, installation, install, Minecraft, Forge, SpongeForge, local" metadescription="A guide to installing Pixelmon on a (local) server."/>
+{{#seo:
+ |title=Server installation
+ |title_mode=replace
+ |keywords=Pixelmon, Reforged, server, installation, install, Minecraft, Forge, SpongeForge, local
+ |description=A guide to installing Pixelmon on a (local) server.
+}}
 <languages/>
 This guide will cover installing [[Pixelmon]] to a server.
-If you are looking for instructions on installing Pixelmon client-side (for singleplayer or joining an existing server), check out the [[Installation]] page.
+If you are looking for instructions on installing Pixelmon client-side (for singleplayer or joining an existing server), check out the [[Installation]] page. If you plan on installing other mods alongside Pixelmon, be sure to check the [[incompatibilities list]] first to avoid issues.
 == Requirements ==
-* At least 3 GB of available (and allocated) RAM, preferably more.
+* At least 3 GB of allocated memory, preferably more. Exact requirements will depend on player count and your exact mods/plugins.
-** Exact requirements will depend on your player count, and which plugins/mods you install.
+* A 64-bit Java 8 version. '''Earlier or later versions of Java will not work!'''
-* A 64-bit Java 8 version.
 == Notes ==
 * This guide is meant to explain local hosting, '''which generally means only people on your own local network can connect!''' See below.
-** If you wish to open your local server to remote connections, check out [https://minecraft.gamepedia.com/Tutorials/Setting_up_a_server#Port_forwarding this page].
+** If you wish to open your local server to remote connections, check out [https://minecraft.wiki/Tutorials/Setting_up_a_server#Port_forwarding this page].
-** For bigger servers, using a paid hosting service is strongly recommended for performance, stability and safety.
+** For bigger servers, using a paid hosting service is strongly recommended for performance, stability and safety. Steps may differ, there.
-*** If you are using such a service, installation steps may differ. Check with your host for the specifics.
+* If you are using Turkish as your system language, you may see a <code>Fatally missing registry entries</code> error when trying to connect, and some things may not work correctly on the server's end. This is a Forge issue. Changing the system language to English should work around this issue.
-* This guide will only cover installing Forge and Pixelmon, along with some common extras. Other mods may work, but will not be covered here.
+* The startup parameters mentioned in this guide were taken directly from [https://forums.spongepowered.org/t/optimized-startup-flags-for-consistent-garbage-collection/13239 Aikar's excellent startup flags guide], and are optimized for performance. Check out the linked post for an explanation on why these are worth using.
-** If you are installing other mods alongside Pixelmon, check the [[incompatibilities list]] first to avoid issues.
-* The Pixelmon .jar file is universal, meaning that the same file can be used on both clients and servers. A smaller server-specific file is also available, which is missing files that a server would never use. Files with "-server" in the name will not work on things that aren't servers.
 ==Versions==
@@ Line 31: / Line 33: @@
 |-
 |style="text-align:center"|1.12.2
-|style="text-align:center"|6.2.3+
+|style="text-align:center"|8.1.2
 |-
 |style="text-align:center"|1.10.2
@@ Line 47: / Line 49: @@
 == Step 1: Forge installation ==
-# Find the recommended Forge version on [https://files.minecraftforge.net this page].
+# Find the current recommended Forge build on [https://files.minecraftforge.net/maven/net/minecraftforge/forge/index_1.12.2.html this page].
-# Depending on your operating system, download either "Installer-win" (Windows) or "Installer" (macOS/Linux).
+# Download the "Installer" file and run it.
-#* ''Note: Make sure you download Forge 2655 or earlier. Newer versions currently break Pixelmon.''
+#* ''Note: Some Windows setups may need Forge 2847's "Installer-win" file from "Show all Versions" instead. Try this if nothing happens.
-# Run the downloaded installer, select "Install server", pick the location you want your server installed to, and then click "OK".
+# Select "Install server" and pick the location you want your server installed to, and then click "OK".
-#* ''Note: The location chosen here will contain your server's files. An easily accessible folder is recommended.''
+#* ''Note: The location chosen here will contain your server's files. An easily accessible folder is recommended!''
 # Open the folder that you installed Forge to. Proceed with the steps for your specific operating system.
 ==== Starting on Windows ====
-# If you haven't yet, enable the showing of file extensions by following [https://www.bleepingcomputer.com/tutorials/how-to-show-file-extensions-in-windows/ these steps].
+# If you haven't already, enable showing file extensions by following [https://www.bleepingcomputer.com/tutorials/how-to-show-file-extensions-in-windows/ this guide].
 # Within the server's base ('''"root"''') folder, create a new file named <code>start.bat</code> or something similar.
 #* ''Note: You can give the file another name, but make sure it ends in <code>.bat</code>.''
 # Right click this file, and click <code>Edit</code>.
 # Copy the following contents into the file:
-#: <pre>java -Xmx3G -Xms3G -jar forge-[VERSION]-universal.jar nogui&#10;PAUSE</pre>
+#: <pre>java -Xms3G -Xmx3G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=100 -XX:+DisableExplicitGC -XX:TargetSurvivorRatio=90 -XX:G1NewSizePercent=50 -XX:G1MaxNewSizePercent=80 -XX:G1MixedGCLiveThresholdPercent=50 -XX:+AlwaysPreTouch -jar forge-[VERSION].jar nogui&#10;PAUSE</pre>
-# Replace <code>[VERSION]</code> with the version of Forge you installed. Example:
+# Replace <code>[VERSION]</code> with the version of Forge you installed. Make sure the file name is an exact match!
-#: <pre>java -Xmx3G -Xms3G -jar forge-1.12.2-14.23.3.2655-universal.jar nogui&#10;PAUSE</pre>
 # If necessary, change the amount of allocated memory (<code>-Xmx3G</code>) and the minimum (<code>-Xms3G</code>) to your desired amount.
 # Save the file and double-click it to start the server.
 ==== Starting on macOS/Linux ====
-# Open the Terminal or its equivalent and navigate to the folder you installed Forge to.
+# Open the Terminal or its equivalent.
-# In the Terminal, enter the following command but do not run it yet:
+# Navigate to the home folder by using <code>cd ~</code>. Use <code>ls</code> to show the folders accessible from your current location.
-#: <pre>java -Xmx3G -Xms3G -jar forge-[VERSION]-universal.jar nogui</pre>
+# Find the folder you installed Forge to. Use <code>cd FOLDERNAME</code> to enter a folder, and <code>cd ..</code> to go back up one level.
-# Replace <code>[VERSION]</code> with the version of Forge you installed. Example:
+# In the Terminal, enter (copy and paste) the following command, but do not run it yet:
-#: <pre>java -Xmx3G -Xms3G -jar forge-1.12.2-14.23.3.2655-universal.jar nogui</pre>
+#: <pre>java -Xms3G -Xmx3G -XX:+UseG1GC -XX:+UnlockExperimentalVMOptions -XX:MaxGCPauseMillis=100 -XX:+DisableExplicitGC -XX:TargetSurvivorRatio=90 -XX:G1NewSizePercent=50 -XX:G1MaxNewSizePercent=80 -XX:G1MixedGCLiveThresholdPercent=50 -XX:+AlwaysPreTouch -jar forge-[VERSION].jar nogui</pre>
+# Replace <code>[VERSION]</code> with the version of Forge you installed. Make sure the file name is an exact match!
 # Copy the command somewhere safe for later use.
 # Run the command to start the server.
@@ Line 83: / Line 85: @@
 == Step 3: Installing Pixelmon ==
-# Shut down the server by typing <code>/stop</code> into the console and hitting the "Enter" key.
+[[File:Serverjarlink.PNG|thumb|300px|The -server jar is located on the main [https://reforged.gg Pixelmon] site underneath the downloads button. The red line indicates the link that is to be pasted into your browser for the download to commence.]]
+# Shut down the server by typing <code>stop</code> into the console and hitting the "Enter" key.
 # In the server's root folder, open the <code>mods</code> folder.
-# Download the most recent version of Pixelmon, and drop it into this folder.
+# Download Pixelmon from [https://reforged.gg this link] and drop it in. '''Do not extract or otherwise change this file!'''
-#* '''Do not extract or otherwise change this file!'''
+#* ''Note: Pixelmon comes in both -universal and -server variants. The -server file (from the link below the buttons) is smaller and may include additional fixes, but will only work on servers.
 # Start the server again. Your server should now be running Pixelmon!
-# To customize your server, you can use Pixelmon's [[config]] file, located in the <code>config</code> folder.
-# ''Note: Changes made to the config generally require a server restart to take effect.''
+== Step 4: Configuring Pixelmon ==
+# With Pixelmon running, you should now have a <code>config</code> folder in the server root. Open this.
+# Find and open the <code>pixelmon.hocon</code> file with a proper text editor, such as [https://notepad-plus-plus.org/downloads/ Notepad++].
+# Tweak to taste. Some settings will only apply to fresh chunks, so make sure you set those now.
+#* ''Note: To avoid loot drain over time, be sure to change <code>spawnMode</code> under <code>PokeLoot</code> now!''
+# When done, use the <code>/pokereload</code> command. Some changes may require a server restart.
 == Optional: Sidemod installation ==
 ''This section is optional. If you do not want to use any Pixelmon [[sidemods]], skip this part of the guide.''
 # View the [[sidemods]] page for a list of sidemods that are compatible with your version of Pixelmon.
-# If you find a sidemod that looks interesting, check its page for a list of requirements and fulfill them.
+# If you find an interesting sidemod, check its wiki page for a list of requirements and fulfill them.
 #* ''Note: Sidemod configuration files are generally created alongside Pixelmon's own [[config]].''
 # Visit the Pixelmon [https://pixelmonmod.com/downloads.php downloads page] to grab the files you want.
@@ Line 100: / Line 108: @@
 #* ''Note: You will need to restart the server for it to load up any new mods/sidemods.''
+Note that many sidemods require a plugin platform like SpongeForge (covered below) as well as a permissions plugin like [https://github.com/lucko/LuckPerms LuckPerms]. Be sure to check the requirements!
-Most sidemods need, at a minimum, SpongeForge (covered below) as well as a permissions plugin like [https://github.com/lucko/LuckPerms LuckPerms].
 == Optional: SpongeForge installation ==
 ''This section is optional. If you do not want to use plugins or sidemods that rely on SpongeForge, skip this part of the guide.''
-# Download a SpongeForge build that matches your Forge version from [https://www.spongepowered.org/downloads/spongeforge/stable/1.12.2 this page].
+# Download the recommended SpongeForge build from [https://www.spongepowered.org/downloads/spongeforge/stable/1.12.2 this page].
-#* ''Note: To find out which Forge version a specific SpongeForge build is built for, check the second number in the file's name.''
 # Drop the downloaded SpongeForge .jar into your server's <code>mods</code> folder.
 # Restart the server again.
 You can now install plugins and sidemods that rely on SpongeForge. To find plugins, please visit [https://forums.spongepowered.org/c/plugins/plugin-releases this page].

Difference between revisions of "Server installation/en"

Difference between revisions of "Server installation/en"

Latest revision as of 02:28, 25 September 2023

Contents

Requirements

Notes

Versions

Step 1: Forge installation

Starting on Windows

Starting on macOS/Linux

Step 2: Accepting the EULA

Step 3: Installing Pixelmon

Step 4: Configuring Pixelmon

Optional: Sidemod installation

Optional: SpongeForge installation

Troubleshooting