AgiraCrates is a customizable and modular crate plugin developed for Minecraft servers. Built on the AgiraLib infrastructure, the system aims to go beyond traditional crate plugins by combining custom 3D models, animations, reward management, holograms, and security mechanisms under a single roof.Development Status: Active development / Test build Latest Version: v1.3 LanguageSafe Target Minecraft Versions: 1.16.5 and above Tested Version: Paper 1.21.11 Platform: Paper-first Language Support: Turkish and English Integration: ItemsAdder Infrastructure: Java, Gradle, SQLiteModular Plugin InfrastructureAgiraCrates: Manages crates, rewards, animations, and player operations.AgiraLib: Used for common functions, item operations, and ItemsAdder integration.Modular Java project structure.Source codes buildable via Gradle.Configuration via YAML.SQLite-based data storage.Architecture aimed at increasing compatibility across server versions.Crate Management SystemStructure designed to support an unlimited number of crates.Creating new crates in-game.Changing crate names and icons.Managing crate settings via GUI.Listing all crates in a single management menu.Paged crate management panel.Crate deletion and confirmation screen.Linking crates to world blocks or furniture.Removing crate links without deleting the model or block.Storing crate settings in YAML files.Crate InteractionsRight-click: Opening a crate using a key.Left-click: Viewing the reward preview menu.Shift + Left-click: Removing the crate link with administrator privileges.Permission checks specific to crate operations.Controls to prevent the same interaction from being processed twice.Fixes to prevent normal environmental blocks from being accidentally recognized as crates.Advanced Crate Animations Five different animation types:ROULETTE: Classic roulette where rewards move horizontally.PULSE: Reward display in the center with color-changing panels.MYSTERY: Mysterious cards and surprise reward display.SPIRAL: Circular, spiral-looking reward animation.CASCADE: Gradually changing inventory animation. Additional visual features:Adjustable animation duration.Slowing down at the end of the animation.Glass panel colors varying according to rarity.Crate opening sounds.Winning particle effects.Custom result screens.Selection of different animations per crate.Reward and Rarity System Five different reward rarities:COMMON: Common — White.RARE: Rare — Light blue.EPIC: Epic — Purple.LEGENDARY: Legendary — Orange.MYTHIC: Mythic — Magenta. Reward features:Defining Minecraft items as rewards.Using ItemsAdder custom items as rewards.Granting rewards via console commands.Preserving meta information of enchanted and custom-named items.Editing reward quantities.Adding and removing rewards.Paged reward list.Changing reward rarity.Displaying winning odds as a percentage.Editing reward percentages out of a total of 100%.Applying visual effects based on rarity.Physical and Virtual Key SystemPhysical keys specific to crate types.SQLite-backed virtual key balance.Commands to give keys to players.Key balance check.ItemsAdder custom key models.Key validation system.HMAC-SHA256 signing for physical keys.Defining unique UUIDs for keys.Disabling used keys from reuse via records.Security controls against opening multiple crates simultaneously.ItemsAdder and 3D Crate IntegrationAbility to use ItemsAdder furniture as crates.Interaction with custom 3D crate models.ArmorStand-based furniture support.Integration for ItemsAdder furniture interaction events.Fixes to support interaction from different sides of the furniture.Matching furniture with crate IDs.ItemsAdder custom key and reward models.Usage alongside normal Minecraft crates. Note: 3D animations where the actual model lid opens and closes are currently among the development goals.Hologram SystemHologram display above the crate.Displaying crate name and reward count.Key requirement information.Toggling holograms on/off per crate.Hologram lines via YAML.Hologram height adjustment.Variables: %crate%, %id%, %rewards%.Working via ArmorStand name tags without requiring a separate hologram plugin.Security and Reward Delivery SystemSQLite transaction logs.Pre-determining rewards during crate opening.Reward delivery status tracking.Database operations during virtual key consumption.Signed physical key verification.Re-use prevention checks.Preventing simultaneous crate openings per player.Delivery command for pending rewards.Reward delivery queue for players with full inventories.Directing delivery operations left ambiguous during server shutdown to administrative review.Administrator key distribution logs. Security status: While these mechanisms have been developed, not all concurrency, server crash, and data recovery scenarios have been independently verified. Especially, full atomicity between physical inventory operations and SQLite is not guaranteed.Turkish and English Language Systemtr_TR.yml Turkish language file.en_US.yml English language file.English standard commands.Language selection from configuration.Customizing player messages.Infrastructure to translate GUI titles and descriptions.Editing hologram texts.Messages supporting color codes.Safe from / to structure for translations with punctuation marks.Logging and fallback mechanism in case of language file loading errors. The language system is actively under development; the translation scope of some dynamic texts is being further tested.Command System Base commands have been updated to the English standard.CommandDescription/crates editorCrate management panel/crates create Create a new crate/crates open Open a crate/crates preview Preview rewards/crates givekey Give a physical key/crates givevirtual Give a virtual key/crates bindfurniture Bind furniture to a crate/crates hologram on/offControl holograms/crates claimClaim pending rewards/crates reloadReload configurationCommands work according to permissions and respective crate settings.Development Roadmap Planned upcoming features:Real 3D crate lid animations.Advanced Pity (guaranteed reward) system.Bulk crate opening.Animation skip options.Crate opening statistics.Detailed player history.Reward stock and limits.Vault economy integration.PlaceholderAPI integration.MySQL/MariaDB support.Special crate events.Reward collection system.Extended API for developers.Comprehensive automated tests across different Minecraft versions.Project Status AgiraCrates is a custom Minecraft crate plugin under active development.During the development process, core features such as creating crates, distributing rewards, animations, ItemsAdder furniture interactions, and holograms have been tested in-game on Paper 1.21.11.However, all recent security and language infrastructure updates have not yet undergone comprehensive production testing.Our goal is to deliver a performant, flexible, visually advanced, and professional crate system that server administrators can easily use.

AgiraCrates — More than just a crate.