nqaaN's Crate Skript v2.0.1

Resolved a bug where crates with "require_key" set to false would proceed with the opening sequence even if the reward pool was empty or unconfigured. The system now properly validates the reward layout and halts execution with an appropriate warning before attempting to open.

I didn't just update the skript; I rewrote it completely from scratch.
The old system is gone. This massive update transforms the script into a modular, feature-rich powerhouse with 12,000+ lines of code, an advanced GUI Editor, and zero dependencies on Skellet.

• Complete Rewrite: The entire codebase has been completely rewritten from scratch. The old 1,500-line layout is replaced by a massive, optimized 6,500-line core script and 4 dedicated modules (animations, tabComplete, virtualCrate, virtualKey).
• Addon Optimization: Completely eliminated the dependency on Skellet, ensuring a lighter and more stable performance.
• Core GUI Editor: Added a comprehensive in-game editor to modify crate and key materials, glowing effects, and display information seamlessly.
• Advanced Messaging & Titles: Implemented granular control over open, loot, and fail actions, including custom screen titles (Opening/Loot/Fail) and chat broadcast options.
• Expanded Animations: Doubled the animation library. Upgraded from 13 layouts to an extensive selection of high-performance configurations and unique mechanical concepts.
• Preview & Display Settings: Added fully customizable preview menus with optional auto-row calculations, custom row layouts, and visibility toggles.
• Permission Guard: Integrated robust permission checking with customizable permission nodes and dynamic unauthorized action messages.
• Dynamic Mechanics: Added requirements for empty inventory slot checks, custom countdown intervals, and localized sound settings (private audio vs. ambient world radius).
• Economy & Key Integrations: Introduced gold payment requirements for opening crates, with advanced options to require keys alongside currency, plus dynamic insufficient funds handling.
• Crate Stock & Player Limits: Implemented a crate stock management system featuring auto-restock timers and per-player opening limit caps per cycle.
• Failed Actions & Knockback: Added a configurable knockback feature that physically repels players if they fail to meet opening requirements.
• Command-Based Holograms: Integrated a flexible, command-driven hologram support system with Y-Offset adjustments. It automatically creates, updates, and deletes text lines by executing commands from your preferred hologram plugin (DecentHolograms, FancyHolograms, etc.) via placeholders.
• Advanced Reward & Display System: Item drops now act as visual containers; clicking a display item opens its inner contents, allowing for multi-item or command rewards.
• Auto-Balance Logic: Added an optional mathematical chance balancer that automatically distributes winning percentages equally based on total reward counts, disabling manual adjustments.
• Particle & Visual Effects: Added a robust cosmetic system supporting granular particle types, counts, speed, XYZ-Delta offsets, and source origin points (crate or player), alongside lightning and firework triggers.
• Built-in Uninstaller: Added a secure cleanup feature to completely wipe all script parameters, crate data, and variable logs before safely disabling.
• Documentation Polish: Updated and restructured the "!Readme.txt" file for a flawless deployment of the new modular system.

IMPORTANT: Due to the sheer scale and complexity of this version (12,000+ lines of code), reloading the script may take longer than usual and print standard performance warnings in the console. These are natural alerts from the script engine and do NOT indicate any errors. Your script will function perfectly.

Resolved a bug that prevented the "/crate give" command from working when executed via the server console.

This major update focuses on security, performance, and a completely restructured file system.

• Version Support: Starting from this version, Minecraft 1.20 and all older versions are no longer supported.
• Animation Logic: Fixed the slow-down issue caused by menu spamming. Animations now run smoothly in real-time.
• Interface Improvements: The "1slot" animation now uses a Dispenser interface instead of a Chest for a more compact look.
• Directory Change: Moved all files to "plugins/Skript/scripts/nqaaN's Skripts/" for a cleaner and unified structure.
• Optimization: Significant code cleanup and logic improvements for better server performance.

IMPORTANT: Versions prior to this update are no longer supported. It is highly recommended to use the latest version to ensure system stability.

Some minor errors have been fixed.

Now fully tested and compatible with 1.21, 1.21.4, and 1.21.5.

I have completely overhauled the script to ensure a flawless experience.
This update focuses on fixing all known issues and simplifying the installation process.

• New Content: Added 2 new animations.
• Bug Fixes: Fixed all errors(Those I know) and added missing features/logic.
• New Resources: Included "Tested with" folder & detailed '!Readme.txt'.

Follow the new '!Readme.txt' for a flawless installation!