? 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+ (可选) |
⚙️ 安装步骤
- 下载
DonutShard-1.0.0.jar并将其放入你的/plugins文件夹。 - 启动服务器 —— 配置文件将自动生成。
- 根据需要编辑
plugins/DonutShard/config.yml。 - 在游戏中运行
/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
添加商店分类
- 创建
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
- 在
shop.yml下的categories中添加该分类:
categories:
MyCategory:
icon: DIAMOND
name: "<aqua>My Category"
slot: 4
lore:
- "<gray>Buy diamonds and spawners"
- 运行
/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 用 ❤️ 制作
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
可自定义玩家模型
tom5454
自定义你的Minecraft头像!
装饰社交
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