PowerNukkitX Server Administration Commands Guide

Contexte

PowerNukkitX stands out as a highly performant, cutting-edge software solution designed to power Minecraft Bedrock Edition servers. To efficiently lead your community and preserve the long-term structural integrity of your instance, mastering system and administration commands is essential.

This guide lists the fundamental PowerNukkitX core commands required to manage your infrastructure hosted at Winheberg. Whether you need to moderate disruptive behavior, alter the environment in real-time, or execute maintenance diagnostics, these instructions can be entered directly into the in-game text chat or via your management console.

Prerequisites

• An active game instance initialized within the PowerNukkitX environment.
• Functional access to your management panel at panel.winheberg.com.
• The assignment of operator privileges (OP status) if you plan to execute these directives from the in-game user interface.

1. Player Management and Moderation

The security and integrity of your server space rely on robust moderation tools. The table below summarizes the syntaxes required to restrict or grant access to your server.

Command	Syntax and System Action
/kick	/kick <player: selection> [reason: message] Immediately terminates a player's session and disconnects them.
/ban	/ban <player: id> [reason: id] Permanently bans the targeted user profile.
/ban-ip	/ban-ip <ip: id> [reason: id] or /ban-ip <player: id> Permanently restricts access from the associated network IP address.
/pardon	/pardon <player: selection> Unbans a user profile by lifting their name restriction.
/pardon-ip	/pardon-ip <ip: id> Revokes the network access restriction applied to an IP address.
/whitelist	/whitelist <add|remove> <player: selection> Adds or removes a profile from the exclusive access list.
/whitelist	/whitelist <on|off|list|reload> Toggles the global status, lists members, or reloads the whitelist configuration.
/op	/op <player: selection> Elevates a player's privileges to administrator (operator) status.
/deop	/deop <player: selection> Revokes a player's system operator privileges.

2. World and Environment Control

PowerNukkitX integrates advanced commands to manipulate weather management, time vectors, and the multi-world topology of your infrastructure.

Command	Syntax and System Action
/world list	/world list Indexes and displays all dimensions and worlds currently loaded into the RAM.
/world tp	/world <tp> <world|world_the_nether|world_the_end> Instantly transfers your position from one dimension to another.
/time set	/time <set> <day|night|midnight|noon|sunrise|sunset> Immediately alters the state of the game's internal clock.
/weather	/weather <clear|rain|thunder> [duration: int] Modifies weather conditions and sets their persistence in seconds.
/tickingarea	/tickingarea <add> <from: position> <to: position> [name: id] Forces the continuous loading and processing of a defined geographic zone.

3. Gameplay and Customization Commands

These variables modify the immediate experience of connected users or alter the default physical laws of the Minecraft engine.

Command	Syntax and System Action
/gamemode	/gamemode <survival|creative|spectator> [player: selection] Instantly changes the game mode allocated to a user.
/gamerule	/gamerule <rule> <true|false> Enables or disables fundamental world rules (domobspawning, dofiretick, etc.).
/give	/give <player: selection> <itemName> [amount: int] Injects a defined quantity of a specific item into the target's inventory.
/tp	/tp <victim: selection> <destination: selection> Moves a user to the exact coordinates of another entity.
/camera	/camera <players: selection> <clear|fade|set> Manipulates perspectives or applies visual fades onto a player's screen in real time.

4. Diagnostics and System Maintenance

To guarantee flawless runtime fluidity, our engineers invite you to regularly monitor the load status of your hardware resources.

Command	Syntax and System Action
/status	/status [full|simple|tps] Generates an analytical report of CPU/RAM usage and displays the precise TPS (Ticks Per Second) rate.
/plugins	/plugins Compiles the complete inventory of Java .jar extensions loaded by the PowerNukkitX core.
/save-all	/save-all Forces the immediate synchronous writing of world data onto the host's NVMe storage.
/stop	/stop Gracefully terminates the server process after correctly purging and closing active user sessions.

Troubleshooting

❌ Error Message: "You do not have permission to use this command"

• Cause: OP rights are either missing or improperly assigned to your profile.
• Resolution: Log in to your panel.winheberg.com panel, access the Console tab, and enter the following command (without the / character):

  op YourExactUsername
  

❌ Error Message: "Player not found"

• Cause: The username is misspelled, the user is offline, or their identifier includes special characters/spaces.
• Resolution: If the username contains a space, you must enclose it within double quotation marks in your syntax:

  /give "Username With Space" apple 64
  

Best Practices for Administration

• Database Security: Form the habit of running a /save-all command before shutting down your instance to commit inventory data and chunk states to the disk.
• Hardware Resource Preservation: Use the /tickingarea directive sparingly. Multiplying permanently loaded zones saturates processor usage and lowers the server's overall TPS.
• Log Cleanliness: Set the /gamerule commandblockoutput false rule to prevent command blocks from flooding your web console and log files with unnecessary repetitive entries.

Need Help?

If you encounter persistent malfunctions while executing system commands or if instabilities appear after loading a Java extension, our support teams are ready to help.

You can submit a support ticket to our Technical department from your client area at billing.winheberg.com by linking your PowerNukkitX subscription for personalized troubleshooting.

Happy configuring and have a great game on your Winheberg infrastructure! 🎮