xAlmas

📖 Overview

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.

✨ Key Features

• 💀 Custom Soul Items: Infinite types of currencies. Support for custom lore, enchantments, hidden flags, and Base64 Custom Heads.
• 🛡️ Advanced Anti-Farming: Prevent abuse with built-in IP-matching blocks and per-player cooldowns.
• 🎨 Modern Formatting: Full support for MiniMessage and HEX Colors.
• 🎲 Dynamic Drops: Souls go directly to INVENTORY or DROP on the ground.
• 📊 PlaceholderAPI Support: Use %xa_almas%.

💻 Commands & Permissions

🛠️ Configuration Snapshot

items:
  alma_premium:
    material: "PLAYER_HEAD"
    base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI..."
    name: "&#FACBCB☠ Premium Soul &#FACBCB&lF&#EED1D0&lA&#E2D8D5&lN&#D5DED9&lI&#C9E4DE&lA &#FACBCB♫"
    lore:
      - "&8 ℹ Information  "
      - "&f Exchange this rare coin for  "
      - "&f VIP rewards at spawn.  "
    enchantments:
      - "DURABILITY:3"
    flags:
      - "HIDE_ENCHANTS"
            

🚀 For Developers (API)

Hook into the plugin, manipulate soul balances, and listen to custom events.

import jn.willfrydev.xalmas.api.XAlmasAPI;

// Get total souls
int totalSouls = XAlmasAPI.getSouls(player.getUniqueId());

// Listen to events
@EventHandler
public void onSoulReceive(PlayerReceiveSoulEvent event) {
    if (event.getKiller().hasPermission("vip.doublesouls")) {
        event.setSoulType("alma_premium");
    }
}