# AdvanceClans<\/p>\n
<\/p>\n
### 1. Plugin Overview
\n**Name**: AdvanceClans (Advance ClanX)
\n**Version**: 1.0
\n**Description**: A professional-grade, high-performance clan management system for Minecraft servers. Built with a focus on extreme scalability, minimal resource usage, and seamless player experience<\/p>\n
### 2. Core Features (Performance)
\n### The Performance Analysis
\n* **Extreme Load Handling**: Tested for **30 Kills\/Deaths per second**.
\n* **Zero TPS Impact**: All database operations (point updates, member changes) are handled **Asynchronously**. The main server thread is never blocked.
\n* **Memory Efficiency**: Uses smart caching for online players (~10-20MB overhead). Does **NOT** use `Bukkit.getOfflinePlayer().getName()`, preventing the common “null” bug and lag.
\n* **Scalability**: Optimized for **1,000+ members per clan** and **200+ active clans**.
\n* **Database**: Uses **SQLite with WAL Mode** (Write-Ahead Logging) for safe, concurrent high-speed data access.<\/p>\n
### 3. Commands & Permissions<\/p>\n
### Player Commands ### Leader\/Admin Commands ` | Invite a player. | `clans.invite` | ` | Kick a member. | `clans.kick` | `| Promote to Co-Owner. | `clans.cowner` | `| Admin: Remove member. | `force.op` |<\/p>\n ### 4. PlaceholderAPI Integration ### 5. Technical Specifications ### 7. Data Saving Internal Logic ### Data Storage Mechanism ### Functional Logic A professional-grade, high-performance clan management system for Minecraft servers. Built with a focus on extreme scalability, minimal resource usage, and seamless player experience<\/p>\n","protected":false},"featured_media":6586,"template":"","meta":{"_minecraft_slug":"advance-clanx","_minecraft_project_id":"PjZGwrs8","_minecraft_author":"YourSenior","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":172,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"advance-clanx.zip","_minecraft_size_bytes":64931,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T13:10:23.599571Z","_minecraft_date_created":"2026-01-31T21:19:03.302247Z","_minecraft_date_modified":"2026-02-09T12:40:09.728215Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/advance-clanx","_minecraft_icon_attachment_id":6586,"_minecraft_imported_at":"2026-05-31T14:21:47+00:00","_minecraft_import_hash":"f6ac62e3c48c065575cf42b205eaf117","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,126,127,128,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-6585","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n| Command | Usage | Description | Permission |
\n|:— |:— |:— |:— |
\n| `\/clan` | `\/clan` | Main GUI Menu. | `clans.use` |
\n| `\/clan create` | `\/clan create
\n| `\/clan join` | `\/clan join
\n| `\/clan accept` | `\/clan accept` | Accept a clan invite. | `clans.accept` |
\n| `\/clan leave` | `\/clan leave` | Leave current clan. | `clans.leave` |
\n| `\/clan info` | `\/clan info [clan]` | View clan statistics. | `clans.info` |
\n| `\/clan top` | `\/clan top` | Leaderboard GUI. | `clans.top` |
\n| `\/clan chat` | `\/clan chat` | Toggle Clan Chat mode. | `clans.chat` |
\n| `\/clan home` | `\/clan home` | Teleport to clan home. | `clans.home` |<\/p>\n
\n| Command | Usage | Description | Permission |
\n|:— |:— |:— |:— |
\n| `\/clan invite` | `\/clan invite <\/p>\n
\n| `\/clan kick` | `\/clan kick <\/p>\n
\n| `\/clan disband` | `\/clan disband` | Delete the clan. | `clans.disband` |
\n| `\/clan sethome` | `\/clan sethome` | Set home location. | `clans.sethome` |
\n| `\/clan cowner` | `\/clan cowner set <\/p>\n
\n| `\/clan set colour`| `\/clan set colour
\n| `\/forceclan delete`| `\/forceclan delete
\n| `\/forceclan remove`| `\/forceclan remove
\nUse these placeholders in scoreboards, tablists, or chat:
\n* `%advanceclans_clan%` – Player’s clan name.
\n* `%advanceclans_role%` – Player’s role (LEADER, COOWNER, MEMBER).
\n* `%advanceclans_points%` – Clan’s total points.
\n* `%advanceclans_color%` – Clan’s display color code.
\n* `%clans_name%` \u2192 Shows the player’s clan name.
\n* `%clans_name_plain%` \u2192 Shows the player’s clan name stripped from color codes.
\n* `%clans_list_<#>_name%` \u2192 Shows the name of the clan at that position in the leaderboard.
\n* `%clans_list_<#>_leader%` \u2192 Shows the leader of the clan at that position.
\n* `%clans_list_<#>_point%` \u2192 Shows the balance of the clan at that position.
\nNote: Replace <#> with the rank number in the leaderboard (e.g., %clans_list_1_name% for the top clan).<\/p>\n
\n* **Dependencies**: Requires PlaceholderAPI.
\n* **Database Structure**:
\n * `clans`: Stores name, leader name, points, color, and home location.
\n * `members`: Stores UUID, clan name, role, and **last_known_name** (prevents “null” issues).
\n * `allies`: Stores clan alliance relationships.
\n* **Configuration Files**:
\n * `config.yml`: Core limits and permissions.
\n * `msg.yml`: 100% translatable messages.
\n * `gui.yml` \/ `settingsgui.yml`: Full GUI customization.<\/p>\n
\nThe plugin employs a multi-layered approach to data integrity and performance:<\/p>\n
\n* **Database Engine**: SQLite with **WAL (Write-Ahead Logging)** mode. This allows the plugin to write to the database while simultaneously reading from it, preventing the “database is locked” errors common in simpler plugins.
\n* **Schema Design**:
\n * `clans`: Primary table for metadata (Owner name, Points, Color, Home Location).
\n * `members`: Linking table connecting Player UUIDs to Clan names. It includes a `last_name` column which is updated every time a player joins, ensuring that even if a player changes their name or is offline, the plugin can display their name without querying the Mojang API or Bukkit’s heavy `getOfflinePlayer` methods.
\n * `allies`: A simple relationship table for clan-to-clan alliances.<\/p>\n
\n* **Asynchronous Execution**: Functions like `updatePoints`, `createClan`, and `forceDeleteClan` run on a separate thread. This means that if the database takes 100ms to save, your server’s TPS stays at a perfect 20.0.
\n* **Smart Caching**: On startup, the plugin loads all member-to-clan relationships into a `HashMap
\n* **Atomic Updates**: Point updates use SQL arithmetic (`SET points = points + ?`) rather than reading, modifying, and writing back. This prevents “race conditions” where two kills happening at the exact same time might overwrite each other.
\n* **Persistence Strategy**: Data is saved immediately to the SQLite file upon any change. There is no risk of losing points if the server crashes unexpectedly.<\/p>\n","protected":false},"excerpt":{"rendered":"