Slapper is an NPC plugin for PocketMine-MP servers. This ReinfyTeam-maintained fork preserves the upstream project identity, commands, permissions and addon ecosystem while porting the plugin to the API 5 contract.
- PocketMine-MP API
5.0.0or newer. - PHP 8.1 or newer for development and packaging.
The project is designed and supported for PocketMine-MP. Compatibility with unofficial variants is not promised. The campaign verification environment also tested the packaged plugin on Axolotl-PM 5.49.1; that is a tested environment, not a claim that every 5.x release is supported.
Official addons:
- /slapper [args...]
- /rca - Run command as another player! This can be used to only run the command if the player has permission.
- help: /slapper help
- spawn: /slapper spawn [name]
- edit: /slapper edit [id] [args...]
- id: /slapper id
- remove: /slapper remove [id]
- version: /slapper version
- cancel: /slapper cancel
- updateall: /slapper updateall
- helmet: /slapper edit helmet
- chestplate: /slapper edit
- leggings: /slapper edit leggings
- boots: /slapper edit boots
- skin: /slapper edit skin
- name: /slapper edit name
- addcommand: /slapper edit addcommand
- delcommand: /slapper edit delcommand
- listcommands: /slapper edit listcommands
- update: /slapper edit update
- block: /slapper edit block
- tphere: /slapper edit tphere
- tpto: /slapper edit tpto
- menuname: /slapper edit menuname <name/remove>
helmet: helm, helmet, head, hat, cap chestplate: chest, shirt, chestplate leggings: pants, legs, leggings boots: feet, boots, shoes item: hand, item, holding, arm, held skin: setskin, changeskin, editskin, skin name: name, customname menuname: listname, nameonlist, menuname namevisible: namevisible, customnamevisible, tagvisible, name_visible, custom_name_visible, tag_visible addcommand: addc, adduced, add command delcommand: delc, delcmd, delcommand, remove command listcommands: listcommands, listcmds, listcs fix: update, fix, migrate block: block, tile, blockid, tileid tphere: teleporthere, tphere, movehere, bringer tpto: teleportto, tpto, goto, teleport, tp
- Download the latest compatible
Slapper.pharfrom the ReinfyTeam releases. - Copy the PHAR into the server's
plugins/directory. - Start the server and review the startup log for the Slapper enable message.
- Grant the relevant
slapper.*permissions to operators or permission groups.
- Create and manage NPC entities through
/slapper. - Execute commands as another player through
/rca. - Configure entity names, skins, equipment, locations and command actions.
- Preserve Slapper entity data through the server's normal world save lifecycle.
- Integrate with the Slapper addon ecosystem listed above.
slapper— use all Slapper commands.slapper.command— use/slapper.slapper.create— create NPCs.slapper.edit— edit NPC data.slapper.remove— remove NPCs.slapper.id— view entity IDs.slapper.help— view help.slapper.rca— use/rca.slapper.nothing— use the no-op command.
The default permission for these nodes is operator. Confirm the exact command behavior and permission assignment on a staging server before applying a custom permission policy.
Install the locked development dependencies and run the repository's analysis command:
composer install
composer analyseThe build workflow uses DevTools to package and validate the plugin PHAR. The maintained workflow pins the builder revision used by CI; this README intentionally does not copy that CI pin into the user-facing installation guide.
Before a release, validate the PHAR manifest and checksum, load it in an isolated PocketMine-MP-compatible server data directory, and review the startup and shutdown logs. Do not test by overwriting a live server world or plugin_data directory.
The plugin manifest declares API 5.0.0. Minimum API, supported range and tested server versions are separate claims; see release notes and campaign verification records for exact commits and runtime evidence.
The campaign verification environment tested the packaged plugin on Axolotl-PM 5.49.1. This is a tested environment, not a claim that every 5.x release is supported.
Release artifacts and source history are published on the ReinfyTeam GitHub repository. Existing upstream attribution, LGPL-3.0-or-later licensing and original author credits are preserved in LICENSE.
Use the issue tracker for reproducible bugs and the ReinfyTeam Discord server for community discussion. Include the Slapper version, server version, relevant log output and a minimal reproduction. Do not report issues from modified installations as if they were tested release artifacts.
Slapper originated in the jojoe77777/Slapper project. The upstream author and project links are retained in the repository metadata and history. This fork is maintained by ReinfyTeam.
The project is licensed under LGPL-3.0-or-later.