SnDevelopmentCommands
On this page(3)
The root command is /playerwarp, with the aliases /pwarp, /pw and /pwarps. The aliases live in command.aliases in config.yml and are re-read on /playerwarp reload. Bare /playerwarp opens the warp browser when presentation.main is gui, and prints the help when it is chat.
Player commands
| Command | Description |
|---|---|
/playerwarp | Opens the warp browser, or prints the help with presentation.main: chat. |
/playerwarp menu | Opens the warp browser. |
/playerwarp create <name> [display...] | Creates a warp where you stand. display is its styled title; the name is used when you leave it out. Aliases: new, set. |
/playerwarp visit <player> [warp] | Visits a player's warp. With several open warps and no name, a picker opens. Aliases: go, v. |
/playerwarp <player> [warp] | Same as visit. |
/playerwarp delete <warp> [confirm] | Deletes one of your warps. A warp featured in a sponsor slot needs confirm, because deleting it gives the slot up. Alias: remove. |
/playerwarp update <warp> | Moves one of your warps to where you stand. Aliases: setlocation, move. |
/playerwarp rename <warp> <display...> | Changes the title of one of your warps. |
/playerwarp open <warp> | Opens one of your warps to visitors. |
/playerwarp close <warp> | Closes one of your warps to visitors. |
/playerwarp manage | Opens the menu of your warps. Alias: mine. |
/playerwarp ban <player> | Bans a player from all of your warps. |
/playerwarp unban <player> | Lets a banned player visit your warps again. A name shared by several banned players opens the bans menu so you pick one. |
/playerwarp help [page] | Shows the commands you can use. |
Each player command has its own node: menu, help and the bare root need snplayerwarps.use, create needs snplayerwarps.create, and visit needs snplayerwarps.visit. delete, update, rename, open, close and manage need snplayerwarps.manage, and ban and unban need snplayerwarps.ban. Every node is granted by default. See Permissions.
Moving a warp to the block and facing it already has, or renaming it to its current title, is refused and charges nothing. Turning to face a new direction on the same block is a real move.
Admin commands
Every staff command sits under /playerwarp admin, which has its own help: /playerwarp admin help. A staff subcommand needs snplayerwarps.admin plus its own node.
| Command | Permission | Description |
|---|---|---|
/playerwarp admin manage <player> | snplayerwarps.admin.manage | Manages the warps of a player in the menus. |
/playerwarp admin info <player> [warp] | snplayerwarps.admin.info | Shows the warps of a player, or one warp in detail. |
/playerwarp admin tp <player> [warp] | snplayerwarps.admin.tp | Teleports to a warp at once, skipping every visit check. |
/playerwarp admin delete <player> <warp> [-s] | snplayerwarps.admin.delete | Deletes a warp of a player. |
/playerwarp admin deleteall <player> [-s] | snplayerwarps.admin.deleteall | Deletes every warp of a player. |
/playerwarp admin rename <player> <warp> <display...> | snplayerwarps.admin.rename | Changes the title of a warp of a player. |
/playerwarp admin move <player> <warp> | snplayerwarps.admin.move | Moves a warp of a player to where you stand. |
/playerwarp admin lock <player> <warp> [reason...] | snplayerwarps.admin.lock | Locks a warp: hidden, not visitable and frozen for its owner, who may still delete it. |
/playerwarp admin unlock <player> <warp> | snplayerwarps.admin.unlock | Unlocks a warp. |
/playerwarp admin setvisits <player> <warp> <amount> | snplayerwarps.admin.setvisits | Sets the visit count of a warp. |
/playerwarp admin setprice <slot> <price> | snplayerwarps.admin.setprice | Sets the price of a sponsor slot and writes it to config.yml. |
/playerwarp admin setsponsor <slot> <player> <warp> [duration] | snplayerwarps.admin.setsponsor | Features a warp in a sponsor slot for free. |
/playerwarp admin clearsponsor <slot> [refund] | snplayerwarps.admin.clearsponsor | Frees a sponsor slot. refund pays back its unused time. |
/playerwarp admin purge <days> [confirm] | snplayerwarps.admin.purge | Deletes the warps of owners inactive for that many days. Without confirm it only counts them. |
/playerwarp admin validate | snplayerwarps.admin.validate | Checks every warp for problems and prints a report. |
/playerwarp reload | snplayerwarps.admin.reload | Reloads config.yml, the language file and the menus. |
/playerwarp debug | snplayerwarps.admin.debug | Toggles the debug output. |
The -s flag skips the owner and staff notices. It needs snplayerwarps.admin.silent.
What validate reports
/playerwarp admin validate lists:
- warps in worlds that are not loaded, or that the world rules no longer allow;
- warps whose owner is no longer part of their island;
- warps on spots the safety check refuses (only in loaded chunks);
- sponsored warps that are closed to visitors.
With the inactivity purge on, it also shows what its next run would delete.
These commands are destructive and cannot be undone: /playerwarp admin delete, /playerwarp admin deleteall and /playerwarp admin purge <days> confirm.