CappyShards

插件

· 作者 CappyBooMc

高性能的 Shard 经济系统,支持挂机奖励、离线收益、即时增益道具,以及专为 Paper 1.21+ 设计的智能 100% 原版 GUI 商店。

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

最新 1.0.0 · 26.3 · Paper

一键开服(送7天)

? CappyShards

专为 PaperMC 打造的终极水晶与碎片经济、挂机奖励及智能 GUI 商店

轻量级 • 100% 原版客户端兼容 • 超安全防刷引擎 • 异步 SQLite 支持


功能特性 • 快速入门 • 游戏内商店 • 碎片倍率 • 占位符变量 • 指令与权限 • 配置文件


? 语言支持: English • Tiếng Việt



? 为什么选择 CappyShards?

厌倦了那些导致 TPS 卡顿、内存泄漏或容易被背包点击漏洞利用的经济类插件吗?

CappyShards 是一款高级且经过生产环境验证的服务器解决方案,专为现代 Paper/Purpur 1.21+ Minecraft 网络从零构建。它引入了次级高级经济系统(碎片/Shards)、带有不可被其他插件覆盖的动作栏显示的挂机奖励区域、支持即时单位和批量调整的直观游戏内商店、功能完备的可消耗型加成道具,以及坚如磐石的并发保护机制。

最重要的是? 无需任何客户端模组或资源包。所有功能均可在原版 Minecraft 客户端中无缝运行!


? 功能特性

⚡ 1. 高性能碎片经济系统

  • 异步数据库事务: 基于 SQLite 和 HikariCP 连接池。在主游戏线程上实现零卡顿、无冻结体验。
  • 原子性防刷锁定: 使用线程安全的原子标志(AtomicBoolean),防止快速点击刷物品、背包拖拽漏洞及数据包异常。
  • 玩家间转账: 提供安全的 /shard pay 指令,具备自我转账预防、余额验证及交易并发保护功能。

⏳ 2. 挂机碎片奖励与主导动作栏

  • 开箱即用: 预配置为世界 ShardAFK。
  • 不受 TPS 影响的时间追踪: 使用毫秒级时间戳(System.currentTimeMillis())计算,确保服务器延迟波动不会导致玩家倒计时漂移或延迟。
  • 优先级动作栏引擎: 每 0.5秒(10刻) 异步脉冲一次,即使其他插件发送动作栏消息,也能保证你的挂机倒计时始终可见。
  • 祝贺奖励横幅: 在平滑返回倒计时之前,显示持续 3 秒的醒目奖励信息。
  • 等级倍率: 为 VIP 和捐赠者提供可定制的各层级支付金额。

?️ 3. 内置网络安全防护

  • 防小号保护: 限制每个 IP 地址同时允许的最大账号数量(可在 config.yml 中配置)。
  • 防 VPN 与代理屏蔽: 通过 IP 情报 API(如 proxycheck.io)执行异步预登录 HTTP 检查,在机器人和 VPN 用户加入前将其拒绝。

? 4. 碎片倍率消耗品

  • 即时生效药水: 自定义水瓶,右键点击后立即授予限时碎片收入倍率。
  • 无饮用延迟: 瞬间消耗,无需原版 1.6 秒的饮用动画。
  • 视听反馈: 激活时播放升级音效和粒子特效。
  • 完全可定制: 可在 item.yml 中配置纹理、自定义模型数据、名称、描述文本、声音和粒子效果。

? 5. 智能游戏内商店

无需自定义材质包即可享受直观、玩家友好的购物体验:

  • 清晰的分类浏览: 将物品组织到自定义部门(武器、消耗品、材料等),支持自定义图标和颜色渐变。
  • 单位与批量购买: 玩家可通过简单的 + 和 - 按钮轻松切换购买单个物品(1 至 64)或批量堆叠(1 至 36)。
  • 智能堆叠检测: 不可堆叠的装备(剑、盔甲、工具)会自动禁用堆叠模式,以防止问题发生。
  • 即时购买预览: 确认前清晰显示所选数量、总成本和当前余额。
  • 虚拟奖励与指令: 支持在 shop.yml 中使用可选的控制台 commands 来发放箱子钥匙、等级或自定义插件物品。
  • 库存安全: 自动在交易前检查可用库存空间,避免物品掉落。

? 6. 离线碎片累积

  • 被动离线进度: 即使玩家完全下线,也能累积碎片!
  • 基于等级的时长上限: 可在 config.yml 中为每个等级配置最大累积时间(例如:默认 2 小时,VIP 6 小时,VIP+ 12 小时)。
  • 灵活的权限控制: 使用 cappy.offline.shard 全局授予,或使用 cappy.offline.shard.<rank> 按等级授予。
  • 回归通知: 重新连接的玩家会收到详细的聊天通知,显示其离线时间和获得的碎片数量。

⚡ 碎片倍率加成道具

管理员可以将临时碎片倍率作为任务奖励、箱子奖品或商店商品发放!

# 给自己一个持续 30 分钟的 2x 倍率:
/cappy give shard_multiplier 2 30

