## Release 1.14 - The Editor & Customization Update This update adds more control over pedestal appearance, easier editing, and live recipe previews. ### New Features - **Hologram Height Controls:** Separate height settings for pedestals with and without recipes, configurable through the GUI and `config.yml`. - **Expanded Particle Controls:** Adjust circle radius, height, speed, type, density, and color, including custom HEX colors. - **Collision Barrier Toggle:** Enable or disable the physical 1 × 1 × 2 barrier while keeping the pedestal clickable. - **Reset Buttons:** Restore hologram settings, particle settings, or the entire appearance without changing recipes or gameplay. - **Appearance Presets:** Save and apply complete designs, including holograms, particles, collision, and animations. - **Undo Last Change:** Reverse editor changes, moves, or preset applications through the GUI or `/pedestal undo [name]`. - **Recipe Preview:** Preview missing ingredients, ready ingredients, or your actual inventory. Simulated previews are visible only to the inspecting admin. ### Bug Fixes - **Centered Particle Circles:** Fixed circles appearing off-center around pedestals. - **Barrier Cleanup:** Fixed leftover barriers when moving, disabling, deleting, or discarding a pedestal. - **Settings Persistence:** New appearance settings survive restarts and cloning. - **Preview Cleanup:** Recipe previews and unsaved editor drafts clear when players leave or disconnect. ### Improvements & Technical Changes - **Organized Editor:** Controls are grouped into Recipe, Appearance, and Gameplay pages. - **Live Adjustments:** Hologram and particle changes preview immediately. - **Chunk Handling:** Particle circles skip unloaded chunks, including neighboring chunks. - **Safer Editing:** Chat edits run on the server thread, preset saves run in the background, and GUI clicks and drags respect menu boundaries. - **Build Verification:** Added Java 21 build checks and 12 passing regression tests. ## Upcoming Update - Easier Crafting Clicks - **Larger Crafting Hitbox:** Increased the click target to **1.5 × 1.5 × 2.5 blocks**, making the pedestal and floating reward easier to target. Physical collision remains **1 × 1 × 2 blocks**.

## Release 1.12 - The Design & Smoothness Update This update gives pedestals a visual overhaul: new shapes and themes, a cleaner editor, smoother animations, and optional visual extras. ### New Features - **New Shapes:** Twelve more simple or unusual silhouettes (Plinth, Column, Obelisk, Spire, Altar, Ziggurat, Rustic, Verdigris, Ossuary, Geode, Bamboo, Cherry). The template menu is now paged so every template shows. - **New Themes:** Nine built-in design themes (Minimal, Arcane, Nether, Frost, Gilded, Overgrown, Abyss, Ember, Void) are installed as templates (`themes.install-defaults`). Apply them from Design Templates. - **Name Without Recipe:** Pedestals with no recipe now show their name/custom name hologram (toggle with `show-name-without-recipe` in `config.yml`). - **Optional Visuals (all off by default):** New `visuals:` section in `config.yml` - ingredient progress bar, "ready to craft" banner, hologram pop-in, idle particles, ground ring, craft sequence, discovery reveal, and per-pedestal rarity tiers (Display Settings > Rarity Tier). - **GUI Sounds:** Click, page-turn, save and delete sounds in the editor menus (`gui.sounds`). ### Bug Fixes - **Theme Fix:** Applying a theme no longer drops the item under the pedestal. ### Improvements & Technical Changes - **GUI Cleanup:** Tighter button layout, a dark interior inside the frame so buttons stand out, shorter button text, and on/off dots on toggles. - **Smoother Animation:** Spin, pulse and orbital motion now use client-side interpolation (updates every 2 ticks) for smoother visuals with far fewer packets. - **Performance:** Animations and text updates skip pedestals with no nearby players; hologram text is only re-sent when it changes; chunk checks no longer force-load chunks.

# 26.* SUPPORT IS UNTESTED ANY BUGS PLEASE REPORT! # Pedestals - Core 1.8 ## Release 1.8 - The Reliability Update This update fixes pedestals losing their interaction hitbox after dimension travel, most commonly reported in the Nether. ### Bug Fixes - **Missing Hitbox After Dimension Travel:** Fixed pedestals permanently losing their interaction hitbox (and sometimes their displays) when rapid chunk load/unload cycles - such as those caused by Nether portal linking - caused the plugin's one-time delayed chunk-load respawn check to miss its window. ### Improvements & Technical Changes - **Self-Healing Core Displays:** Block displays, the item display, and the interaction hitbox now reconcile automatically about once per second, adopting or respawning anything missing without duplicating existing entities. This mirrors the self-healing already in place for orbitals, extended to the pedestal's core structure.

