# About
![|800x400](img/brand/logo.png)

Welcome to **ExcellentCrates** documentation! Follow the steps below to get up and running.

!!!warning
The **v7** documentation is work in progress...
!!!

## :icon-phs-toolbox: Prerequisites

You **must** have the [NightCore](https://nightexpressdev.com/nightcore/) framework plugin installed.

The following versions and platforms are supported:

{.compact}
| **Server Version**  | **Paper** | **Spigot** | **Folia** | **Java Version**
| :---: | :---: | :---: | :--: | :---: |
| 26.4 | :heavy_check_mark: | :heavy_check_mark: | :x: | 25 |
| 26.3 | :heavy_check_mark: | :heavy_check_mark: | :x: | 25 |
| 26.2 | :heavy_check_mark: | :heavy_check_mark: | :x: | 25 |
| 26.1 | :heavy_check_mark: | :heavy_check_mark: | :x: | 25 |
| 1.21.11 | :heavy_check_mark: | :heavy_check_mark: | :x: | 25 |

[!card layout="snap" title="Download NightCore" icon="phs-gear-six" target="blank"](https://nightexpressdev.com/nightcore)
[!card layout="snap" title="Download Paper" icon="brands-papermc" target="blank"](https://papermc.io/downloads/paper)
[!card layout="snap" title="Download Spigot" icon="brands-spigotmc" target="blank"](https://www.spigotmc.org/link-forums/downloads.31)

- Anything not listed in the compatibility table is **NOT** supported.
- Make sure to check out all known issues and incompatibilities [here](/faq/).

**Optional Plugins:**
- [PacketEvents](https://spigotmc.org/resources/80279/) - For crate holograms.
- [PlaceholderAPI](https://spigotmc.org/resources/6245/) - For global placeholders to use in other plugins.

---

## :icon-phs-download: Installation

**ExcellentCrates** can be downloaded for free from the following platforms:

- [SpigotMC](https://www.spigotmc.org/resources/48732/)
- [BuiltByBit](https://builtbybit.com/resources/130473/)
- [PixelEast](https://pixeleast.com/product/excellentcrates)
- [Modrinth](https://modrinth.com/plugin/excellentcrates)
- [Hangar](https://hangar.papermc.io/NightExpress/ExcellentCrates)

Put the downloaded `JAR` files (`nightcore.jar` and `ExcellentCrates.jar`) into your server's `/plugins/` folder and restart it. You are all set!

## :icon-phs-hand-heart: Donate

If you enjoy my work or find my plugins useful, feel free to [Buy me a coffee](https://ko-fi.com/nightexpress). Thank you! 🧡