{"id":151386,"date":"2026-06-09T06:13:36","date_gmt":"2026-06-09T03:13:36","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/"},"modified":"2026-06-09T06:13:36","modified_gmt":"2026-06-09T03:13:36","slug":"syextract","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/","title":{"rendered":"SyExtract"},"content":{"rendered":"

# SyExtract<\/p>\n

A red envelope plugin for Minecraft Paper\/Purpur 1.21 with Vault economy support.<\/p>\n

## Features<\/p>\n

– Create red envelopes (set name, amount, quantity)
\n– **Each red envelope has a unique numeric ID starting from 1 (e.g., 1, 2, 3)**
\n– GUI interface for viewing and claiming red envelopes
\n– **GUI can be opened even when no red envelopes are available**
\n– **Broadcast red envelopes to all players with one click**
\n– **Unclaimed amounts are automatically refunded when red envelopes expire**
\n– **Multi-language support (\u7b80\u4f53\u4e2d\u6587\/English)**
\n– Vault economy system support
\n– Configurable fee system
\n– Player ban system (restrict sending\/claiming red envelopes)
\n– Red envelope expiration settings
\n– Highly configurable<\/p>\n

## Requirements<\/p>\n

– Minecraft Server: Paper\/Purpur 1.21
\n– Java: 17 or higher
\n– Dependencies: Vault + any economy plugin (e.g., EssentialsX)<\/p>\n

## Commands<\/p>\n

| Command | Permission | Description |
\n| ————————————- | ——————- | ————————————— |
\n| `\/sye create ` | syextract.create | Create a red envelope |
\n| `\/sye open` | syextract.open | Open the red envelope GUI |
\n| `\/sye broadcast ` | syextract.broadcast | Broadcast a red envelope to all players |
\n| `\/sye claim ` | syextract.claim | Claim a specific red envelope by ID |
\n| `\/sye ban

### Command Aliases<\/p>\n

– `create` \u2192 `c`
\n– `open` \u2192 `o`
\n– `broadcast` \u2192 `br`
\n– `claim` \u2192 `cl`
\n– `ban` \u2192 `b`
\n– `unban` \u2192 `u`
\n– `reload` \u2192 `r`<\/p>\n

### Time Format<\/p>\n

Ban duration supports the following formats:<\/p>\n

– `1h` – 1 hour
\n– `1d` – 1 day
\n– `1w` – 1 week
\n– `30d` – 30 days<\/p>\n

## Permissions<\/p>\n

| Permission | Default | Description |
\n| ——————- | ——- | ——————————— |
\n| syextract.use | true | Basic usage permission |
\n| syextract.create | true | Create red envelope permission |
\n| syextract.open | true | Open GUI permission |
\n| syextract.claim | true | Claim red envelope permission |
\n| syextract.broadcast | true | Broadcast red envelope permission |
\n| syextract.ban | op | Ban player permission |
\n| syextract.unban | op | Unban player permission |
\n| syextract.reload | op | Reload configuration permission |
\n| syextract.admin | op | All admin permissions |<\/p>\n

## Configuration<\/p>\n

### config.yml<\/p>\n

“`yaml
\n# Language Settings
\n# Available values: zh (\u7b80\u4f53\u4e2d\u6587), en (English)
\nlanguage: zh<\/p>\n

# Red envelope settings
\nred-envelope:
\n # Default claim duration (hours)
\n default-expire-hours: 24
\n # Minimum red envelope amount
\n min-amount: 1.0
\n # Minimum red envelope count
\n min-count: 1
\n # Maximum red envelope count
\n max-count: 100<\/p>\n

# Fee settings
\nfee:
\n # Enable fee
\n enabled: true
\n # Fee percentage (0.0 – 1.0, e.g., 0.05 = 5%)
\n percentage: 0.05
\n # Minimum fee
\n min-fee: 1.0<\/p>\n

# GUI settings
\ngui:
\n # Red envelope item material
\n item-material: “SUNFLOWER”<\/p>\n

# Broadcast message settings
\nbroadcast:
\n # Notification when red envelope is fully claimed
\n envelope-completed: “&6&l\ud83c\udf89 Red envelope &e{name} &7has been fully claimed! &6{player} &7got the highest amount: &e{amount} &7coins!”
\n“`<\/p>\n

### Language Files<\/p>\n

The plugin supports multi-language through language files located in `plugins\/SyExtract\/lang\/`:<\/p>\n

– `zh.yml` – \u7b80\u4f53\u4e2d\u6587 (default)
\n– `en.yml` – English<\/p>\n

You can customize all messages in these files. To switch language, change the `language` option in `config.yml`.<\/p>\n

#### Language File Structure<\/p>\n

“`yaml
\n# Message prefix
\nprefix: “&8[&cSyExtract&8] &r”<\/p>\n

# Success messages
\nsuccess:
\n create: “&aSuccessfully created red envelope! ID: &e{id}”
\n claim: “&aYou claimed the red envelope and received &6{amount} &acoins!”
\n # … more messages<\/p>\n

# Error messages
\nerror:
\n no-permission: “&cYou don’t have permission!”
\n # … more messages<\/p>\n

# GUI texts
\ngui:
\n title: “&c&lRed Envelope Hall”
\n # … more texts<\/p>\n

# Broadcast messages
\nbroadcast:
\n format: “&6&l\ud83e\udde7 Red Envelope! &e{sender} &7sent &6&l[{name}]”
\n click-text: “&a&l[Claim Now]”
\n“`<\/p>\n

## Data Storage<\/p>\n

The plugin generates the following data files in the `plugins\/SyExtract\/` directory:<\/p>\n

– `envelopes.yml` – Red envelope data
\n– `bans.yml` – Ban data
\n– `lang\/` – Language files (auto-generated)<\/p>\n

## Usage Examples<\/p>\n

1. **Create a red envelope**
\n “`
\n \/sye create HappyNewYear 1000 10
\n “`
\n Create a red envelope named “HappyNewYear” with a total of 1000 coins divided into 10 shares.
\n The system will display the red envelope ID upon successful creation.<\/p>\n

2. **Open GUI to claim red envelopes**
\n “`
\n \/sye open
\n “`
\n The GUI can be opened even when no red envelopes are available.<\/p>\n

3. **Broadcast a red envelope**
\n “`
\n \/sye broadcast 1
\n “`
\n Broadcast the red envelope with ID “1” to all online players.
\n Players can click the “[Claim Now]” button in the chat to claim it.<\/p>\n

4. **Claim a specific red envelope**
\n “`
\n \/sye claim 1
\n “`
\n Directly claim the red envelope with ID “1”.<\/p>\n

5. **Ban a player**
\n “`
\n \/sye ban PlayerName 7d
\n “`
\n Ban a player for 7 days, preventing them from sending and claiming red envelopes.<\/p>\n

6. **Unban a player**
\n “`
\n \/sye unban PlayerName
\n “`<\/p>\n

## Notes<\/p>\n

1. Creating a red envelope deducts the envelope amount + fee
\n2. Red envelopes use a random distribution algorithm; each share amount is random
\n3. **Expired unclaimed red envelopes will be automatically refunded to the sender**
\n4. Each player can only claim the same red envelope once
\n5. **Each red envelope has a unique numeric ID for easy sharing and claiming**
\n6. **Multi-language support allows you to customize all plugin messages**<\/p>\n

## Changelog<\/p>\n

### v1.4.0<\/p>\n

– Added multi-language support (\u7b80\u4f53\u4e2d\u6587\/English)
\n– Language files are now stored in `lang\/` folder
\n– All messages can be customized through language files
\n– Added `language` option in config.yml<\/p>\n

### v1.3.0<\/p>\n

– Added notification when red envelope is fully claimed
\n– Shows the luckiest player (hand king) who got the highest amount
\n– Added `broadcast.envelope-completed` message configuration<\/p>\n

### v1.2.0<\/p>\n

– Fixed broadcast message not found issue (success.broadcast)
\n– Fixed clickable claim button in broadcast messages
\n– Changed red envelope ID from random 6-character to sequential numeric ID starting from 1<\/p>\n

### v1.1.0<\/p>\n

– Added unique ID for each red envelope
\n– Added automatic refund for expired unclaimed red envelopes
\n– Added `\/sye broadcast` command to broadcast red envelopes
\n– Added `\/sye claim` command to claim by ID
\n– GUI can now be opened even when no red envelopes are available
\n– Updated to Java 17 compatibility<\/p>\n

### v1.0.0<\/p>\n

– Initial release<\/p>\n

## Author<\/p>\n

– **Author**: Shiyuan
\n– **Year**: 2026<\/p>\n","protected":false},"excerpt":{"rendered":"

Minecraft server red packet plugin<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"syextract","_minecraft_project_id":"l7csFOF7","_minecraft_author":"Shiyuan","_minecraft_license":"MIT","_minecraft_downloads":56,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"syextract.zip","_minecraft_size_bytes":320823,"_minecraft_version_count":9,"_minecraft_updated_at":"2026-05-15T20:53:25.107045Z","_minecraft_date_created":"2026-03-29T05:20:23.545754Z","_minecraft_date_modified":"2026-04-04T04:32:13.844493Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/syextract","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-09T03:13:37+00:00","_minecraft_import_hash":"4adc1457878f8e64f4f08ea4ed43fc74","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167],"class_list":["post-151386","mod","type-mod","status-publish","hentry","mod_category-economy","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","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","minecraft_version-26-1","minecraft_version-26-1-1"],"yoast_head":"\nSyExtract - Minecraft<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"SyExtract - Minecraft\" \/>\n<meta property=\"og:description\" content=\"Minecraft server red packet plugin\" \/>\n<meta property=\"og:url\" content=\"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/\" \/>\n<meta property=\"og:site_name\" content=\"Minecraft\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"4 minutes\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/syextract\\\/\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/syextract\\\/\",\"name\":\"SyExtract - Minecraft\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\"},\"datePublished\":\"2026-06-09T03:13:36+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/syextract\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/syextract\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/syextract\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Mods\",\"item\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/mods\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"SyExtract\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/#website\",\"url\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/\",\"name\":\"Minecraft\",\"description\":\"\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/vpesports.com\\\/minecraft\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"SyExtract - Minecraft","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/","og_locale":"en_US","og_type":"article","og_title":"SyExtract - Minecraft","og_description":"Minecraft server red packet plugin","og_url":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/","og_site_name":"Minecraft","twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"4 minutes"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/","url":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/","name":"SyExtract - Minecraft","isPartOf":{"@id":"https:\/\/vpesports.com\/minecraft\/#website"},"datePublished":"2026-06-09T03:13:36+00:00","breadcrumb":{"@id":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/vpesports.com\/minecraft\/mods\/syextract\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/vpesports.com\/minecraft\/mods\/syextract\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/vpesports.com\/minecraft\/"},{"@type":"ListItem","position":2,"name":"Mods","item":"https:\/\/vpesports.com\/minecraft\/mods\/"},{"@type":"ListItem","position":3,"name":"SyExtract"}]},{"@type":"WebSite","@id":"https:\/\/vpesports.com\/minecraft\/#website","url":"https:\/\/vpesports.com\/minecraft\/","name":"Minecraft","description":"","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/vpesports.com\/minecraft\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"_links":{"self":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod\/151386","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod"}],"about":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/types\/mod"}],"wp:attachment":[{"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/media?parent=151386"}],"wp:term":[{"taxonomy":"mod_category","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_category?post=151386"},{"taxonomy":"mod_loader","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/mod_loader?post=151386"},{"taxonomy":"minecraft_version","embeddable":true,"href":"https:\/\/vpesports.com\/minecraft\/wp-json\/wp\/v2\/minecraft_version?post=151386"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}