⌨️ 玩家命令列表¶
KaGuilds 提供了丰富的命令系统，支持所有公会功能的操作。所有命令都以 /kg 或 /guild 为前缀。
📋 命令概览¶
主命令¶
快捷访问¶
| 命令 | 功能 | 权限 |
|---|---|---|
/kg |
打开菜单 | kaguilds.command.main |
📝 玩家命令速查表¶
| 命令 | 功能 | 需要 | 权限节点 |
|---|---|---|---|
/kg |
打开菜单 | - | kaguilds.command.main |
/kg help |
查看帮助 | - | kaguilds.command.help |
/kg create |
创建公会 | - | kaguilds.command.create |
/kg join |
申请加入 | - | kaguilds.command.join |
/kg yes |
接受邀请 | - | kaguilds.command.yes |
/kg no |
拒绝邀请 | - | kaguilds.command.no |
/kg info |
查看信息 | - | kaguilds.command.info |
/kg menu |
打开菜单 | - | kaguilds.command.menu |
/kg leave |
退出公会 | - | kaguilds.command.leave |
/kg delete |
解散公会 | 会长 | kaguilds.command.delete |
/kg rename |
重命名 | 会长 | kaguilds.command.rename |
/kg seticon |
设置图标 | 会长 | kaguilds.command.seticon |
/kg motd |
设置公告 | 公会管理 | kaguilds.command.motd |
/kg invite |
邀请成员 | 公会管理 | kaguilds.command.invite |
/kg accept |
批准申请 | 公会管理 | kaguilds.command.accept |
/kg deny |
拒绝申请 | 公会管理 | kaguilds.command.deny |
/kg requests |
查看申请 | 公会管理 | kaguilds.command.requests |
/kg kick |
踢出成员 | 公会管理 | kaguilds.command.kick |
/kg promote |
提升成员 | 会长 | kaguilds.command.promote |
/kg demote |
降级成员 | 会长 | kaguilds.command.demote |
/kg transfer |
转让公会 | 会长 | kaguilds.command.transfer |
/kg chat |
公会聊天 | - | kaguilds.command.chat |
/kg settp |
设置传送点 | 会长 | kaguilds.command.settp |
/kg tp |
公会传送 | - | kaguilds.command.tp |
/kg bank |
金库管理 | - | kaguilds.command.bank |
/kg buff |
购买 Buff | - | kaguilds.command.buff |
/kg vault |
访问仓库 | - | kaguilds.command.vault |
/kg upgrade |
升级公会 | 公会管理 | kaguilds.command.upgrade |
/kg pvp |
公会战 | 公会管理 | kaguilds.command.pvp |
/kg confirm |
确认操作 | - | kaguilds.command.confirm |
/kg reload |
重载配置 | 公会管理 | kaguilds.admin.reload |
🏠 基础命令¶
/kg help [页码]¶
查看插件帮助菜单。
权限: kaguilds.command.help
用法:
说明:
- 每页显示 10 个命令
- 按功能分类显示
- 包含命令简短描述
示例:
👥 公会管理命令¶
/kg create <公会名称>¶
创建一个新的公会。
权限: kaguilds.command.create
用法:
说明:
- 需要支付创建费用（在
config.yml中配置） - 公会名称必须符合命名规则（长度、字符等）
- 创建后玩家自动成为公会会长
/kg delete¶
解散当前公会。
权限: kaguilds.command.delete
用法:
说明:
- 需要会长权限
- 需要确认操作（
/kg confirm） - 解散后所有成员离开公会
- 公会数据会被删除
注意: 此操作不可逆！
/kg rename <新名称>¶
重命名公会。
权限: kaguilds.command.rename
用法:
说明:
- 需要会长权限
- 需要支付费用（在
config.yml中配置） - 新名称必须符合命名规则
/kg info [公会名称]¶
查看公会信息。
权限: kaguilds.command.info
用法:
说明:
- 显示公会的详细信息
- 包括：名称、等级、成员数、资金等
输出示例:
/kg motd <公告内容>¶
设置公会公告。
权限: kaguilds.command.motd
用法:
说明:
- 需要管理员或会长权限
- 支持颜色代码
/kg seticon¶
设置公会图标。
权限: kaguilds.command.seticon
用法:
说明:
- 手持想要设置的物品
- 需要会长或管理员权限
- 需要支付费用（在
config.yml中配置） - 支持特殊材质物品（如 Oraxen、ItemsAdder 等自定义物品）
🤝 成员管理命令¶
/kg invite <玩家名称>¶
邀请玩家加入公会。
权限: kaguilds.command.invite
用法:
说明:
- 需要管理员或会长权限
- 邀请有效期为 60 秒
- 目标玩家可以使用
/kg yes或点击提示接受邀请
/kg accept <玩家名称>¶
批准玩家的入会申请。
权限: kaguilds.command.accept
用法:
说明:
- 需要管理员或会长权限
- 目标玩家必须已提交入会申请
- 使用
/kg requests查看待处理的申请
/kg deny <玩家名称>¶
拒绝玩家的入会申请。
权限: kaguilds.command.deny
用法:
说明:
- 需要管理员或会长权限
- 目标玩家会收到拒绝通知
/kg requests¶
查看待处理的入会申请。
权限: kaguilds.command.requests
用法:
说明:
- 需要管理员或会长权限
- 显示所有待处理的入会申请列表
/kg join <公会名称或ID>¶
申请加入公会。
权限: kaguilds.command.join
用法:
说明:
- 公会管理员会收到申请通知
- 可以使用
/kg accept <玩家名称>批准或/kg deny <玩家名称>拒绝
/kg yes¶
接受公会邀请。
权限: kaguilds.command.yes
用法:
说明:
- 接受公会管理员的入会邀请
- 邀请有效期为 60 秒
/kg no¶
拒绝公会邀请。
权限: kaguilds.command.no
用法:
说明:
- 拒绝公会管理员的入会邀请
/kg kick <玩家名称>¶
踢出公会成员。
权限: kaguilds.command.kick
用法:
说明:
- 需要管理员或会长权限
- 被踢出的玩家会收到通知
/kg promote <玩家名称>¶
提升成员为管理员。
权限: kaguilds.command.promote
用法:
说明:
- 需要会长权限
- 目标玩家必须是成员
- 只能提升为管理员
/kg demote <玩家名称>¶
降级管理员为成员。
权限: kaguilds.command.demote
用法:
说明:
- 需要会长权限
- 目标玩家必须是管理员
- 降级后变为成员
/kg transfer <玩家名称>¶
转让公会所有权。
权限: kaguilds.command.transfer
用法:
说明:
- 需要会长权限
- 目标玩家必须是公会成员
- 需要确认操作（
/kg confirm） - 转让后原会长变为成员
注意: 此操作不可逆！
/kg leave¶
退出公会。
权限: kaguilds.command.leave
用法:
说明:
- 需要确认操作（
/kg confirm）
💰 经济系统命令¶
/kg bank [add/take/log] [金额]¶
管理公会金库。
权限: kaguilds.command.bank
用法:
说明:
add- 存入金币到公会金库take- 从公会金库取出金币log- 查看金库交易日志（仅管理员）- 存取款会根据贡献度系统增加或减少贡献度
贡献度计算（config.yml）:
- 存款贡献度 = 存款金额 ×
bank-deposit-ratio - 取款贡献度 = 取款金额 ×
bank-withdraw-ratio
/kg upgrade¶
升级公会等级。
权限: kaguilds.command.upgrade
用法:
说明:
- 需要管理员或会长权限
- 需要足够的公会经验
- 升级后解锁新功能和提高属性上限
升级效果（请前往 levels.yml 配置）:
🎮 传送系统命令¶
/kg settp¶
设置公会传送点。
权限: kaguilds.command.settp
用法:
说明:
- 需要会长或管理员权限
- 将当前位置设置为公会传送点
- 需要支付费用（在
config.yml中配置）
/kg tp¶
传送到公会传送点。
权限: kaguilds.command.tp
用法:
说明:
- 需要支付费用（在
config.yml中配置） - 开始传送期间禁止移动
- 某些世界可能禁止传送（在
config.yml中配置）
🎁 Buff 系统命令¶
/kg buff <Buff名称>¶
购买公会增益效果。
权限: kaguilds.command.buff
用法:
说明:
- 需要公会金库余额充足
- Buff 购买后会分发给所有公会在线成员
📦 仓库系统命令¶
/kg vault <仓库编号>¶
访问公会云仓库。
权限: kaguilds.command.vault
用法:
说明:
- 仓库需要在
levels.yml中解锁 - 支持跨服同步
- 当有玩家在操作仓库时，其他玩家暂时无法使用
💬 聊天系统命令¶
/kg chat [消息]¶
发送公会聊天消息。
权限: kaguilds.command.chat
用法:
说明:
- /kg chat ：切换聊天模式（再次输入退出）
- /kg chat 内容 ：发送单条消息
- 进入公会聊天模式后，所有消息都会发送到公会频道
⚔️ PvP 系统命令¶
/kg pvp <start/accept/ready/exit>¶
公会战相关命令。
权限: kaguilds.command.pvp
用法:
说明:
- 需要管理员或会长权限
- 公会战有参与者人数限制（在
config.yml中配置） - 有冷却时间限制
- 战斗奖励均可配置（在
config.yml中配置）
🖼️ 菜单系统命令¶
/kg menu¶
打开公会主菜单。
权限: kaguilds.command.menu
用法:
说明:
- 打开图形化的公会管理界面
- 提供便捷的公会操作
- 支持自定义菜单布局（在
gui/目录下配置）
🔧 系统命令¶
/kg reload¶
重载插件配置。
权限: kaguilds.admin.reload
用法:
说明:
- 重新加载所有配置文件
- 包括
config.yml,levels.yml,buffs.yml,task.yml等 - 无需重启服务器
- 支持控制台执行
/kg confirm¶
确认危险操作。
权限: kaguilds.command.confirm
用法:
说明:
- 用于确认危险操作（如解散公会、转让等）
- 操作有效期为 30 秒