# 管理员指令

KaGuilds 提供了完整的管理员命令系统，用于管理和控制公会的各项功能。

***

## 🔐 管理员命令概览

### 主命令

```bash
/kg admin <动作> [参数...]
```

**权限**: `kaguilds.admin`

**所有管理员操作均无需公会权限，可直接管理任意公会。**

***

## 📋 管理员命令速查表

| 命令                    | 功能     | 权限                         |
| --------------------- | ------ | -------------------------- |
| `/kg admin rename`    | 重命名公会  | `kaguilds.admin.rename`    |
| `/kg admin delete`    | 解散公会   | `kaguilds.admin.delete`    |
| `/kg admin info`      | 查看公会信息 | `kaguilds.admin.info`      |
| `/kg admin bank`      | 管理公会金库 | `kaguilds.admin.bank`      |
| `/kg admin transfer`  | 转让公会   | `kaguilds.admin.transfer`  |
| `/kg admin kick`      | 踢出成员   | `kaguilds.admin.kick`      |
| `/kg admin join`      | 加入玩家   | `kaguilds.admin.join`      |
| `/kg admin vault`     | 访问仓库   | `kaguilds.admin.vault`     |
| `/kg admin unlockall` | 解锁所有仓库 | `kaguilds.admin.unlockall` |
| `/kg admin setlevel`  | 设置公会等级 | `kaguilds.admin.setlevel`  |
| `/kg admin exp`       | 管理公会经验 | `kaguilds.admin.exp`       |
| `/kg admin arena`     | 竞技场管理  | `kaguilds.admin.arena`     |
| `/kg admin open`      | 打开指定菜单 | `kaguilds.admin.open`      |
| `/kg admin release`   | 释放菜单文件 | `kaguilds.admin.release`   |

***

## 📦 公会管理

### `/kg admin rename <公会ID> <新名称>`

重命名指定公会。

**权限**: `kaguilds.admin.rename`

**用法**:

```bash
/kg admin rename 1 新公会名称
```

**说明**:

* 无需公会权限
* 直接修改公会名称
* 新名称必须符合命名规则

***

### `/kg admin delete <公会ID>`

解散指定公会。

**权限**: `kaguilds.admin.delete`

**用法**:

```bash
/kg admin delete 1
/kg confirm    # 确认解散
```

**说明**:

* 无需公会权限
* 需要确认操作（`/kg confirm`）
* 解散后所有成员离开公会
* 公会数据会被删除

**注意**: 此操作不可逆！

***

### `/kg admin info <公会ID>`

查看指定公会信息。

**权限**: `kaguilds.admin.info`

**用法**:

```bash
/kg admin info 1
```

**说明**:

* 显示公会的完整详细信息
* 包括：名称、等级、成员列表、资金、公告等

***

### `/kg admin transfer <公会ID> <新会长>`

转让指定公会。

**权限**: `kaguilds.admin.transfer`

**用法**:

```bash
/kg admin transfer 1 新会长名称
/kg confirm    # 确认转让
```

**说明**:

* 无需公会权限
* 目标玩家可以是任意在线玩家
* 需要确认操作（`/kg confirm`）
* 转让后原会长变为成员

**注意**: 此操作不可逆！

***

## 👥 成员管理

### `/kg admin kick <公会ID> <玩家名称>`

从指定公会踢出成员。

**权限**: `kaguilds.admin.kick`

**用法**:

```bash
/kg admin kick 1 玩家名称
```

**说明**:

* 无需公会权限
* 被踢出的玩家会收到通知
* 可以踢出任意成员（包括会长）

***

### `/kg admin join <公会ID> <玩家名称>`

将玩家加入指定公会。

**权限**: `kaguilds.admin.join`

**用法**:

```bash
/kg admin join 1 玩家名称
```

**说明**:

* 无需公会权限
* 直接将玩家加入公会（无需申请/批准）
* 玩家必须在线

***

## 💰 经济管理

### `/kg admin bank <公会ID> <操作> [金额]`

管理指定公会金库。

**权限**: `kaguilds.admin.bank`

**用法**:

```bash
/kg admin bank 1 add 1000    # 添加 1000 金币
/kg admin bank 1 remove 500    # 移除 500 金币
/kg admin bank 1 set 500    # 设置为 500 金币
/kg admin bank 1 see    # 查看当前余额
/kg admin bank 1 log    # 查看银行日志
```

