XMyIsland

# XMyIsland

A comprehensive island management plugin that brings robust protection, intuitive GUI management, and economy integration to your Minecraft server.

## 🌟 Key Features

### Island Management
– Create personal islands with customizable sizes
– Visual border particles for easy boundary identification
– Expandable islands with economy integration
– Intuitive GUI-based management system

### Advanced Protection Systems
– Complete grief prevention
– Protection against:
– Explosions
– Liquid flow
– Redstone manipulation
– Piston mechanics
– Tree growth exploitation
– Falling block abuse
– Wither damage

### Trust System
– Detailed permission management
– GUI-based trust controls
– Per-player permission settings
– Multiple permission types:
– Block breaking/placing
– Chest access
– PvP controls
– Entity interaction
– And more!

### Economy Integration
– Expansion costs
– Configurable pricing
– Refund system for island deletion
– Full Vault support

## 🔧 Technical Details

– **Version:** 1.17+
– **Dependencies:** Vault
– **Permissions:** Automatic handling
– **Configuration:** Fully configurable
– **Database:** YAML-based storage
– **Performance:** Optimized for minimal impact

## 💡 Perfect For

– Survival servers
– Economy-focused communities
– PvE servers
– Community-driven servers
– Skyblock-style gameplay

## 🤝 Support & Community

– Active issue tracking
– Regular updates
– Community-driven development
– Comprehensive documentation

Experience the next level of island management with XMyIsland!

XLeaderBoard

🌍 English Description
⚡ **X-LeaderBoard**
Ultimate dynamic leaderboards for Minecraft!

X-LeaderBoard is a next-generation ranking system that brings real-time competition to your server using modern Text Display technology. No more bulky armor stands—just clean, lag-free holographic rankings!

🚀** Key Features**
Performance First: Built with Text Display entities to ensure zero lag on your server.

Full PAPI Support: Rank anything! Money, Kills, Level, Votes, and more via PlaceholderAPI.

Fully Customizable: Change titles, colors, and update intervals in the config.

Database Options: Support for both SQLite and MySQL.

🛠️ **Commands**
/xlb create – Create a new leaderboard.

/xlb delete – Remove a leaderboard.

/xlb reload – Reload the configuration.

📦 **Quick Start**
Place the plugin in your plugins folder.

Install PlaceholderAPI (Required).

Restart your server.

Configure your categories in config.yml and use /xlb create!

———————————————————————————————-

🇹🇷 **Türkçe Açıklama**
⚡ X-LeaderBoard
Minecraft için yeni nesil dinamik sıralama tabloları!

X-LeaderBoard, sunucunuza modern Text Display teknolojisini kullanarak anlık rekabet getiren bir sıralama sistemidir. Hantal zırh askıları (armor stand) yerine, sunucunuzu yormayan tertemiz holografik tablolar kullanın!

🚀 **Öne Çıkan Özellikler**
Önce Performans: Sunucuda gecikme yapmayan Text Display varlıkları ile kodlanmıştır.

Tam PAPI Desteği: PlaceholderAPI sayesinde Para, Öldürme, Seviye, Oy ve her şeyi sıralayın!

Tamamen Özelleştirilebilir: Başlıkları, renkleri ve güncelleme sürelerini config’den ayarlayın.

Veritabanı Seçenekleri: Hem SQLite hem de MySQL desteği mevcuttur.

🛠️ **Komutlar**
/xlb create – Yeni bir sıralama tablosu oluşturur.

/xlb delete – Mevcut bir tabloyu siler.

/xlb reload – Ayarları yeniler.

📦 **Hızlı Kurulum**
Eklentiyi plugins klasörüne atın.

PlaceholderAPI eklentisini yükleyin (Gereklidir).

Sunucuyu yeniden başlatın.

config.yml dosyasından kategorileri ayarlayıp /xlb create ile tabloları dikin!

xJobs

# 👷 xJobs | The Ultimate Professional Job System 👷
—

