# GemEngine \u2013 Plugin Description<\/p>\n
**GemEngine** is a Minecraft plugin for Paper servers that provides a flexible multi-economy system. It allows you to manage multiple independent currencies per player, accessible via commands and PlaceholderAPI.<\/p>\n
—<\/p>\n
## \u2699\ufe0f Requirements<\/p>\n
| Plugin | Required? | Purpose |
\n|—|—|—|
\n| PlaceholderAPI | \u2705 Required | Provides the `%gemengine_…%` placeholders |
\n| Vault | \u274c Optional | Automatic detection of installed economies (e.g. Essentials) |<\/p>\n
—<\/p>\n
## \ud83d\udcc2 Files<\/p>\n
### `config.yml` \u2013 Configure Economies
\nThis is where all currencies managed by the plugin are defined.<\/p>\n
“`yaml
\neconomies:
\n gems:
\n name: “Gems” # Display name of the currency
\n allow-pay: true # Can players transfer to each other?
\n coins:
\n name: “Coins”
\n allow-pay: false
\n“`<\/p>\n
> **Tip:** If Vault + Essentials are installed, an entry for the Essentials economy will be generated automatically on server start \u2014 no manual setup required.<\/p>\n
—<\/p>\n
### `data.yml` \u2013 Player Data
\nAll player balances are stored here. This file is managed automatically and should not be edited manually.<\/p>\n
“`yaml
\n#Example
\n550e8400-e29b-41d4-a716-446655440000:
\n gems: 150.0
\n coins: 320.50
\n“`<\/p>\n
—<\/p>\n
## \ud83d\udcac Commands<\/p>\n
### `\/gpay | Argument | Description | **Example:** —<\/p>\n ### `\/gemengine eco | Action | Description | **Examples:** —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Description | —<\/p>\n ## \ud83d\udcca Placeholders (PlaceholderAPI)<\/p>\n The placeholder format is: The ` **Examples:**<\/p>\n | Placeholder | Returns | > Values are always returned with **2 decimal places**, e.g. `150.00`<\/p>\n —<\/p>\n ## \ud83d\udd17 Vault Integration<\/p>\n If **Vault** is installed alongside an economy plugin such as **EssentialsX**, GemEngine will automatically detect it on startup and add a matching entry to `config.yml`.<\/p>\n **Example:** EssentialsX is installed and uses `Dollars` as its currency.<\/p>\n On the first server start, the following will appear in the console: The `config.yml` will then be automatically updated with this entry: > **Note:** `allow-pay` is intentionally set to `false` to prevent accidental transfers from being enabled. This can be changed manually in `config.yml`. For more help and explanations look in the `config.yml` and `message.yml`.<\/p>\n —<\/p>\n ## \ud83d\ude80 Installation<\/p>\n 1. Drop `GemEngine.jar` into your server’s `plugins\/` folder With this project you can add multiple currencies with Placeholder api support<\/p>\n","protected":false},"featured_media":75074,"template":"","meta":{"_minecraft_slug":"gemengine","_minecraft_project_id":"5hSdft7l","_minecraft_author":"Liquit13","_minecraft_license":"MIT","_minecraft_downloads":20,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"gemengine.zip","_minecraft_size_bytes":14469055,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-15T22:30:22.271898Z","_minecraft_date_created":"2026-04-29T04:05:58.588924Z","_minecraft_date_modified":"2026-05-01T22:56:41.439243Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/gemengine","_minecraft_icon_attachment_id":75074,"_minecraft_imported_at":"2026-06-04T08:30:56+00:00","_minecraft_import_hash":"795dd4df1ef1a9614c16c108c5500fd9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,126,127,91],"mod_loader":[132],"minecraft_version":[163],"class_list":["post-75073","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-management","mod_category-paper","mod_category-storage","mod_loader-paper","minecraft_version-26-1-2"],"yoast_head":"\n
\nTransfers an amount of a specific currency to another player.<\/p>\n
\n|—|—|
\n| `
\n| `
\n| `
\n“`
\n\/gpay gems Steve 50
\n“`
\n> \u26a0\ufe0f Transfers must be enabled per economy in config.yml via `allow-pay: true`. The sender also needs a sufficient balance.<\/p>\n
\nAdmin command for manually managing player balances.<\/p>\n
\n|—|—|
\n| `set` | Sets the balance to a specific value |
\n| `add` | Adds an amount to the balance |
\n| `remove` | Deducts an amount from the balance (minimum 0, no negative balance) |<\/p>\n
\n“`
\n\/gemengine eco set gems Steve 500
\n\/gemengine eco add coins Steve 100
\n\/gemengine eco remove gems Steve 25
\n“`<\/p>\n
\n|—|—|
\n| `gemengine.admin` | Access to `\/gemengine eco` |<\/p>\n
\n“`
\n%gemengine_
\n“`<\/p>\n
\n|—|—|
\n| `%gemengine_gems%` | The player’s balance in the “gems” economy |
\n| `%gemengine_coins%` | The player’s balance in the “coins” economy |<\/p>\n
\n“`
\n[GemEngine] Vault Economy ‘Essentials Economy’ detected!
\n[GemEngine] Entry ‘essentials_economy’ has been automatically added to config.yml.
\n[GemEngine] Placeholder: %gemengine_essentials_economy%
\n“`<\/p>\n
\n“`yaml
\neconomies:
\n essentials_economy:
\n name: “Dollars”
\n allow-pay: false
\n“`<\/p>\n
\n2. Make sure PlaceholderAPI is installed as well
\n3. Start the server \u2014 config files will be created automatically
\n4. Add your own economies in `plugins\/GemEngine\/config.yml`
\n5. Restart the server<\/p>\n","protected":false},"excerpt":{"rendered":"