Toda a documentação
WIKI DO PLUGIN

GUI Admin Tools FREE — Configuração

Gere jogadores, mundos e definições do servidor através de menus claros dentro do jogo.

Ver plugin

Configuração

Informações da versão atual
Versão mais recente
3.6.0
Minecraft
1.21.4 - 26.3
Plataformas
Spigot, Paper, Folia, Purpur
Versão mínima do Java
21+
Notas de versão

Este artigo foi escrito para 3.5.5. A versão estável mais recente é 3.6.0; consulta os requisitos atuais acima.

Versão 3.5.5Última atualização: 18/10/2026 15:37
Configuração

Ficheiros e dados guardados
Alguns sistemas distinguem maiúsculas em nomes de ficheiros. Config.yml contém flags, registo de comandos, códigos de cor, moderação e definições geradas de PlayerData. Messages.yml contém mensagens configuráveis. Worlds.yml guarda definições de mundos e coordenadas de spawn. myEQ.yml guarda inventários pessoais por nome. PlayerData/<uuid>.yml contém registos antigos ou espelhados de jogadores registados. A base SQLite predefinida é playerdata.db.

Configuração
Deixa CfgVersion ao plugin. FLAGS contém valores globais de permitir/bloquear; FLAGS.WORLDS.<world>.<FLAG> pode substituí-los. INTERACT e EXPLOSIONS são true por predefinição embora o ficheiro liste as sete flags antigas. colorCode ativa cores no chat e continua a exigir a permissão do jogador. CommandRegistration.<command> controla o registo no arranque. Reinicia após alterações manuais.

BanManager.DefaultReason define o motivo inicial; AdminNick regista o administrador e KickPlayer controla a desconexão imediata. BanMessage é uma lista de linhas com cores & e os marcadores do ficheiro incluído. Ban e unban abrem interfaces em vez de aceitar motivo ou duração pelo chat.

Armazenamento de PlayerData
PlayerDataStorage é adicionado no arranque. Guarda UUID/nome, silêncio e bloqueio de movimento de jogadores registados, não inventários, baús do Ender ou XP. Escolhe SQLITE, MYSQL ou YAML. Os modos de base de dados exigem o controlador JDBC correspondente disponível para o plugin; falhas de inicialização usam YAML se a alternativa estiver ativada. Não é sincronização em tempo real entre servidores.

Abaixo estão as predefinições de execução. fallback-to-yaml permite usar YAML em falhas de inicialização. O ficheiro SQLite deve permanecer dentro da pasta do plugin. MySQL usa host, porta, base, utilizador, palavra-passe e tabela, com SSL e obtenção de chave pública opcionais; os tempos de ligação/socket são milissegundos. legacy-yaml controla importação no arranque, retenção de ficheiros e espelhamento de escritas da base nos YAML mantidos. A espera ao encerrar limita-se a 1–120 segundos. Copia base e YAML antes de mudar de modo.

Código · Texto simples

PlayerDataStorage:
  type: SQLITE
  fallback-to-yaml: true
  sqlite:
    file: playerdata.db
  mysql:
    host: 127.0.0.1
    port: 3306
    database: minecraft
    username: root
    password: ''
    table: guiadmin_tools_player_data
    use-ssl: false
    allow-public-key-retrieval: false
    connection-timeout-ms: 5000
    socket-timeout-ms: 10000
  legacy-yaml:
    import-on-startup: true
    keep-files: true
    mirror-writes: true
  shutdown-timeout-seconds: 10


Mensagens
MESSAGE_OPTION ativa mensagens configuráveis; PREFIX_OPTION controla o PREFIX comum. Edita textos em MESSAGES preservando marcadores. Suporta cores &; não traduz todas as etiquetas GUI fixas no código. Esta versão não tem comando de seleção de idioma. Reinicia após edição manual.

Exemplos de configuração
Integra estes exemplos nas secções correspondentes de Config.yml; não dupliques FLAGS ou PlayerDataStorage. A substituição por mundo só afeta o mundo indicado. Reinicia após editar manualmente; alterações de flags pela GUI/comandos são guardadas imediatamente.

Código · Texto simples

FLAGS:
  PVP: true
  INTERACT: true
  EXPLOSIONS: true
  WORLDS:
    lobby:
      PVP: false
      BREAK_BLOCK: false
      PLACE_BLOCK: false


Código · Texto simples

PlayerDataStorage:
  type: MYSQL
  fallback-to-yaml: true
  mysql:
    host: "127.0.0.1"
    port: 3306
    database: "minecraft"
    username: "guiadmintools"
    password: "REPLACE_WITH_YOUR_PASSWORD"
    table: "guiadmin_tools_player_data"
    use-ssl: false
    allow-public-key-retrieval: false
    connection-timeout-ms: 5000
    socket-timeout-ms: 10000


