Red Pockets

# 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**: (https://modrinth.com/plugin/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 ` | `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**: (https://modrinth.com/plugin/red-pockets/).