## Release 1.7 - The Stability & Integration Update This update fixes a long-standing orbital display bug and adds the persistence and third-party integration players and admins have been asking for. ### New Features - **Persistent Craft History:** Multi-step recipe prerequisites are now saved to `craft-history.yml` and survive server restarts, instead of resetting every session. - **PlaceholderAPI Support:** New soft-dependency exposing `%pedestals_total%`, `%pedestals_crafts_<name>%`, and `%pedestals_cooldown_<name>%` for scoreboards, tab lists, and other plugins. ### Bug Fixes - **Orbital Loot Preview Duplication:** Fixed a bug where floating loot-table item displays could duplicate into hundreds of entities or freeze in place after a chunk unload/reload. - **Cross-Chunk Drift:** Orbitals that drifted across a chunk boundary are now tracked and cleaned up correctly instead of becoming permanent orphans. ### Improvements & Technical Changes - **Throttled Self-Healing:** Orbitals now reconcile (adopt/clean up/top off) at most once per second per pedestal instead of every tick, removing the runaway-duplication risk while staying cheap on performance. - **Restart-Safe Orbitals:** Orbitals are now restored automatically on pedestal/chunk load instead of being disabled after load.

# Pedestals - Core 1.6 ## Release 1.6 - The Customization & Analytics Update This update focuses on deep visual personalization for your pedestals and the introduction of advanced metrics to track server performance and player engagement. ### New Features - **Custom Display Names:** Override the default blue-gradient item names with your own custom strings. - **The "@hand" Shortcut:** Instantly clone the exact name, colors, and formatting from the item in your hand by typing `@hand` during rename. - **Improved GUI Workflow:** Dedicated **Custom Display Name** button added to the **Display Settings** menu. - **bStats Integration:** Track total pedestals, popular types, and discovery status. - **Reset/Clear Command:** Revert any custom name back to the premium default by typing `reset` or `clear`. ### Improvements & Technical Changes - **Rendering Priority:** Holograms now prioritize custom names while maintaining smooth animations. - **Dynamic Recipe Headers:** Recipe views now respect custom names while preserving the styling. - **Maven Optimization:** Enhanced shading and relocation for zero library conflicts. - **Persistence Layer:** Integrated custom name storage within `pedestals.yml`.

# Release 1.5 - The Mechanics & Customization Update This update introduces advanced pedestal mechanics, deep visual customization, and powerful administration tools to elevate your server experience. ## New Features * **Infusion Pedestals**: Introduce advanced crafting networks where a central pedestal is empowered by surrounding supporting pillars. * **Dynamic Sizing**: Configure pedestals in **Small**, **Medium**, or **Large** sizes to fit any build setup perfectly. * **Invisible Bases**: Added option to hide the pedestal structure entirely for floating or embedded item displays. * **Multi-Step Crafting**: Create progressive journeys by chaining pedestals together utilizing new prerequisite requirements. * **Randomized Outputs**: Configure tables with item weights and quantity ranges to reward varying items from a loot table. * **Orbital Displays**: Items from the randomized loot table orbit smoothly around the pedestal center. * **Dynamic Animations**: Added customizable **Breath** and **Pulse** hover animations for displayed items. * **Deep Customization**: Adjust display item scale, rotation speeds, and specific Y-offsets for exact placement. * **Enhanced Particle Rings**: Fully configurable particle effects supporting specific types, hex RGB colors, speed, and radius settings. * **XP Cost Support**: Charge players in either **Levels** or **Points** to access pedestal rewards or yields. * **Cooldown Management**: Pace your server economy with individual and global cooldown timers. * **Discovery Mechanic**: Introduce exploration elements where players discover pedestals entering range for alerts. * **Design Templates**: Save complete designs with `/pedestal template save <name>` and replicate setups universally. * **Batch Utility Commands**: New bulk commands for `enableall`, `disableall`, and `resetall` maintenance tasks. * **Craft Logs**: Integrated diagnostic logs for checking usage and yields over time. ## Technical Details * Enhanced entity cleanup safeguards introduced to prevent legacy or ghost displays during spawning sequences.

# Release 1.0 - Initial Release This is the first public release of Pedestals! ## New Features - Core Pedestal System: Initial implementation of the pedestal framework. - Management GUI: A robust interface for administrators to configure pedestals in-game. - Command API: Full suite of /pedestal commands for management and maintenance. - Configuration Support: Initial 'config.yml' for message customization and branding. - Item Utilities: Integrated support for custom item handling and recipe validation. - Sound and Visuals: Integrated SoundPalette and ColorPalette for a premium feel. ## Technical Details - Built for Minecraft 1.21 (Paper/Spigot). - Requires Java 21 or higher.