SimpleGems - SimpleGems

SimpleGems 是一款为 Minecraft 服务器添加自定义宝石经济系统的插件。它轻量高效，提供完全可配置的选项，并支持多种数据库和现代文本格式。

💡重要须知

• 请勿在 SpigotMC 等平台发布支持请求，技术支持仅在 GitHub 或 Discord 提供。
• 本插件不支持也永远不会支持离线模式（破解版）服务器。
• 本插件不支持 PlugMan 或服务器 /reload 等重载方式。

🎮核心特性

• 自定义经济：为服务器添加一种全新的“宝石”货币。
• 高度可配置：所有消息和设置均可通过配置文件修改。
• 轻量高效：经过优化，不会对服务器造成卡顿。
• 多数据库支持：支持 MySQL、MariaDB 和 SQLite。
• 内置商店：提供分类商店菜单系统。
• 现代格式支持：支持 ItemsAdder 和 MiniMessage 格式（自动转换旧版颜色代码和十六进制格式）。
• 依赖需求：运行本插件必须安装 NBTAPI。

🔧安装步骤

• 下载 SimpleGems 插件。
• 将 .jar 文件放入服务器的 plugins 文件夹。
• 重启服务器。
• 开始使用！

✨玩家命令与权限

• /gems - 查看自己拥有的宝石数量。
• /gems help - 显示帮助菜单。
• /gems shop <category> - 打开宝石商店。 (simplegems.command.shop)
• /gems withdraw <amount> - 将宝石提取为物品。 (simplegems.command.withdraw)
• /gems pay <player> <amount> - 向其他玩家支付宝石。 (simplegems.command.pay)
• /gems top - 显示宝石数量前十的玩家排行榜。 (simplegems.command.top)

⭐管理员命令与权限

• /gems reload - 重载插件配置文件。 (simplegems.command.reload)
• /gems give <player> <amount> - 给予玩家宝石。 (simplegems.command.give)
• /gems take <player> <amount> - 扣除玩家的宝石。 (simplegems.command.take)
• /gems set <player> <amount> - 设置玩家的宝石数量。 (simplegems.command.set)
• /gems version - 显示插件版本信息。 (simplegems.command.version)
• /gems update - 手动更新宝石排行榜。 (simplegems.command.update)
• /gems reset [player] - 重置整个数据库或指定玩家的数据。 (simplegems.command.reset)

提示：所有命令均可在 SimpleGems/commands/gems.yml 文件中进行自定义。

🔧变量与占位符

内置变量

• %player% - 玩家名
• %displayname% - 玩家显示名
• %arrowright%, %arrowleft% - 箭头符号
• %star% - 星星符号
• %circle% - 圆圈符号
• %gems% - 玩家宝石数量
• %gems_formatted% - 格式化后的玩家宝石数量
• %gems_decimal% - 十进制格式的玩家宝石数量

PlaceholderAPI 占位符

• %simplegems_balance% - 玩家宝石数量
• %simplegems_balance_formatted% - 格式化后的玩家宝石数量
• %simplegems_balance_decimal% - 十进制格式的玩家宝石数量
• %simplegems_player_<数字>% - 获取排行榜指定位置的玩家信息（例如：%simplegems_player_1% 显示第一名），显示格式由 config.yml 中的 gems-top 设置控制。

❓获取帮助

需要帮助或有建议？请加入 Discord 社区

Discord: https://discord.gg/EFeSKPg739

SimpleGems 是一款为 Minecraft 服务器设计的宝石插件，它允许你创建自定义的宝石物品，玩家可以将其镶嵌到装备上以获得永久的属性加成，为你的服务器经济与角色成长系统增添深度。

💡前置插件与依赖

运行 SimpleGems 需要以下插件。请确保在安装 SimpleGems 前正确配置它们。

必需依赖

• NBTAPI: 核心必需插件，用于处理物品的 NBT 数据。
• 下载链接: https://www.spigotmc.org/resources/nbt-api.7939/

可选依赖

以下插件可以增强 SimpleGems 的功能，但非强制安装：

• PlaceholderAPI: 用于在其他插件中显示与宝石相关的变量。
• 下载链接: https://www.spigotmc.org/resources/placeholderapi.6245/
• Head Database: 可用于为自定义宝石设置玩家头颅图标。
• 下载链接: https://www.spigotmc.org/resources/head-database.14280/
• Skulls: 另一个可用的头颅数据库插件，功能类似。
• 下载链接: https://www.spigotmc.org/resources/skulls-the-ultimate-head-database.90098/
• ItemsAdder: 如果你希望使用 ItemsAdder 的自定义物品作为宝石，则需要此插件。
• 下载链接: https://www.spigotmc.org/resources/✨itemsadder⭐emotes-mobs-items-armors-hud-gui-emojis-blocks-wings-hats-liquids.73355/

🎮开发者文档与支持

如需查看完整的配置指南、命令列表、权限节点以及 API 开发文档，请访问官方 Wiki：

• Wiki & 开发者 API: https://refracdevelopment.gitbook.io/simplegems/