xAlmas

插件

· 作者 jn_willfrydev

你的 Minecraft 服务器的终极、高度可定制的 PvP 经济插件。

0 本站下载 0 关注 更新于 8 个月前

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

⚡ xAlmas - Premium PvP Soul Economy ⚡

为你的 Minecraft 服务器打造的终极、高度可定制的 PvP 经济插件。

banner

? 概览

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

? PlaceholderAPI

请确保你已安装 PlaceholderAPi 才能使用此功能!

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

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源