Ficheiros completos incluídos
Estes são os quatro ficheiros exatos incluídos na 3.5.5. O arranque também adiciona as definições PlayerDataStorage anteriores; mantém os valores gerados. Os ficheiros de dados vazios são intencionais. Não substituas Worlds.yml ou myEQ.yml existentes para aplicar um exemplo.

Config.yml

Código · Texto simples

#Config version
#DO NOT CHANGE IT MANUALLY!
CfgVersion: 1.6

#Flags are working on whole server without WorldEdit and WorldGuard
#TRUE - allow
#FALSE - block
#Tip: change values to control global behavior (e.g., PVP or chat blocking)
FLAGS:
  PLACE_BLOCK: true
  BREAK_BLOCK: true
  CHAT: true
  PVP: true
  MOB_SPAWN: true
  DROP_ITEM: true
  PICKUP_ITEM: true

#TRUE - set '&' as color code for chat messages
#Permission - 'admintools.tools.colorcode' or 'admintools.tools.colorcode.tool'
colorCode: true

#FALSE - unregister
#Tip: set to false to hide/unregister a command entirely
CommandRegistration:
  admintools: true
  ban: true
  cleararrows: true
  clearchat: true
  clearinv: true
  effects: true
  enderchest: true
  exp: true
  fastflags: true
  fly: true
  gamemode: true
  god: true
  gamerules: true
  heal: true
  kickall: true
  kick: true
  kill: true
  mobspawn: true
  mute: true
  myeq: true
  player: true
  repair: true
  servermanager: true
  showinv: true
  speed: true
  timeweather: true
  top: true
  tp: true
  tptome: true
  tppos: true
  tpw: true
  unban: true
  workbench: true
  worldmanager: true

#Ban manager config
BanManager:
  #Set default ban reason
  DefaultReason: 'No reason!'
  #Save admin nick
  AdminNick: true
  #Kick player immediately
  KickPlayer: true
  #Ban message
  #Color code - &
  #%REASON% - reason variable
  #%EXPIRES% - expires variable
  BanMessage:
    - "&cYou are banned!"
    - "&cUsername: &f%PLAYER%"
    - "&cReason: &f%REASON%"
    - "&cCreated: &f%CREATED%"
    - "&cExpires: &f%EXPIRES%"
    - "&cBanned by: &f%BANNER%"




Messages.yml

Código · Texto simples

# Messages configuration version
# DO NOT CHANGE IT MANUALLY!
CfgVersion: 3.2

# Enables messages sent after commands and GUI tool actions.
MESSAGE_OPTION: true

# Adds one consistent prefix to every configurable message.
PREFIX_OPTION: true
PREFIX: '&8[&cGUIAT&8] &r'

