⌨️ Admin Command List¶
KaGuilds provides a complete admin command system for managing and controlling all guild functions.
🔐 Admin Command Overview¶
Main Command¶
Permission: kaguilds.admin
All admin operations do not require guild permissions and can directly manage any guild.
📋 Admin Command Quick Reference¶
| Command | Function | Permission |
|---|---|---|
/kg admin rename |
Rename guild | kaguilds.admin.rename |
/kg admin delete |
Delete guild | kaguilds.admin.delete |
/kg admin info |
View guild info | kaguilds.admin.info |
/kg admin bank |
Manage guild bank | kaguilds.admin.bank |
/kg admin transfer |
Transfer guild | kaguilds.admin.transfer |
/kg admin kick |
Kick member | kaguilds.admin.kick |
/kg admin join |
Add player | kaguilds.admin.join |
/kg admin vault |
Access vault | kaguilds.admin.vault |
/kg admin unlockall |
Unlock all vaults | kaguilds.admin.unlockall |
/kg admin setlevel |
Set guild level | kaguilds.admin.setlevel |
/kg admin exp |
Manage guild experience | kaguilds.admin.exp |
/kg admin arena |
Arena management | kaguilds.admin.arena |
/kg admin open |
Open specified menu | kaguilds.admin.open |
/kg admin release |
Release menu files | kaguilds.admin.release |
📦 Guild Management¶
/kg admin rename <guild_id> <new_name>¶
Rename a specified guild.
Permission: kaguilds.admin.rename
Usage:
Description:
- Does not require guild permission
- Directly modifies guild name
- New name must follow naming rules
/kg admin delete <guild_id>¶
Delete a specified guild.
Permission: kaguilds.admin.delete
Usage:
Description:
- Does not require guild permission
- Requires action confirmation (
/kg confirm) - All members leave the guild after deletion
- Guild data will be deleted
Note: This action is irreversible!
/kg admin info <guild_id>¶
View information of a specified guild.
Permission: kaguilds.admin.info
Usage:
Description:
- Displays complete detailed guild information
- Includes: name, level, member list, funds, announcement, etc.
/kg admin transfer <guild_id> <new_owner>¶
Transfer a specified guild.
Permission: kaguilds.admin.transfer
Usage:
Description:
- Does not require guild permission
- Target player can be any online player
- Requires action confirmation (
/kg confirm) - Original owner becomes a member after transfer
Note: This action is irreversible!
👥 Member Management¶
/kg admin kick <guild_id> <player_name>¶
Kick a member from a specified guild.
Permission: kaguilds.admin.kick
Usage:
Description:
- Does not require guild permission
- Kicked player will receive a notification
- Can kick any member (including owner)
/kg admin join <guild_id> <player_name>¶
Add a player to a specified guild.
Permission: kaguilds.admin.join
Usage:
Description:
- Does not require guild permission
- Directly adds player to guild (no request/approval needed)
- Player must be online
💰 Economy Management¶
/kg admin bank <guild_id> <action> [amount]¶
Manage a specified guild's bank.
Permission: kaguilds.admin.bank
Usage:
/kg admin bank 1 add 1000 # Add 1000 gold
/kg admin bank 1 remove 500 # Remove 500 gold
/kg admin bank 1 set 500 # Set to 500 gold
/kg admin bank 1 see # View current balance
/kg admin bank 1 log # View bank log
Description:
- Does not require guild permission
add- Add gold to vaultremove- Remove gold from vaultset- Directly set vault balancesee- View current vault balancelog- View vault transaction history
/kg admin setlevel <guild_id> <level>¶
Set guild level.
Permission: kaguilds.admin.setlevel
Usage:
Description:
- Does not require guild permission
- Directly sets guild level
- Unlocked features take effect immediately after setting
/kg admin exp <guild_id> <action> <value>¶
Manage guild experience.
Permission: kaguilds.admin.exp
Usage:
/kg admin exp 1 add 100 # Add 100 experience
/kg admin exp 1 set 500 # Set to 500 experience
/kg admin exp 1 remove 50 # Remove 50 experience
Description:
- Does not require guild permission
add- Add guild experienceset- Directly set guild experienceremove- Remove guild experience
📦 Vault Management¶
/kg admin vault <guild_id> <vault_number>¶
Access a specified guild's vault.
Permission: kaguilds.admin.vault
Usage:
Description:
- Does not require guild permission
- Can access any vault of any guild
- Vault number must be within the guild's unlocked range
/kg admin unlockall¶
Unlock all vault access locks in the guild, for testing or exceptional situations only.
Permission: kaguilds.admin.unlockall
Usage:
Description:
- Does not require guild permission
- Unlocks vault occupation locks for all guilds
- For exceptional situations only (e.g., player disconnection causes vault lock)
- Do not execute this command casually during normal use
⚔️ Arena Management¶
/kg admin arena <setpos/setspawn/setkit/info>¶
Arena management.
Permission: kaguilds.admin.arena
Usage:
/kg admin arena setpos 1 # Set arena position 1
/kg admin arena setpos 2 # Set arena position 2
/kg admin arena setspawn red # Set red team spawn point
/kg admin arena setspawn blue # Set blue team spawn point
/kg admin arena setkit red # Set red team preset equipment
/kg admin arena setkit blue # Set blue team preset equipment
/kg admin arena info # View arena information
Description:
- Does not require guild permission
setpos- Set arena boundaries (two positions required)setspawn- Set team spawn points (red/blue)setkit- Set team preset equipment (red/blue)info- Display current arena configuration
Arena Setup Steps:
- Execute
/kg admin arena setpos 1at arena position 1 - Execute
/kg admin arena setpos 2at arena position 2 - Execute
/kg admin arena setspawn redat red team spawn point - Execute
/kg admin arena setspawn blueat blue team spawn point - Execute
/kg admin arena infoto view configuration
🖼️ Menu Management¶
/kg admin open <menu_name>¶
Open a specified menu.
Permission: kaguilds.admin.open
Usage:
Description:
- Does not require guild permission
- Can open any menu file
- Menu files are in the
gui/directory (without.ymlextension) - Used for testing and debugging menu configurations
/kg admin release <language>¶
Release plugin's specified language menu file.
Permission: kaguilds.admin.release
Usage:
Description:
- Requires admin permission
- Existing files with the same name will be replaced during release
EN- Release English menu filesCN- Release Chinese menu files- Used to restore default menu configuration
Use Cases:
- Menu file is corrupted and needs recovery
- Want to view the latest default menu configuration
- Need to base custom configuration on default settings
Note: Executing this command will overwrite existing files with the same name — please back up in advance!