👟Setting Sail

Discover how to make a server with Plazma.

To use Plazma reliably, yer system must meet the followin' requirements.

	Minimum	Recommended
Architecture	x64	-
RAM	8GB	16GB
Storage Space	1GB	8GB
JRE	17	21

For smooth configuration file edits, it be good to install an editor like Visual Studio Code.

---

1. JRE Installation

As the name suggests, Minecraft: "Java" Edition be developed in Java, so ye need to run it.

Plazma be based on Mojang Studios' official server platform, so ye also need to install JRE to use Plazma.

1.1 Checkin' for JRE

To check if JRE be installed on yer system, type cmd /k java --version in the Run window and run it.

If ye be seein' th' followin', skip t' 2 steps.

Proper Output

openjdk 21.0.2 2024-01-16 LTS
OpenJDK Runtime Environment Zulu21.32+17-CA (build 21.0.2+13-LTS)
OpenJDK 64-Bit Server VM Zulu21.32+17-CA (build 21.0.2+13-LTS, mixed mode, sharing)

If ye not be seein' like above, or be seein' like below, 'tis 'cause thar be no JRE or 'tis too old, so ye need t' perform 1.2 steps.

JRE Not Installed

'java' be not an internal or external command, nor be it a program or
batch file.

JRE Too Old

Unrecognized option: --version
Error: Could not create the Java Virtual Machine.
Error: A fatal exception has occurred. Program will exit.

1.2 JRE Install

In this here guide, we be usin' Azul Zulu as one o' th' types o' JRE.

After ye be finishin' installin', redo 1.1 steps t' make sure th' install be done rightly.

Windows

1. First off, download JDK 21 from Azul Zulu in .msi format.

2. Run the downloaded install wizard and click Next.

3. After activatin' Set JAVA_HOME variable in the menu displayed in the center-left o' the window, click Next.

4. Press Install t' complete the JRE install.

macOS

Azul Zulu to JDK 21 download the .dmg installation wizard and run to install JRE.

Debian/Ubuntu

First, add the Azul Zulu repository to APT by running the following command in the terminal.

sudo apt install gnupg ca-certificates curl --no-install-recommends --no-install-suggests -y

curl -s https://repos.azul.com/azul-repo.key | sudo gpg --dearmor -o /usr/share/keyrings/azul.gpg

echo "deb [signed-by=/usr/share/keyrings/azul.gpg] https://repos.azul.com/zulu/deb stable main" | sudo tee /etc/apt/sources.list.d/zulu.list

Then, run the followin' command in the terminal t' install JRE.

sudo apt install --no-install-recommends --no-install-suggests -y zulu21-ca-jre-headless

Fedora/RHEL

You can install JRE by entering the following command.

sudo dnf install -y https://cdn.azul.com/zulu/bin/zulu-repo-1.0.0-1.noarch.rpm

sudo dnf install -y zulu21-ca-jre-headless

---

2. Plazma Download

Plazma offers various types o' executable files.

In most cases, use Reobf Paperclip.

Th' followin' be fer developers or those curious 'bout each form's features. If ye be a regular user, ye can skip t' 3 steps without any issue.

Learn More

The name o' the executable file be plazma-(version manager)-1.20.4-R0.1-SNAPSHOT-(mappin' type).jar.

• Mappin' Type Mappin' be a kind o' map that connects Minecraft's actual code with the obfuscated code.

  • Reobf Reobfuscated (재난독화), Spigot 매핑으로도 불리며 대부분의 NMS 플러그인에서 사용됩니다. 1.20.5부터 사용이 종료될 예정입니다.

  • Mojmap Mojang-mapped, 바닐라 Minecraft 매핑입니다.

• Version Manager The version manager be a launcher necessary fer server operation, patchin' server files, and libraries.

  • Paperclip Developed by the PaperMC team fer Paper and other derivative platforms, it downloads libraries and applies patches t' the server.

  • Bundler The vanilla Minecraft version manager.

---

3. Start Script Creation

T' easily start Plazma and automatically restart the server, ye need t' create a .

Flags.shbe startin' yer script wit' . Plazma be enterin' only the and the command be optimized automatically.

Ye can download the start script by clickin' the download button at the bottom left. Make sure the downloaded start script matches yer operatin' system.