**xJobs** is a high-performance, premium-grade job system designed for modern Minecraft servers. Featuring a stunning **Cyan & Midnight Blue** interface, seamless **Discord integration**, and a robust **database-driven** backend, it provides your players with an immersive and rewarding professional experience.

—

> ## ✨ Premium Features
* **💎 High-End GUI**: A modern, columnar selection menu with custom heads and vibrant accent colors.
* **🌐 100% Internationalized**: Professionally translated into English, with global label management.
* **🤖 Discord Webhooks**: Real-time notifications for level-ups, job changes, and more with fully customizable embeds.
* **📊 Optimized Backend**: Support for H2 and MySQL databases with efficient caching.
* **🎭 Dynamic Lore**: Each job features unique premium descriptions and action hints.
* **🛠️ Developer Friendly**: Full PlaceholderAPI support and a simple yet powerful YML API for creating jobs.
* **⚡ Lightweight**: Built for performance, ensuring zero impact on your server’s TPS.

—

> ## 🚀 How to Create a Custom Job
Adding new professions to your server is incredibly simple. Follow this step-by-step guide:

1. Navigate to the `/plugins/xJobs/jobs/` folder.
2. Create a new file named `your_job_id.yml` (e.g., `alchemist.yml`).
3. Copy and customize the template below:

“`yaml
name: “Alchemist”
permission: “default”
max-level: 200

icon:
material: PLAYER_HEAD
base64: “eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUv…”
slot: 10
name: “Alchemist”
lore:
– “”
– ” &#A2FF5C✦ &f{info_label}:”
– ” &e⭐ &f{level_label}: &e{level}&f/&e{max_level}”
– ” &a👥 &f{workers_label}: &#D0FFD3{workers}”
– “”
– ” &#A2FF5C✦ &f{blurb_label}:”
– ” &7A master of volatile reactions. Brew concoctions”
– ” &7and elixirs that grant inhuman strength and life.”
– “”
– ” &#A2FF5C✦ &f{actions_label}:”
– ” &8▪ &7Brew magical potions”
– “”
– ” {join_action}”

actions:
block_break: # Logic for breaking blocks
‘WHEAT’:
xp: 5
money: 10.0
kill_mob: # Logic for hunting
‘ZOMBIE’:
xp: 15
money: 20.0
“`

4. Use `/jobs reload` in-game to apply your new profession immediately!

—

> ## 📌 Placeholders & Variables
Enhance your GUIs and chat with our dynamic placeholders:

| Placeholder | Description |
| :— | :— |
| `{player}` | The name of the player |
| `{job}` | The current profession name |
| `{level}` | The player’s current job level |
| `{max_level}` | The maximum level reachable |
| `{xp}` | Current experience points |
| `{xp_needed}` | Experience needed for next level |
| `{progress}` | A visual progress bar (e.g., `|||||…..`) |
| `{workers}` | Total number of players in that job |

—

> ## 🛠️ Commands & Permissions
Manage your professions with these simple commands:

| Command | Description | Permission |
| :— | :— | :— |
| `/jobs` | Open the main professional selection menu | *None* |
| `/jobs stats` | View your personal progress and statistics | *None* |
| `/jobs leave` | Resign from your current job | *None* |
| `/jobs help` | Show the command help menu | *None* |
| `/jobs reload` | Reload all configurations and jobs | `xjobs.admin` |

—

> ## 📦 Requirements
Ensure your server meets these criteria for optimal performance:

| Requirement | Description | Status |
| :— | :— | :— |
| **Vault** | Essential for economy rewards and money management | **Required** |
| **Java 17+** | Modern runtime required for high-performance execution | **Required** |
| **PlaceholderAPI** | Enables dynamic labels and custom variables | *Recommended* |

—

> ## 🛰️ Discord Integration
Keep your community engaged by linking your Discord server.
In `config.yml`, set `webhooks.discord.enabled: true` and paste your URL.

**Features:**
* **Custom Embeds**: Edit colors, footers, and thumbnails per event.
* **Async Processing**: Webhooks never lag your server.
* **Player Avatars**: Automatically fetches the player’s head for the notification.
—

