📦 ResourcePackEnforcer

Enforce your server's resource pack — with kick message, update checker & full customization.

---

📖 Overview

ResourcePackEnforcer is a lightweight Spigot plugin that automatically sends a resource pack to every player on join. If a player declines, they are kicked with a fully customizable message — no more players bypassing your server's resource pack!

Everything is configurable out of the box. The config is generated automatically on first start with full comments, and missing keys are added automatically after plugin updates.

---

✨ Features

• 📥 Automatic sending — Resource pack is sent to every player on join
• 🔒 Enforce mode — Players who decline are immediately kicked
• 💬 Custom kick message — Full support for color codes (&) and hex colors (&#RRGGBB)
• 📝 Prompt message — Custom text shown when requesting the pack (1.17+)
• 🔑 SHA-1 hash validation — Optional hash verification for pack integrity
• ⏱️ Configurable send delay — Adjust the delay in ticks before the pack is sent
• 🛡️ Bypass permission — Allow staff to skip the resource pack requirement
• 🔄 Automatic update checker — Checks GitHub Releases on startup, notifies admins in-game
• 🎨 Hex color support — &#RRGGBB in all messages (1.16+)
• 🔔 Console banners — ASCII banners on plugin start, stop and available updates
• ⚙️ Auto-generated config — Created with comments on first start, missing keys added automatically

---

⚙️ Configuration

resourcepack:
  # Direct download URL to the resource pack (.zip)
  url: "https://example.com/resourcepack.zip"

  # SHA-1 hash for validation (or "none" to disable)
  hash: "none"

  # Prompt message shown when requesting the pack (1.17+)
  prompt: "&ePlease accept the resource pack to join the server!"

true = kick on decline | false = optional

enforce: true

Delay in ticks before sending (20 ticks = 1 second)

send-delay: 20

messages: kick-message: |- &c&lResource Pack Declined! &7You must accept the resource pack &7to play on this server.

pack-loaded: "&a&lResource pack successfully loaded!" pack-failed: "&c&lFailed to load resource pack. Please reconnect!" prefix: "&8[&6ResourcePack&8] &r" reload-success: "&aConfiguration successfully reloaded!" pack-sent: "&aResource pack sent to %player%!"

---

## 💬 Commands

| Command | Description | Permission |
|---|---|---|
| `/rp reload` | Reload the configuration | `resourcepack.admin` |
| `/rp send [player]` | Send the pack to a player | `resourcepack.admin` |
| `/rp sendall` | Send the pack to all players | `resourcepack.admin` |
| `/rp info` | Show plugin status | `resourcepack.admin` |

**Alias:** `/resourcepack`

---

## 🔑 Permissions

| Permission | Description | Default |
|---|---|---|
| `resourcepack.admin` | Access to all commands | OP |
| `resourcepack.bypass` | Skip the resource pack requirement | `false` |

---

## 🖥️ Requirements

| | |
|---|---|
| **Java** | 21 or higher |
| **Server** | Spigot / Paper 1.20 or higher |

---

## 🚀 Installation

1. Download the latest `.jar` from the version tab
2. Drop it into your server's `plugins/` folder
3. Start the server — `config.yml` is generated automatically
4. Enter your resource pack URL in `config.yml`
5. Run `/rp reload` or restart the server

---

## 🔄 Update Checker

ResourcePackEnforcer checks for new versions on startup via the GitHub Releases API — completely asynchronous, so it never delays your server start. If a new version is found, a banner appears in the console and admins receive a chat notification on join.

[ResourcePack] ⚡ Update available! (1.0.0 → 1.1.0) [ResourcePack] Download: https://github.com/.../releases/latest

---

## 🐛 Issues & Support

Found a bug or have a question? Open an issue on GitHub.

---

*Made with ❤️ — Licensed under the MIT License*