hClansStorageAddon is an addon for hClans that adds a shared clan storage inventory.
It allows clan members to open one common storage, store items together and manage access through configurable clan permission checks. The addon keeps the storage saved in the database, restores it when needed and can automatically remove it after a clan is deleted.
The addon also supports configurable storage size, custom title, world restrictions, aliases for the storage subcommand and separate control for opening, putting and taking items.
Main Features

• Shared clan storage for hClans.
• Configurable storage size from 1 to 6 rows.
• Custom storage title with clan name placeholder.
• Automatic loading and saving of clan storage contents.
• Separate permission logic for opening, putting and taking items.
• Optional owner bypass for each permission group.
• Optional clan permission nodes for storage access.
• World blacklist and whitelist support.
• Automatic storage deletion when a clan is deleted.
• Storage subcommand aliases through the configuration.
• Optional visibility in tab completion.
• Uses the hClans database API for persistent storage.

How It Works
A player opens the shared storage through the clan storage subcommand.
The addon checks whether the player is in a clan, verifies world restrictions and then validates whether the player is allowed to open the storage.
When the storage is opened, the addon loads the clan inventory from the database or creates a new one if this clan has no saved storage yet.
All changes are tracked while the inventory is open. When the inventory is changed or closed, the current contents are saved back to the database.
Shared Inventory
Each clan gets one common inventory.
The storage size is configurable with settings.storage.rows and supports values from 1 to 6 rows.
The inventory title is also configurable and supports the {clan} placeholder.
Default title example:
Access Control
The addon supports three independent access groups:

• opening the storage
• putting items into the storage
• taking items from the storage

For each group you can configure:

• whether the clan owner is always allowed
• whether clan permission checks are enabled
• which clan permission name should be checked

Default configured clan permission names:
By default, clan permission checks are disabled, so every clan member can use the storage unless you enable those checks in the configuration.
World Restrictions
The addon can restrict storage usage by world.
Supported modes:

• blacklist – block storage only in listed worlds
• whitelist – allow storage only in listed worlds

If a world is blocked, the player receives the configured worldBlocked action.
Configuration
Default configuration:
Actions
The addon uses configurable action lists for player feedback.
Included action groups:
These actions are used for errors, usage messages and permission-related responses.
Commands
Main subcommand:
Default usage:
Additional aliases for the storage subcommand can be configured in:
Permissions
hClansStorageAddon does not use standalone Bukkit permissions for players in the default setup.
Instead, it can register and check clan permissions if you enable them in the configuration.
Configurable clan permissions:
Important: these are clan permissions used inside the hClans permission system, not regular standalone Bukkit permissions for a separate command.
Requirements

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

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

1. Install hClans on your server.
2. Place hClansStorageAddon.jar into the plugins folder.
3. Start or restart the server.
4. Open the generated configuration file.
5. Adjust the storage, permission and world settings if needed.
6. Restart the server again or reload hClans/addons in your normal workflow.

Configuration file:
Notes

• Each clan has one shared storage.
• Storage contents are saved in the database through the hClans database API.
• The addon can automatically remove saved storage when a clan is deleted.
• Opening, putting and taking permissions can be configured independently.
• The storage title supports the {clan} placeholder.
• Storage size is limited to 1–6 rows.