# 给某玩家一个持续 60 分钟的 1.5x 倍率:
/cappy give Steve shard_multiplier 1.5 60
  • 即时右键: 在任何地方右键即可立即激活增益效果。
  • 收益倍增: 激活期间,所有挂机奖励将按比例倍增(例如:10 碎片 × 2.0 = 20 碎片)。
  • HUD 指示器: 动作栏会自动附加当前生效的倍增倍率(例如:Receiving Shards in: 45s (x2))。

? PlaceholderAPI 集成

CappyShards 提供了全面的 PlaceholderAPI (PAPI) 占位符,可用于你的计分板、TAB 列表、聊天、全息图或 DeluxeMenus:

占位符 描述 示例输出
%cappyshards_balance% 精确的碎片余额(原始数字) 1500
%cappyshards_shards% %cappyshards_balance% 的别名 1500
%cappyshards_balance_formatted% 带千位分隔符的碎片余额 1,500
%cappyshards_shards_formatted% 格式化余额的别名 1,500
%cappyshards_afk_time% 距离下次挂机奖励剩余的秒数 42
%cappyshards_afk_remaining% 挂机倒计时的别名 42
%cappyshards_rank_reward% 基于玩家等级的碎片发放量 50
%cappyshards_multiplier% 当前的碎片倍增增益(若无则为 1) 2
%cappyshards_multiplayer% %cappyshards_multiplier% 的别名 2
%cappyshards_multiplier_formatted% 带有前缀 x 的倍率显示 x2
%cappyshards_multiplier_remaining% 剩余增益时间的秒数 1799
%cappyshards_multiplier_time_formatted% 人类可读格式的剩余增益时间 29m 59s
%cappyshards_has_multiplier% 检查玩家是否拥有有效的增益 true / false
%cappyshards_multiplier_tag% 格式化后的增益标签(若无有效增益则为空) (x2)
%cappyshards_offline_max_hours% 该玩家离线碎片积累的最大小时数 6

? 命令与权限

命令

命令 别名 权限 描述
/cappyshard /shard, /shards, /cshard, /cappy cappyshards.use 查看你当前的碎片余额
/cappyshard pay <player> <amount> cappyshards.use.pay 向其他在线玩家转账碎片
/cappyshard shop /shardshop cappyshards.use.shop 打开碎片目录商店 GUI
/cappyshard give [player] shard_multiplier <multiplier> [minutes] cappyshards.admin 给予即时的碎片倍增药水
/cappyshard add <player> <amount> cappyshards.admin 增加玩家的碎片余额
/cappyshard set <player> <amount> cappyshards.admin 设置玩家的精确碎片余额
/cappyshard remove <player> <amount> cappyshards.admin 从玩家余额中扣除碎片
/cappyshard reload cappyshards.admin 重载所有配置、物品并重启管理器

权限

  • cappyshards.use (默认: true) — 允许查看余额。
  • cappyshards.use.pay (默认: true) — 允许向其他玩家发送碎片。
  • cappyshards.use.shop (默认: true) — 允许打开碎片商店 GUI。
  • cappyshards.admin (默认: op) — 管理访问权限(设置、添加、移除、给予、重载)。
  • cappyshards.bypass.zone (默认: op) — 无视当前世界限制,接收挂机奖励。
  • cappyshards.rank.<name> — 授予在 config.yml 中配置的特定等级发放量。
  • cappy.offline.shard — 离线时积累碎片的基线权限。
  • cappy.offline.shard.<rank> — 针对特定等级的离线积累权限(如 cappy.offline.shard.vipplus, cappy.offline.shard.vip)。

?️ 配置文件

所有配置均使用现代的 MiniMessage 渐变和十六进制颜色格式。

  • config.yml:常规设置、挂机间隔、启用的世界、反小号/VPN 以及等级发放率。
  • messages.yml:100% 可自定义的消息、提示和前缀。
  • item.yml:自定义碎片倍增瓶(名称、描述、自定义模型数据、音效和粒子效果)。
  • Shop/catalogue.yml:配置目录分类、布局大小、图标和描述文本。
  • Shop/shop.yml:配置每个分类中的物品、价格、数量以及可选的控制台奖励命令。

? 快速开始

  1. 从 Releases 或 Modrinth 下载最新的 CappyShards-1.0.0.jar。
  2. 将 jar 文件放入服务器的 plugins/ 文件夹中。
  3. (可选) 安装 PlaceholderAPI 以支持计分板和 TAB 列表集成。
  4. 启动服务器。配置文件将自动生成。
  5. 根据服务器需求自定义 config.yml、messages.yml、item.yml 和 Shop/shop.yml。
  6. 运行 /cappyshard reload 即可即时应用更改!

?️ 从源码构建

git clone https://github.com/quocdat251107-del/CappyShard.git
cd CappyShard
./gradlew build

编译后的 jar 文件将位于 build/libs/CappyShards-1.0.0.jar。


CappyShards 是由 Cappy Community 用 ❤️ 创建的开源项目。
如果你喜欢这个插件,请在 GitHub 上给仓库点个星!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源