Shards Custom Economy - Shards 自定义经济系统

Shards 是一款允许你在 Minecraft 服务器中创建全新经济系统的插件，无需依赖 Vault 或其他类似插件。它配置简单，支持多版本，是构建服务器经济的理想选择。

💡核心特性

• 独立经济系统：无需 Vault 即可运行。
• 多版本支持：兼容 1.8 至 1.18.1 版本。
• 高度可配置：所有文本、菜单和商店均可自定义。
• 游戏内商店：提供直观的 GUI 商店界面。
• 商店分类：支持将商品按类别组织在不同的商店中。
• 完全免费：插件可免费使用。
• 经过广泛测试：已被众多服务器验证其稳定性。

🎮依赖与占位符

• 默认无需依赖：插件可独立运行。
• PlaceholderAPI 支持（可选）：如需使用，可添加以下占位符：

- `%shards_player_balance%`

- `%shards_player_purchase_count%`

• 配置兼容性：请注意，1.9 版本重写前的旧配置文件已不再兼容。

🔧命令与权限

玩家命令

• /shard - 打开商店分类主菜单。

- 权限：`shard.use`

• /shard balance - 查看自己的碎片余额。

- 权限：`shard.use`

• /shard pay <玩家> <数量> - 向其他玩家支付碎片。

- 权限：`shard.use`

• /shard toggle - 切换是否接收他人支付的碎片。

- 权限：`shard.use`

管理员命令

• /ashard - 查看管理员帮助。

- 权限：`shard.admin`

• /ashard openshop <商店名> - 为玩家打开指定商店。
• /ashard reload - 重载插件配置。
• /ashard setshards <玩家> <数量> - 设置玩家的碎片数量。
• /ashard addshards <玩家> <数量> - 增加玩家的碎片数量。
• /ashard removeshards <玩家> <数量> - 减少玩家的碎片数量。

✨配置文件详解

categories.yml

这是商店的主菜单配置文件，当玩家执行 /shard 时打开。

• Menu Settings：定义主菜单的标题、大小和填充物品。
• Shops：在此列出所有商店。每个商店需要指定：

- `Shop`：对应商店配置文件的名称（不含 `.yml`）。

- `Slot`：该商店图标在菜单中的位置（从0开始计数）。

- `Name`、`Material`、`Lore`：定义图标的显示信息。

shops/example.yml

这是单个商店的配置文件示例。

• Menu Settings：定义该商店界面的标题、大小和填充物品。
• Menu Items：定义商店内出售的商品。每个商品需要配置：

- `Display Item`：商品在商店中的显示图标。

- `Settings`：包含商品槽位、价格以及购买后执行的命令。

- `Give Display`：设置为 `false` 时，购买后不会给予显示图标物品，而是执行命令。

lang.yml

此文件用于自定义插件所有提示信息。

• Commands：配置所有命令的反馈消息。
• Balance：查看余额时的消息。
• Pay：包含支付成功、失败、支付被拒等消息。
• Shop：包含购买成功或余额不足的消息。

settings.yml

核心设置文件。

• Data Save：玩家数据自动保存的间隔时间（秒）。
• Default Balance：新玩家加入服务器时获得的初始碎片数量。
• Auto Update：是否启用自动更新。

items.yml

用于配置特殊物品（例如“碎片炸弹”）。

• 可以定义物品的材质、名称、描述 lore 及其效果参数（如持续时间、产生的碎片数量范围）。

❓使用示例服务器

以下服务器正在使用 Shards 插件

• play.blizzardmc.org
• play.dupemc.net
• tangomc.net
• play.minetix.uk

如果你的服务器也在使用，并希望加入此列表，请通过 Discord 联系作者。

⭐API 与支持

• API 访问：开发者可通过 ShardsAPI.getInstance() 访问插件 API。
• 事件：插件提供 ShopPurchaseEvent 等事件。
• 错误反馈：如果你发现任何错误或问题，请通过 Discord 联系作者 zzzzzzz#4716，请不要在插件评论中发布错误报告。