---

4. File Organization

Now, move the downloaded start script and Plazma t' a new folder.

The folder name must have no spaces and must be in English.

Otherwise, Plazma or JRE may not function correctly.

Now, run the start script. For Windows, in the firewall permission prompt, be sure to select Allow.

---

5. EULA Agreement

Once ye run the start script, a eula.txt file will be created in the folder.

The be a license agreement ye must agree t' by usin' the services o' .

If ye do not agree, ye canna start the server, and if ye violate the EULA, ye may be subject to sanctions such as account suspension.

T' agree t' the EULA, change eula=false in the eula.txt file t' eula=true and save it.

---

6. Allow External Connections (Windows)

Modern operatin' systems block external access by default t' prevent risky access from outside via the firewall and router.

For Windows, since th' firewall be allowed in 3 steps, ye just need t' do port forwardin'.

This here guide be assumin' ye be havin' a Windows operatin' system 'n a router that can use UPnP.

If yer router does not support UPnP, ye must search fer the specific panel fer each router, as they vary.

Alternatively, ye can use Ngrok t' generate a temporary address.

For Linux or macOS, or other (semi-)UNIX based operating systems, firewall configuration methods vary by service, so you must research directly.

6.1 Checkin' the Need fer Port Forwardin'

Enter the followin' in the run window and execute it.

powershell -noexit -c "((Get-NetIPConfiguration).IPv4Address).IPAddress -eq (Invoke-WebRequest "ifconfig.me").content"

If the output be True, ye be good t' go, but if it be False, ye need t' set up port forwardin'.

6.2 Connectin' t' the Server

External Access

If port forwarding is not needed, or if port forwarding has already been successful, you can now connect to the server.

The address t' connect t' the server can be found here.

UPnP로 포트포워딩 시도

서버 폴더의 purpur.yml에서, network.upnp-port-forwarding을 true로 활성화합니다.

Then, after restartin' the server, Plazma will automatically attempt port forwardin'.

The success o' UPnP will be determined by the message output t' the console, which will be displayed as [UPnP] (message).

Message	Meanin'
Successfully opened port (port)	Port forwardin' successful.
Port (port) is already open	Another service be usin' that port.
Failed t' open port (port)	Port forwardin' failed.
Service be unavailable	The router does not support UPnP.

When the server shuts down, Plazma will automatically close the port.

Ngrok으로 임시 주소 생성

Ngrok을 이용한 방법은 단기적인 테스트, 참여형 또는 친구들과 함께 플레이하기에 유용합니다.

1. Download the Windows (64-bit) ZIP file from the Ngrok website.

2. Place the downloaded Ngrok in the server folder.

3. Generate an authentication token from the Ngrok dashboard.

4. Run the command displayed in the Command Line section in the server folder.

5. Add start /b ngrok tcp --region jp 25565 at the top o' the run script, and taskkill /f /t /im ngrok.exe at the bottom.

6. At the tippity top o' th' console be showin' Forwardin' tcp://0.tcp.jp.ngrok.io:12345 -> localhost:25565, 'n 0.tcp.jp.ngrok.io:12345 becometh th' server's address.

7. Ye can now connect through that address from th' outside.

로컬에서 접속

로컬에서 서버에 접속하려고 하는 경우, 실행 창에서 cmd /k ipconfig를 실행하여 출력된 IPv4 주소 로 접속할 수 있습니다.

For example, if 'tis shown as follows after runnin' th' command,

Windows IP Configuration

Ethernet adapter Ethernet:

    Connection-specific DNS Suffix  . . . . . : 
    IPv4 Address. . . . . . . . . . . : 192.168.3.7
    Subnet Mask . . . . . . . . . . . : 255.255.255.0
    Default Gateway . . . . . . . . . : 192.168.3.1

Ye can connect t' th' server from yer local machine by attemptin' t' connect t' th' 192.168.3.7 shown in th' IPv4 address.

If th' server 'n th' game be runnin' on th' same PC, ye can connect usin' localhost.

7. Thrivin'

Once ye have successfully started th' server 'n 'tis runnin' properly, 'tis time t' customize th' server.

Learn how t' customize yer server through th' followin' guide.

🎨발전하기

---