DonutShards

插件

· 作者 Duong2012G

DonutShard 是一款功能丰富的自定义货币插件。通过 PvP 击杀和挂机刷怪赚取碎片,然后在拥有多个分类的美丽图形界面商店中消费它们。

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

最新 1.2.0 · 1.21.11 · Bukkit / Paper

一键开服(送7天)

? DonutShard

一款功能丰富的 自定义货币插件,适用于 PaperMC 服务器 —— 通过击杀、挂机以及在一个可配置的商店中消费来赚取碎片(Shards)。


✨ 特性

特性 描述
? 碎片货币 自定义经济货币,包含排行榜和余额命令
⚔️ 击杀奖励 在 PvP 击杀时赚取碎片,具备冷却时间和额外倍率加成
? AFK 系统 在指定的 AFK 区域挂机时被动赚取碎片
?️ 区域保护 类似 WorldGuard 的 AFK 区域保护(无需安装 WorldGuard)
? 碎片商店 多分类 GUI 商店 —— 使用碎片购买物品
? 多语言支持 内置 5 种语言:vi en zh es fr
? 排行榜 /shard top 命令,支持 PlaceholderAPI
? 开发者 API 允许其他插件挂钩 Shard 事件
? 双存储模式 支持 YAML 或 SQLite,采用 WAL 模式异步写入

? 依赖要求

依赖项 版本
PaperMC 1.21.x
Java 21+
PlaceholderAPI 2.11+ (可选)

⚙️ 安装步骤

  1. 下载 DonutShard-1.0.0.jar 并将其放入你的 /plugins 文件夹。
  2. 启动服务器 —— 配置文件将自动生成。
  3. 根据需要编辑 plugins/DonutShard/config.yml。
  4. 在游戏中运行 /shard reload 以应用更改,无需重启服务器。

?️ 文件结构

plugins/DonutShard/
├── config.yml          # 主配置文件(击杀奖励、存储、排行榜)
├── afk.yml             # AFK 区域、保护规则、收益速率
├── shop.yml            # 商店分类及 GUI 布局
├── shops/
│   ├── Spawners.yml    # 刷怪笼物品
│   ├── Ores.yml        # 矿石方块
│   └── Farm.yml        # 农业类物品
├── languages/
│   ├── en.yml
│   ├── vi.yml
│   ├── zh.yml
│   ├── es.yml
│   └── fr.yml
└── data/               # YAML 存储文件(如果使用 YAML 模式)
    ├── balances.yml
    ├── afk_sessions.yml
    ├── afk_warps.yml
    └── daily_earnings.yml

? 配置说明

config.yml — 快速参考

language: en           # 当前语言 (en/vi/zh/es/fr)

kill-reward:
  enabled: true
  shards-per-kill: 10
  kill-cooldown: 30    # 秒数,在此之后相同的击杀才会再次给予奖励
  ignore-afk-victims: false
  bonus-multiplier:
    enabled: false
    threshold: 1000    # 如果受害者拥有 >= 此数量的碎片
    multiplier: 1.5

storage:
  type: SQLITE         # YAML 或 SQLITE
  auto-save-interval: 5  # 分钟

leaderboard:
  size: 10

afk.yml — AFK 系统

enabled: true
shards-per-minute: 1
daily-limit: 100       # 0 = 无限制
teleport-cooldown: 5   # 两次 /afk 使用之间的间隔秒数
auto-detect-afk: true  # 自动检测已在 AFK 世界的玩家

protection:
  default:
    no-damage: true
    no-hunger: true
    no-pvp: true
    no-mob-spawn: true
    no-item-drop: true
    restore-health-on-enter: true
    clear-effects-on-enter: true

添加商店分类

  1. 创建 plugins/DonutShard/shops/MyCategory.yml:
gui-title: "<gold>⭐ My Category"
items:
  - id: DIAMOND
    name: "<aqua>? Diamond"
    price: 100
    slot: 10
    quantity: 1
    lore:
      - "<gray>Shiny and expensive"
  - id: SPAWNER
    name: "<red>? Blaze Spawner"
    spawnertype: BLAZE
    price: 5000
    slot: 11
    quantity: 1
  1. 在 shop.yml 下的 categories 中添加该分类:
categories:
  MyCategory:
    icon: DIAMOND
    name: "<aqua>My Category"
    slot: 4
    lore:
      - "<gray>Buy diamonds and spawners"
  1. 运行 /shard reload。无需重启!

? 命令

命令 描述 权限节点
/shard balance [player] 查看碎片余额 donutshard.balance
/shard give <player> <amount> 给予碎片 donutshard.give
/shard take <player> <amount> 扣除碎片 donutshard.take
/shard set <player> <amount> 设置碎片余额 donutshard.set
/shard top [page] 查看排行榜 donutshard.top
/shard reload 重载配置 donutshard.reload
/shard set-afk-warp <name> 设置 AFK 传送点至世界 donutshard.admin
/shard remove-afk-warp <name> 移除 AFK 传送点 donutshard.admin
/shard list-afk-warp 列出所有 AFK 传送点 donutshard.admin
/shard language <code> 切换语言 donutshard.language
/afk [warpname] 进入 AFK 区域 donutshard.afk
/afk-setting 管理 AFK 区域设置 donutshard.afk.admin
/shardshop 打开碎片商店 donutshard.shop

别名: /shard → /donutshard, /ds


?️ 权限节点

权限节点 描述 默认值
donutshard.balance 查看自己的余额 true
donutshard.balance.others 查看他人的余额 op
donutshard.give 给予他人碎片 op
donutshard.take 从他人处扣除碎片 op
donutshard.set 设置碎片余额 op
donutshard.top 查看排行榜 true
donutshard.reload 重载插件 op
donutshard.admin 所有管理员命令 op
donutshard.afk 使用 /afk 命令 true
donutshard.afk.admin 管理 AFK 设置 op
donutshard.shop 打开碎片商店 true
donutshard.kill.bypass 该玩家的死亡不会给予碎片 false
donutshard.zone.bypass 绕过区域保护 op
donutshard.language 切换语言 true

? PlaceholderAPI

在任何兼容的插件中注册以下占位符:

占位符 返回值
%donutshard_balance% 玩家的碎片余额
%donutshard_rank% 玩家在排行榜中的排名
%donutshard_top_1% 到 %donutshard_top_10% 排名第 N 的玩家名称
%donutshard_top_balance_1% 排名第 N 的玩家碎片余额

? 开发者 API

在你的插件中将 DonutShard 添加为依赖项:

// 检查可用性
if (DonutShardAPI.isAvailable()) {

    // 获取余额
    long balance = DonutShardAPI.getBalance(player);

    // 给予碎片并附带原因
    DonutShardAPI.give(player, 100, "任务奖励");

    // 扣除碎片(如果余额不足则返回 false)
    boolean success = DonutShardAPI.take(player, 50);

    // 监听碎片事件
    DonutShardAPI.registerHook(new ShardEventHook() {
        @Override
        public void onShardEarned(UUID uuid, long amount, String reason) {
            // ...
        }
        @Override
        public void onShardSpent(UUID uuid, long amount, String reason, long newBalance) {
            // ...
        }
    });
}

? 从源码构建

git clone https://github.com/duong2012g/DonutShard.git
cd DonutShard
mvn clean package
# 输出: target/DonutShard-1.0.0.jar

要求: Java 21,Maven 3.8+


? 许可证

MIT — 可自由使用、修改和重新分发,但需注明出处。


由 duong2012g 用 ❤️ 制作

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源