SaicoCrates v1.0.1

SaicoCrates​

A feature-rich, fully customizable crates plugin with two unique animation styles, bonus reward system, and extensive GUI customization. Perfect for creating an engaging reward system on your server.

Key Features:​

- Dual Animation System​

• OG Animation: Classic full-border closing effect with red glass panels converging to center
• NEW Animation: Modern row-by-row closing with white glass while borders stay visible
• Configurable spin duration, slowdown curves, and closing speeds
• Dynamic sound effects with pitch variations per row

- Advanced Reward System​

• 3-Row Opening System: 2 regular reward rows + 1 bonus row
• Weighted Chance System: Configure individual win rates for each reward
• Flexible Rewards: Give items, execute commands, or both
• Broadcast System: Announce rare reward wins server-wide with custom messages
• No-Duplicate Protection: Fair distribution across all configured rewards

- Fully Customizable GUIs​

• Opening GUI: Configurable title, borders, reward indicators, and start buttons
• Preview GUI: Paginated reward browser with custom navigation buttons
• Separate display items and actual reward items
• Per-crate GUI configuration
• Custom lore additions showing chances and reward types

- Physical Crate System​

• Crate Placer Blocks: Give players blocks to place crate locations
• Holographic Text: Floating text above crates with custom lines and height
• NBT-Tagged Keys: Custom "charm" items to open crates
• Location Persistence: Crate locations save across restarts
• Sneak-to-Remove: Admins can remove crates by sneaking while breaking

- Per-Crate Configuration​

Each crate has its own YAML file with complete control over:

• Animation type (OG or NEW)
• GUI layout and items (borders, buttons, indicators)
• Key/charm appearance (material, name, lore, glow effect)
• Hologram settings (enabled, height, lines)
• Animation timings (duration, delays, stage speeds)
• Sound effects (type, volume, pitch)
• Reward pools (regular and bonus)

- Complete Message System​

• All messages configurable in messages.yml
• Sound effects per message
• Placeholder support (%player%, %crate%, %amount%, etc.)
• Multi-line message support
• Separate sender/receiver messages for commands

- Admin Commands​

/crate give <player> <crate> [amount] - Give keys to a player
/crate giveplacer <player> <crate> [amount] - Give crate placer blocks
/crate giveall <crate> [amount] - Give keys to all online players
/crate reload - Reload all configurations
/crate preview <crate> - will open the preview gui for the specified crate

• Full tab completion for all arguments
• Individual permissions per command
• Configurable main permission

- Technical Features​

• Cross-Version Support: Compatible with 1.8 - 1.21+ using XSeries
• No Dependencies: Standalone plugin, no external dependencies required
• Debug Mode: Built-in debugging for troubleshooting
• Lightweight: Optimized inventory handling and animations
• Lombok: Clean, maintainable codebase

What's Included:​

- Configuration Files​

• settings.yml - Global plugin settings and command configuration
• messages.yml - All player-facing messages with sounds
• crates/exampleog.yml - Example crate with OG animation
• crates/examplenew.yml - Example crate with NEW animation

- Pre-Configured Examples​

Both example crates include:

• Custom charm items with lore
• Crate placer blocks
• Hologram configuration
• Multiple rewards with different rarities
• Bonus reward system
• Broadcast messages for rare wins

Use Cases:​

• Donation Rewards: Give purchasers custom crate keys
• Event Prizes: Reward event winners with crates
• Daily Rewards: Create daily/weekly login reward crates
• Rank Rewards: Include rank upgrades or perks as possible rewards
• Economy Integration: Execute economy commands as rewards

Permissions:​

saicocrates.admin - Access to main admin command (configurable in settings.yml)
saicocrates.preview - preview the crates
saicocrates.give - Give keys to players
saicocrates.giveplacer - Give crate placers
saicocrates.giveall - Give keys to all online players
saicocrates.reload - Reload configurations

Why Choose SaicoCrates?​

No External Dependencies - Drop in and run
Two Unique Animation Styles - OG and NEW modes
Bonus Reward System - Extra prize chances
Fully Customizable - Every color, sound, and item
Cross-Version Compatible - 1.8 to 1.21+
Active Support - Regular updates and assistance
Lightweight & Optimized - No lag or performance issues
Physical Crate Blocks - Players place crates themselves
Hologram Support - Built-in floating text

Installation:​

1. Download SaicoCrates.jar
2. Place in your server's plugins/ folder
3. Restart server
4. Configure crates in plugins/SaicoCrates/crates/
5. Customize messages in messages.yml
6. Use /crate commands to test

Support & Updates:​

• Discord Support:
• Regular Updates: New features and bug fixes

Requirements:​

• Spigot/Paper 1.8 - 1.21+
• Java 8 or higher

Make your server stand out with a professional, engaging crate system!