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

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)

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.