**说明**:

* 无需公会权限
* `add` - 向金库添加金币
* `remove` - 从金库移除金币
* `set` - 直接设置金库余额
* `see` - 查看当前金库余额
* `log` - 查看金库交易历史记录

***

### `/kg admin setlevel <公会ID> <等级>`

设置公会等级。

**权限**: `kaguilds.admin.setlevel`

**用法**:

```bash
/kg admin setlevel 1 5
```

**说明**:

* 无需公会权限
* 直接设置公会等级
* 等级解锁的功能会在设置后立即生效

***

### `/kg admin exp <公会ID> <操作> <数值>`

管理公会经验。

**权限**: `kaguilds.admin.exp`

**用法**:

```bash
/kg admin exp 1 add 100     # 增加 100 经验
/kg admin exp 1 set 500     # 设置为 500 经验
/kg admin exp 1 remove 50   # 减少 50 经验
```

**说明**:

* 无需公会权限
* `add` - 增加公会经验
* `set` - 直接设置公会经验值
* `remove` - 减少公会经验

***

## 📦 仓库管理

### `/kg admin vault <公会ID> <仓库编号>`

访问指定公会仓库。

**权限**: `kaguilds.admin.vault`

**用法**:

```bash
/kg admin vault 1 1
```

**说明**:

* 无需公会权限
* 可以访问任意公会的任意仓库
* 仓库编号必须在公会已解锁范围内

***

### `/kg admin unlockall`

解锁公会的所有仓库访问锁，仅用于测试或异常情况。

**权限**: `kaguilds.admin.unlockall`

**用法**:

```bash
/kg admin unlockall
```

**说明**:

* 无需公会权限
* 解锁所有公会的仓库占用锁
* 仅用于异常情况（如玩家掉线导致仓库被锁定）
* 正常使用时请勿随意执行此命令

***

## ⚔️ 竞技场管理

### `/kg admin arena <setpos/setspawn/setkit/info>`

竞技场管理。

**权限**: `kaguilds.admin.arena`

**用法**:

```bash
/kg admin arena setpos 1    # 设置竞技场第一个位置
/kg admin arena setpos 2    # 设置竞技场第二个位置
/kg admin arena setspawn red  # 设置红队出生点
/kg admin arena setspawn blue  # 设置蓝队出生点
/kg admin arena setkit red     # 设置红队预设装备包
/kg admin arena setkit blue    # 设置蓝队预设装备包
/kg admin arena info       # 查看竞技场信息
```

**说明**:

* 无需公会权限
* `setpos` - 设置竞技场范围（需要设置两个位置）
* `setspawn` - 设置队伍出生点（red/blue）
* `setkit` - 设置队伍预设装备包（red/blue）
* `info` - 显示当前竞技场配置信息

**竞技场设置步骤**:

1. 使用 `/kg admin arena setpos 1` 在竞技场第一个位置执行
2. 使用 `/kg admin arena setpos 2` 在竞技场第二个位置执行
3. 使用 `/kg admin arena setspawn red` 在红队出生点执行
4. 使用 `/kg admin arena setspawn blue` 在蓝队出生点执行
5. 使用 `/kg admin arena info` 查看配置

***

## 🖼️ 菜单管理

### `/kg admin open <菜单名称>`

打开指定菜单。

**权限**: `kaguilds.admin.open`

**用法**:

```bash
/kg admin open main_menu
/kg admin open guild_list
/kg admin open member_list
```

**说明**:

* 无需公会权限
* 可以打开任意菜单文件
* 菜单文件位于 `gui/` 目录下（不包括 `.yml` 后缀）
* 用于测试和调试菜单配置

***

### `/kg admin release <语言>`

释放插件内的指定语言菜单文件。

**权限**: `kaguilds.admin.release`

**用法**:

```bash
/kg admin release EN
/kg admin release CN
```

**说明**:

* 需要管理员权限
* 释放时会替换当前已有文件名的文件
* `EN` - 释放英文版菜单文件
* `CN` - 释放中文版菜单文件
* 用于恢复默认菜单配置

**使用场景**:

* 菜单文件损坏需要恢复
* 想要查看最新的默认菜单配置
* 需要基于默认配置进行自定义

**注意**: 执行此命令会覆盖现有同名文件，请提前备份！

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://katacr.gitbook.io/plugins/perm/admin-commands.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.