PivotPoly [BETA]

PivotPoly is a powerful Minecraft plugin designed for creators, builders, and server owners who want to bring their builds to life with high-fidelity, smooth-animated mechanical structures.

[!WARNING] This project is currently in BETA. Systems are being actively refined, and you may encounter minor bugs. We recommend backing up your door configurations before major updates.

Key Features

• Smooth Animation System: Say goodbye to "snapping" movements. PivotPoly uses a high-performance tick-based interpolation system (20TPS) combined with client-side sub-tick smoothing to deliver fluid motion.
• Rigid Body Physics: Blocks move as a single synchronized unit. Whether it's a massive heavy door or a small hatch, the entire structure maintains its integrity during movement.
• Support for Multi-Stage Paths:
  • Swing Doors: Classic hinge-based rotation.
  • Slide Doors: Linear movement along X, Y, or Z axes.
  • Garage Doors: Realistic "Lift-and-Tuck" movement where the door slides up and then tucks away flat against the ceiling.
  • Drawbridges: Heavy vertical rotation for castle gates and bridges.
• Custom Easing Profiles: Choose how your structures move:
  • Smooth: Sine-based acceleration/deceleration for a natural feel.
  • Bounce: Energetic bounce-back effect upon completion.
  • Linear: Constant speed for mechanical precision.
• Interactive Collision: Invisible physical colliders move in perfect sync with the visual blocks, preventing players from walking through moving doors.
• In-Game GUI Manager: Configure sounds, easing, timers, and proximity triggers through an intuitive menu (/pp gui).

Installation

1. Ensure your server is running a modern version of Paper, Purpur, or Spigot (1.20.x+ recommended).
2. Drop PivotPoly.jar into your plugins folder.
3. Restart the server.

Getting Started

1. Use /pp wand to select the region of blocks you want to animate.
2. Select your hinge/pivot point.
3. Run /pp create <name> to define your new animated structure.
4. Access /pp gui to fine-tune the movement type and easing!