TheClans

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
THECLANS
Clans, alliances and private chats for modern SMP servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Create real communities inside your server.
TheClans gives players a clean way to build clans, organize members, form alliances and communicate privately — without requiring Vault, PlaceholderAPI or an external database.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
OVERVIEW
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TheClans is a lightweight social plugin designed for survival servers, SMP communities and public events.
Players can create a clan with a unique name and tag, invite friends, manage internal roles and cooperate with allied clans. All data is stored locally in YAML.
Version 1.2.0 includes English and Spanish language files plus bilingual command aliases.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
MAIN FEATURES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Unique clan names and short tags
◆ Leader, officer and member roles
◆ Secure invitations with automatic expiration
◆ Promote, demote and remove members
◆ Public clan information and clan list
◆ Alliance requests, acceptance and separation
◆ Private clan chat with /cc
◆ Private alliance chat with /ac
◆ Persistent clan and alliance chat modes
◆ Optional protection against friendly fire
◆ Configurable clan size and request duration
◆ Persistent YAML storage
◆ English and Spanish included
◆ Fully customizable language files
◆ Commands supported in both languages
◆ No required dependencies
◆ Java and Bedrock friendly through Geyser
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ALLIANCES
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Clan leaders can send alliance requests to other clans.
Once accepted, both communities can communicate through the private alliance channel while remaining independent. Either leader may end the alliance at any time.
English commands:
/clan alliance request <clan>
/clan alliance accept <clan>
/clan alliance reject <clan>
/clan alliance break <clan>
Spanish commands:
/clan alianza solicitar <clan>
/clan alianza aceptar <clan>
/clan alianza rechazar <clan>
/clan alianza romper <clan>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PRIVATE CHAT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
/cc <message> — Clan chat
/ac <message> — Alliance chat
Change the default channel:
/clan chat clan
/clan chat alliance
/clan chat global
Private messages are also written to the server console for moderation and auditing.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
LANGUAGE SYSTEM
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Version 1.2.0 organizes translations inside:
plugins/TheClans/lang/
Included files:
lang/en.yml — English
lang/es.yml — Spanish
Select the active language in config.yml:
language: en
or
language: es
Every help page, error, invitation, role, chat mode, alliance notification, information display and private chat format is localized.
Supported variables include:
%player% %clan% %tag% %role% %mode% %message% %members% %max%
Reload configuration and language changes without restarting:
/clan reload
/clan recargar
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
BILINGUAL COMMANDS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TheClans recognizes both command styles regardless of the selected language.
◆ crear / create
◆ invitar / invite
◆ aceptar / accept
◆ rechazar / reject
◆ salir / leave
◆ expulsar / kick
◆ ascender / promote
◆ degradar / demote
◆ lista / list
◆ disolver / disband
◆ alianza / alliance
◆ recargar / reload
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PERMISSIONS
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
themurftclans.use
Allows normal clan features.
Default: true
themurftclans.create
Allows players to create clans.
Default: true
themurftclans.admin
Allows configuration and language reloads.
Default: operators
LuckPerms example:
/lp group default permission set themurftclans.use true
/lp group default permission set themurftclans.create true
/lp group owner permission set themurftclans.admin true
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
COMPATIBILITY
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
◆ Server software: Paper 1.21.x
◆ Tested version: Paper 1.21.8
◆ Java: 21 or newer
◆ LuckPerms: Optional and compatible
◆ Geyser/Floodgate: Optional and compatible
◆ Vault: Not required
◆ PlaceholderAPI: Not required
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
INSTALLATION
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1. Download TheClans-1.2.0.jar.
2. Place the file inside your server's /plugins folder.
3. Restart the Paper server.
4. Confirm that TheClans appears in green in /plugins.
5. Choose language: en or language: es in config.yml.
6. Customize files inside plugins/TheClans/lang/ if needed.
7. Assign the administrator permission only to trusted staff.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
UPDATING FROM 1.1.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Replace the old JAR and restart the server.
Existing clanes.yml data remains compatible.
The old root lang.yml is replaced by the new lang/en.yml and lang/es.yml structure.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
GUÍA RÁPIDA EN ESPAÑOL
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
TheClans permite crear clanes, invitar jugadores, administrar rangos internos, formar alianzas y utilizar chats privados.
Selecciona español usando language: es en config.yml.
Los idiomas se encuentran en plugins/TheClans/lang/.
Comandos principales:
/clan ayuda
/clan crear <nombre> <tag>
/clan invitar <jugador>
/cc <mensaje>
/ac <mensaje>
Después de editar config.yml o los idiomas utiliza:
/clan recargar
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Created by TheMurft • Version 1.2.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━