# 🪙 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.

Links

Tags

Creators

Details

The Pyriferrum Candelabra

goob

Blast Lamps, another planned feature

The Sundergut, a planned mob for Crag