Configuração
- 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+
Este artigo foi escrito para 3.5.5. A versão estável mais recente é 3.6.0; consulta os requisitos atuais acima.
Configuração
Ficheiros e dados guardados
Alguns sistemas distinguem maiúsculas em nomes de ficheiros.
Configuração
Deixa
Armazenamento de PlayerData
Abaixo estão as predefinições de execução.
Mensagens
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.
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.
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
