⚡ xAlmas - Premium PvP Soul Economy ⚡
为你的 Minecraft 服务器打造的终极、高度可定制的 PvP 经济插件。

? 概览
xAlmas 是一款优质的 Minecraft 插件,旨在奖励玩家的 PvP 技巧。每当玩家获得击杀时,他们都可以收集受害者的“灵魂”作为实体物品,且该物品高度可定制。它具备强大的防刷机制、现代 HEX 颜色支持以及专用的开发者 API。
无论你是想使用标准染料还是自定义 Base64 玩家头颅,xAlmas 都能让你完全掌控服务器的击杀奖励经济!
✨ 主要特性
- ? 自定义灵魂物品: 创建无限种类的货币!支持标准材质、自定义描述(lore)、附魔、隐藏标志位以及 Base64 自定义头颅。
- ?️ 高级防刷系统: 通过内置的 IP 匹配阻止和可配置的玩家冷却时间防止滥用。
- ? 现代格式化: 全面支持 MiniMessage 和 HEX 颜色 (
&#HEX 或 <#HEX>)。让你的物品和聊天信息看起来惊艳夺目。
- ? 动态掉落: 选择灵魂是直接放入击杀者的
INVENTORY(背包)还是 DROP(掉落在地上)。你甚至可以将掉落的物品设置为从配置列表中 random(随机)选取!
- ? 世界白名单/黑名单: 在特定世界(例如出生点或末地)禁用灵魂掉落。
- ? PlaceholderAPI 支持: 使用
%xa_almas% 在记分板或菜单中显示玩家的灵魂统计数据。
- ? 自定义音效: 当玩家收集灵魂时播放特定的声音(可调整音高和音量)。
- ⚙️ 开发者 API: 包含一个强大的 API,带有自定义事件,允许其他插件与该系统交互。
? 命令与权限
所有命令均可在一个单一、易于使用的基础命令下管理,并完整支持 Tab 补全。
| 命令 |
描述 |
权限 |
/xa help |
显示自定义帮助菜单。 |
xalmas.admin |
/xa give <currency> <amount> |
给予玩家特定数量的灵魂。 |
xalmas.admin |
/xa reload |
安全地重新加载 config.yml、almas.yml 和数据。 |
xalmas.admin |
请确保你已安装
才能使用此功能!
%xa_almas% — 返回玩家收集的灵魂总数。
?️ 配置快照
在 almas.yml 中设置你的物品非常简单。以下是一个优质 Base64 头颅设置的示例:
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"
? 面向开发者 (API)
xAlmas 在设计时充分考虑了可扩展性。你可以通过 JitPack 使用我们的 API 来挂钩插件、操纵灵魂余额并监听自定义事件。
1. 依赖安装
首先,将 JitPack 仓库和 xAlmas 依赖项添加到你的项目中。(请务必将 VERSION 替换为最新版本,例如 v1.0.1)。
Gradle (Kotlin DSL)
repositories {
mavenCentral()
maven("[https://jitpack.io](https://jitpack.io)")
}
dependencies {
compileOnly("com.github.WilfryDev:xAlmas:VERSION")
}
Gradle (Groovy)
repositories {
mavenCentral()
maven { url '[https://jitpack.io](https://jitpack.io)' }
}
dependencies {
compileOnly 'com.github.WilfryDev:xAlmas:VERSION'
}
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>[https://jitpack.io](https://jitpack.io)</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.WilfryDev</groupId>
<artifactId>xAlmas</artifactId>
<version>v1.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
2. 可用事件
PlayerReceiveSoulEvent
此事件在玩家从 PvP 击杀中获得灵魂物品之前触发。
isCancelled() / setCancelled(boolean):取消事件以防止掉落。
getSoulType() / setSoulType(String):查看或根据击杀者的等级或权限动态更改获得的灵魂类型。
getKiller() / getVictim():获取事件中涉及的精确玩家。
@EventHandler
public void onSoulReceive(PlayerReceiveSoulEvent event) {
if (event.getKiller().hasPermission("vip.doublesouls")) {
// 你可以动态地将掉落的灵魂更改为优质版本
event.setSoulType("alma_premium");
}
}
3. API 方法
你可以使用 XAlmasAPI 类轻松与玩家保存的数据进行交互。
import jn.willfrydev.xalmas.api.XAlmasAPI;
// 获取玩家拥有的灵魂总数
int totalSouls = XAlmasAPI.getSouls(player.getUniqueId());
// 直接将灵魂添加到玩家的数据文件中
XAlmasAPI.addSouls(player.getUniqueId(), 5);
// 安全地移除灵魂(不会低于 0)
XAlmasAPI.removeSouls(player.getUniqueId(), 2);
针对 Paper 1.16.5+ 优化。
? By xPlugins :=)
⚡ 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 <currency> <amount> |
Gives a specific amount of souls to a player. |
xalmas.admin |
/xa reload |
Reloads config.yml, almas.yml, and data safely. |
xalmas.admin |
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:
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)
repositories {
mavenCentral()
maven("[https://jitpack.io](https://jitpack.io)")
}
dependencies {
compileOnly("com.github.WilfryDev:xAlmas:VERSION")
}
Gradle (Groovy)
repositories {
mavenCentral()
maven { url '[https://jitpack.io](https://jitpack.io)' }
}
dependencies {
compileOnly 'com.github.WilfryDev:xAlmas:VERSION'
}
Maven
<repositories>
<repository>
<id>jitpack.io</id>
<url>[https://jitpack.io](https://jitpack.io)</url>
</repository>
</repositories>
<dependencies>
<dependency>
<groupId>com.github.WilfryDev</groupId>
<artifactId>xAlmas</artifactId>
<version>v1.0.1</version>
<scope>provided</scope>
</dependency>
</dependencies>
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.
@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.
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 :=)
评论 0
登录后参与评分
还没有评论,来抢沙发吧