NoieServerCion

# 🪙 NoieServerCion --- ## 📋 概述 NoieServerCion 是一个多功能的 Minecraft 服务器 Cion 管理插件，为您的服务器提供强大的经济基础设施。该插件实现了服务器范围内的全局 Cion (nsc) 和玩家特定的个人 Cion (npcion)，为服务器管理员提供了前所未有的灵活性来创建经济体系。 ### NoieServerCion 的不同之处？ 与提供单个 Cion 的传统经济插件不同，NoieServerCion 允许您： - 创建多个具有不同用途的 Cion - 实施玩家特定的 Cion，用于特殊活动或奖励 - 设置 Cion 限制以防止通货膨胀 - 使用精确的小数值进行微交易 - 配置智能占位符检测，以实现无缝集成 --- ## ✨ 功能 ### 核心系统 - **双 Cion 系统**: - 服务器范围内的全局 Cion，用于服务器范围内的经济 - 玩家特定的个人 Cion，用于个人奖励和成就 - **高级管理**: - 完整的 Cion 创建、删除、重命名和查询功能 - 全局模式命令的批量操作 - 交易日志记录和监控功能 - **技术卓越**: - 具有 2 位小数精度的十进制 Cion 值 - 可配置的最大值限制 - 优化后的数据库结构和缓存 - 异步操作以防止服务器卡顿 ### 集成与扩展 - **数据库支持**: - 小型服务器的本地 SQLite 存储 - 用于较大基础设施的 MySQL 支持 - 高效的连接池和数据缓存 - **对开发者友好**: - 分钟表系统，用于排行榜/GUI 集成 - 智能检测算法，用于选择适当的 Cion 显示 - 清洁的 API，用于第三方插件集成 ### 管理 - **强大的控制**: - 粒度权限系统 - 完整的命令结构 - 高级配置选项 - 实时重新加载功能 --- ## 🗄️ 数据结构 该插件在三个优化的表中组织数据： | 表 | 用途 | 描述 | |-----------------------|---------------------|------------------------------------------------------| | **Server_Cion** | 全局 Cion | 存储服务器范围内的 Cion 数据 | | **Server_Cion_Limit** | 限制管理 | 定义每种 Cion 类型的最大值 | | **Player_Cion** | 个人 Cion | 维护玩家特定的 Cion 余额 | --- ## 🔍 命令 ### 服务器 Cion 命令 `/nsc` | 命令 | 描述 | 用法 | 示例 | |---------------|-------------------------------|--------------------------------------------|-----------------------------| | `/nsc create` | 创建一个新的服务器 Cion | `/nsc create [initial_amount]` | `/nsc create diamonds 1000` | | `/nsc remove` | 删除一个服务器 Cion | `/nsc remove ` | `/nsc remove diamonds` | | `/nsc give` | 增加服务器 Cion 金额 | `/nsc give ` | `/nsc give diamonds 500` | | `/nsc take` | 减少服务器 Cion 金额 | `/nsc take ` | `/nsc take diamonds 250` | | `/nsc set` | 设置服务器 Cion 金额 | `/nsc set ` | `/nsc set diamonds 2000` | | `/nsc rename` | 重命名服务器 Cion | `/nsc rename ` | `/nsc rename diamonds gems` | | `/nsc list` | 显示所有服务器 Cion | `/nsc list [cache\|database]` | `/nsc list cache` | | `/nsc limit` | 设置 Cion 限制 | `/nsc limit [limit_value]` | `/nsc limit diamonds 10000` | | `/nsc reload` | 重新加载插件 | `/nsc reload` | `/nsc reload` | ### 玩家 Cion 命令 `/npcion` 玩家 Cion 命令支持两种强大的模式： #### 1️⃣ 玩家特定模式 针对玩家特定 Cion 余额的操作。 | 命令 | 描述 | 用法 | 示例 | |------------------|--------------------------------------|---------------------------------------------------------------------|----------------------------------------| | `/npcion create` | 为特定玩家创建 Cion | `/npcion create [initial_amount] [limit]` | `/npcion create Steve tokens 100 1000` | | `/npcion remove` | 删除特定玩家的 Cion | `/npcion remove ` | `/npcion remove Steve tokens` | | `/npcion give` | 向玩家赠送 Cion | `/npcion give ` | `/npcion give Steve tokens 50` | | `/npcion take` | 从玩家中扣除 Cion | `/npcion take ` | `/npcion take Steve tokens 25` | | `/npcion set` | 设置玩家的 Cion 金额 | `/npcion set ` | `/npcion set Steve tokens 200` | | `/npcion rename` | 重命名玩家的 Cion | `/npcion rename ` | `/npcion rename Steve tokens credits` | | `/npcion list` | 显示所有玩家的 Cion | `/npcion list ` | `/npcion list Steve` | | `/npcion limit` | 设置玩家的 Cion 限制 | `/npcion limit [limit_value]` | `/npcion limit Steve tokens 2000` | #### 2️⃣ 全局模式 同时针对所有玩家的操作，同时保持个人余额。 | 命令 | 描述 | 用法 | 示例 | |------------------|----------------------------------------|-------------------------------------------------------|-------------------------------------| | `/npcion create` | 为所有玩家创建 Cion | `/npcion create [initial_amount] [limit]` | `/npcion create event_points 0 100` | | `/npcion remove` | 从所有玩家中删除 Cion | `/npcion remove ` | `/npcion remove event_points` | | `/npcion list` | 显示所有玩家使用的 Cion | `/npcion list` | `/npcion list` | --- ## 🔒 权限 | 权限节点 | 描述 | 推荐对象 | |-------------------------|---------------------------------------------------|-------------------------------| | `noieservercion.admin` | 访问所有插件管理命令 | 服务器所有者、管理员 | | `noieservercion.player` | 访问玩家 Cion 命令 | 版主、受信任的工作人员 | --- ## 📊 占位符 NoieServerCion 提供动态占位符，用于与其他插件集成： | 占位符 | 描述 | 示例结果 | |------------------------------|------------------------------------------------------------------------------------------------------------------------------------------|----------------| | `%noieservercion_cion_name%` | 显示指定 Cion 的值（优先检查玩家的个人 Cion，如果未找到则默认为服务器 Cion） | `250.00` | | `%noieservercion_cion_name_[Format]%` | 自定义数字格式 | `0.##` | ### 智能检测算法 该插件使用智能算法来确定要显示的 Cion： 1. 首先检查玩家是否具有指定名称的个人 Cion 2. 如果未找到，则回退到具有相同名称的服务器范围内的 Cion 3. 如果两者都不存在，则返回可配置的默认值（通常为 0.00） 这允许排行榜和 GUI 集成，无需复杂的条件逻辑。 --- ## ⚙️ 配置 插件配置文件包含广泛的自定义选项： ### 1. 数据库设置 ```yaml mysql: enabled: false # 设置为 true 以使用 MySQL 代替 SQLite host: "localhost" # 数据库服务器地址 port: 3306 # MySQL 端口 database: "minecraft" # 数据库名称 username: "root" # 数据库用户名 password: "password" # 数据库密码 connection_pool: 10 # 维护的连接数 timeout: 30000 # 连接超时时间（毫秒） ``` ### 2. 消息自定义 ```yaml messages: permission_denied: '<#7c8ff2>您无权执行此操作。' invalid_amount_message: '<#7c8ff2>指定的金额无效。' invalid_limit_message: '<#7c8ff2>指定的限制无效。限制必须大于 0。' ``` --- ## 📥 安装 1. **下载插件** - 从官方网站或 SpigotMC 获取最新版本 2. **服务器安装** - 将 JAR 文件放入服务器的 `plugins` 文件夹中 3. **服务器重启** - 重启您的服务器或使用插件管理器加载插件 4. **配置** - 编辑 `config.yml` 文件以自定义插件 - 如有需要，配置 MySQL 用于较大的服务器 5. **重新加载** - 运行 `/nsc reload` 以应用您的配置更改 --- ## 🔄 依赖 ### 必需 - Bukkit/Spigot/Paper 服务器平台 ### 可选 - **PlaceholderAPI**: 启用其他插件中使用占位符 - **Vault**: 提供与其他经济插件的兼容性 - **MySQL**: 用于需要数据库存储的较大服务器 --- ## 🌟 最佳实践 ### 经济设计 - 为不同的目的创建不同的 Cion（例如，投票奖励、活动令牌） - 设置适当的限制以防止经济通货膨胀 - 为临时活动使用玩家特定的 Cion ### 性能优化 - 启用高速服务器的缓存 - 考虑对于拥有许多玩家的服务器使用 MySQL - 定期安排数据库维护 ### 安全 - 仅将管理员权限限制给受信任的工作人员 - 启用交易日志记录在具有高安全性环境 - 定期备份您的 Cion 数据 --- ## 📊 用例 ### 服务器商店和市场 使用多个 Cion 创建强大的经济，用于不同类型的商店。 ### 事件奖励 使用玩家特定的 Cion 进行有限时间的活动，而不会影响主经济。 ### 进度系统 使用解锁特殊功能或物品的 Cion 实现进度系统。 ### VIP 优惠 为 VIP 玩家提供独家的 Cion 或更高的限制。 --- ## ❓ 常见问题解答 ### 一般问题 **Q：我可以使用 NoieServerCion 与其他经济插件一起使用吗？** A：是的！NoieServerCion 的设计目的是与其他经济插件一起使用，而不会发生冲突。 **Q：服务器 Cion 和玩家 Cion 有什么区别？** A：服务器 Cions 是所有人都可以访问的全局 Cion，而玩家 Cions 是特定于个人的。 **Q：我能创建多少 Cion？** A：没有硬性限制，但出于性能考虑，我们建议总数不要超过 50 个 Cion。 ### 技术问题 **Q：该插件是否适用于离线玩家？** A：是的，该插件将数据存储在数据库中，允许操作离线玩家的余额。 **Q：数据是否存储在安全的地方？** A：是的，所有数据库交互都是安全的，并遵循数据保护的最佳实践。 --- ## 🔧 故障排除 ### 常见问题 | 问题 | 解决方案 | |--------------------------|-------------------------------------------------------------------------------------| | 插件无法加载 | 检查服务器日志中的错误并确保您使用的是兼容的 Minecraft 版本 | | MySQL 连接失败 | 验证您的数据库凭据并确保 MySQL 服务器可访问 | | 命令无法工作 | 检查权限和命令语法 | | 占位符无法工作 | 确保安装了 PlaceholderAPI 并已正确配置 | --- ## 🔄 更新日志 ### 版本 1.5 - 添加了限制功能：为指定的 Cion 设置最大上限 - 添加了初始配置功能 - 引入了同时适用于全局池和个人玩家的 Cion 系统 - 升级到 Java 21 兼容性 - 性能改进和错误修复 --- ## 📞 支持 遇到问题或疑问？ 我们可以提供帮助! - **Discord**: [加入我们的社区](https://discord.noie.fun) --- ## 📜 许可证 版权所有 © 2025 linmimeng。保留所有权利。 NoieServerCion 是专有软件。未经作者明确授权，禁止复制、修改或分发。