Configuration
- Latest version
- 9.0.16
- Minecraft
- 1.21.4 - 26.3
- Platforms
- Spigot, Paper, Folia, Purpur
- Minimum Java version
- 21+
Configuration
Files
Settings and data are stored in
Main settings
Language and configuration example
The Wiki is available in eight languages. Plugin messages in this release support
This is a partial example, not a replacement
For manual configuration edits, use a complete server restart to load the new values. Changes made through the plugin's supported menus/commands are saved by the plugin.
Enabling commands and resolving conflicts
Use
FastFlags and built-in regions
In
An action must be allowed globally and by every matching region. A local allow cannot override a global block, and a block in an overlapping region still applies.
Flag arguments
Creating a protected region
To create a protected area, run
In
Join/leave, spawns and kits
Open Join/Leave Manager through
Create and edit kits with
Files
Settings and data are stored in
plugins/GUIAdminToolsPremium/. File names are case-sensitive on systems that distinguish upper and lower case. Back up the entire folder before manual edits. Stop the server before changing persistent player, kit, region or world data.Code · Plain text
Config.yml — Main settings, global flags, chat, economy and join/leave effects.
Commands.yml — Generated on startup: enabled commands, descriptions and aliases.
Messages_<language>.yml — Plugin messages for the selected language.
Icons/MainMenuGUI.yml — Main menu item materials, names and lore.
Icons/PlayerSettingsGUI.yml — Player settings menu icons.
Icons/ServerManagerGUI.yml — Server Manager menu icons.
Regions.yml — Built-in cuboid regions, their flags and transition notifications.
Worlds.yml — World Manager settings and saved world definitions.
PlayerData/<uuid>.yml — Saved player data, including home, personal spawn and plugin states.
Kits/<kit name>.yml — Kit contents, icons and settings.
ChatLogs.yml — Saved chat history.
Main settings
Code · Plain text
CfgVersion — Internal configuration version; leave it unchanged.
Language_messages — Global plugin language: en, pl, de, es, fr, nl, cn. Unsupported codes fall back to English.
UPDATE_INFO_ON_JOIN — Notify authorised administrators about an available update when they join; default true.
EconomyProvider — false: use an existing Vault economy; true: register the built-in economy provider.
Economy.Currency — Singular/Plural: currency labels; Format: number display pattern.
Economy.AllowNegative — Allow negative player balances; default false.
Economy.Banks — Enabled, StartBalance, MaxBanksPerPlayer and AllowNegative configure built-in banks.
CHAT.MUTE — Global chat mute; default false.
CHAT.SLOW_MODE — STATUS enables slow mode; DELAY is the interval in seconds (default 5).
CHAT.FILTER — STATUS enables filtering; WORDS is one comma-separated string, not a YAML list.
CHAT.ANTI_CAPS — STATUS, MIN_LETTERS (5) and MAX_PERCENTAGE (70.0) control uppercase conversion; missing options can be added manually or by toggling Anti Caps.
CHAT.LOGS.CLEAR — Chat log retention in hours; default 48.
CHAT.COLOR_CODE / CHAT.COLOR_CODE_CHAR — Enable colour codes and choose their prefix (default &); players also need admintools.use.colorcode.
JoinLeaveManager — Join, first-join and leave messages; titles, sounds, particles and fireworks. Use %NICK% in message text.
BanManager — DefaultReason, AdminNick and KickPlayer configure bans; BanMessage/BanIPMessage format the kick screen.
Language and configuration example
The Wiki is available in eight languages. Plugin messages in this release support
en, pl, de, es, fr, nl and cn; pt and ru are not message-language options. Select a supported language with /servermanager language <code>.This is a partial example, not a replacement
Config.yml. Merge values into existing sections without creating a second CHAT section. The example enables moderation options that are disabled by default.Code · Plain text
UPDATE_INFO_ON_JOIN: true
Language_messages: en
EconomyProvider: false
CHAT:
MUTE: false
SLOW_MODE:
STATUS: true
DELAY: 5
FILTER:
STATUS: true
WORDS: 'word1, word2'
ANTI_CAPS:
STATUS: true
MIN_LETTERS: 5
MAX_PERCENTAGE: 70.0
LOGS:
CLEAR: 48
COLOR_CODE: true
COLOR_CODE_CHAR: '&'
For manual configuration edits, use a complete server restart to load the new values. Changes made through the plugin's supported menus/commands are saved by the plugin.
/servermanager reloadcommands only reloads command statuses.Enabling commands and resolving conflicts
Commands.yml is created automatically. Status enables a command, Description sets its description and Aliases is a YAML list without leading slashes. Do not rename command keys or change CfgVersion. The old Config.yml > CommandRegistration section is used for initial migration; maintain Commands.yml afterwards. The example below shows two entries only; retain the other commands in your file.Code · Plain text
CfgVersion: 2
Commands:
heal:
Status: true
Description: 'Heal yourself or an online player.'
Aliases:
- atheal
fly:
Status: false
Description: 'Toggle flight for yourself or an online player.'
Aliases:
- atfly
Use
/servermanager commandregistration for the command GUI. After editing statuses, use /servermanager reloadcommands. Alias and description changes require a full restart. Aliases must be unique within the plugin, must not conflict with its root names, and may contain lowercase letters, digits, _ and -. With Essentials or other plugins, select which plugin owns overlapping commands.FastFlags and built-in regions
In
Config.yml, flags use uppercase keys under FLAGS. true allows an action and false blocks it. Command arguments use the lowercase names below. /fastflags <flag> toggles a flag; /fastflags all on allows all flag-controlled actions and /fastflags all off blocks them.Code · Plain text
FLAGS:
PLACE_BLOCK: true
BREAK_BLOCK: true
PVP: false
EXPLOSION_BLOCK_DAMAGE: false
An action must be allowed globally and by every matching region. A local allow cannot override a global block, and a block in an overlapping region still applies.
weather_change is global only. Blocking command_use also blocks administrators' in-game commands; blocking teleport, entry or exit affects movement tools.Flag arguments
Code · Plain text
place_block — Placing blocks.
break_block — Breaking blocks.
pvp — Player-versus-player damage.
command_use — Player command execution, including administrators.
mob_spawn — Natural mob spawning.
drop_item — Dropping items.
pickup_item — Picking up items.
use_item — Right-click item actions.
interact — Block interactions.
explosion_damage — Explosion damage to entities.
fire_spread — Fire spreading and ignition.
fall_damage — Fall damage.
entity_damage — Damage caused by entities.
explosion_block_damage — Block destruction by explosions.
fluid_flow — Water and lava flow.
leaf_decay — Natural leaf decay.
entity_grief — Mobs changing blocks.
hunger — Hunger level changes.
item_durability — Loss of item durability.
weather_change — Rain and thunder starting; global flag only.
chat — Sending chat messages.
container_access — Opening containers.
bucket_use — Filling and emptying buckets.
fire_damage — Damage from fire, lava and hot surfaces.
drowning_damage — Drowning damage.
block_burn — Blocks being destroyed by fire.
block_grow — Natural growth and fertilising.
block_spread — Non-fire block spreading.
piston — Pistons moving blocks.
item_consume — Eating and drinking.
entity_interact — Right-click interactions with entities.
bed_use — Using beds.
teleport — Teleportation at both origin and destination.
entry — Crossing into regions.
exit — Crossing out of regions.
Creating a protected region
To create a protected area, run
/region new, note its ID and stand at each corner before setting pos1 and pos2. Both corners must be in the same world. Regions include the full X/Y/Z range between the corners, so set the required vertical range too. Replace 1 with the new region's actual ID:Code · Plain text
/region new
/region edit 1 pos1
/region edit 1 pos2
/region flag 1 pvp off
/region flag 1 break_block off
/region flag 1 place_block off
In
Regions.yml, Notifications.Enabled enables transition messages. Edit Notifications.Enter and Notifications.Exit; %REGION% is the region name and %ID% its ID.Join/leave, spawns and kits
Open Join/Leave Manager through
/at serverpluginmenu. Configure messages, titles and effects there; use the GUI to save join locations. Effects require the matching admintools.use.* permissions listed under Permissions. First-join location takes priority over the normal join location for an eligible new player./setspawn saves a personal spawn. /spawn uses it, or the current world's spawn if no personal spawn exists. If a saved spawn's world is unavailable, the teleport fails instead of silently selecting another destination. Respawning prioritises a usable personal spawn; otherwise bed/anchor rules and the plugin's world respawn handling apply.Create and edit kits with
/kitmanager. Kit settings include a cooldown in seconds, an optional permission check and inventory clearing. Check the inventory-clearing setting before giving kits to players.