? NoieServerCion
一款精美的 Minecraft 经济解决方案,采用双 Cion 系统
? 概述
NoieServerCion 是一款多功能的 Minecraft 服务器 Cion 管理插件,为您的服务器提供强大的经济基础设施。该插件实现了全服全局 Cion(nsc)和玩家专属个人 Cion(npcion),赋予服务器管理员前所未有的创建经济系统的灵活性。
NoieServerCion 的独特之处?
与传统仅提供单一 Cion 的经济插件不同,NoieServerCion 允许您:
- 创建具有不同用途的多种 Cion
- 为特殊活动或奖励实施玩家专属 Cion
- 设置 Cion 上限以防止通货膨胀
- 使用精确的小数值进行微交易
- 配置智能占位符检测以实现无缝集成
✨ 功能特性
核心系统
-
双 Cion 系统:
- 用于全服经济的全局 Cion
- 用于个人奖励和成就的玩家专属个人 Cion
-
高级管理:
- 完整的 Cion 创建、删除、重命名和查询功能
- 支持全局模式命令的批量操作
- 交易日志记录与监控能力
-
技术卓越:
- 保留两位小数精度的十进制 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 <Cion_name> [initial_amount] |
/nsc create diamonds 1000 |
/nsc remove |
删除服务器 Cion |
/nsc remove <Cion_name> |
/nsc remove diamonds |
/nsc give |
增加服务器 Cion 数量 |
/nsc give <Cion_name> <amount> |
/nsc give diamonds 500 |
/nsc take |
减少服务器 Cion 数量 |
/nsc take <Cion_name> <amount> |
/nsc take diamonds 250 |
/nsc set |
设置服务器 Cion 数量 |
/nsc set <Cion_name> <amount> |
/nsc set diamonds 2000 |
/nsc rename |
重命名服务器 Cion |
/nsc rename <old_name> <new_name> |
/nsc rename diamonds gems |
/nsc list |
显示所有服务器 Cion |
/nsc list [cache|database] |
/nsc list cache |
/nsc limit |
设置 Cion 上限 |
/nsc limit <Cion_name> [limit_value] |
/nsc limit diamonds 10000 |
/nsc reload |
重载插件 |
/nsc reload |
/nsc reload |
玩家 Cion 命令 /npcion
玩家 Cion 命令支持两种强大的模式:
1️⃣ 玩家专属模式
针对特定玩家的 Cion 余额进行操作。
| 命令 |
描述 |
用法 |
示例 |
/npcion create |
为指定玩家创建 Cion |
/npcion create <player_name> <Cion_name> [initial_amount] [limit] |
/npcion create Steve tokens 100 1000 |
/npcion remove |
删除特定玩家的 Cion |
/npcion remove <player_name> <Cion_name> |
/npcion remove Steve tokens |
/npcion give |
向玩家发放 Cion |
/npcion give <player_name> <Cion_name> <amount> |
/npcion give Steve tokens 50 |
/npcion take |
从玩家扣除 Cion |
/npcion take <player_name> <Cion_name> <amount> |
/npcion take Steve tokens 25 |
/npcion set |
设置玩家的 Cion 数量 |
/npcion set <player_name> <Cion_name> <amount> |
/npcion set Steve tokens 200 |
/npcion rename |
重命名玩家的 Cion |
/npcion rename <player_name> <old_name> <new_name> |
/npcion rename Steve tokens credits |
/npcion list |
显示玩家的所有 Cion |
/npcion list <player_name> |
/npcion list Steve |
/npcion limit |
设置玩家的 Cion 上限 |
/npcion limit <player_name> <Cion_name> [limit_value] |
/npcion limit Steve tokens 2000 |
2️⃣ 全局模式
针对所有玩家同时执行的操作,同时保持各自的余额。
| 命令 |
描述 |
用法 |
示例 |
/npcion create |
为所有玩家创建 Cion |
/npcion create <Cion_name> [initial_amount] [limit] |
/npcion create event_points 0 100 |
/npcion remove |
从所有玩家处删除 Cion |
/npcion remove <Cion_name> |
/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:
- 首先检查玩家是否具有指定名称的个人 Cion
- 如果未找到,则回退到具有相同名称的全局 Cion
- 如果两者都不存在,则返回可配置默认值(通常为 0.00)
这允许无缝集成记分板和 GUI,而无需复杂的条件逻辑。
⚙️ 配置
插件配置文件包含大量自定义选项:
1. 数据库设置
mysql:
enabled: false # 设置为 true 以使用 MySQL 代替 SQLite
host: "localhost" # 数据库服务器地址
port: 3306 # MySQL 端口
database: "minecraft" # 数据库名称
username: "root" # 数据库用户名
password: "password" # 数据库密码
connection_pool: 10 # 保持的连接数
timeout: 30000 # 连接超时时间(毫秒)
2. 消息自定义
messages:
permission_denied: '<#7c8ff2>You do not have permission to perform this action.'
invalid_amount_message: '<#7c8ff2>The specified amount is invalid.'
invalid_limit_message: '<#7c8ff2>The specified limit is invalid. Limit must be greater than 0.'
? 安装
-
下载插件
-
服务器安装
- 将 JAR 文件放入服务器的
plugins 文件夹中
-
重启服务器
-
配置
- 编辑
config.yml 文件以根据您的需求自定义插件
- 如果需要,配置 MySQL 以支持大型服务器
-
重载
? 依赖项
必需
- Bukkit/Spigot/Paper 服务器平台
可选依赖
- PlaceholderAPI:允许在其他插件中使用占位符
- Vault:提供与其他经济类插件的兼容性
- MySQL:适用于需要数据库存储的大型服务器
? 最佳实践
经济系统设计
- 为不同用途创建不同的 Cion(例如:投票奖励、活动代币)
- 设置合理的上限以防止经济通胀
- 使用玩家专属 Cion 用于临时活动
性能优化
- 对于高流量服务器,启用缓存功能
- 对于玩家数量较多的服务器,考虑使用 MySQL
- 定期安排数据库维护
安全性
- 将管理员权限限制在受信任的工作人员范围内
- 在高安全环境中启用交易日志记录
- 定期备份你的 Cion 数据
? 应用场景
服务器商店与市场
通过多种 Cion 构建强大的经济体系,以支持不同类型的商店。
活动奖励
利用玩家专属 Cion 开展限时活动,而不影响主经济系统。
进度系统
实施基于 Cion 的进度系统,解锁特殊功能或物品。
VIP 特权
为 VIP 玩家提供专属 Cion 或更高的额度限制。
❓ 常见问题
通用问题
Q: NoieServerCion 能否与其他经济类插件共存?
A: 可以!NoieServerCion 设计为可与其他经济类插件协同工作,不会产生冲突。
Q: 服务器 Cion 和玩家 Cion 有什么区别?
A: 服务器 Cion 是全局 Cion,所有人都可以访问;而玩家 Cion 则专属于特定玩家。
Q: 我可以创建多少个 Cion?
A: 没有硬性限制,但出于性能考虑,建议总数保持在 50 个以内。
技术问题
Q: 该插件是否支持离线玩家?
A: 是的,插件将数据存储于数据库中,因此可以操作离线玩家的余额。
Q: 数据存储是否安全?
A: 是的,所有数据库交互均符合安全标准,并遵循数据保护的最佳实践。
? 故障排除
常见问题
| 问题 |
解决方案 |
| 插件未加载 |
检查服务器日志中的错误信息,并确保使用的是兼容的 Minecraft 版本 |
| MySQL 连接失败 |
验证数据库凭据,并确保 MySQL 服务器可访问 |
| 命令无法使用 |
检查权限配置及命令语法 |
| 占位符无效 |
确保已安装 PlaceholderAPI 且配置正确 |
? 更新日志
版本 1.5
- 新增“限额”功能:可为指定 Cion 设置最大上限
- 新增“初始分配”功能
- 引入了同时作用于全局池和独立玩家的 Cion 系统
- 升级至 Java 21 兼容
- 性能提升与漏洞修复
? 技术支持
遇到问题或有疑问?我们随时为您提供帮助!
? 许可证
版权所有 © 2025 linmimeng。保留所有权利。
NoieServerCion 为专有软件。未经作者明确许可,禁止未经授权地复制、修改或分发。
? NoieServerCion
A sophisticated Minecraft economy solution with dual-Cion systems
? Overview
NoieServerCion is a versatile Minecraft server Cion management plugin that provides robust economic infrastructure for your server. The plugin implements both server-wide global Cion (nsc) and player-specific personal Cion (npcion), giving server administrators unprecedented flexibility in creating economic systems.
What Makes NoieServerCion Different?
Unlike traditional economy plugins that provide a single Cion, NoieServerCion allows you to:
- Create multiple Cion with different purposes
- Implement player-specific Cion for special events or rewards
- Set Cion limits to prevent inflation
- Use precision decimal values for micro-transactions
- Configure intelligent placeholder detection for seamless integration
✨ Features
Core System
-
Dual Cion System:
- Server-wide global Cion for server-wide economies
- Player-specific personal Cion for individual rewards and achievements
-
Advanced Management:
- Complete Cion creation, deletion, renaming, and query functions
- Batch operations with global mode commands
- Transaction logging and monitoring capabilities
-
Technical Excellence:
- Decimal Cion values with 2 decimal places precision
- Configurable maximum value limits
- Optimized database structure and caching
- Asynchronous operations to prevent server lag
Integration & Extensions
-
Database Support:
- Local SQLite storage for small servers
- MySQL support for larger infrastructures
- Efficient connection pooling and data caching
-
Developer-Friendly:
- Comprehensive placeholder system for scoreboard/GUI integration
- Smart detection algorithm for choosing appropriate Cion display
- Clean API for third-party plugin integration
Administration
- Powerful Control:
- Granular permissions system
- Comprehensive command structure
- Advanced configuration options
- Real-time reload capabilities
?️ Data Structure
The plugin organizes data in three optimized tables:
| Table |
Purpose |
Description |
| Server_Cion |
Global Cion |
Stores the main Cion data for server-wide Cion |
| Server_Cion_Limit |
Limit management |
Defines maximum values for each Cion type |
| Player_Cion |
Personal Cion |
Maintains player-specific Cion balances |
? Commands
Server Cion Commands /nsc
| Command |
Description |
Usage |
Example |
/nsc create |
Create a new server Cion |
/nsc create <Cion_name> [initial_amount] |
/nsc create diamonds 1000 |
/nsc remove |
Delete a server Cion |
/nsc remove <Cion_name> |
/nsc remove diamonds |
/nsc give |
Increase server Cion amount |
/nsc give <Cion_name> <amount> |
/nsc give diamonds 500 |
/nsc take |
Decrease server Cion amount |
/nsc take <Cion_name> <amount> |
/nsc take diamonds 250 |
/nsc set |
Set server Cion amount |
/nsc set <Cion_name> <amount> |
/nsc set diamonds 2000 |
/nsc rename |
Rename server Cion |
/nsc rename <old_name> <new_name> |
/nsc rename diamonds gems |
/nsc list |
Display all server Cion |
/nsc list [cache|database] |
/nsc list cache |
/nsc limit |
Set Cion limit |
/nsc limit <Cion_name> [limit_value] |
/nsc limit diamonds 10000 |
/nsc reload |
Reload plugin |
/nsc reload |
/nsc reload |
Player Cion Commands /npcion
Player Cion commands support two powerful modes:
1️⃣ Player-Specific Mode
Operations that target a specific player's Cion balance.
| Command |
Description |
Usage |
Example |
/npcion create |
Create Cion for a specific player |
/npcion create <player_name> <Cion_name> [initial_amount] [limit] |
/npcion create Steve tokens 100 1000 |
/npcion remove |
Delete a specific player's Cion |
/npcion remove <player_name> <Cion_name> |
/npcion remove Steve tokens |
/npcion give |
Give Cion to a player |
/npcion give <player_name> <Cion_name> <amount> |
/npcion give Steve tokens 50 |
/npcion take |
Deduct Cion from a player |
/npcion take <player_name> <Cion_name> <amount> |
/npcion take Steve tokens 25 |
/npcion set |
Set player's Cion amount |
/npcion set <player_name> <Cion_name> <amount> |
/npcion set Steve tokens 200 |
/npcion rename |
Rename player's Cion |
/npcion rename <player_name> <old_name> <new_name> |
/npcion rename Steve tokens credits |
/npcion list |
Display all of a player's Cion |
/npcion list <player_name> |
/npcion list Steve |
/npcion limit |
Set player's Cion limit |
/npcion limit <player_name> <Cion_name> [limit_value] |
/npcion limit Steve tokens 2000 |
2️⃣ Global Mode
Operations that target all players simultaneously, while maintaining individual balances.
| Command |
Description |
Usage |
Example |
/npcion create |
Create Cion for all players |
/npcion create <Cion_name> [initial_amount] [limit] |
/npcion create event_points 0 100 |
/npcion remove |
Delete Cion from all players |
/npcion remove <Cion_name> |
/npcion remove event_points |
/npcion list |
Display Cion used by all players |
/npcion list |
/npcion list |
? Permissions
| Permission Node |
Description |
Recommended For |
noieservercion.admin |
Full access to all plugin administration commands |
Server owners, administrators |
noieservercion.player |
Access to player Cion commands |
Moderators, trusted staff |
? Placeholders
NoieServerCion provides dynamic placeholders for integration with other plugins:
| Placeholder |
Description |
Example Result |
%noieservercion_cion_name% |
Displays the value of the specified Cion with smart detection (prioritizes player's personal Cion, defaults to server Cion if not found) |
250.00 |
%noieservercion_cion_name_[Format]% |
Custom number format |
0.## |
Smart Detection Algorithm
The plugin uses an intelligent algorithm to determine which Cion to display:
- First checks if the player has a personal Cion with the specified name
- If not found, falls back to server-wide Cion with the same name
- If neither exists, returns a configurable default value (typically 0.00)
This allows for seamless scoreboard and GUI integration without complex conditional logic.
⚙️ Configuration
The plugin configuration file contains extensive customization options:
1. Database Settings
mysql:
enabled: false # Set to true to use MySQL instead of SQLite
host: "localhost" # Database server address
port: 3306 # MySQL port
database: "minecraft" # Database name
username: "root" # Database username
password: "password" # Database password
connection_pool: 10 # Number of connections to maintain
timeout: 30000 # Connection timeout in milliseconds
2. Message Customization
messages:
permission_denied: '<#7c8ff2>You do not have permission to perform this action.'
invalid_amount_message: '<#7c8ff2>The specified amount is invalid.'
invalid_limit_message: '<#7c8ff2>The specified limit is invalid. Limit must be greater than 0.'
? Installation
-
Download the Plugin
- Get the latest version from the official website or SpigotMC
-
Server Installation
- Place the JAR file in your server's
plugins folder
-
Server Restart
- Restart your server or use a plugin manager to load the plugin
-
Configuration
- Edit the
config.yml file to customize the plugin to your needs
- Configure MySQL if needed for larger servers
-
Reload
- Run
/nsc reload to apply your configuration changes
? Dependencies
Required
- Bukkit/Spigot/Paper server platform
Optional
- PlaceholderAPI: Enables the use of placeholders in other plugins
- Vault: Provides compatibility with other economy plugins
- MySQL: For larger servers requiring database storage
? Best Practices
Economy Design
- Create different Cion for different purposes (e.g., voting rewards, event tokens)
- Set appropriate limits to prevent economy inflation
- Use player-specific Cion for temporary events
Performance Optimization
- Enable caching for high-traffic servers
- Consider MySQL for servers with many players
- Schedule regular database maintenance
Security
- Restrict admin permissions to trusted staff only
- Enable transaction logging in high-security environments
- Regularly backup your Cion data
? Use Cases
Server Shops and Markets
Create a robust economy with multiple Cion for different types of shops.
Event Rewards
Use player-specific Cion for limited-time events without affecting the main economy.
Progression Systems
Implement progression systems with Cion that unlock special features or items.
VIP Benefits
Provide VIP players with exclusive Cion or higher limits.
❓ Frequently Asked Questions
General Questions
Q: Can I use NoieServerCion alongside other economy plugins?
A: Yes! NoieServerCion is designed to work alongside other economy plugins without conflicts.
Q: What's the difference between server Cion and player Cion?
A: Server Cions are global Cion accessible to everyone, while player Cions are specific to individual players.
Q: Is there a limit to how many Cion I can create?
A: There's no hard limit, but for performance reasons, we recommend keeping it under 50 total Cion.
Technical Questions
Q: Does the plugin work with offline players?
A: Yes, the plugin stores data in a database, allowing manipulation of offline player balances.
Q: Is the data stored securely?
A: Yes, all database interactions are secure and follow best practices for data protection.
? Troubleshooting
Common Issues
| Issue |
Solution |
| Plugin doesn't load |
Check server logs for errors and ensure you're using a compatible Minecraft version |
| MySQL connection fails |
Verify your database credentials and ensure the MySQL server is accessible |
| Commands not working |
Check permissions and command syntax |
| Placeholders not working |
Ensure PlaceholderAPI is installed and properly configured |
? Changelog
Version 1.5
- Added Limit feature: set a maximum cap for a specified Cion
- Added Initial Allocation feature
- Introduced a Cion system scoped to both the global pool and individual players
- Upgraded to Java 21 compatibility
- Performance improvements and bug fixes
? Support
Having issues or questions? We're here to help!
? License
Copyright © 2025 linmimeng. All Rights Reserved.
NoieServerCion is proprietary software. Unauthorized copying, modification, or distribution is prohibited without express permission from the author.
评论 0
登录后参与评分
还没有评论,来抢沙发吧