Minecraft plugin ExcellentCrates

🔌 About ExcellentCrates

ExcellentCrates — is a Minecraft plugin that provides a lightweight, feature‑rich and highly configurable crates system for Paper/Spigot servers. The plugin lets you create crate blocks and crate items, set rewards (items or commands), use virtual or physical keys, and present custom GUIs and holograms for openings.

🎯 Purpose

ExcellentCrates solves the problem of creating flexible reward systems (crates) without custom coding. It is designed to offer server owners a GUI editor, multiple reward types, rarity/weight systems and integration points with custom item plugins and economy plugins so crates can be used in minigames, survival servers or economy setups.

(Confirmed features and scope sourced from the plugin documentation and repo.)

⚙ Main features

• In‑game GUI editor to manage crates, rewards and keys. ()
• Support for custom items (ItemsAdder, Oraxen, MMOItems, ExecutableItems etc.) as reward items. ()
• Built‑in holograms and particle effects (requires ProtocolLib/PacketEvents for some hologram features). ()
• Physical and virtual keys; crate blocks and crate items. ()
• Multiple reward types: Item rewards, Command rewards, selectable rewards, rarities and weights, reward limits and logs. ()
• Mass open, open cooldowns, open cost (economy integration), per‑crate permission requirements. ()

🧩 Who is this for

ExcellentCrates is suitable for server owners and admins who need a flexible crate/reward system on Paper or Spigot servers. Use cases include:

• Survival servers with reward crates
• Minigames that give randomized or selectable rewards
• Economy servers that sell crate opens via currency
• Networks that want per‑crate permissions and customizable GUIs

🏗 Usage examples

• Create a "Daily Crate" with rarity tiers and a per‑player cooldown. (ExcellentCrates supports rarities, weights and cooldowns.) ()
• Give virtual keys via a rewards system so keys cannot be traded. (ExcellentCrates supports virtual keys.) ()
• Use a custom ItemsAdder item as a reward item and show a hologram above crate blocks (ProtocolLib/PacketEvents optional). ()

⌨️ Commands

Note: official pages and the plugin repo reference an in‑game GUI editor and many in‑game operations; the exact command nodes and full command list are documented in the plugin documentation or wiki. If you need command nodes, check the Documentation or GitHub issues. ()

🔐 Permissions

The README indicates that ExcellentCrates supports permission requirements per crate (i.e., crates can require permissions), but the repository and resource pages do not list all permission nodes. Consult the plugin documentation for the exact permission nodes. ()

⚙ Installation

📥 Installation

• Download the ExcellentCrates .jar from the official resource (Spigot/Hangar/Modrinth/GitHub releases). ()
• Place the ExcellentCrates.jar into your server's plugins/ folder.
• Restart the server (full restart). Do not rely on /reload.
• Install required dependencies (see below) before first run.

📦 Dependencies (confirmed)

• nightcore — REQUIRED (plugin engine used by ExcellentCrates). ()
• PlaceholderAPI — OPTIONAL (for placeholders). ()
• ProtocolLib or PacketEvents — OPTIONAL (used for holograms/advanced visuals). ()
• EconomyBridge / economy plugins — OPTIONAL (for open costs). ()

🧾 Configuration

• The official docs describe an in‑game GUI for editing crates; check the documentation for file locations and manual configuration steps. The repo and resource pages confirm a documentation/wiki for advanced configuration. ()
• Information about automatic generation of config.yml and database support (MySQL/SQLite) is not explicitly listed on the resource pages; consult the plugin documentation for details. ()

🧠 Additional information

⚠ Known limitations & compatibility

• Server software: Spigot/Paper supported; minimum server version cited as 1.21.8 or above in official resources. Java 21+ is recommended/required per the repo. Folia and Forge are not supported. ()
• The plugin requires the NightCore engine; installing ExcellentCrates without NightCore will prevent it from loading. ()
• Users have reported version‑compatibility issues in resource reviews—always match plugin version to server version and check changelogs. ()

❓ FAQ

Q: Does ExcellentCrates support custom item plugins (ItemsAdder, Oraxen)? A: Yes — the plugin lists support for several custom item systems. ()

Q: Is NightCore required? A: Yes — NightCore is a required dependency according to official release notes. ()

Q: Do I need ProtocolLib or PacketEvents? A: ProtocolLib/PacketEvents are optional but required for some hologram/visual features. ()

Q: Does ExcellentCrates collect anonymous stats (bStats)? A: Information about bStats is not visible in the primary README/resource pages; check the documentation or plugin config after installation. ()

Q: Is there Discord support for help? A: Yes — the author maintains a Discord community for support (link available on resource pages). For direct integration features, consult the docs. ()

🤝 When to use ExcellentCrates

Use ExcellentCrates when you need a modern, configurable crates system with GUI editing, support for custom items, and options for economy integration on Paper/Spigot servers. Confirm dependency installation (NightCore) and server version compatibility before deploying to production. ()