xAlmas

⚡ xAlmas – Premium PvP Soul Economy ⚡

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

—

## 📖 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

> 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”)
}

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

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

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

**Maven**
“`xml


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 :=)

xali’s White Diamond

# xali’s White Diamond
Introducing a stunning twist to the world of Minecraft, xali’s White Diamond brings a touch of elegance to the iconic diamond ore. Step into a realm of luxury with dazzling white diamonds that feature exquisite custom textures. Every swing of your pickaxe will reveal a treasure worth coveting. Experience the game like never before as your mining adventures become a quest for opulence. Embrace the beauty of these refined gemstones and elevate your Minecraft gameplay to new levels of sophistication with xali’s White Diamond.

## Requirement
There is no requirement

xali’s Potions – Addon

This project is fan made and not directly related to any of xali’s works. Xali owns all the rights to “xali’s Potions”
Click the banner below to download original “xali’s Potions”. Original file is required for this pack to operate correctly!


^ Click it ^

Resource packs must be installed in the following order:


 
### **1.21.5+** Updating the pack to 1.21.5+ right now is not possible due to this Minecraft bug. As soon as this issue is fixed, I’ll update the pack to the next supported version

—

**ATTENTION!**

You are **required** to install any mod that can work with custom CIT resource packs for the pack to be able to operate: Optifine, CIT Resewn, Forge CIT, CIT Reforged, [[CIT] CustomItemTextures](https://modrinth.com/mod/cit), etc. The pack should work on any Minecraft version with any mentioned mods. Ignore the “Incompatible” warning.

The purpose of this pack is to provide additional mod support to “xali’s Potions”. This pack does not include any textures that are already included in “xali’s Potions” and only adds those which are missing. This pack probably won’t be updated with any more additional mods in the future because it was made just for our own personal experience that I decided to share.

Mods supported by this pack:

– Nether’s Exoticism
– Kobolds
– Undergarden
– Alex’s Mobs
– Upgrade Aquatic
– Removed Content Revival
– Phantasm

—

All the art is done by HASKO, pack assembled by DedMaxim99

HASKO VK page

Anybody is free to use this pack anywhere. Just do not rename the pack, please.

Contact me (DedMaxim99):

My YouTube channel

My Twitch channel

My VK page

My Telegram

xali’s Potions

# xali’s Potions

Introducing Xali’s Potions, an extraordinary texture pack that revolutionizes the world of Minecraft. Say farewell to the mundane as every potion undergoes a mesmerizing transformation, breaking free from the uniformity of default textures.
Immerse yourself in a realm where creativity knows no bounds, as each potion radiates with distinct and captivating designs. From the ethereal glow of the night vision potion to the fiery essence of strength, experience a visual feast that brings enchantment to life. Unleash your brewing prowess and embark on a thrilling journey where every sip becomes an immersive and magical adventure. Upgrade your Minecraft experience with Xali’s Potions and redefine the art of potion-making in truly mesmerizing ways.

xali’s Framed Planks

This texture pack basically add a new blocks to the game with minimal impact with a minimal impact to vanilla. It will simply add a new texture to double slab (Full block) without changing the functionality of single slabs or planks. This is the perfect pack to enhance your building!

xali’s Enhanced Jungle Wood

# xali’s Enhanced Jungle Wood

Introducing Xali’s Enhanced Jungle Wood, a captivating texture pack that breathes new life into the world of Minecraft. Experience the lush beauty of the jungle like never before as the textures of jungle wood are completely transformed. Immerse yourself in a vibrant realm where each block radiates with the essence of the wilderness. Let your creativity flourish in a tropical paradise with Xali’s Enhanced Jungle Wood texture pack.

xali’s Enhanced Biome River & Pond

# Xali’s Enhanced Biome: River and Pond

Introducing Xali’s Enhanced Biome: River and Pond, a transformative texture pack that revolutionizes the natural beauty of Minecraft. Dive into a world where rivers and ponds come alive with breathtaking visuals. Witness the serene flow of water as it meanders through lush landscapes, enhanced by meticulously crafted textures. Immerse yourself in the tranquility of nature, with vibrant flora and fauna that harmonize seamlessly with the enchanting waterscapes. Whether you seek a peaceful fishing spot or wish to explore the hidden depths of aquatic life, Xali’s Enhanced Biome: River and Pond is your gateway to a captivating and immersive Minecraft experience.

xali’s Enchanted Books – Fix

This project is fan made and not directly related to any of xali’s works. Xali owns all the rights to “xali’s Enchanted Books”
Click the banner below to download original “xali’s Enchanted Books”.
Original file is required for this pack to operate correctly!

## What does this pack “fix”?

**If there are mods present that increase enchantments’ max levels like Apotheosis, those books would have missing textures. So, with this Apotheosis examle, there are books like “Sharpness VII”, that won’t have a custom texture without this pack. The fix makes it so any level above vanilla maximum will use the texture of max level enchantment. This pack does not include any textures that are already included in “xali’s Enchanted Books” and only adds those which are missing, so you need to install both: this fix and the original pack.**

DOWNLOAD ORIGINAL AND ADDON:


**[Below 1.21.5]** Resource packs must be installed in the following order:

**[1.21.5+]** Starting 1.21.5, if you use xali’s Enchanted Books – Addon you DO NOT need to use this pack. The “fix” is now integrated into the Addon pack!

—

**ATTENTION!**

You are **required** to install any mod that can work with custom CIT resource packs for the pack to be able to operate: Optifine, CIT Resewn, Forge CIT, CIT Reforged, [[CIT] CustomItemTextures](https://modrinth.com/mod/cit), etc. The pack should work on any Minecraft version with any mentioned mods. Ignore the “Incompatible” warning.

**ATTENTION!** At the moment of writing, 04 Jul 2024, CIT Reforged has a bug that prevents this pack from operating! Use Optifine or try to launch Fabric version, CIT Resewn, using Sinytra Connector

—

Anybody is free to use this pack anywhere. Just do not rename the pack, please.

Contact me:

My YouTube channel

My Twitch channel

My VK page

My Telegram

xali’s Enchanted Books – Addon

This project is fan made and not directly related to any of xali’s works. Xali owns all the rights to “xali’s Enchanted Books”
Click the banner below to download original “xali’s Enchanted Books”. Original file is required for this pack to operate correctly!

The purpose of this pack is to provide additional mod support to “xali’s Enchanted Books”. This pack does not include any textures that are already included in “xali’s Enchanted Books” and only adds those which are missing. This pack probably won’t be updated with any more additional mods in the future because it was made just for our own personal experience that I decided to share.


^ Click it ^

Resource packs must be installed in the following order:


### **ATTENTION!**

**[1.21.5+]** Since vanilla Minecraft now has support for custom item models, no additional mods are required!
Additionally, now [xali’s Enchanted Books – Fix]([https://modrinth.com/resourcepack/xalis-enchanted-books-fix](https://modrinth.com/resourcepack/xalis-enchanted-books-fix)) is integrated into the Addon due to how custom models for enchanted books are implemented by Mojang.

**[Below 1.21.5]** You are **required** to install any mod that can work with custom CIT resource packs for the pack to be able to operate: Optifine, CIT Resewn, Forge CIT, CIT Reforged, [[CIT] CustomItemTextures](https://modrinth.com/mod/cit), etc. The pack should work on any Minecraft version with any mentioned mods. Ignore the “Incompatible” warning.

Mods supported by this pack:

– Supplementaries
– Combat Roll
– Endless Biomes
– Kobolds
– Undergarden
– Farmer’s Delight

—

All the art is done by HASKO, pack assembled by DedMaxim99

HASKO VK page

Anybody is free to use this pack anywhere. Just do not rename the pack, please.

Contact me (DedMaxim99):

My YouTube channel

My Twitch channel

My VK page

My Telegram

xali’s Enchanted Books


# xali’s Enchanted Books
Trying to find the enchanted book I wanted in a chest full of it have always been a pain to me. This pack aim to resolve that issue by giving every enchanted book a different texture base on their type and their level while keeping an art style that still fit into the base game. 

## Supported Enchants
### Minecraft
– All as of 1.21.5

### Illager Plus
– Illager Bane (max level: 7)

### Alex’s Mobs
– Straddle Jump (max level: 3)
– Board Return
– Serpentfriend
– Lavawax

### Better End Forge
– End Veil

### Astral Sorcery
– Scorching Heat
– Night Vision

### Enchanted Shulkers
– Refill
– Siphon

### Charm
– Acquisition

### VeinMining
– Vein Mining

### Nether Depths Upgrade
– Hell Strider (max level: 3)

## Requirement
For 1.21.1 and under, one of the following mod is required for this pack to work properly:
– **Optifine**
– **CIT Resewn**
– **EnchantedBookEnabler**

## Issues
### Optifine
**The custom item texture is always the same**
– Make sure `ESC/Option/Video Setting/Quality/Custom Item` is set to `ON`.
– Make sure the texture pack is enabled
– Make sure Optifine is properly installed