# RedPockets – Minecraft Red Packet Plugin<\/p>\n
A feature-rich Minecraft red packet plugin that supports both currency red packets and item red packets.<\/p>\n
## Requirements<\/p>\n
– Minecraft 1.21+
\n– Java 17+
\n– Spigot\/Paper\/Folia server
\n– Vault (optional, for currency red packet feature)
\n– **Dependencies**: nbtapi
\n#### Languages Supported:
\nChinese, English
\n#### The language files are located in the resources directory<\/p>\n
## Features<\/p>\n
– **Currency Red Packets**: Supports both random distribution and equal distribution modes
\n– **Item Red Packets**: Players can put in items for others to draw randomly
\n– **Visual GUI**: Full graphical interface operation, easy to use
\n– **Broadcast Messages**: Real-time broadcasts for sending and grabbing red packets
\n– **Multi-language Support**: Built-in Chinese and English language packs
\n– **Data Persistence**: Supports MySQL and SQLite databases
\n– **Economy System**: Compatible with mainstream economy plugins (Vault)<\/p>\n
## Installation<\/p>\n
1. Download the latest version of RedPockets.jar
\n2. Place the plugin into your server’s `plugins` folder
\n3. Restart the server or load the plugin
\n4. Configure the `config.yml` file (optional)
\n5. Restart the server to apply configurations<\/p>\n
## Configuration<\/p>\n
### Database<\/p>\n
“`yaml
\ndatabase:
\n # Database type: mysql or sqlite
\n type: sqlite<\/p>\n
# MySQL configuration (only needed when type is mysql)
\n mysql:
\n host: localhost
\n port: 3306
\n database: redpockets
\n username: root
\n password: password
\n“`<\/p>\n
### Red Packet Settings<\/p>\n
“`yaml
\nredpocket:
\n # Red packet expiration time (seconds), 0 means never expire
\n expire-time: 3600<\/p>\n
# Maximum amount for currency red packets
\n max-amount: 100000.0<\/p>\n
# Maximum number of red packets
\n max-count: 100
\n“`<\/p>\n
## Commands<\/p>\n
### Player Commands<\/p>\n
| Command | Description | ### Admin Commands<\/p>\n | Command | Description | ## Permissions<\/p>\n | Permission Node | Description | Default | ## Usage<\/p>\n ### Creating Currency Red Packets<\/p>\n 1. Type `\/redpocket` to open the main interface ### Creating Item Red Packets<\/p>\n 1. Type `\/redpocket` to open the main interface ### Grabbing Red Packets<\/p>\n – Click on the red packet link in the chat ## Support<\/p>\n For issues or suggestions, please contact the plugin author.<\/p>\n ## License<\/p>\n This project is open-sourced under the GPL-3.0 License.<\/p>\n # User Guide<\/p>\n Detailed instructions on how to use all features of the RedPockets plugin.<\/p>\n ## Quick Start<\/p>\n ### Basic Commands<\/p>\n “` ### Your First Red Packet<\/p>\n 1. Type `\/redpocket` in-game ## Currency Red Packets<\/p>\n ### Overview<\/p>\n Currency red packets are based on in-game currency. Players receive corresponding currency after grabbing them.<\/p>\n ### Creation Steps<\/p>\n 1. **Open Creation Interface** 2. **Set Total Amount** 3. **Set Quantity** 4. **Choose Distribution Method** 5. **Set Note (Optional)** 6. **Confirm Sending** ### Distribution Methods<\/p>\n #### Random Distribution<\/p>\n – The system randomly allocates amounts based on total amount and quantity #### Equal Distribution<\/p>\n – Total amount is divided equally among all recipients ## Item Red Packets<\/p>\n ### Overview<\/p>\n Item red packets allow senders to place items for other players to randomly draw. It’s a great way to give gifts to friends!<\/p>\n ### Creation Steps<\/p>\n 1. **Open Creation Interface** 2. **Edit Items** 3. **Return to Main Interface** 4. **Confirm Sending** ### Features<\/p>\n – **Random Draw**: Players randomly receive one of the items ### Important Notes<\/p>\n – Ensure items have been placed in the editing area ## Grabbing Red Packets<\/p>\n ### Method 1: Click Chat Link<\/p>\n When someone sends a red packet, it will appear in the chat: Simply click on the green “[Click here to grab]” text to grab the red packet.<\/p>\n ### Method 2: Use Command<\/p>\n “` You need to know the red packet ID to grab it.<\/p>\n ### Viewing Red Packet ID<\/p>\n Click on the “type” text in the chat to view the red packet ID.<\/p>\n ## Preview Feature<\/p>\n ### Item Red Packet Preview<\/p>\n In the item red packet broadcast message, click on the “Item Red Packet” text to preview the red packet contents:<\/p>\n “` The preview feature allows you to see what items are in the red packet, but you **cannot take items** from it.<\/p>\n ### Preview Notes<\/p>\n – The preview interface is read-only ## FAQ<\/p>\n ### Q: What should I do if I get an “insufficient balance” prompt when grabbing a red packet?<\/p>\n **A**: Currency red packets require an economy system. Please ensure: ### Q: Where do items go when a red packet expires?<\/p>\n **A**: When item red packets expire: ### Q: How can I modify a sent red packet?<\/p>\n **A**: Sent red packets cannot be modified: ### Q: Why is the edit interface still read-only even after all items in an item red packet have been claimed?<\/p>\n **A**: This might be a bug. Please try: ### Q: Can I see what others have grabbed?<\/p>\n **A**: Yes, the system broadcasts in real-time: ### Q: How do I delete a red packet?<\/p>\n **A**: Only administrators can delete red packets: ### Q: What should I do if data is lost?<\/p>\n **A**: Please back up your database regularly: ### Q: Which economy plugins are supported?<\/p>\n **A**: Supports all Vault-compatible economy plugins: ### Q: What are the maximum amounts and quantities for red packets?<\/p>\n **A**: These can be configured in `config.yml`: ## Tips<\/p>\n 1. **Note Function**: Add notes to red packets to make them more meaningful A fully-featured Minecraft red envelope plugin that supports both coin red envelopes and item red envelopes.<\/p>\n","protected":false},"featured_media":130864,"template":"","meta":{"_minecraft_slug":"redpockets","_minecraft_project_id":"3yb0MHN3","_minecraft_author":"chenasyd","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":27,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"redpockets.zip","_minecraft_size_bytes":5263753,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:17:32.697886Z","_minecraft_date_created":"2026-03-04T21:17:42.523703Z","_minecraft_date_modified":"2026-04-12T16:07:40.949962Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/redpockets","_minecraft_icon_attachment_id":130864,"_minecraft_imported_at":"2026-06-07T17:05:12+00:00","_minecraft_import_hash":"4b8f10ada91a4e199dc5cf57a30297ae","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,125,127,128,129,91,92],"mod_loader":[131,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-130863","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-folia","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_category-storage","mod_category-utility","mod_loader-folia","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n|———|————-|
\n| `\/redpocket` | Open the red packet creation GUI |
\n| `\/redpocket create` | Create a red packet (opens GUI) |
\n| `\/grab
\n| `\/redpocket preview
\n|———|————-|
\n| `\/redpocketadmin delete
\n| `\/redpocketadmin reload` | Reload plugin configuration |<\/p>\n
\n|—————–|————-|———|
\n| `redpockets.use` | Use red packet features | OP |
\n| `redpockets.create` | Create red packets | OP |
\n| `redpockets.grab` | Grab red packets | OP |
\n| `redpockets.admin` | Admin commands | OP |<\/p>\n
\n2. Click on the “Currency Red Packet” icon
\n3. Set the total amount and quantity
\n4. Choose distribution method (random\/equal)
\n5. Click “Confirm Send”<\/p>\n
\n2. Click on the “Item Red Packet” icon
\n3. Click “Edit Items” to open the editing interface
\n4. Drag items into the editing area
\n5. Return to the main interface and click “Confirm Send”<\/p>\n
\n– Or type `\/grab
\n\/redpocket – Open the main red packet interface
\n\/grab
\n“`<\/p>\n
\n2. In the GUI that appears, select either “Currency Red Packet” or “Item Red Packet”
\n3. Follow the prompts to set parameters
\n4. Click “Confirm Send”<\/p>\n
\n “`
\n \/redpocket
\n “`
\n Click on the “Currency Red Packet” icon<\/p>\n
\n – Click the “Total Amount” item
\n – Enter the amount in chat (e.g., `100`)
\n – Enter `cancel` to cancel<\/p>\n
\n – Click the “Quantity” item
\n – Enter the quantity in chat (e.g., `10`)
\n – The quantity indicates how many people can grab the red packet<\/p>\n
\n – **Random Distribution**: Each person gets a random amount, with a “Lucky Draw” possible
\n – **Equal Distribution**: Everyone gets the same amount<\/p>\n
\n – Click the “Set Note” item
\n – Enter the note information in chat<\/p>\n
\n – Check if settings are correct
\n – Click “Confirm Send”
\n – The red packet will be sent to all online players<\/p>\n
\n– Each person receives a different amount
\n– The person who grabs the most will be shown as “Lucky Draw” after the red packet is fully claimed
\n– Suitable for adding fun and interactivity<\/p>\n
\n– Everyone receives the same amount
\n– Suitable for fair distribution scenarios<\/p>\n
\n “`
\n \/redpocket
\n “`
\n Click on the “Item Red Packet” icon<\/p>\n
\n – Click the “Edit Items” icon
\n – Open the item editing interface (54 slots)
\n – Drag items you want to send into the editing area
\n – You can place multiple items, one item per slot
\n – Items can be stacked<\/p>\n
\n – Closing the edit interface saves automatically
\n – Return to the creation interface<\/p>\n
\n – Check the item quantity
\n – Click “Confirm Send”
\n – The red packet will be sent to all online players<\/p>\n
\n– **Uniqueness**: Each item can only be grabbed once
\n– **Auto-lock**: Items are automatically locked after sending and cannot be modified
\n– **Expiry Return**: Unclaimed items are automatically returned when the red packet expires<\/p>\n
\n– Confirm item settings before sending
\n– Items will be automatically returned when the red packet expires<\/p>\n
\n“`
\nPlayer xxx sent 10 red packets worth 100 coins each, [Click here to grab]
\n“`<\/p>\n
\n\/grab
\n“`<\/p>\n
\nPlayer xxx sent an Item Red Packet containing 5 items, [Click to view]
\n“`<\/p>\n
\n– You cannot take items from the preview
\n– Preview data is stored in memory
\n– The preview automatically disappears when the red packet expires or is fully claimed<\/p>\n
\n1. Vault plugin is installed
\n2. An economy plugin (like Essentials) is installed
\n3. Server economy features are enabled<\/p>\n
\n1. Unclaimed items are automatically returned to the sender
\n2. You can view remaining items through the item editing interface
\n3. Reopen the item editing interface to see the returned items<\/p>\n
\n– Currency red packets: Amount and quantity are fixed after sending
\n– Item red packets: Items are automatically locked after sending<\/p>\n
\n1. Waiting a few seconds for it to refresh
\n2. Reopening the edit interface
\n3. Contacting an administrator if the issue persists<\/p>\n
\n– Currency red packets: Shows the amount grabbed
\n– Item red packets: Shows the grabbed item name and quantity<\/p>\n
\n“`
\n\/redpocketadmin delete
\n“`<\/p>\n
\n– MySQL: Regularly back up the `redpockets` database
\n– SQLite: Back up the `plugins\/RedPockets\/redpockets.db` file<\/p>\n
\n– EssentialsX
\n– CMI
\n– VaultEconomy
\n– Other mainstream economy plugins<\/p>\n
\n“`yaml
\nredpocket:
\n max-amount: 100000.0 # Maximum amount
\n max-count: 100 # Maximum quantity
\n“`<\/p>\n
\n2. **Preview Items**: Preview item red packets before grabbing to see what items are available
\n3. **Equal Distribution**: Choose equal distribution mode for fair distribution
\n4. **Random Distribution**: Choose random distribution mode to increase interactive fun
\n5. **Watch Expiry Time**: Default expiration is 1 hour, remember to grab in time<\/p>\n","protected":false},"excerpt":{"rendered":"