# 🪙 NoieServerCion

![Version](https://img.shields.io/badge/version-1.5-blue.svg) ![Minecraft](https://img.shields.io/badge/Minecraft-1.20+-green.svg) ![Java](https://img.shields.io/badge/Java-21+-red.svg) **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](https://discord.noie.fun) --- ## 📜 License Copyright © 2025 linmimeng. All Rights Reserved. NoieServerCion is proprietary software. Unauthorized copying, modification, or distribution is prohibited without express permission from the author.