# \ud83d\udc8e V-Shards <\/p>\n
> Simple vertical transportation for Paper 1.21.1+ servers<\/p>\n
\n<\/p>\n
—<\/p>\n
## \u2728 Features<\/p>\n
– \ud83c\udfe6 **UUID-based economy** \u2014 Balances survive name changes
\n– \ud83d\uded2 **GUI Shop System** \u2014 Fully customizable buy\/sell interface
\n– \ud83c\udfaf **PlaceholderAPI Support** \u2014 Display balances anywhere
\n– \ud83d\udcca **Leaderboards** \u2014 Top shard holders with pagination
\n– \u26a1 **Zero Lag Design** \u2014 Dirty-tracking saves only modified data
\n– \ud83c\udfa8 **MiniMessage Formatting** \u2014 Modern color gradients & styling
\n– \ud83d\udd12 **Secure** \u2014 Locked GUI prevents item manipulation
\n– \u2b06\ufe0f **Auto-save** \u2014 Configurable intervals (default: 5 min)<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
1. Download `V-Shards.jar`
\n2. Drop into `plugins\/` folder
\n3. Restart server
\n4. Edit `plugins\/V-Shards\/config.yml` to customize<\/p>\n
—<\/p>\n
## PlaceholderAPI<\/p>\n
| Placeholder | Returns | Balances are formatted using the same K \/ M \/ B abbreviation system as in-game (e.g. `10K`, `2.5M`, `1B`).<\/p>\n —<\/p>\n ## Number Formatting<\/p>\n All balance and price values across commands, messages, and placeholders are automatically abbreviated:<\/p>\n | Raw Value | Displayed As | Whole numbers never show a decimal (e.g. `10K` not `10.0K`). Decimals only appear when meaningful (e.g. `10.5K`).<\/p>\n —<\/p>\n ## \u2328\ufe0f Commands<\/p>\n | Command | Permission | Description | **Aliases:** `\/shard`<\/p>\n —<\/p>\n ## \ud83d\udd10 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ### \ud83d\udee0\ufe0f shop.yml #preview<\/p>\n Defines the GUI layout and all shop items. Reloads with `\/shards reload` \u2014 no restart needed.<\/p>\n “`yaml items:<\/p>\n # Top decorative border # Shop items #### \ud83d\udee0\ufe0f Item field reference<\/p>\n | Field | Required | Notes | > **Tip:** Slots are 0-indexed. For a 54-slot inventory (6 rows), valid slots are `0`\u2013`53`. Two items sharing the same slot will cause one to silently overwrite the other.<\/p>\n —<\/p>\n","protected":false},"excerpt":{"rendered":" V-Shards – It adds a custom in-game currency called Shards that players can earn, spend, and trade.<\/p>\n","protected":false},"featured_media":167976,"template":"","meta":{"_minecraft_slug":"vshards","_minecraft_project_id":"5OXjBr93","_minecraft_author":"ReakZ","_minecraft_license":"MIT","_minecraft_downloads":81,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"vshards.zip","_minecraft_size_bytes":77855,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T20:18:35.359448Z","_minecraft_date_created":"2026-04-16T21:58:22.393671Z","_minecraft_date_modified":"2026-05-02T09:49:43.161901Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/vshards","_minecraft_icon_attachment_id":167976,"_minecraft_imported_at":"2026-06-09T19:22:25+00:00","_minecraft_import_hash":"410c99ad2fe2cc54d0673038cf11cf31","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,124,156,844,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-167975","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-bukkit","mod_category-decoration","mod_category-economy","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|—|—|
\n| `%vshards_amount%` | The requesting player’s shard balance |
\n| `%vshards_amount_
\n|—|—|
\n| 500 | `500` |
\n| 1,000 | `1K` |
\n| 10,000 | `10K` |
\n| 10,500 | `10.5K` |
\n| 1,000,000 | `1M` |
\n| 2,500,000 | `2.5M` |
\n| 1,000,000,000 | `1B` |<\/p>\n
\n|———|————|————-|
\n| `\/shards` | `vshards.balance` | Check your balance |
\n| `\/shards
\n| `\/shards pay
\n| `\/shards give
\n| `\/shards take
\n| `\/shards set
\n| `\/shards top [page]` | `vshards.top` | View leaderboard |
\n| `\/shards shop` | `vshards.shop` | Open shop GUI |
\n| `\/shards reload` | `vshards.admin.reload` | Reload all configs |<\/p>\n
\n|————|———|————-|
\n| `vshards.balance` | Everyone | Check own balance |
\n| `vshards.pay` | Everyone | Send shards to another player |
\n| `vshards.top` | Everyone | View leaderboard |
\n| `vshards.shop` | Everyone | Access shop GUI |
\n| `vshards.balance.others` | OP | Check others’ balances |
\n| `vshards.admin.*` | OP | All admin commands |<\/p>\n
\nmenu_title: ‘&d\ua731\u029c\u1d00\u0280\u1d05\ua731 \ua731\u029c\u1d0f\u1d18’
\nsize: 27<\/p>\n
\n border:
\n material: GRAY_STAINED_GLASS_PANE
\n slot: 18, 19, 20, 21, 22, 23, 24, 25, 26
\n type: decoration
\n display_name: ‘&r’
\n lore: []<\/p>\n
\n pig_spawner_buy:
\n material: SPAWNER
\n slot: 0
\n type: buy
\n price: 5000
\n amount: 1
\n display_name: ‘&d&l\u1d18\u026a\u0262 \ua731\u1d18\u1d00\u1d21\u0274\u1d07\u0280’
\n lore:
\n – ‘&8&m ‘
\n – ‘&l&8| &f1x \u1d18\u026a\u0262 \ua731\u1d18\u1d00\u1d21\u0274\u1d07\u0280’
\n – ‘&l&8| &7\u1d04\u1d0f\ua731\u1d1b: &d5,000 \ua731\u029c\u1d00\u0280\u1d05\ua731’
\n – ‘&8&m ‘
\n – ‘&l&8| &7\u1d04\u029f\u026a\u1d04\u1d0b \u1d1b\u1d0f \u0299\u1d1c\u028f!’
\n“`<\/p>\n
\n|—|—|—|
\n| `material` | \u2705 | Any valid Bukkit `Material` name (e.g. `DIAMOND`, `SPAWNER`) |
\n| `slot` | \u2705 | Inventory slot index, `0` to `size – 1` |
\n| `type` | \u2705 | `buy`, `sell`, `close`, or `decoration` |
\n| `price` | buy \/ sell | Shards deducted (buy) or rewarded (sell) |
\n| `amount` | buy \/ sell | Items given\/taken. Use `0` alongside `command-console` \/ `command-player` |
\n| `command-console` | optional | List of commands run as console. Supports `%player%` |
\n| `command-player` | optional | List of commands run as the player. Supports `%player%` |
\n| `display_name` | \u2705 | Supports `&` color codes |
\n| `lore` | optional | List of lore lines. Supports `&` color codes |<\/p>\n