Switch Language
  1. PowerNukkitX
  2. Get Started
  3. Config

    1. server.properties
    2. nukkit.yml
    3. pnx-cli-config.ini
    4. Anti-xray
    5. Resource Encryption
    6. Compression Acceleration
    7. PNX with WaterDogPE
    8. Flat World
  4. FAQ

    1. To Newcomers
    2. How to use PNX-CLI
    3. Common Questions
    4. Terra Questions
    5. Spawn-point Questions
    6. Convert Worlds
  5. For Devs

    1. Java

      1. Goto JavaDoc
      2. Mod API

        1. Custom Block
        2. Custom Item
        3. Custom Entity
        4. Custom Enchantment
      3. Entity AI

        1. Behavior
        2. Memory
        3. Sensor
        4. Motion Controller
        5. Navigator
        6. Behavior Group
        7. Work Cycle
    2. JavaScript

      1. setup dev env
      2. Base LLSELib dev
      3. Hello World
      4. Basic knowledge
      5. Event Listener
      6. FAQ
    3. Resources

      1. Event List
      2. IDs(block & item)

Common Questions


Simple solution

Prepend -jar before --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED in your start command.
For example:

Java17\bin\java --add-opens java.base/java.lang=ALL-UNNAMED --add-opens java.base/java.io=ALL-UNNAMED -jar powernukkitx-

Full solution

Check the following parts of the error stacktrace:

module A does not "opens B" to unnamed module @C

Add -add-opens A/B=ALL-UNNAMED (the content in A/B is the name of the module in question, see the following example) before the start command -jar, and do this for each different error report


If the error is reported as: module java.base does not "opens java.lang" to unnamed module @?????? then the parameter configuration would be

--add-opens java.base/java.lang=ALL-UNNAMED


Install Java17. Download

java.net.BindException: Address already in use: bind


Windows solution

Win+R opens the Run window, type cmd in the window to open the command window that comes with Windows

netstat -ano|findstr 19132

Enter the above command to check if the port is occupied, the number 19132 represents the port Example:

C:\Users\Administrator>netstat -ano|findstr 19132
  UDP          *:*                                    12228

Find the corresponding UDP number for port 12228 and enter the following command in the Windows command window to unlock port 19132

taskkill /f /t /im 12228

Linux solution

Enter the following command in the command box

netstat -tln | grep 19132

Check the corresponding system PID number to end the process using the following command

kill -9 PID

java.lang.NoClassDefFoundError: org/objectweb/asm/Type

If you are using pnx-cli,please use the following command to update dependent libraries.

pnx libs update

If you are using shaded core,please download the latest core in github action.


If the error log contains the following content:

java.io.IOException: Unable to acquire lock on '......players/LOCK'

It means that you have opened at least two identical PNX programs on the same path at the same time. Please close the one you started earlier.
If you don't even know how to close a program, please restart your server to solve the problem and learn how to use your operating system correctly.

All players are offline at the same time

This may be caused by the following reasons:

Please check the above reasons first. If you really can't solve it, you can turn to QQ group or Discord server for help.

DOS error/errno=1455

The page file is too small to complete the operation DOS error/errno=1455

This happens when the JVM asks the operating system for memory, and the operating system cannot give more memory.
When PNX starts, the available memory configured by default will be slightly less than the maximum available physical memory space at that time. If it is exceeded, GC will be performed and JVM internal error will be thrown instead of applying for more memory from the operating system. This happens only when the maximum available physical memory space data that PNX calculates does not match the actual memory size. If the machine memory is too small, or some core displays with too much reserved space (usually with laptops) are used, the proportion of hardware reserved memory is too large to cause this problem. This problem can also be caused by over-opened virtual machines.

You can try to solve this problem in the following ways:

How to disable the automatic restart

Waiting 10 seconds for automatic restart after shutdown is the default feature of PNX-CLI. You can turn this off by adding 'start' after the startup command.

For example:

# Native PNX-CLI on Windows
.\pnx start
# Native PNX-CLI on Linux
./pnx start
# Jar version of PNX-CLI
java -jar PNX-CLI.jar start

© PowerNukkitX Dev team