hShards

插件

· 作者 hodakazy

一个很酷的次级虚拟经济系统。

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

需要前置:LuckPerms

最新 1.0.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

hShards

一个轻量级的虚拟经济插件,可与你的主经济系统并行运行,或完全取代它。


什么是 hShards?

hShards 为你的服务器添加了一种名为 Shards(可完全重命名)的货币。它旨在与现有的 Vault 经济系统共存:玩家保留常规货币用于日常消费,而 Shards 则成为一种独立的进度货币,玩家可以通过出售物品、获得奖励、与其他玩家交易或通过利息系统被动赚取。

你也可以将其设置为 PRIMARY 模式,作为你的主 Vault 经济提供者,从而完全取代 EssentialsX 经济等插件。

我构建此插件是为了配合 hShop 使用,但其 API 是公开的,其他插件也可以接入其中。


功能

  • 双模式 - 可作为 Vault 的辅助货币运行,也可接管成为主要的 Vault 提供者
  • 玩家间转账 - /pay 命令,可选配置税费和冷却时间
  • 物品出售 - 为任何物品定义 Shard 价格,玩家可通过 /hshards sell 或 /sellall 出售
  • 排行榜 - 分页显示余额最高的玩家列表,支持可配置的刷新间隔和缓存大小
  • 利息系统 - 按定时器自动向在线玩家发放其余额的一定百分比
  • 最大余额上限 - 可选择防止玩家持有超过设定数量的余额
  • 支付税费 - 从每笔玩家间转账中抽取可配置的百分比作为税费
  • 交易日志 - 每一笔存款、取款、转账和出售操作都会记录到日志文件中
  • YAML 或 SQLite 存储 - 根据你的服务器规模选择适合的存储方式,可在配置中切换
  • PlaceholderAPI 支持 - 提供完整的占位符,用于余额、排名、排行榜等
  • 公开 API - HShardsAPI 类允许任何插件获取/设置/存入/取出 Shard 余额
  • 标题通知 - 当玩家获得或失去 Shards 时,可选地在屏幕上方显示标题提示
  • 完全自定义消息 - 所有消息均位于 messages.yml 中,支持颜色代码

依赖

依赖项 是否必需
Paper 1.21+ ✅ 必需
Vault ⭐ 软依赖(PRIMARY 模式或 hShop 集成时需要)
PlaceholderAPI ⭐ 软依赖
hShop ⭐ 软依赖(SECONDARY 模式下需要)

模式

SECONDARY (默认) - hShards 完全不接触 Vault。它作为完全独立的货币在旁运行。需要 hShop(或其他集成)才能发挥实际作用,因为仅使用 Vault 的插件无法感知 Shards。这是 99% 情况下推荐使用的模式。

PRIMARY - hShards 注册自己为 Vault 的经济提供者。每个调用 economy.getBalance() 的插件都将从 hShards 读取数据。如果你希望拥有完全自定义的经济系统,而不使用 EssentialsX 或 CMI 来处理,这是一个不错的选择。

在 config.yml 中设置:

mode:
  type: SECONDARY  # 或 PRIMARY

命令

命令 描述 权限
/hshards balance 查看你的 Shard 余额 hshards.balance
/shardbal [player] 查看你自己或其他玩家的余额 hshards.balance
/pay <player> <amount> 向其他玩家支付 Shards hshards.pay
/shardstop [page] 查看 Shards 排行榜 hshards.top
/hshards sell 出售手中的物品以换取 Shards hshards.use
/hshards sellall 出售所有符合条件的物品 hshards.use
/hshards rank 查看你在排行榜中的位置 hshards.top
/hshardsadmin give <player> <amount> 给予玩家 Shards hshards.admin.give
/hshardsadmin take <player> <amount> 从玩家处扣除 Shards hshards.admin.take
/hshardsadmin set <player> <amount> 设置玩家的余额 hshards.admin.set
/hshardsadmin reset <player> 将玩家余额重置为初始值 hshards.admin.reset
/hshardsadmin resetall confirm 重置所有玩家的余额 hshards.admin.reset
/hshardsadmin balance <player> 查看任意玩家的余额 hshards.admin
/hshardsadmin reload 重载插件 hshards.admin.reload
/hshardsadmin lb-refresh 强制刷新排行榜缓存 hshards.admin

绕过权限

权限 效果
hshards.bypass.pay-tax 跳过支付税费
hshards.bypass.pay-cooldown 跳过支付冷却时间
hshards.bypass.max-balance 突破最大余额上限

PlaceholderAPI 占位符

占位符 描述
%hshards_balance% 玩家的原始余额
%hshards_balance_formatted% 带货币符号的格式化余额
%hshards_rank% 玩家在排行榜中的排名
%hshards_top_name_<N>% 排名第 N 的玩家名称
%hshards_top_balance_<N>% 排名第 N 的玩家余额
%hshards_top_balance_formatted_<N>% 排名第 N 的格式化余额
%hshards_currency_name% 复数形式的货币名称
%hshards_currency_symbol% 货币符号
%hshards_total_players% 有记录余额的玩家总数

top_name 和 top_balance 支持任意排名数字,不仅限于前 10 名。


可出售物品

在 plugins/hShards/sellable-items.yml 中定义玩家可以出售以换取 Shards 的物品:

items:
  diamond:
    material: DIAMOND
    price: 50.0
    enabled: true
    name: "&bDiamond"
    permission: ""   # 留空表示无要求

  netherite_ingot:
    material: NETHERITE_INGOT
    price: 200.0
    enabled: true
    name: "&8&lNetherite Ingot"
    permission: "hshards.sell.netherite"

开发者 API

其他插件可以通过静态 API 类与 hShards 余额进行交互:

// 在调用任何方法之前检查 hShards 是否可用
if (HShardsAPI.isAvailable()) {
    double balance = HShardsAPI.getBalance(player);
    HShardsAPI.deposit(player, 100);
    boolean success = HShardsAPI.withdraw(player, 50);
    HShardsAPI.setBalance(player, 500);
}

// 格式化 String formatted - HShardsAPI.format(balance); // 例如 "✦ 500.00" String name - HShardsAPI.getCurrencyName(); // 例如 "Shards"

// 排行榜
int rank - HShardsAPI.getRank(player);
String topName - HShardsAPI.getLeaderboardName(1);
double topBalance - HShardsAPI.getLeaderboardBalance(1);

}


在 `plugin.yml` 中将 hShards 添加为软依赖,当 hShards 加载时 API 即可使用。

---

## 利息系统

利息系统会定期给予在线玩家其余额的一定百分比作为利息。该功能完全可选,默认处于禁用状态。

```yaml
interest:
  enabled: true
  interval: 60        # 每 60 分钟
  percent: 1.0        # 余额的 1%
  max-eligible: 5000  # 仅前 5000 个碎片计入利息
  permission: ""      # 需要权限节点,或留空以允许所有人使用

存储

hShards 支持两种存储后端:

  • YAML - 默认选项,无需配置,适合小型服务器
  • SQLite - 推荐用于大型服务器,写入操作是异步的,不会影响性能
storage:
  type: SQLITE
  sqlite-file: "hshards.db"

与 hShop 完美配合

hShards 与 hShop 搭配效果极佳。玩家通过出售物品赚取碎片,然后在商店中使用这些碎片购买特殊物品,商店将 HSHARDS 作为其货币。这两个插件可以互相识别——当两者同时存在时,hShop 会自动钩入 hShards。


由 hodakazy 制作的 hPlugins 出品

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源