WarZHongBao – Advanced Red Packet System
Money / Points / Item Red Packets · GUI Item System · Random Luck Mode · Full Version Support (1.8–1.21+) · Folia Ready

Overview
WarZHongBao is a modern, fully rewritten Red Packet (HongBao) system for Minecraft servers.

Players can send Money, Points, or Item red packets directly in chat, while others compete to grab them through an immersive, interactive experience.

The plugin is inspired by classic red packet mechanics but is 100% original code, redesigned with a strong focus on GUI interaction, safety, customization, and cross-version compatibility, including native support for Folia.

✨ Core Features
Multiple Red Packet Types

• Money Red Packets (Vault economy)
  
  
• Points Red Packets (PlayerPoints)
  
  
• Item Red Packets (supports all items, stackable or not)

️ GUI-Based Item Red Packet System (Major Feature)
The item red packet system has been fully redesigned into a GUI workflow, replacing traditional command-only input.

• /fhb item now opens a visual GUI interface
  
  
• 54-slot large chest layout:
  
  • Top 45 slots: item placement area
    
    
  • Bottom 9 slots: functional buttons
    
• Multi-item & multi-type support:
  
  • Place multiple different items at once
    
    
  • Supports unlimited pages
    
• In-GUI configuration:
  
  • Adjust red packet count directly inside the GUI
    
    
  • No need to input item amount via command arguments
    

This design greatly improves usability and prevents common item-handling mistakes.

Random Luck Distribution Algorithm (Improved)
The item distribution logic has been completely rewritten.

• Uses a variant of the “Double Mean Method”
  
  
• Items are randomly distributed across all red packets
  
  
• Improvements:
  
  • Items are no longer given entirely to the first player
    
    
  • Each packet is guaranteed to contain items when quantities allow
    
    
  • The final packet automatically receives all remaining items
    
• Effectively prevents item loss and ensures fair distribution
  

Advanced Chat Interaction

• Clickable [Grab Red Packet] button
  
  
• Hover tooltips with detailed information
  
  
• Chat image icons for red packets
  
  
• Sound effects on grab (auto-adapted from 1.8 to 1.21+)
  
  
• Clear feedback messages for senders and receivers
  

Smart Item Localization System

• Built-in 400+ item translations
  
  
• Automatic name detection:
  
  • Custom item display names
    
    
  • items.yml translations
    
    
  • Beautified English names as fallback
    

Priority order:

Custom Display Name > items.yml > Auto-formatted Name

Targeted Red Packets

• Send to all online players
  
  
• Or send a private red packet to a specific player
  

Customization & UX Enhancements
Fully Externalized Language Files

• Removed all hardcoded strings (e.g. "Money", "Ticket")
  
  
• Unit names and messages are now fully configurable via lang_zh.yml
  
  
• Password red packet messages moved into language files
  
  
• Added extensive GUI-related messages:
  
  • Inventory full warnings
    
    
  • Item return notifications
    
    
  • Quantity and limit prompts
    

Advanced GUI Customization

• Bottom GUI buttons are fully configurable in config.yml:
  
  • Material
    
    
  • Display name
    
    
  • Lore
    
• CustomModelData support:
  
  • New custom_model_data field
    
    
  • Available for Minecraft 1.14+
    
    
  • Ideal for resource pack integration
    

Safety & Stability
Item Protection System

• Automatic return mechanism:
  
  • If a player closes the GUI without confirming:
    
    • Items are returned to inventory
      
      
    • If inventory is full, items drop at the player’s feet
      
• Quantity validation:
  
  • Red packet count cannot exceed total item amount
    
    
  • Prevents empty red packets
    

Broadcast Logic Fix

• Fixed a bug where the “red packet finished” broadcast triggered on every grab
  
  
• Broadcast now triggers only once, when the final packet is claimed
  

⚙ Compatibility
✔ Minecraft 1.8 – 1.21.x
✔ Spigot / Paper / Purpur
✔ Native Folia support
✔ Modded server compatibility:

• Mohist
  
  
• Arclight
  
  
• CatServer
  

Version Adaptation

• Automatic material fallback:
  
  • High versions use GRAY_STAINED_GLASS_PANE
    
    
  • Legacy versions fall back to STAINED_GLASS_PANE:7
    
• plugin.yml includes api-version: 1.13 for modern server compatibility
  

Dependencies
Plugin Required Purpose
Vault Yes Money red packets
Economy Plugin Yes EssentialsX / CMI / XConomy / etc
PlayerPoints Optional Points red packets
‍ Commands
Player Commands
/hb - Show help
/fhb - Open red packet menu

Send Red Packets
/fhb money <amount> <count> [player]
/fhb ticket <amount> <count> [player]
/fhb item <count> [player]

• [player] is optional
  
  
• Omitted → global red packet
  
  
• Specified → private red packet
  

Grab Red Packet
/qhb <id>

(Usually not needed — click the chat message instead)

Permissions
Permission Description Default
bm.money Send money red packets OP
bm.ticket Send points red packets OP
bm.item Send item red packets OP
warzhongbao.admin Reload plugin OP
All permission nodes are configurable via config.yml.

Installation

1. Download WarZHongBao-x.x.jar
   
   
2. Place it in the plugins folder
   
   
3. Install Vault and an economy plugin
   
   
4. (Optional) Install PlayerPoints
   
   
5. Restart server
   
   
6. Use /hb reload after editing configs
   

Conclusion
WarZHongBao is a lightweight yet powerful red packet system designed for modern Minecraft servers.

With:

• Fully GUI-based item red packets
  
  
• Strong safety guarantees
  
  
• Deep customization
  
  
• Full cross-version and Folia compatibility
  

It is an excellent choice for Survival, RPG, Event, and Community-focused servers.