> **Pro Tip**: You can edit the titles of all GUI sections (like “Information” or “Active Workers”) globally in `messages.yml`. Edit once, update everywhere!

> Got some cash? Get a PREMIUM (ES/EN) config on Discord.

Xiaoklunar Fly

# ✨ Xiaoklunar Fly (ElytraFlight)

> **Xiaoklunar Fly** is a premium-style Elytra flight plugin that gives players **creative-like flight** without removing balance or immersion.
> Perfect for servers that want flight to feel **powerful, fair, and non-cheaty**.

This plugin is ideal for:

* 💰 Monetizing flight permissions
* 🌍 Controlled flight in specific worlds (spawn, hub, RPG zones)
* ⚖️ Balanced survival gameplay using Elytra durability

—

## 🚀 What Does Xiaoklunar Fly Do?

> Xiaoklunar Fly allows players to toggle **creative-style flight** using `/elytrafly`,
> **only if all required conditions are met**.

Once enabled, the plugin **checks every second** that the player:

* Is in an **allowed world**
* Has an **Elytra equipped**
* Has the **required permission**
* Is **actively flying**

> If **any** requirement fails, flight is **immediately disabled** and the player is notified.

This behavior is similar in spirit to plugins like **EssentialsX.Flight**, but designed specifically around **Elytra-based balance and monetization**.

—

## ⭐ Core Features

### 🪽 Creative-Like Flight (Not Vanilla Gliding)

> Players fly **exactly like creative mode**.

* No awkward Elytra gliding mechanics
* Smooth, controllable, and intuitive movement

—

### 🔐 Permission-Based (Perfect for Monetization)

> Xiaoklunar Fly uses **one configurable permission node**.

* Sell access via **ranks, crates, or stores**
* Fully compatible with **LuckPerms** and other permission plugins

> 💡 **Example:**
> Sell **“Elytra Flight Access”** as a premium perk.

—

### 🌍 World-Restricted Flight

> You decide **where flight is allowed**.

Examples:

* Only in **spawn**
* Only in **hub**
* Or **every world** for full freedom

> Flight is **automatically disabled** when a player leaves an allowed world.

—

### 🛡️ Elytra Required (No Elytra = No Flight)

> Elytra is **required at all times**.

* Must be worn in the chest slot
* Removing it instantly stops flight
* Keeps Elytra meaningful and relevant

—

### 🔧 Configurable Elytra Durability Damage

> Elytra takes durability damage **every second while flying**.

* Damage applies **only while the player is actively flying**
* Fully configurable in `config.yml`

This ensures:

* Flight feels powerful
* Elytra still has a **real cost**
* No infinite free flight abuse

—

### ⏱️ Constant Safety Checks (Every Second)

> The plugin continuously verifies:

* World validity
* Elytra equipped
* Permission still present
* Player still flying

This guarantees:

* ❌ No exploits
* ❌ No bypassing restrictions
* ✅ Clean, predictable behavior

—

### 🧾 Clean & Stylish Messaging

> Fully branded as **Xiaoklunar Fly**.

* All messages use **small-caps font** for a premium look
* Color-code friendly
* Messages trigger **only once per stop reason** (no spam)

—

## 🧑‍💻 How Players Use It

> Using Xiaoklunar Fly is simple:

1. Equip an **Elytra**
2. Be in an **allowed world**
3. Have the **permission**
4. Run:

“`text
/elytrafly
“`

> Flight toggles **ON / OFF instantly**.

—

## ⚙️ Example Configuration

“`yaml
allowedWorlds:
– “spawn”
– “hub”

permissionNode: “xiaoklunar.fly”

elytraDamagePerSecond: 1
“`

> Adjust worlds, permissions, and Elytra damage to fit your server’s balance.

—

## 🧠 Why This Plugin Is Perfect

* ✅ Feels like creative flight
* ✅ Still balanced and survival-friendly
* ✅ Excellent for server monetization
* ✅ Lightweight and stable

