Add a Custom Item to Your Server

Define the Item in Configuration

Custom items in PowerNukkitX are defined through server configuration files. Create or edit your item definition file to specify the item's properties: internal name, display name, texture, stack size, and any special attributes like durability or enchantability.

Register the Item

Once your item definition is complete, the server reads it during startup. Place your configuration in the designated items folder within your server directory. Restart the server to load the new item into the game world.

Test in-Game

After restart, use the /give command to spawn your custom item:

`

/give @s [item_name]

`

Replace [item_name] with the internal name you defined. The item should appear in your inventory with the correct name and texture. If it doesn't appear, check your configuration file for syntax errors and verify the file is in the correct folder.

Distribute to Players

Once tested, all players joining your server will automatically receive the item definitions. No client-side installation is needed—PowerNukkitX handles distribution through the server connection.