Xshards 插件
Xshards 是一款功能全面的 Minecraft 插件,旨在管理基于碎片(Shards)的经济系统,支持玩家间转账、排行榜、每日奖励、连续登录天数(Streaks)以及多种赚取方式,并配备可自定义的商店界面。所有数据均通过批量操作和事务管理可靠地持久化存储到数据库中。
主要功能:
- 碎片经济系统:玩家可以通过各种活动赚取碎片,支持可配置的赚取速率并与 PlaceholderAPI 集成。支持数据库存储(SQLite 或 MySQL),确保固定的数据持久性。
- 可靠的数据存储:新增!已修复关键的商店持久化漏洞——现在所有商店物品、玩家碎片余额及连续登录天数数据均可通过批量操作和事务管理正确保存。
- 逐条消息控制:插件中的每条消息现在都可以单独启用或禁用,让服务器管理员完全掌控聊天栏的杂乱信息。
- 管理员控制:强大的碎片管理功能,包括给予和移除碎片的命令。
- 完全可自定义的商店系统:支持带有描述文本(Lore)和模型数据(Model Data)的自定义物品,可调的商店大小,以及带有购买确认界面的价格编辑系统。新增!可通过配置文件自定义商店 GUI 标题,并通过
/store editname和/store editlore命令自定义单个物品的显示名称和描述文本——所有设置均存储在数据库中。 - 碎片转账系统:通过带 GUI 确认对话框的功能,实现真正的玩家间经济交互。
- 排行榜 GUI 与全息图:查看排名前列的玩家,支持玩家头像展示和分页功能。全息图排行榜完全支持 PlaceholderAPI(例如
%xshards_top_name_1%)。 - 每日奖励与连续登录天数:自动发放每日奖励,支持可配置的连续登录倍数加成(简单/中等/困难模式)。
- 高级空闲(AFK)系统:
- 5秒倒计时与移动检测
- 在空闲模式下允许自由移动
- 位置持久化存储
- 自动返回之前的位置
- 空闲期间免受伤害保护
- 专用世界支持(推荐)
- 安全传送系统
- 可配置的赚取速率
- 无缝处理服务器重启
赚取方式:
- 在线时长奖励:保持在线即可赚取碎片。
- PvP 奖励:通过击杀其他玩家获得碎片,附带冷却系统。
- 空闲奖励:在空闲模式下累积碎片,具备倒计时系统、移动检测和专用世界支持。
命令:
包含用于检查碎片余额、打开商店以及进入/退出空闲模式的常规命令,以及用于管理商店、玩家碎片(给予/移除)和插件配置的管理员命令。
权限:
可配置基本命令和管理员命令的权限,为玩家和服务器管理员提供量身定制的体验。
安装:
只需下载插件 JAR 文件,将其放入服务器的 plugins 文件夹中,并根据需要进行配置即可。
数据库存储:
XShards 现在同时支持 SQLite(默认)和 MySQL 数据库存储,提供更佳的数据持久性和可靠性。插件会自动创建必要的数据库表,并无缝处理所有数据操作。
如需支持和更多详情,请参阅项目的 GitHub 仓库。
Xshards Plugin
Xshards is a comprehensive Minecraft plugin designed to manage a shard-based economy system with player transfers, leaderboards, daily rewards, streaks, and multiple earning methods with a customizable shop interface. All data is reliably persisted to the database using batch operations and transaction management.
Key Features:
- Shard Economy System: Players can earn shards through various activities, with configurable earning rates and integration with PlaceholderAPI. Database storage support (SQLite or MySQL) with fixed persistence.
- Reliable Data Storage: NEW! Fixed critical shop persistence bug - all shop items, player shards, and streak data now properly save with batch operations and transaction management.
- Per-Message Control: Every message in the plugin can now be enabled or disabled, giving server owners full control over chat clutter.
- Admin Controls: Robust shard management including give and remove commands.
- Fully Customizable Shop System: Supports custom items with lore and model data, adjustable shop sizes, and a price editing system with a purchase confirmation interface. NEW! Customize shop GUI title via config, and per-item display names/lore via
/store editnameand/store editlorecommands - all stored in database. - Shard Transfer System: Enable true player-to-player economy with GUI confirmation dialogs.
- Leaderboard GUI & Holograms: View top players with ranking system, player heads display, and pagination. Full PlaceholderAPI support for hologram leaderboards (e.g., %xshards_top_name_1%).
- Daily Rewards & Streaks: Automatic daily bonuses with configurable streak multiplier (Easy/Mid/Hard modes).
- Advanced AFK System:
- 5-second countdown with movement detection
- Free movement while in AFK mode
- Persistent location storage
- Automatic return to previous location
- Protection from damage while AFK
- Dedicated world support (recommended)
- Safe teleportation system
- Configurable earning rates
- Seamless server restart handling
Earning Methods:
- Playtime Rewards: Earn shards by staying online.
- PvP Rewards: Gain shards from player kills with a cooldown system.
- AFK Rewards: Accumulate shards while in AFK mode with countdown system, movement detection, and dedicated world support.
Commands:
Includes general commands for checking shard balance, opening the shop, and entering/exiting AFK mode, as well as admin commands for managing the shop, player shards (give/remove), and plugin configuration.
Permissions:
Configurable permissions for basic and admin commands, ensuring a tailored experience for players and server administrators.
Installation:
Simply download the plugin JAR file, place it in the server's plugins folder, and configure it as needed.
Database Storage:
XShards now supports both SQLite (default) and MySQL database storage, providing improved data persistence and reliability. The plugin automatically creates the necessary database tables and handles all data operations seamlessly.
For support and further details, please refer to the project's GitHub repository.
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Xshards
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
更新日志
本文件记录了 Xshards 插件的所有重要变更。
[1.2.9] - 2026-04-16
已修复
-
商店:未支付即可领取物品 / 购买时丢失碎片。 商店监听器现在使用
getRawSlot(),并且仅对商店顶部容器内的点击做出响应,因此玩家自身容器中的点击不再触发购买流程。碎片的扣除发生在交付物品之前,并在确认时重新验证玩家的余额;如果物品无法装入已满的背包,则会掉落至玩家脚下,从而确保他们不会损失已支付的代价。当关闭确认界面而未做选择时,待处理购买状态也会被清除。修复了“我可以不付费从碎片商店拿走物品”的报告。 -
数据库路径不匹配(
XShards与Xshards)。config.yml中的默认 SQLite 路径为plugins/XShards/storage/xshards.db(大写 S),而插件的数据文件夹名为Xshards。默认路径已更正为plugins/Xshards/storage/xshards.db。升级提示: 如果您运行的是 1.2.8 或更早版本,您的数据位于
plugins/XShards/storage/xshards.db。您可以将该文件移动至plugins/Xshards/storage/xshards.db,或者在config.yml中设置storage.sqlite.file: plugins/XShards/storage/xshards.db以保留旧路径。 -
SQLite 错误:“stmt pointer is closed” / “database has been closed” / “Database connection lost. Reconnecting...” 刷屏。 之前的
DatabaseManager返回一个共享的 JDBC 连接,调用者随后通过try-with-resources关闭该连接,这会导致在其他线程执行查询中途关闭共享连接(例如 AFK 任务和 PlaceholderAPI/DecentHolograms 刷新排行榜和 AFK 状态时)。DatabaseManager.getConnection()现在每次调用都返回一个新的连接,使每个查询完全隔离。SQLite 连接还启用了 WAL 日志模式和 5 秒繁忙超时,以改善并发读写行为。 -
/shards remove <player> <amount>现在可以从控制台使用。 此前控制台分支仅接受give命令。现在控制台、命令方块和 RCON 也可以使用remove命令,使得自定义命令和管理脚本能够在不使用give <player> -N变通方法的情况下扣减玩家余额。
已更改
- 启动横幅现在从
plugin.yml读取版本号,而不是使用硬编码字符串(之前一直卡在v1.2.4)。 ShardCommand现在会在早期阶段拒绝非正数金额,并使用现有的“无效数量”消息,防止管理员因输入负数而意外反转给予/移除操作。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