Xiaoklunar Auction House

# Auction

A clean, GUI-first Auction House plugin for **Paper 1.21+** using **Vault** for economy.
Designed to be lightweight, permission-minimal, and easy for both players and developers.

—

## Requirements

– **Paper**: 1.21+
– **Vault** (plugin)
– **A Vault-compatible economy plugin** (e.g., EssentialsX)

> Vault does **not** store balances. You must install an economy provider.

—

## Commands

### `/ah`
Opens the global Auction House GUI.

### `/ah sell `
Lists the item currently in the player’s hand for sale.

– Item must not be `AIR`
– Item must not be blocked by config
– Price must be within configured limits
– Listing limit enforced (normal vs premium)

### `/ah storage`
Opens **Auction Storage**, showing:
– Active listings (click to cancel)
– Cancelled / expired returns (click to claim)
– Delivery overflow items (when inventory was full on purchase)

### `/ah resell`
Relists eligible stored items (premium feature + cooldown).

### `/ah `
Opens a view showing **only listings by that exact seller name**.

– Case-sensitive matching
– Does not validate whether the name belongs to a real player
– If no listings exist, GUI opens empty

### `/ah search [maxPrice]`
Searches auction listings by keyword.

– No `minecraft:` namespace required
– Matches:
– Material key/name (e.g., `iron_ingot`)
– Display name (custom items like “Bulldozer” / “Drill”)

Examples:
– `/ah search iron`
– `/ah search net`
– `/ah search note block 500` *(premium price filter)*

—

## Premium Features

Permission:
– `auctionhouse.premium`

Premium unlocks:
– Increased listing limit (default: 20 vs 10)
– `/ah resell` and “Relist All” button
– Advanced search price filter (max price argument)
– Cooldown on relist (default: 60s)

Relist spam protection:
– “Wait X seconds” message is throttled to **max once per second** per player.

—

## GUI Overview

### Auction House GUI
– Paginated
– Edge glass border
– Buttons:
– **Refresh** (nether star)
– **Storage** (chest)
– **Prev/Next page** arrows (hidden when not usable)

Listing lore formatting:
– Seller name: **Yellow**
– Price: **Green**
– Expires in: **Red**
– Lore is **non-italic**

### Confirm Purchase GUI
– Click listing → confirm screen:
– Green: Buy
– Red: Cancel (returns to `/ah`)

Purchase logic:
– Checks balance **before** opening confirmation
– On successful buy:
– Money is withdrawn
– Item delivered to inventory
– If inventory full → moved to storage as delivery overflow

### Auction Storage GUI
– Title: **Auction Storage**
– Shows:
– Active listings (cancelable)
– Cancelled returns
– Expired returns
– Overflow deliveries
– Back arrow returns to main `/ah`

Status display:
– Cancelled: red
– Expired: red
– Delivery: yellow

—

## Sounds

– Successful listing: “ding” sound
– Listing denied (limit reached / not allowed): villager “no”
– Successful purchase: villager “yes”
– Seller receives notification + sound on successful sale

—

## Configuration

Key config options include:
– Listing limits for normal/premium
– Maximum sell price
– Premium relist cooldown
– Blocked item list
– GUI sound toggles (if present in your build)

*(Exact keys depend on your current shipped config.yml.)*

—

## Installation

1. Drop into `plugins/`:
– Vault
– Economy plugin (e.g., EssentialsX)
– Xiaoklunar Auction
2. Start server
3. Configure `config.yml`
4. Assign premium permission (optional)
– Example (LuckPerms):
“`
/lp group premium permission set auctionhouse.premium true
“`

—

## Troubleshooting

### Vault installed but economy not working
Vault needs an economy provider (EssentialsX, etc.). Check console for economy registration logs.

### “Invalid plugin.yml”
YAML must use spaces (no tabs) and usage strings should be quoted.

Have fun

XfeaturesRPGMoney

# 💰 XfeaturesRPGMoney

