hClansMenuAddon is an addon for hClans that adds a configurable clan menu.
The addon registers a new clan subcommand, opens a custom GUI, displays clan information and allows you to create clickable menu items that execute configured actions.
The menu is fully configured through YAML: size, title, items, slots, materials, names, lore, custom heads, glow, CustomModelData, click actions and command aliases.
Main Features

• Adds a configurable /clan menu subcommand.
• Custom inventory menu for hClans.
• Configurable menu size.
• Configurable menu title.
• Optional clan-only access.
• Custom GUI items.
• Slot ranges support.
• Custom materials.
• Custom player heads and base64 heads.
• Custom item names and lore.
• CustomModelData support.
• Glow support.
• Hide attributes support.
• Click-based actions.
• Command aliases through config.
• Optional tab-complete visibility.
• Clan placeholders in menu title, item names and lore.

How It Works
Players open the menu through the clan subcommand:
When the command is used, the addon checks whether the player is in a clan if requireClan is enabled.
If the player is allowed to open the menu, the addon builds the GUI from the configuration file, applies placeholders, creates all configured items and opens the inventory.
When a player clicks an item, the addon reads the click action from the item configuration and executes the configured actions.
Clan-Only Access
The menu can be restricted only to players who are in a clan.
This is controlled by:
If the player is not in a clan, the addon runs the configured notInClan actions.
Custom Menu Layout
The menu size can be configured as a standard Minecraft inventory size.
Supported sizes:
The title is configurable and supports clan placeholders.
Example:
Custom Items
Every item in the menu can be configured separately.
Item settings include:

• single slot or multiple slots
• slot ranges
• material
• amount
• display name
• lore
• CustomModelData
• glow
• hidden attributes
• custom skull owner
• base64 head texture
• click actions

Example slot formats:
This makes it possible to create borders, buttons, information items and navigation items directly from the config.
Custom Heads
The addon supports custom heads through the hClans skull API.
You can use base64 head values in item material configuration.
Example:
This allows you to create cleaner and more unique menu buttons without requiring separate resource packs.
Click Actions
Items can execute actions when clicked.
Default configuration examples use actions such as:
Example:
You can use menu items to redirect players to other clan commands, open other menus, show messages or close the inventory.
Click Types
The addon supports different click action keys.
Examples:
This allows different behavior depending on how a player clicks an item.
Configuration
Default configuration structure:
Action Sections
Global action sections:
Item action section example:
Placeholders
The addon supports placeholders in menu title, item names, lore and actions.
Available placeholders include:
Additional placeholders may also be processed through hClans formatting utilities.
Commands
Main command:
Additional aliases for the menu subcommand can be configured in:
Permissions
hClansMenuAddon does not define separate Bukkit permissions in the current version.
Access is controlled through:

• whether the player is in a clan
• the settings.menu.requireClan option
• permissions of commands executed by menu item actions

If an item action runs another command, that command may still require its own permission depending on the target plugin.
Requirements

• Java 17 or newer.
• Minecraft 1.16 or newer.
• A server compatible with Bukkit/Spigot/Paper.
• hClans plugin.

Important: hClansMenuAddon is an addon and requires hClans to work.
Installation

1. Install hClans on your server.
2. Place hClansMenuAddon.jar into the plugins folder.
3. Start or restart the server.
4. Open the generated configuration file.
5. Configure menu size, title, items and actions.
6. Restart the server again or reload hClans/addons in your normal workflow.

Configuration file:
Notes

• The addon registers menu as a clan subcommand.
• The menu can be hidden from tab-complete through the config.
• The menu can require clan membership.
• All GUI items are configured through YAML.
• Slot ranges can be used for borders and decorations.
• Item clicks can execute configured actions.
• The addon uses hClans systems for command registration, actions and placeholders.