RedPockets

A WeChat/QQ-style red packet plugin for Minecraft: regular, lucky, blessing, and password types; click-to-claim, chat announcements, auto-refund on expiry. Compatible with Paper / Folia / Spigot / Purpur 1.20+.

Download & updates: Modrinth – Red Pockets

---

Red packet types

Type	Description
Regular	Same amount per person; total must be divisible by count.
Lucky	Random amounts; “best luck” is announced after all claimed.
Blessing	Custom blessing text (default if empty), max 6 characters.
Password	Set a password; players click “Type password to claim” to auto-send and claim (once per player), or type the password in chat.

---

Core features

• GUI to choose type; chat to enter amount, count, blessing/password; cancel word to abort.
• Click to claim or “Type password to claim” in chat; each claim is announced.
• Best luck announcement for lucky packets; auto-refund when expired or on server shutdown.
• Red packet rain by OP; server or player funding; optional scheduled rain.

---

Currency & economy

• Vault (gold, etc.) or PlayerPoints; choose in config. PlayerPoints uses whole numbers.
• Need Vault + economy plugin, or PlayerPoints; plugin falls back to Vault if PlayerPoints is missing.

---

Send / claim lists (whitelist & blacklist)

• Send list: Only listed players can send, or listed players cannot send.
• Claim list: Only listed players can claim, or listed players cannot.
• Use player names or UUIDs in config; empty list = no restriction for blacklist, nobody for whitelist.

---

Resend on join

• When a player joins (or reconnects), they can be shown current active red packets so they don’t miss any.
• Config: turn resend on/off and set a minimum amount (e.g. only show packets ≥ 100).

---

More features

• 10 languages; cooldown & daily limit with VIP bypass; sounds & particles; history & rankings with retention days; PlaceholderAPI; Modrinth update notice and link; config auto-merge on plugin update (new options added, your changes kept).

---

Requirements & install

• Server: Spigot / Paper / Folia / Purpur 1.21+ · Java: 21
• Dependencies: Vault + economy plugin, or PlayerPoints (see config).
• Put RedPockets.jar in plugins, install economy/PlayerPoints, start or reload. Configs appear under plugins/RedPockets/. Updates: replace JAR and reload; config is merged automatically.

---

Commands & permissions (summary)

Command	Permission
/hongbao – open GUI	redpockets.send
/hongbao help	—
/hongbao history [page]	redpockets.history
/hongbao rank	redpockets.rank
/hongbao rain	redpockets.rain
/hongbao claim <id> / clickclaim <id>	redpockets.claim
/hongbao update / reload	redpockets.reload

Permissions: redpockets.send, redpockets.claim, redpockets.history, redpockets.rank, redpockets.rain, redpockets.reload; bypass: redpockets.bypass.cooldown, redpockets.bypass.dailylimit; VIP list in config.

---

Usage (players)

1. Run /hongbao, choose type.
2. Enter total amount and count in chat.
3. For blessing/password, enter text as prompted.
4. Red packet is broadcast; click to claim (or type password for password type).
5. Type cancel (or configured word) to cancel.

---

Config (admins)

• config.yml: Language, cancel word, expiry, amount/count limits, cooldown, daily limit, currency type (vault/playerpoints), send/claim lists, resend on join and min amount, sounds, particles, password options, rain source and schedule, history retention, etc.
• main.yml: GUI text. messages/ : per-language strings.
• After changes, run /hongbao reload. New options are merged on plugin update.

---

FAQ

• “Currency not found”: Install Vault + economy (or PlayerPoints); plugin retries after ~5s. If PlayerPoints is set but missing, it falls back to Vault.
• Missed packet after disconnect: Enable “resend on join” in config and reload; rejoining players get current active packets.
• Restrict who can send/claim: Use send list and claim list in config (whitelist or blacklist with names/UUIDs).
• Where to download: Modrinth – Red Pockets.