hClans
hClans 是一个可配置的 Minecraft 服务器公会系统。
它提供公会创建、邀请、成员管理、基于角色的权限、公会等级、经验值、PlaceholderAPI 占位符、SQLite/MySQL 存储以及用于扩展核心插件的加载器系统。
功能
- 公会的创建与删除
- 带过期时间的公会邀请
- 接受和拒绝邀请的命令
- 踢出成员和离开公会的命令
- 基于角色的公会权限
- 可配置的管理者和成员角色
- 公会等级和经验值
- 基于公会等级的成员上限
- PlaceholderAPI 支持
- SQLite 和 MySQL 存储
- 可配置的公会名称验证
- 禁止使用的公会名称列表
- 基于 PlaceholderAPI 的创建条件
- 可视化的公会名称创建 GUI
- 可配置的字体、颜色和文本样式
- 加载器系统
- 开发者 API 和公会事件
- Hex 颜色支持
- 可配置的动作
公会
玩家可以创建公会、邀请其他玩家、接受或拒绝邀请、离开自己的公会、踢出成员,并在拥有相应权限时删除公会。
公会名称可以通过最小长度、最大长度、正则表达式验证、禁止名单和自定义创建条件进行控制。
邀请
hClans 内置了邀请系统。
邀请会在可配置的时间后过期。
settings:
clans:
inviteExpirationSeconds: 300
邀请消息可以通过动作系统包含可点击的文本。
角色
hClans 包含一个基于角色的权限系统。
默认角色:
owner
member
默认成员权限:
hclans.leave
内置公会权限:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expire
加载器可以通过 hClans API 注册额外的公会权限。
等级
公会等级是可配置的。
每个等级可以定义所需的经验值和最大成员数量限制。
settings:
levels:
lvl:
1:
exp: 0
maxMembers: 10
2:
exp: 300
maxMembers: 15
3:
exp: 500
maxMembers: 25
工作人员可以通过管理员命令管理公会等级和经验值。
创建者 GUI
hClans 包含一个可选的 GUI,用于可视化地自定义公会名称。
配置文件:
plugins/hClans/clanCreator.yml
创建者 GUI 支持:
- 字体选择
- 小型大写字母样式
- 粗体切换
- 斜体切换
- 下划线切换
- 三个可配置的颜色点
- 名称预览物品
- 确认和取消按钮
- 自定义装饰物品
- 通过 basehead 材质实现的自定义头颅
条件
公会的创建可以通过基于 PlaceholderAPI 的条件进行限制。
createConditions:
1:
check: '%player_level%'
type: '>='
value: 30
actions:
- '[MESSAGE] {prefix}&cYou do not meet the requirements to create a clan.'
存储
支持的存储模式:
SQLite
MySQL
默认使用 SQLite。可以在 config.yml 中启用 MySQL。
该插件还支持表前缀,因此核心插件和加载器可以安全地使用同一个数据库。
加载器
hClans 可以从以下位置加载加载器:
plugins/hClans/addons/
加载器可以通过额外的命令、菜单、存储模块、事件和集成来扩展公会系统。
核心 API 提供对以下内容的访问:
- 公会权限
- 自定义角色
- 自定义子命令
- 自定义占位符
- 数据库 API
- 公会事件
- 头颅工具
PAPI
PlaceholderAPI 标识符:
hclans
可用的占位符:
%hclans_has_clan%
%hclans_invite_clan%
%hclans_clan%
%hclans_name%
%hclans_owner%
%hclans_owner_uuid%
%hclans_members%
%hclans_member_count%
%hclans_is_owner%
%hclans_roles%
%hclans_role_ids%
%hclans_role_count%
也可以通过 API 或加载器注册自定义占位符。
动作
hClans 支持可配置的动作。
示例:
[MESSAGE]
[CONSOLE]
[PLAYER]
[BROADCAST]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[FIREWORK]
[EFFECT]
[VAULT]
[CLOSE]
动作可用于消息、邀请通知、创建条件、创建者 GUI 物品和结果处理。
命令
| 命令 |
描述 |
/clan |
显示公会帮助 |
/clan create <name> |
创建一个公会 |
/clan delete |
开始公会删除确认 |
/clan delete <name> |
确认公会删除 |
/clan invite <player> |
邀请一名玩家 |
/clan kick <player> |
踢出一名成员 |
/clan accept <clan> |
接受邀请 |
/clan deny <clan> |
拒绝邀请 |
/clan leave |
离开公会 |
/hclans reload |
重新加载插件配置 |
/hclans levels <clan> <action> <amount> |
管理公会等级或经验值 |
等级操作:
addlvl
addexp
removelvl
removeexp
setlevel
setexp
权限
Bukkit 权限:
hclans.use
hclans.reload
hclans.levels
公会角色权限:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expire
要求
必需:
Java 21+
Minecraft 1.21+
Spigot / Paper / 兼容的核心
PlaceholderAPI
可选:
MySQL
用于 Vault 动作的兼容 Vault 的经济系统
hClans 加载器
必须安装 PlaceholderAPI。
安装
- 安装 PlaceholderAPI。
- 将
hClans.jar 放入 plugins 文件夹。
- 启动或重启服务器。
- 打开
plugins/hClans/config.yml。
- 配置存储、角色、等级和公会设置。
- 如果希望使用视觉创建菜单,请配置
clanCreator.yml。
- 编辑存储或主要配置设置后,请重启服务器。
注意
- 默认使用 SQLite。
- 可以在存储部分启用 MySQL。
- 公会等级可以控制最大成员数量限制。
- 可以使用加载器文件夹来扩展系统。
- 创建菜单通过
clanCreator.yml 进行配置。
hClans
hClans is a configurable clan system for Minecraft servers.
It 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 plugin.
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 clan name validation
- Blocked clan names list
- PlaceholderAPI-based creation conditions
- Visual clan name creator GUI
- Configurable fonts, colors and text styles
- Addon loader
- Developer API and clan events
- Hex color support
- Configurable actions
Clans
Players can create clans, invite other players, accept or deny invites, leave their clan, kick members and delete the clan when they have the required access.
Clan names can be controlled with minimum length, maximum length, regex validation, blocked names and custom creation conditions.
Invites
hClans includes a built-in invite system.
Invites expire after a configurable time.
settings:
clans:
inviteExpirationSeconds: 300
Invite messages can include clickable text through the action system.
Roles
hClans includes a role-based permission system.
Default roles:
owner
member
Default member permission:
hclans.leave
Built-in clan permissions:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expire
Addons can register additional clan permissions through the hClans API.
Levels
Clan levels are configurable.
Each level can define required experience and a maximum member limit.
settings:
levels:
lvl:
1:
exp: 0
maxMembers: 10
2:
exp: 300
maxMembers: 15
3:
exp: 500
maxMembers: 25
Staff can manage clan level and experience through admin commands.
Creator GUI
hClans includes an optional GUI for visual clan name customization.
Configuration file:
plugins/hClans/clanCreator.yml
The creator GUI supports:
- font selection
- small caps 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
Conditions
Clan creation can be restricted through PlaceholderAPI-based conditions.
createConditions:
1:
check: '%player_level%'
type: '>='
value: 30
actions:
- '[MESSAGE] {prefix}&cYou do not meet the requirements to create a clan.'
Storage
Supported storage modes:
SQLite
MySQL
SQLite is used by default. MySQL can be enabled in config.yml.
The plugin also supports table prefixes so the core plugin and addons can use the same database safely.
Addons
hClans can load addons from:
plugins/hClans/addons/
Addons can extend the clan system with extra commands, menus, storage modules, events and integrations.
The core API provides access to:
- clan permissions
- custom roles
- custom subcommands
- custom placeholders
- database API
- clan events
- skull utilities
PAPI
PlaceholderAPI identifier:
hclans
Available placeholders:
%hclans_has_clan%
%hclans_invite_clan%
%hclans_clan%
%hclans_name%
%hclans_owner%
%hclans_owner_uuid%
%hclans_members%
%hclans_member_count%
%hclans_is_owner%
%hclans_roles%
%hclans_role_ids%
%hclans_role_count%
Custom placeholders can also be registered through the API or addons.
Actions
hClans supports configurable actions.
Examples:
[MESSAGE]
[CONSOLE]
[PLAYER]
[BROADCAST]
[SOUND]
[TITLE]
[ACTIONBAR]
[BOSSBAR]
[PARTICLE]
[FIREWORK]
[EFFECT]
[VAULT]
[CLOSE]
Actions can be used in messages, invite notifications, creation conditions, creator GUI items and result handling.
Commands
| Command |
Description |
/clan |
Shows clan help |
/clan create <name> |
Creates a clan |
/clan delete |
Starts clan deletion confirmation |
/clan delete <name> |
Confirms clan deletion |
/clan invite <player> |
Invites a player |
/clan kick <player> |
Kicks a member |
/clan accept <clan> |
Accepts an invite |
/clan deny <clan> |
Denies an invite |
/clan leave |
Leaves the clan |
/hclans reload |
Reloads the plugin configuration |
/hclans levels <clan> <action> <amount> |
Manages clan level or experience |
Level actions:
addlvl
addexp
removelvl
removeexp
setlevel
setexp
Permissions
Bukkit permissions:
hclans.use
hclans.reload
hclans.levels
Clan role permissions:
hclans.invite
hclans.kick
hclans.delete
hclans.leave
hclans.request.accept
hclans.request.deny
hclans.request.expire
Requirements
Required:
Java 21+
Minecraft 1.21+
Spigot / Paper / compatible core
PlaceholderAPI
Optional:
MySQL
Vault-compatible economy for Vault actions
hClans addons
PlaceholderAPI is required.
Install
- Install PlaceholderAPI.
- Place
hClans.jar into the plugins folder.
- Start or restart the server.
- Open
plugins/hClans/config.yml.
- Configure storage, roles, levels and clan settings.
- Configure
clanCreator.yml if you want to use the visual creator menu.
- Restart the server after editing storage or major configuration settings.
Notes
- 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 creator menu is configured through
clanCreator.yml.
评论 0
登录后参与评分
还没有评论,来抢沙发吧