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 [initial_amount]` | `/nsc create diamonds 1000` |
| `/nsc remove` | Delete a server Cion | `/nsc remove ` | `/nsc remove diamonds` |
| `/nsc give` | Increase server Cion amount | `/nsc give ` | `/nsc give diamonds 500` |
| `/nsc take` | Decrease server Cion amount | `/nsc take ` | `/nsc take diamonds 250` |
| `/nsc set` | Set server Cion amount | `/nsc set ` | `/nsc set diamonds 2000` |
| `/nsc rename` | Rename server Cion | `/nsc rename ` | `/nsc rename diamonds gems` |
| `/nsc list` | Display all server Cion | `/nsc list [cache|database]` | `/nsc list cache` |
| `/nsc limit` | Set Cion limit | `/nsc limit [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 [initial_amount] [limit]` | `/npcion create Steve tokens 100 1000` |
| `/npcion remove` | Delete a specific player’s Cion | `/npcion remove ` | `/npcion remove Steve tokens` |
| `/npcion give` | Give Cion to a player | `/npcion give ` | `/npcion give Steve tokens 50` |
| `/npcion take` | Deduct Cion from a player | `/npcion take ` | `/npcion take Steve tokens 25` |
| `/npcion set` | Set player’s Cion amount | `/npcion set ` | `/npcion set Steve tokens 200` |
| `/npcion rename` | Rename player’s Cion | `/npcion rename ` | `/npcion rename Steve tokens credits` |
| `/npcion list` | Display all of a player’s Cion | `/npcion list ` | `/npcion list Steve` |
| `/npcion limit` | Set player’s Cion limit | `/npcion limit [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 [initial_amount] [limit]` | `/npcion create event_points 0 100` |
| `/npcion remove` | Delete Cion from all players | `/npcion remove ` | `/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:
1. First checks if the player has a personal Cion with the specified name
2. If not found, falls back to server-wide Cion with the same name
3. 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
“`yaml
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
“`yaml
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
1. **Download the Plugin**
– Get the latest version from the official website or SpigotMC
2. **Server Installation**
– Place the JAR file in your server’s `plugins` folder
3. **Server Restart**
– Restart your server or use a plugin manager to load the plugin
4. **Configuration**
– Edit the `config.yml` file to customize the plugin to your needs
– Configure MySQL if needed for larger servers
5. **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!
– **Discord**: Join our community
—
## 📜 License
Copyright © 2025 linmimeng. All Rights Reserved.
NoieServerCion is proprietary software. Unauthorized copying, modification, or distribution is prohibited without express permission from the author.