⭐ hClans [1.21.X-26.X] ⭐ | XSkull, PAPI, Vault and more support!

hClans is a configurable clan system for Minecraft servers.
The plugin provides clan creation, invites, member management, role-based permissions, clan levels, experience, PlaceholderAPI placeholders, SQLite/MySQL storage and an addon system for extending the core functionality.
hClans is designed as a core clan platform: the main plugin handles the clan logic, database, commands, roles, permissions, placeholders and API, while addons can register extra commands, menus, storage, events or custom integrations.
Main Features

• Clan creation and deletion.
• Clan invites with expiration time.
• Accept and deny invite commands.
• Member kick and leave commands.
• Role-based clan permissions.
• Configurable owner and member roles.
• Clan levels and experience.
• Member limits based on clan level.
• PlaceholderAPI support.
• SQLite and MySQL storage.
• Configurable name length and regex validation.
• Blocked clan names list.
• Optional clan creation conditions through PlaceholderAPI.
• Visual clan name creator GUI.
• Configurable colors, fonts and text styles for clan display names.
• Addon loader for extra hClans modules.
• Developer API and clan events.
• Hex color support.
• Configurable action system.

Clan Management
Players can create clans, invite other players, accept or deny invites, leave their clan, kick members and delete the clan if they have enough permission.
Main clan actions include:

• create a clan
• invite players
• accept or deny invitations
• kick members
• leave the clan
• delete the clan

Clan names can be controlled through:

• minimum length
• maximum length
• regular expression validation
• blocked names list
• creation conditions

Invites
hClans includes a built-in invite system.
Invites are stored temporarily and expire after the configured time.
Default invite expiration:
Invite messages can include clickable text through the action system.
Delete Confirmation
Clan deletion can require exact confirmation through:
This is controlled by:
This helps prevent accidental clan deletion.
Roles and Permissions
hClans includes a role-based permission system.
Default roles:
The owner role is configured as the main owner role and has special access to clan management actions.
The member role can be configured with specific clan permissions.
Default member permission:
Available built-in clan permissions include:
Addons can also register their own clan permissions through the hClans API.
Levels and Experience
hClans supports configurable clan levels.
Each level can define:

• required experience
• maximum member limit

Example:
Server staff can manage clan levels and experience through admin commands.
Visual Clan Creator
hClans includes an optional GUI for clan name customization during creation.
The creator menu can be configured in:
The GUI supports:

• font selection
• small caps font style
• bold toggle
• italic toggle
• underline toggle
• three configurable color points
• name preview item
• confirm and cancel buttons
• custom decorative items
• custom heads through basehead materials

This allows players to configure how their clan display name should look before creating the clan.
Creation Conditions
Clan creation can be restricted through PlaceholderAPI-based conditions.
Example:
This makes it possible to require a level, statistic, balance, permission-related placeholder or any other PlaceholderAPI value before a player can create a clan.
Storage
hClans supports two storage modes:

• SQLite
• MySQL

SQLite is used by default and stores data in the plugin folder.
MySQL can be enabled for external database storage.
The plugin uses a table prefix setting so both the main plugin and addons can use the same database safely.
Example:
Addon System
hClans can load addons from:
Addons can extend the clan system with additional features, commands, menus, storage modules and integrations.
The core plugin exposes systems for:

• clan permissions
• custom roles
• custom subcommands
• custom placeholders
• database access
• clan events
• skull/head utilities

Addon loading can be enabled or disabled in the configuration.
PlaceholderAPI
hClans registers PlaceholderAPI placeholders under the identifier:
Available placeholders include:
The plugin also supports custom placeholders registered through the API or addons.
Placeholder empty and zero values are configurable in config.yml.
Action System
hClans uses configurable actions for messages, commands, sounds, visual feedback and economy-related operations.
Action examples:
Actions can be used in messages, invite notifications, create conditions, clan creator GUI items and result handling.
Commands
Permissions
Bukkit permissions:
Clan role permissions:
Addon permissions may be registered by installed hClans addons.
Requirements

• Java 21 or newer.
• Minecraft 1.21 or newer.
• Spigot / Paper / compatible server core.
• PlaceholderAPI.

Optional:

• MySQL
• Vault-compatible economy for Vault actions
• hClans addons

Important: PlaceholderAPI is required.
Installation

1. Install PlaceholderAPI.
2. Place hClans.jar into the plugins folder.
3. Start or restart the server.
4. Open plugins/hClans/config.yml.
5. Configure storage, roles, levels and clan settings.
6. Configure clanCreator.yml if you want to use the visual creator menu.
7. Restart the server after editing storage or major configuration settings.

Notes

• PlaceholderAPI is required by the plugin.
• SQLite is used by default.
• MySQL can be enabled in the storage section.
• Clan levels can control maximum member limits.
• The addon folder can be used to extend the system.
• The clan creator menu is controlled by clanCreator.yml.