🪙 NoieServerCion

---

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