# Color code: &
# Do not change variables inside % %.
MESSAGES:
  # Technical messages
  NO_PERMISSION: '&cYou do not have permission to perform this action.'
  PLAYER_ONLY: '&cOnly a player can use this command.'
  CORRECT_USAGE: '&eUsage: &a&l%SYNTAX%&r&e.'
  WRONG_VALUE: '&cInvalid value. Check the command arguments and try again.'
  WRONG_PLAYER: '&cPlayer &d&l%PLAYER%&r &cwas not found or is offline.'
  ACTION_FAILED: '&cThe action could not be completed. Check the server console for details.'
  UNSUPPORTED_FEATURE: '&cThis feature is not supported by the current server software.'
  INTEGRATION_UNAVAILABLE: '&cThe &e%INTEGRATION% &cintegration is unavailable.'
  TELEPORT_FAILED: '&cTeleportation failed. The destination may be unavailable or unsafe.'

  # Basic tools and commands
  ADD_EXP: '&eAdded &a&l%EXP%&r &eexperience points.'
  SET_EXP: '&6Your total experience is now &a&l%EXP%&r&6.'
  SHOW_EXP: '&6Your total experience is &a&l%EXP%&r&6.'
  INVALID_EXP_VALUE: '&cInvalid experience value: &e%EXP%&c.'
  CLEARARROWS: '&6All arrows were removed from your body.'
  CLEAR_MY_INV: '&6Your inventory was &ccleared&6.'
  CLEAR_INV_ALL: '&6Inventories of all online players were cleared.'
  FLY: '&6Flight mode: &a&l%SET%&r&6.'
  FLY_SPEED: '&6Flight speed: &a&l%SPEED%&r&6.'
  GAMEMODE: '&6Your game mode was changed to &a&l%MODE%&r&6.'
  GOD: '&6God mode: &a&l%SET%&r&6.'
  HEAL_ME: '&6You were healed.'
  POTION_EFFECT: '&6Added potion effect: &a&l%EFFECT%&r&6.'
  POTION_EFFECT_REMOVED: '&6Removed potion effect: &a&l%EFFECT%&r&6.'
  POTION_EFFECTS_CLEAR: '&6All potion effects were cleared.'
  POTION_EFFECTS_CLEAR_PLAYER: '&6Cleared all potion effects from &d&l%PLAYER%&r&6.'
  REPAIR_ITEMS: '&6All supported items were repaired.'
  RESET_EXP: '&6Your experience was reset.'
  TOP: '&6You were teleported to the highest block.'
  TPPOS: '&6Teleported to &a&l%LOCATION%&r&6.'
  WALK_SPEED: '&6Walk speed: &a&l%SPEED%&r&6.'
  OPEN_ENDER_CHEST: '&6Opened your ender chest.'
  OPEN_ENDER_CHEST_PLAYER: '&6Opened the ender chest of &d&l%PLAYER%&r&6.'
  OPEN_WORKBENCH: '&6Opened the portable workbench.'
  OPEN_PLAYER_INVENTORY: '&6Opened the inventory of &d&l%PLAYER%&r&6.'

  # Player manager tools and commands
  ADD_EXP_PLAYER: '&6Added &a&l%EXP%&r &6experience points to &d&l%PLAYER%&r&6.'
  SET_EXP_PLAYER: '&6Set the experience of &d&l%PLAYER%&r &6to &a&l%EXP%&r&6.'
  SHOW_EXP_PLAYER: '&d&l%PLAYER%&r &6has &a&l%EXP%&r &6total experience.'
  CLEARARROWS_PLAYER: '&6Removed all arrows from &d&l%PLAYER%&r&6.'
  CLEAR_INV: '&6Cleared the inventory of &d&l%PLAYER%&r&6.'
  DEOP_PLAYER: '&6Removed operator status from &d&l%PLAYER%&r&6.'
  FLY_PLAYER: '&6Flight mode for &d&l%PLAYER%&r&6: &a&l%SET%&r&6.'
  GAMEMODE_PLAYER: '&6Changed the game mode of &d&l%PLAYER%&r &6to &a&l%MODE%&r&6.'
  GOD_PLAYER: '&6God mode for &d&l%PLAYER%&r&6: &a&l%SET%&r&6.'
  HEAL_PLAYER: '&6Healed &d&l%PLAYER%&r&6.'
  KICK: '&6Kicked &d&l%PLAYER%&r&6.'
  KICK_ALL: '&6Kicked all other online players.'
  KILL: '&6Killed &d&l%PLAYER%&r&6.'
  OP_PLAYER: '&6Granted operator status to &d&l%PLAYER%&r&6.'
  OP: '&6You are now a server operator.'
  DEOP: '&6You are no longer a server operator.'
  REPAIR_ITEMS_PLAYER: '&6Repaired supported items for &d&l%PLAYER%&r&6.'
  RESET_EXP_PLAYER: '&6Reset the experience of &d&l%PLAYER%&r&6.'
  TOP_PLAYER: '&6Teleported &d&l%PLAYER%&r &6to the highest block.'
  TP: '&6Teleported to &d&l%PLAYER%&r&6.'
  TP_TO_ME: '&6Teleported &d&l%PLAYER%&r &6to you.'
  BLOCK_MOVEMENT: '&6Blocked movement for &d&l%PLAYER%&r&6.'
  UNBLOCK_MOVEMENT: '&6Restored movement for &d&l%PLAYER%&r&6.'
  MOVEMENT_BLOCKED: '&cYour movement was blocked by an administrator.'
  MOVEMENT_UNBLOCKED: '&6Your movement was restored by an administrator.'
  MUTE_PLAYER: '&6Muted &d&l%PLAYER%&r&6.'
  UNMUTE_PLAYER: '&6Unmuted &d&l%PLAYER%&r&6.'
  MUTED: '&cYou were muted by an administrator.'
  UNMUTED: '&6You were unmuted by an administrator.'
  WHITELIST_PLAYER: '&6Whitelist status for &d&l%PLAYER%&r&6: &a&l%SET%&r&6.'
  BAN_PLAYER: '&6Banned &d&l%PLAYER%&r &6until &a&l%EXPIRES%&r&6.'
  UNBAN_PLAYER: '&6Removed the ban from &d&l%PLAYER%&r&6.'

  # World tools
  SET_TIME: '&6Time was set to &a&l%TIME%&r&6.'
  LOCK_TIME: '&6Time lock: &a&l%STATUS%&r&6.'
  LOCK_WEATHER: '&6Weather lock: &a&l%STATUS%&r&6.'
  SET_WEATHER: '&6Weather was set to &a&l%WEATHER%&r&6.'
  TP_WORLDS: '&6Teleported to world &a&l%NAME%&r&6.'
  TP_WORLDS_PLAYER: '&6Teleported &d&l%PLAYER%&r &6to world &a&l%NAME%&r&6.'
  CREATED_NEW_WORLD: '&6Created world &a&l%NAME%&r&6.'
  RENAMED_WORLD: '&6Renamed world &e%OLD_NAME% &6to &a&l%NAME%&r&6.'
  SET_WORLD_SPAWN: '&6Set the spawn of &a&l%NAME%&r &6to &a%LOCATION%&6.'
  REMOVE_WORLD: '&6Removed world &a&l%NAME%&r&6.'
  WRONG_WORLD: '&cYou must stand in world &e%NAME% &cto set its spawn.'
  INVALID_WORLD_NAME: '&cInvalid world name: &e%NAME%&c. Use letters, numbers, spaces, _ or -.'
  WORLD_ALREADY_EXISTS: '&cA world or world folder named &e%NAME% &calready exists.'
  WORLD_NOT_FOUND: '&cWorld &e%NAME% &cwas not found.'
  WORLD_NOT_MANAGED: '&cWorld &e%NAME% &cis not managed by this plugin.'
  WORLD_ONLY_LOADED: '&cThe only loaded world cannot be removed or renamed.'
  WORLD_OPERATION_BUSY: '&cAnother operation is already running for world &e%NAME%&c.'
  WORLD_OPERATION_UNSUPPORTED: '&cWorld %OPERATION% is unavailable on Folia. Stop the server and manage world folders manually.'
  WORLD_CREATE_FAILED: '&cWorld &e%NAME% &ccould not be created. Check the server console.'
  WORLD_LOAD_FAILED: '&cWorld &e%NAME% &ccould not be loaded. The previous folder name was restored.'
  WORLD_UNLOAD_FAILED: '&cWorld &e%NAME% &ccould not be unloaded.'
  WORLD_MOVE_PLAYERS_FAILED: '&cPlayers could not be moved safely out of world &e%NAME%&c.'
  WORLD_FILE_OPERATION_FAILED: '&cThe folder operation for world &e%NAME% &cfailed. Check the server console.'

  # Server tools
  CHAT_CLEARED: '&6Chat was cleared.'
  MOB_SPAWN: '&6Spawned &a&l%TYPE%&r&6.'
  MOBS_CLEARED: '&6Removed &a&l%AMOUNT%&r &6living non-player entities from this world.'
  COLOR_CODE: '&6Chat color codes: &a&l%SET%&r&6.'
  LANGUAGE: '&6Language: &a&l%LANG%&r&6.'
  WHITELIST: '&6Whitelist: &a&l%SET%&r&6.'
  COMMAND_REGISTRATION: '&6Command &a/%COMMAND% &6enabled: &a&l%SET%&r&6.'
  GAME_RULE_UPDATED: '&6Game rule &e%RULE% &6was set to &a&l%VALUE%&r&6.'
  RELOAD: '&6Server reload was requested.'
  STOP: '&6Server shutdown was requested.'
  RESTART: '&6Server restart was requested.'
  RESTART_FILE_NOT_FOUND: '&cCannot restart: the restart script is not configured or does not exist.'

  # Flags
  PLACE_BLOCK_FLAG: '&6Place block flag: &a&l%SET%&r&6.'
  BREAK_BLOCK_FLAG: '&6Break block flag: &a&l%SET%&r&6.'
  CHAT_FLAG: '&6Chat flag: &a&l%SET%&r&6.'
  PVP_FLAG: '&6PvP flag: &a&l%SET%&r&6.'
  MOB_SPAWN_FLAG: '&6Mob spawn flag: &a&l%SET%&r&6.'
  DROP_ITEM_FLAG: '&6Drop item flag: &a&l%SET%&r&6.'
  PICKUP_ITEM_FLAG: '&6Pickup item flag: &a&l%SET%&r&6.'
  INTERACT_FLAG: '&6Interact flag: &a&l%SET%&r&6.'
  EXPLOSIONS_FLAG: '&6Explosions flag: &a&l%SET%&r&6.'




Worlds.yml

Código · Texto simples





myEQ.yml

Código · Texto simples




Bem-vindo — idioma e privacidade

Os cookies necessários protegem o início de sessão e guardam as suas escolhas. As estatísticas opcionais e o YouTube ficam desativados até dar consentimento. Pode alterar esta escolha no rodapé. Privacidade