NetherPortalFix Installation Guide

Requirements

Prerequisites

• JDK 21 or higher
• Recommended to use Luminol server
• Leaves server has this feature built-in, no installation needed

Installation Methods

Quick Install

Step 1: Download Plugin

Go to GitHub Releases to download the latest .jar file.

Step 2: Place Plugin

Put the downloaded .jar file into the server's plugins folder.

server_root/
├── plugins/
│   └── AkiAsyncNetherPortalFix-x.x.x.jar  <-- Place here
├── server.jar
└── ...

Step 3: Enable Mixin

Add the following JVM parameter to your server startup script:

-Dleavesclip.enable.mixin=true

Complete startup command example:

java -Xms4G -Xmx4G -Dleavesclip.enable.mixin=true -jar server.jar nogui

Step 4: Restart Server

Restart the server, and the plugin will automatically load and generate configuration files.

Build from Source

Step 1: Clone Repository

git clone https://github.com/virgil698/Aki-Async-NetherPortalFix.git
cd Aki-Async-NetherPortalFix

Step 2: Build Project

Linux/macOS

./gradlew build

Windows

gradlew.bat build

Step 3: Get Build Output

After successful build, the plugin JAR file will be generated in the build/libs directory.

Step 4: Deploy Plugin

Place the generated .jar file into the server's plugins folder, enable Mixin following the quick install steps, and restart the server.

:::

Verify Installation

After server startup, you can verify the plugin is loaded correctly by:

1. Check console logs for any errors
2. Run /plugins command to view plugin list
3. Check if configuration files are generated in plugins/AkiAsyncNetherPortalFix/ directory

Configuration File

After first load, the plugin will generate configuration files in plugins/AkiAsyncNetherPortalFix/ directory:

# Enable plugin
enabled: true
# Teleport record expiry time (seconds)
record-expire-time: 3600

Next Steps

• View FAQ
• Back to Introduction