## 📝 Description

**XfeaturesRPGMoney** is an innovative economic plugin for Minecraft servers that adds RPG elements to your server’s economy. The plugin provides players with a variety of ways to earn in-game currency:

– 💀 **Mob hunting**: earn money for killing various creatures
– 🎣 **Fishing**: earn money by catching different types of fish
– ⛏️ **Block mining**: get a chance to earn money when mining certain blocks
– 🔍 **Archaeology**: get rewards for mining archaeological treasures

The plugin is fully integrated with the Vault API, ensuring compatibility with most economic systems.

## ✨ Key features

– **Flexible reward system**: customizable minimum and maximum amounts for each source of income
– **Luck and loot multipliers**: Fortune and Looting enchantments increase the reward received
– **Player statistics**: track money earned and create a ranking of the best players
– **Visual effects**: animated appearance of coins in the game world
– **Full message customization**: all notifications can be changed in the configuration
– **Easy management**: intuitive commands for players and administrators

## 📋 Requirements

– Spigot/Paper 1.13+
– Vault
– Any economic plugin compatible with Vault (e.g., EssentialsX, CMI)

## 🔧 Installation

1. Download the latest version of the plugin from the [Releases](https://github.com/XfeaturesGroup/XfeaturesRPGMoney/releases) section
2. Place the JAR file in the `plugins` folder of your server
3. Restart the server
4. Configure the configuration files as you see fit
5. Reload the plugin with the command `/rpgmoney reload`

## 📜 Commands
| Command | Description | Permissions |
|———|———-|——-|
| `/rpgmoney reload` | Reload configuration | `xfeatures.rpgmoney.reload` |
| `/rpgmoney stats` | Show your stats | – |
| `/rpgmoney top [page]` | Show top players | `xfeatures.rpgmoney.top` |
| `/rpgmoney info` | Plugin information | – |
| `/rpgmoney language ` | Change plugin language | `xfeatures.rpgmoney.language` |

## 🔒 Permissions
– xfeatures.rpgmoney.reload – Access to the reload command
– xfeatures.rpgmoney.top – Access to view the top players
– xfeatures.rpgmoney.admin – Full access to all plugin features
– xfeatures.rpgmoney.language – Access to change the plugin language

## 🛠️ API for developers
The plugin provides an API for integration with other plugins:

“`java
// Getting a plugin instance
XfeaturesRPGMoney plugin = (XfeaturesRPGMoney) Bukkit.getPluginManager().getPlugin(“XfeaturesRPGMoney”);

// Working with mob configuration
MobConfig mobConfig = plugin.mobConfig;
List zombieReward = mobConfig.getReward(“zombie”);
double min = zombieReward.get(0);
double max = zombieReward.get(1);

// Working with the plugin API
RPGMoneyAPI api = plugin.getAPI();
// Get a random value in the range
double amount = api.getRandomInRange(10.0, 20.0);
// Drop money in the world
api.dropMoney(location, amount);
// Check if the block was placed by the player
boolean isPlayerPlaced = api.isPlayerPlacedBlock(location);
“`

## 📊 Performance
### The plugin is optimized for minimal impact on server performance:
– Asynchronous data saving
– Optimized reward calculation algorithms
– Minimal memory usage

## 📝 Future plans
– ✅ More refined configurations **(Implemented)**
– ✅ Support for more languages **(Implemented)**
– Integration with PlaceholderAPI
– Graphical interface for managing settings
– Adding rewards for Archaeology, Research, Creation

## 🤝 Contributing to the project
### Contributions are welcome! If you have ideas for improving the plugin:
1. Fork the repository
2. Create a branch for your feature (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m ‘Add some amazing feature’)
4. Push the changes to your fork (git push origin feature/amazing-feature)
5. Open a Pull Request

## 📊 Statistics
### The plugin collects anonymous statistics via bStats to improve functionality:
You can view the plugin statistics on the [bStats](https://bstats.org/plugin/bukkit/XfeaturesRPGMoney/26636) page.


### Data collected:
– Total amount of money in the economy
– Number of players with money records
– Use of messages in the action bar
– Use of Fortune and Looting multipliers
– Number of players and servers
– Online mode status
– Server, plugin, and Java versions

### Disabling statistics
If you want to disable statistics collection, you can do so in the `plugins/bStats/config.yml` file by setting `enabled: false`. Disabling statistics does not affect the functionality of the plugin.

## 📞 Support
### If you encounter any problems or have any questions:
– Create an issue in the repository
– Contact us via [Discord](https://discord.gg/KJU4DjGkeH)


Made with ❤️ by the XfeaturesGroup team

XercaMod

This mod adds a lot of content to the game. For detailed information, please visit this page.

The additions include:

• Food, especially fast food and desserts
• Tea!
• Unique tools and weapons with enchantments including Warhammer, Grab Hook, Knife, Scythe, etc.
• “Ender Flask” that can be filled with multiple charges of potion
• And Potion Launcher for throwable potions
• Cushions that you can sit on
• A bookshelf that works and shows how many books it holds
• Spyglass (removed in 1.17, since Mojang added it to the base game)
• Confetti and Confetti Balls
• Carved wood with cool designs
• Terracotta tiles, roof material of every color
• Rope that you can climb
• Omni chest, a global ender chest for the whole universe
• Other decorative blocks and items

Configuration

You can edit the xercamod-common.toml file in the config directory to enable/disable each feature in the mod independently.

New in 1.17.1-2.1

Omni Chest

Omni Chest is like Ender Chest, but for the whole universe. It holds a global inventory that anyone can access from anwhere in any dimension. It is everyone’s chest, and yet noone’s at the same time. Get collaborative with your server mates and use this unique logistical ability to your advantage.

Devour

There is a new combat enchantment for the Scythe! It lets you drop little hearts out of the enemy you strike, which you can pick up to replensish health! There is a chance to drop a heart at each hit depending on the Devour level, and a certain amount of heart drops at the killing blow, that again vary depending on the enchantment level.

Food

Cheese and Pizza

You can make cheese to use in recipes or eat as is. The process of making cheese is as follows:

• Craft a curdling vat as in the recipe, using copper and iron ingots.
• Pour milk into the vat.
• Wait as the protein in the milk solidifies into cheese. It should take around 1 minute on average.
• Right click on the vat to retrieve the cheese wheel, then place it on a surface.
• You can eat the cheese in pieces directly from the wheel, or slice it using a knife.

We have wheat, tomatoes, and now cheese. The logical conclusion to all of this is Pizza, of course.

You can prepare a base pizza using these three ingredients, and then either bake it as is to get a margherita pizza, or add toppings of your choosing to create the pizza of your dreams.

The ingredients you can use are sausage, mushroom, chicken, cod fish and doner. You can add up to three ingredients in total. There are 56 variations in total, so go ham with it.

Pizza is eaten in “circular” slices in a way similar to cheese.

Soda

After gulping down all the greasy foodstuff you can get your hands on, there is nothing like carbonated sugar water to wash down your throat. All of the fizzy drinks have a nice, fizzy animation.

You can use an empty glass on a bubbling soul sand to acquire sparkling water. From there, getting to a generic soda is a matter of adding sugar and a snowball to your drink.

Making cola is a little more involved, since it requires processing secret ingredients in a secret procedure:

• Craft the secret cola formula powder using warped roots, rotten flesh, spider eye and three units of sugar.
• Brew the powder into water bottles to get the extract.
• Combine the extract and two snowballs with six glasses of sparkling water to get six glasses of cola.

Drinking cola gives you a Haste effect to reward your efforts.

New Food Items

A few new cheesy and glowy food items are added. Also, the top part of ultimate burger is updated to contain cheese now. Eating glow berry cupcake and glow squid ink paella will make you glow as well.

 In addition, the textures of many old food items are updated now!

Nether Carved Wood

There are now carved wood variants for nether stems, namely Crimson Stem and Warped Stem. Differing from their overworld counterparts, these blocks have netherly animations!

Rope with Pistons

Rope now acts like slime block when interacting with pistons!

Credits:

Credits to LuchadorMickey for most of the graphics (good looking ones).

Credits to chechnyacool488 for the Russian translation 

Credits to junshengxie for the Chinese translation

Notes:

• Use the one for the latest Minecraft version to get all the features. Older versions may not have newer features.

XD’s Utils

## Description

XD’s Utils is a plugin and mod that provides a custom web interface that you can monitor the whole server, create backups to restore points of your server with a simple script to restore to a backup, an API to get and modify data of the server and plugin through sending web requests, and more!

## Features

| Feature | Implementation |
|——————-|—————-|
| Invsee | ✅ |
| AFK Detector | ✅ |
| Bounties | ✅ |
| Custom Shops | ✅ |
| Economy | ✅ |
| Chat Muting | ✅ |
| Chat Censoring | ✅ |
| Disabled Commands | ✅ |
| Disabled Items | ✅ |
| Custom Messages | ✅ |
| Backups | ✅ |
| Web Interface | ✅ |
| Commands | ✅ |

> ✅ : Implemented
>
> 🚧 : Work in Progress
>
> ❌ : Not implemented

## Config

XDailyVoucher

# XDailyVoucher

A feature-rich daily rewards and voucher system for your Minecraft server!

## 📚 Overview

XDailyVoucher brings an engaging rewards system to your server, encouraging player retention through daily login rewards and a flexible voucher system.

### ✨ Features

**Daily Rewards:**
– Progressive rewards with streak bonuses
– Custom rewards for each day
– Special weekly rewards
– Visual GUI interface
– Persistent streak tracking

**Voucher System:**
– Create custom vouchers
– Multiple rewards per voucher
– Support for both command and item rewards
– Visual GUI for editing voucher contents
– Flexible command execution
– Admin distribution controls
– Player redemption system with limits

## 🎮 Usage

### Player Commands:
– `/xdv daily` – Open daily rewards GUI
– `/xdv redeem ` – Redeem available vouchers

### Admin Commands:
– `/xdv reload` – Reload configuration
– `/xdv voucher ` – Create vouchers
– `/xdv vgui ` – Edit voucher items through GUI
– `/xdv give [amount]` – Distribute vouchers
– `/xdv dailyitem ` – Set rewards
– `/xdv active ` – Enable redemption
– `/xdv deactive ` – Disable redemption
– `/xdv vlist` – List all vouchers

## 📋 Requirements

– Paper 1.17+
– Vault

## ⚙️ Configuration

Easily customize through `config.yml`:
– Base reward amounts
– Streak multipliers
– All messages and notifications

## 🔒 Permissions

– `xdv.admin` – Administrative access
– `xdv.use` – Basic player access (default: true)

## 🔧 Installation

1. Download the plugin
2. Place in plugins folder
3. Restart server
4. Configure settings

## 🤝 Support

Need help? Found a bug? Have a suggestion?
– Create an issue on our [GitHub](https://github.com/Akar1881/xdailyvoucher)

## 📝 License

Released under the GNU License

xAlmas

⚡ xAlmas – Premium PvP Soul Economy ⚡

The ultimate, highly customizable PvP economy plugin for your Minecraft server.

[](https://jitpack.io/#WilfryDev/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.

Whether you want to use standard dyes or custom Base64 player heads, **xAlmas** gives you complete control over your server’s kill-reward economy!

## ✨ Key Features

* 💀 **Custom Soul Items:** Create infinite types of currencies! Support for standard materials, custom lore, enchantments, hidden flags, and **Base64 Custom Heads**.
* 🛡️ **Advanced Anti-Farming System:** Prevent abuse with built-in IP-matching blocks and configurable per-player cooldowns.
* 🎨 **Modern Formatting:** Full support for **MiniMessage** and **HEX Colors** (`&#HEX` or `<#HEX>`). Make your items and chat messages look stunning.
* 🎲 **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!
* 🌍 **World Whitelist/Blacklist:** Disable soul drops in specific worlds (e.g., spawn or end).
* 📊 **PlaceholderAPI Support:** Display player soul stats on scoreboards or menus using `%xa_almas%`.
* 🔊 **Custom Sounds:** Play specific sounds (with adjustable pitch and volume) when a player collects a soul.
* ⚙️ **Developer API:** Includes a powerful API with custom events so other plugins can interact with the economy.

—

## 💻 Commands & Permissions

All commands are manageable under a single, easy-to-use base command with full Tab-Completer support.

| Command | Description | Permission |
| :— | :— | :— |
| `/xa help` | Shows the custom help menu. | `xalmas.admin` |
| `/xa give ` | Gives a specific amount of souls to a player. | `xalmas.admin` |
| `/xa reload` | Reloads `config.yml`, `almas.yml`, and data safely. | `xalmas.admin` |

—

## 🔌 [PlaceholderAPI](https://modrinth.com/plugin/placeholderapi)

> Make sure you have
> installed to use this feature!

* `%xa_almas%` — Returns the total amount of souls the player has collected.

—

## 🛠️ Configuration Snapshot

Setting up your items in `almas.yml` is incredibly easy. Here is an example of a premium Base64 head setup:

“`yaml
items:
alma_premium:
material: “PLAYER_HEAD”
base64: “eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvOGRjODgwNTNjMWE4NTNmNzE2NmM5ZTkzYmIzYzUxN2YwODE5NTQ0NzM5ZGJlYWJkNDhhODU5Y2VkNDIwYjcwYiJ9fX0=”
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. ”
– “”
– “&#FACBCB ▸ Special Edition! ”
– “”
enchantments:
– “DURABILITY:3”
flags:
– “HIDE_ENCHANTS”
“`

—

## 🚀 For Developers (API)

**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.

### 1. Dependency Installation
First, 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`)*.

**Gradle (Kotlin DSL)**
“`kotlin
repositories {
mavenCentral()
maven(“[https://jitpack.io](https://jitpack.io)”)
}

dependencies {
compileOnly(“com.github.WilfryDev:xAlmas:VERSION”)
}
“`

**Gradle (Groovy)**
“`gradle
repositories {
mavenCentral()
maven { url ‘[https://jitpack.io](https://jitpack.io)’ }
}

dependencies {
compileOnly ‘com.github.WilfryDev:xAlmas:VERSION’
}
“`

**Maven**
“`xml


jitpack.io
[https://jitpack.io](https://jitpack.io)

com.github.WilfryDev
xAlmas
v1.0.1
provided


“`

### 2. Available Events

**`PlayerReceiveSoulEvent`**
This event is fired right before a player receives a soul item from a PvP kill.
* `isCancelled()` / `setCancelled(boolean)`: Cancel the event to prevent the drop.
* `getSoulType()` / `setSoulType(String)`: View or dynamically change the type of soul awarded based on killer’s ranks or permissions.
* `getKiller()` / `getVictim()`: Get the exact players involved in the event.

“`java
@EventHandler
public void onSoulReceive(PlayerReceiveSoulEvent event) {
if (event.getKiller().hasPermission(“vip.doublesouls”)) {
// You can change the soul dropped to a premium one dynamically
event.setSoulType(“alma_premium”);
}
}
“`

### 3. API Methods

You can easily interact with a player’s saved data using the `XAlmasAPI` class.

“`java
import jn.willfrydev.xalmas.api.XAlmasAPI;

// Get the total amount of souls a player has
int totalSouls = XAlmasAPI.getSouls(player.getUniqueId());

// Add souls directly to a player’s data file
XAlmasAPI.addSouls(player.getUniqueId(), 5);

// Remove souls safely (will not drop below 0)
XAlmasAPI.removeSouls(player.getUniqueId(), 2);
“`

—
*Optimized for Paper 1.16.5+.*
> 💗 By xPlugins :=)