📦 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