EzBanners

# EzBanners - Minecraft server banner generation  **[EzBanners.org](https://ezbanners.org)** delivers dynamic Minecraft server banners powered by live plugin data. The plugin securely syncs your server stats to your banner API so you can embed up-to-date images across forums, vote pages, Discord, and listing sites. --- ## ✨ Highlights - **Live banner data**: Push current server stats to your banner API on a timed sync. - **Secure syncing**: Token + HMAC signatures on every request. - **Async networking**: Non-blocking HTTP with retry/backoff logic. - **PlaceholderAPI support**: Pull custom values when PlaceholderAPI is installed. - **Wide compatibility**: Bukkit/Spigot/Paper 1.7–1.21+. --- ## 🚀 Quick Start 1. Drop `EzBanners.jar` into your `plugins/` folder. 2. Start the server once to generate `plugins/EzBanners/config.yml`. 3. Configure `api.endpoint` and `api.token`, or run `/ezbanners link `. 4. (Optional) Configure `placeholderapi.mappings` if you use PlaceholderAPI. 5. Restart or reload and the sync will begin automatically. --- ## 🧰 Command | Command | Description | Permission | | --- | --- | --- | | `/ezbanners link ` | Link your server to the API token. | `ezbanners.link` | --- ## 🔗 Links - **EzBanners.org** — Dashboard + banner designer: https://ezbanners.org - **EzPlugins Discord** — Support, previews, and announcements: https://discord.gg/yWP95XfmBS --- **Example banner result**  ## 🧾 Sync Payload Notes - Each sync sends the token, server UUID, timestamp, HMAC signature, and enabled data fields. - TPS and PlaceholderAPI values are only sent when available. - HTTP requests are async and never block the main thread.