Minecraft plugin CrazyCrates

🔌 About CrazyCrates

CrazyCrates — is a Minecraft plugin for Paper/Spigot servers that adds configurable crates (lootboxes), keys and opening animations to reward players.

🎯 Purpose

CrazyCrates addresses the need for a flexible reward/lootbox system on Minecraft servers. It lets server owners create many crate types with custom prizes, visual effects and behaviors to increase player engagement without modifying core gameplay.

• For what it is: adds virtual and physical crates and keys, GUI and animation-based openings, and prize execution features. (Confirmed in official project pages.)

⚙ Main features

• Unlimited crate definitions (multiple crate types).
• Support for virtual keys and physical key items.
• Multiple crate opening styles/animations (GUI, physical chest, wheel, etc.).
• Ability to run commands as prizes and grant items/ranks.
• Integration points / API for other plugins (official repo provides an API module).
• Placeholders / metrics support (plugin exposes placeholders; uses bStats for anonymous stats collection).

These features are documented in the project's official distribution pages and repository.

🧩 Who it's for

• Server owners who want a configurable reward system.
• Paper/Spigot networks and minigame servers that use crates for giveaways, voting rewards, or player progression.
• Administrators who need an API or integration for custom systems.

🏗 Usage examples

• Create a "Vote Crate" that gives random rewards when players vote.
• Use a virtual key economy where players buy keys from a shop plugin (Vault-compatible setups common).
• Link crate openings to mini‑events with commands that give ranks or run custom server commands.

⌨️ Commands

The plugin exposes player and admin commands. (The list below is aggregated from official project pages and distribution notes.)

If a command above is not present in your installed build check the plugin's documentation or release notes; commands and nodes have changed between forks/versions.

🔐 Permissions

Note: permission node structure and defaults are derived from the official project repository and distribution pages. Exact node names or defaults can vary by release — check your installed plugin version's docs for precise values.

⚙ Installation

📥 Installation

• Download the plugin .jar from an official distribution (GitHub / CurseForge / Modrinth / Hangar).
• Place the .jar into your server's plugins/ folder.
• Restart the server (do not use /reload).
• On first run the plugin will create its data and config folders.

📦 Dependencies

• Paper or Spigot server (plugin targets Paper‑compatible APIs).
• Common integrations: Vault (if you use economy interactions), PlaceholderAPI (for placeholders).
• The plugin uses bStats for anonymous metrics (optional; can be disabled in config).

Only include listed dependencies if your chosen crate features require them; the plugin can run without some integrations but specific features (economy commands, placeholders) may need them.

🧾 Configuration

• The plugin generates a config folder and files on first run (e.g. plugins/CrazyCrates/ and config.yml / crate files).
• Many options are editable: crate types, prize lists, messages, sounds, animation settings.
• The plugin supports running commands as prize effects and saving data in flat files; some builds may offer database options — check your release notes for MySQL/SQLite support.

🧠 Additional information

Known conflicts & limitations

• Crate-related features that run commands or grant ranks may require integration with other plugins (permissions, economy). Ensure compatibility with your versions of Vault, LuckPerms, PlaceholderAPI, etc.
• When using proxy/proxy‑like setups (BungeeCord/Velocity) verify multi‑server behavior; not all crate features are multi‑server aware by default.
• Because multiple forks/versions of "CrazyCrates" exist historically, ensure you downloaded the correct official build for your server core.

FAQ

Q: Does CrazyCrates collect usage statistics? A: Yes — the plugin uses bStats for anonymous metrics by default; this can be disabled in the config.

Q: Is there an API for other plugins? A: The official repository includes an API module to allow integrations; check the GitHub project for developer docs.

Q: Can crates run server commands or give ranks? A: Yes — prizes can execute commands and grant items/ranks if configured. Integration with your permissions/economy plugin may be required.

Q: Which server core is required? A: The project targets Paper/Spigot APIs (Paper recommended). Always verify the release notes for exact supported Minecraft versions.

Support / Community

• Official distribution and source are available through the project's GitHub, CurseForge, Modrinth and Hangar pages. Use the project's issue tracker on GitHub for bug reports.

🤝 When to use CrazyCrates

If you want a configurable, animated crate system (virtual or physical keys) for a Paper/Spigot Minecraft server with API hooks and placeholders, CrazyCrates is a practical choice. Verify the exact release for your Minecraft version and review the plugin's docs before production deployment.