PivotPoly Commands
Complete reference for all PivotPoly commands with examples and usage.
Command Syntax
All commands start with /pivotpoly or the shorter alias /pp.
/pivotpoly <subcommand> [arguments]
/pp <subcommand> [arguments] # Shorter alias
Command List
/pivotpoly or /pp
Description: Shows help menu with all available commands
Permission: pivotpoly.admin
Aliases: pp
Usage:
/pivotpoly
/pp
Output: Displays formatted help menu with command list
/pivotpoly wand
Description: Gives you the selection wand (Blaze Rod) to define door regions
Permission: pivotpoly.admin
Usage:
/pivotpoly wand
/pp wand
Wand Controls:
- Left-Click: Set Position 1 (first corner)
- Right-Click: Set Position 2 (opposite corner)
- Shift + Right-Click: Set Pivot Point (rotation center)
Example Output:
[PivotPoly] Received PivotPoly Wand (Blaze Rod).
[PivotPoly] L-Click: Pos1 | R-Click: Pos2 | Shift+R-Click: Pivot
/pivotpoly create <name>
Description: Creates a new animated door from your current selection
Permission: pivotpoly.admin
Arguments:
<name>- Unique name for the door (required)
Usage:
/pivotpoly create CastleGate
/pp create MainEntrance
/pp create SecretDoor
Example Output:
[PivotPoly] Door "CastleGate" created successfully!
Requirements:
- Must have selected Position 1, Position 2, and Pivot Point with the wand
- Door name must be unique
Notes:
- Selected blocks are converted to Block Display entities
- Original blocks are removed
- Door data is automatically saved
/pivotpoly delete <name>
Description: Permanently deletes an animated door
Permission: pivotpoly.admin
Arguments:
<name>- Name of the door to delete (required)
Usage:
/pivotpoly delete CastleGate
/pp delete OldDoor
Example Output:
[PivotPoly] Door deleted.
Tab Completion: Suggests existing door names
Warning: This action cannot be undone! Consider using blueprints to backup door designs.
/pivotpoly list
Description: Lists all created animated doors on the server
Permission: pivotpoly.admin
Usage:
/pivotpoly list
/pp list
Example Output:
-------- Animated Doors --------
- CastleGate
- MainEntrance
- SecretDoor
- VaultDoor
/pivotpoly edit <doorName>
Description: Restores door blocks to physical form for editing
Permission: pivotpoly.admin
Arguments:
<doorName>- Name of the door to edit (required)
Usage:
/pivotpoly edit CastleGate
/pp edit MainDoor
What it does:
- Removes BlockDisplay entities
- Restores original blocks
- Keeps your selection active for modifications
- Allows you to recreate with same name after changes
Tab Completion: Suggests existing door names
/pivotpoly gui
Description: Opens the main PivotPoly GUI interface
Permission: pivotpoly.admin
Usage:
/pivotpoly gui
/pp gui
GUI Features:
- Browse all created doors
- Configure door settings (rotation angle, speed, sounds)
- Delete doors with confirmation
- Access door management tools
/pivotpoly blueprint <save|paste> <doorName> <blueprintName>
Description: Save door designs as blueprints or paste them
Permission: pivotpoly.admin
Usage:
Save a Blueprint:
/pivotpoly blueprint save CastleGate castle_gate_blueprint
/pp blueprint save SecretDoor my_secret_design
Paste a Blueprint:
/pivotpoly blueprint paste NewDoor castle_gate_blueprint
/pp blueprint paste CopyDoor my_secret_design
Arguments:
<save|paste>- Action to perform<doorName>- Door to save (for save) or new door name (for paste)<blueprintName>- Name of the blueprint file
Tab Completion:
- Action:
save,paste - Door names for save action
Command Permissions
All commands require the pivotpoly.admin permission by default.
See Permissions for detailed permission configuration.
Command Examples
Creating Your First Door
# Step 1: Get the wand
/pp wand
# Step 2: Select region
# (Use the blaze rod to left-click, right-click, shift+right-click)
# Step 3: Create the door
/pp create MyFirstDoor
# Step 4: Check it was created
/pp list
Managing Multiple Doors
# Create several doors
/pp create FrontGate
/pp create BackDoor
/pp create SidePanels
# List all doors
/pp list
# Edit one if needed
/pp edit FrontGate
# Make changes...
/pp create FrontGate # Recreate with updates
# Delete unused door
/pp delete SidePanels
Using Blueprints
# Create and save a reusable design
/pp create TemplateGate
/pp blueprint save TemplateGate gate_template
# Copy to multiple locations
/pp blueprint paste NorthGate gate_template
/pp blueprint paste SouthGate gate_template
/pp blueprint paste EastGate gate_template
Tab Completion
PivotPoly supports tab completion for:
- ✅ Subcommands (
wand,create,delete, etc.) - ✅ Door names (for
delete,edit,blueprint save) - ✅ Blueprint actions (
save,paste)
Press Tab while typing to see suggestions!
Common Command Patterns
| Task | Commands |
|---|---|
| Quick door creation | /pp wand → select → /pp create <name> |
| Door modification | /pp edit <name> → modify → /pp create <name> |
| Door cleanup | /pp list → /pp delete <name> |
| Template creation | /pp blueprint save <door> <template> |
Troubleshooting Commands
| Issue | Solution |
|---|---|
| Command not found | Verify plugin loaded: /plugins (should be GREEN) |
| No permission | Check permission: pivotpoly.admin required |
| Name already exists | Use /pp delete <name> first or choose different name |
| No selection | Use /pp wand and select positions before creating |
Next: Learn about Permissions to customize access control