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:

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
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

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.