\n The ultimate, highly customizable PvP economy plugin for your Minecraft server.<\/b>\n<\/p>\n
\n
\n—<\/p>\n
## \ud83d\udcd6 Overview<\/p>\n
**xAlmas** is a premium Minecraft plugin designed to reward players for their PvP skills. Every time a player gets a kill, they can collect the victim’s “soul” as a physical, highly customizable item. It features a robust anti-farming system, modern HEX color support, and a dedicated Developer API. <\/p>\n
Whether you want to use standard dyes or custom Base64 player heads, **xAlmas** gives you complete control over your server’s kill-reward economy!<\/p>\n
## \u2728 Key Features<\/p>\n
* \ud83d\udc80 **Custom Soul Items:** Create infinite types of currencies! Support for standard materials, custom lore, enchantments, hidden flags, and **Base64 Custom Heads**.
\n* \ud83d\udee1\ufe0f **Advanced Anti-Farming System:** Prevent abuse with built-in IP-matching blocks and configurable per-player cooldowns.
\n* \ud83c\udfa8 **Modern Formatting:** Full support for **MiniMessage** and **HEX Colors** (`&#HEX` or `<#HEX>`). Make your items and chat messages look stunning.
\n* \ud83c\udfb2 **Dynamic Drops:** Choose whether souls go directly into the killer’s `INVENTORY` or `DROP` on the ground. You can even set the dropped item to be `random` from your configured list!
\n* \ud83c\udf0d **World Whitelist\/Blacklist:** Disable soul drops in specific worlds (e.g., spawn or end).
\n* \ud83d\udcca **PlaceholderAPI Support:** Display player soul stats on scoreboards or menus using `%xa_almas%`.
\n* \ud83d\udd0a **Custom Sounds:** Play specific sounds (with adjustable pitch and volume) when a player collects a soul.
\n* \u2699\ufe0f **Developer API:** Includes a powerful API with custom events so other plugins can interact with the economy.<\/p>\n
—<\/p>\n
## \ud83d\udcbb Commands & Permissions<\/p>\n
All commands are manageable under a single, easy-to-use base command with full Tab-Completer support.<\/p>\n
| Command | Description | Permission | —<\/p>\n ## \ud83d\udd0c PlaceholderAPI<\/p>\n > Make sure you have * `%xa_almas%` \u2014 Returns the total amount of souls the player has collected.<\/p>\n —<\/p>\n ## \ud83d\udee0\ufe0f Configuration Snapshot<\/p>\n Setting up your items in `almas.yml` is incredibly easy. Here is an example of a premium Base64 head setup:<\/p>\n “`yaml —<\/p>\n ## \ud83d\ude80 For Developers (API)<\/p>\n **xAlmas** is built with extensibility in mind. You can use our API via JitPack to hook into the plugin, manipulate soul balances, and listen to custom events.<\/p>\n ### 1. Dependency Installation **Gradle (Kotlin DSL)** dependencies { **Gradle (Groovy)** dependencies { **Maven** ### 2. Available Events<\/p>\n **`PlayerReceiveSoulEvent`** “`java ### 3. API Methods<\/p>\n You can easily interact with a player’s saved data using the `XAlmasAPI` class.<\/p>\n “`java \/\/ Get the total amount of souls a player has \/\/ Add souls directly to a player’s data file \/\/ Remove souls safely (will not drop below 0) — The ultimate, highly customizable PvP economy plugin for your Minecraft server.<\/p>\n","protected":false},"featured_media":172235,"template":"","meta":{"_minecraft_slug":"xalmas","_minecraft_project_id":"xuV69yHE","_minecraft_author":"jn_willfrydev","_minecraft_license":"Apache-2.0","_minecraft_downloads":32,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"xalmas.zip","_minecraft_size_bytes":18917,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T22:01:48.633459Z","_minecraft_date_created":"2026-03-06T23:30:28.677956Z","_minecraft_date_modified":"2026-03-06T19:35:53.886725Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/xalmas","_minecraft_icon_attachment_id":172235,"_minecraft_imported_at":"2026-06-09T21:57:34+00:00","_minecraft_import_hash":"a9d2bfdd242402d0c3312c39fc64ed47","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,844,89,866,127,129,92],"mod_loader":[130,132,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-172234","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-economy","mod_category-game-mechanics","mod_category-minigame","mod_category-paper","mod_category-spigot","mod_category-utility","mod_loader-bukkit","mod_loader-paper","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","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| `\/xa help` | Shows the custom help menu. | `xalmas.admin` |
\n| `\/xa give
\n| `\/xa reload` | Reloads `config.yml`, `almas.yml`, and data safely. | `xalmas.admin` |<\/p>\n
\n
\n> installed to use this feature!<\/p>\n
\nitems:
\n alma_premium:
\n material: “PLAYER_HEAD”
\n base64: “eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGRjODgwNTNjMWE4NTNmNzE2NmM5ZTkzYmIzYzUxN2YwODE5NTQ0NzM5ZGJlYWJkNDhhODU5Y2VkNDIwYjcwYiJ9fX0=”
\n name: “&#FACBCB\u2620 Premium Soul &#FACBCB&lF&#EED1D0&lA&#E2D8D5&lN&#D5DED9&lI&#C9E4DE&lA &#FACBCB\u266b”
\n lore:
\n – “”
\n – “&8 \u2139 Information ”
\n – “”
\n – “&f Exchange this rare coin for ”
\n – “&f VIP rewards at spawn. ”
\n – “”
\n – “&#FACBCB \u25b8 Special Edition! ”
\n – “”
\n enchantments:
\n – “DURABILITY:3”
\n flags:
\n – “HIDE_ENCHANTS”
\n“`<\/p>\n
\nFirst, add the JitPack repository and the xAlmas dependency to your project. *(Make sure to replace `VERSION` with the latest release, e.g., `v1.0.1`)*.<\/p>\n
\n“`kotlin
\nrepositories {
\n mavenCentral()
\n maven(“https:\/\/jitpack.io”)
\n}<\/p>\n
\n compileOnly(“com.github.WilfryDev:xAlmas:VERSION”)
\n}
\n“`<\/p>\n
\n“`gradle
\nrepositories {
\n mavenCentral()
\n maven { url ‘https:\/\/jitpack.io’ }
\n}<\/p>\n
\n compileOnly ‘com.github.WilfryDev:xAlmas:VERSION’
\n}
\n“`<\/p>\n
\n“`xml
\n
\n
\n
\n
\n <\/repository>
\n<\/repositories><\/p>\n
\n
\n
\n
\n
\n
\n <\/dependency>
\n<\/dependencies>
\n“`<\/p>\n
\nThis event is fired right before a player receives a soul item from a PvP kill.
\n* `isCancelled()` \/ `setCancelled(boolean)`: Cancel the event to prevent the drop.
\n* `getSoulType()` \/ `setSoulType(String)`: View or dynamically change the type of soul awarded based on killer’s ranks or permissions.
\n* `getKiller()` \/ `getVictim()`: Get the exact players involved in the event.<\/p>\n
\n@EventHandler
\npublic void onSoulReceive(PlayerReceiveSoulEvent event) {
\n if (event.getKiller().hasPermission(“vip.doublesouls”)) {
\n \/\/ You can change the soul dropped to a premium one dynamically
\n event.setSoulType(“alma_premium”);
\n }
\n}
\n“`<\/p>\n
\nimport jn.willfrydev.xalmas.api.XAlmasAPI;<\/p>\n
\nint totalSouls = XAlmasAPI.getSouls(player.getUniqueId());<\/p>\n
\nXAlmasAPI.addSouls(player.getUniqueId(), 5);<\/p>\n
\nXAlmasAPI.removeSouls(player.getUniqueId(), 2);
\n“`<\/p>\n
\n*Optimized for Paper 1.16.5+.*
\n> \ud83d\udc97 By xPlugins :=)<\/p>\n","protected":false},"excerpt":{"rendered":"