Skip to main content

Installing PivotPoly

This guide will walk you through installing and setting up PivotPoly on your server.

Download​

Get the latest version of PivotPoly from:

Prerequisites​

Before installing, ensure you meet these requirements:

RequirementMinimumRecommended
Minecraft1.21Latest 1.21.x
Server SoftwarePaper 1.21Purpur/Paper Latest
Java2121 Latest
RAM2GB4GB+

Installation Steps​

1. Stop Your Server​

Before installing or updating plugins, always stop your server:

/stop

2. Upload Plugin​

Place PivotPoly-1.0.jar into your server's plugins/ directory:

server/
├── plugins/
│   ├── PivotPoly-1.0.jar  ← Place here
│   └── ...

3. Start Server​

Start your server normally. PivotPoly will automatically:

  • Generate default configuration files
  • Initialize the door storage system
  • Register all commands and events

4. Verify Installation​

Check that PivotPoly loaded successfully:

In Console:

[INFO] Enabling PivotPoly v1.0
[INFO] PivotPoly has been enabled!

In-Game:

/plugins
# PivotPoly should appear in GREEN

First-Time Configuration​

Set Up Permissions​

Grant admin access to trusted players/staff:

# Using LuckPerms
/lp user <username> permission set pivotpoly.admin true

# Or for a group
/lp group admin permission set pivotpoly.admin true

Test Functionality​

  1. Get the wand:

    /pivotpoly wand

  2. Verify selection works:

    • Left-click a block (should see "Position 1 set" message)
    • Right-click a block (should see "Position 2 set" message)

  3. Create a test door:

    /pivotpoly create TestDoor

File Structure​

After first run, PivotPoly creates these files:

server/plugins/
└── PivotPoly/
    ├── config.yml       # Main configuration (if exists)
    └── doors.yml        # Door data storage

Updating PivotPoly​

To update to a newer version:

  1. Backup your server (especially plugins/PivotPoly/doors.yml)
  2. Stop the server
  3. Replace the old JAR with the new version
  4. Start the server
  5. Check console for any migration messages

Troubleshooting Installation​

Plugin Not Loading​

Symptoms: PivotPoly appears in RED in /plugins or doesn't load

Solutions:

  1. ✅ Verify you're using Paper 1.21+ (not Spigot/Bukkit)
  2. ✅ Check Java version: java -version (must be 21+)
  3. ✅ Review console for error messages
  4. ✅ Ensure JAR file isn't corrupted (re-download)

No Commands Available​

Symptoms: /pivotpoly command not recognized

Solutions:

  1. ✅ Verify plugin loaded successfully (/plugins shows GREEN)
  2. ✅ Check you have permission: /lp user <you> permission check pivotpoly.admin
  3. ✅ Try restarting the server

Wand Not Working​

Symptoms: Blaze rod doesn't set positions

Solutions:

  1. ✅ Ensure you received the wand from /pivotpoly wand (not a random blaze rod)
  2. ✅ Check for conflicts with other selection plugins (WorldEdit, etc.)
  3. ✅ Verify no errors in console when clicking blocks

Uninstallation​

To remove PivotPoly:

  1. Backup door data if you want to preserve it
  2. Remove all active doors (optional, to clean up entities): 
    # Delete all doors first if desired
    /pivotpoly list
    /pivotpoly delete <doorname>
  3. Stop the server
  4. Delete plugins/PivotPoly-1.0.jar
  5. Delete plugins/PivotPoly/ folder (if not preserving data)
  6. Start the server

Next Steps​

Need help? Join our Discord for support!