Cała dokumentacja
WIKI PLUGINU

GUI Admin Tools FREE — Konfiguracja

Zarządzaj graczami, światami i ustawieniami serwera z poziomu czytelnych menu w grze.

Zobacz plugin

Konfiguracja

Informacje o bieżącym wydaniu
Najnowsza wersja
3.6.0
Minecraft
1.21.4 - 26.3
Platformy
Spigot, Paper, Folia, Purpur
Minimalna wersja Java
21+
Informacje o wydaniu

Artykuł napisano dla wersji 3.5.5. Najnowsze wydanie stabilne to 3.6.0; korzystaj z bieżących wymagań powyżej.

Wersja 3.5.5Ostatnia aktualizacja: 18.10.2026 15:37
Konfiguracja

Pliki i zapisane dane
W niektórych systemach wielkość liter w nazwach plików ma znaczenie. Config.yml zawiera flagi, rejestrację komend, kody kolorów, moderację i generowane ustawienia PlayerData. Messages.yml zawiera konfigurowalne wiadomości. Worlds.yml przechowuje definicje zarządzanych światów i współrzędne spawnu. myEQ.yml zapisuje osobiste ekwipunki według nazw graczy. PlayerData/<uuid>.yml zawiera starsze lub lustrzane rekordy zapisanych graczy. Domyślna baza SQLite to playerdata.db.

Konfiguracja
Pozostaw CfgVersion pluginowi. FLAGS zawiera globalne wartości pozwalaj/blokuj; FLAGS.WORLDS.<world>.<FLAG> opcjonalnie je nadpisuje. INTERACT i EXPLOSIONS domyślnie mają true, choć plik domyślny wymienia starsze siedem flag. colorCode włącza kolory czatu i nadal wymaga uprawnienia gracza do kolorów. CommandRegistration.<command> steruje rejestracją przy starcie. Po ręcznych zmianach konfiguracji wykonaj restart.

BanManager.DefaultReason ustawia początkowy powód bana; AdminNick zapisuje administratora, a KickPlayer kontroluje natychmiastowe rozłączenie. BanMessage jest listą linii z kolorami & i zmiennymi pokazanymi w pliku domyślnym. Komendy ban i unban otwierają interfejsy zamiast przyjmować powód lub czas na czacie.

Przechowywanie PlayerData
PlayerDataStorage jest dodawany przy starcie. Przechowuje UUID/nazwę znanego gracza, stan wyciszenia i blokady ruchu, a nie ekwipunki, skrzynie Endu ani XP. Wybierz SQLITE, MYSQL lub YAML. Tryby bazodanowe wymagają odpowiedniego sterownika JDBC dostępnego dla pluginu; błąd inicjalizacji uruchamia YAML, gdy tryb awaryjny jest włączony. Nie jest to bieżąca synchronizacja danych graczy między serwerami.

Poniżej są domyślne ustawienia generowane przy uruchomieniu. fallback-to-yaml pozwala przejść na YAML przy błędzie inicjalizacji. Plik SQLite musi pozostać w folderze pluginu. MySQL używa hosta, portu, bazy, użytkownika, hasła i tabeli, z opcjonalnym SSL i pobieraniem klucza publicznego; limity czasu połączenia i gniazda są w milisekundach. legacy-yaml steruje importem przy starcie, zachowaniem starych plików i kopiowaniem zapisów bazy do zachowanych YAML. Oczekiwanie przy zamykaniu jest ograniczone do 1–120 sekund. Przed zmianą trybu wykonaj kopie bazy i YAML.

Kod · Zwykły tekst

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


Wiadomości
MESSAGE_OPTION włącza konfigurowalne wiadomości działań; PREFIX_OPTION kontroluje wspólny PREFIX. Edytuj teksty pod MESSAGES, zachowując zmienne. Plik obsługuje kolory &; nie tłumaczy wszystkich etykiet GUI zapisanych w kodzie. Ta wersja nie ma komendy wyboru języka. Po ręcznej edycji wykonaj restart.

Przykłady konfiguracji
Połącz przykłady z odpowiednimi sekcjami Config.yml; nie twórz powtórnych sekcji FLAGS ani PlayerDataStorage. Nadpisanie świata dotyczy tylko wskazanego świata. Po ręcznej edycji wykonaj restart; zmiany flag przez GUI/komendy są zapisywane od razu.

Kod · Zwykły tekst

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


Kod · Zwykły tekst

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


Kompletne pliki domyślne
To dokładnie cztery pliki dostarczone z 3.5.5. Start dodaje też pokazane wyżej ustawienia PlayerDataStorage; zachowaj wygenerowane wartości. Puste pliki danych w paczce są celowe. Nie zastępuj istniejących Worlds.yml ani myEQ.yml, aby zastosować przykład konfiguracji.

Config.yml

Kod · Zwykły tekst

#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

Kod · Zwykły tekst

# 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

Kod · Zwykły tekst





myEQ.yml

Kod · Zwykły tekst




Witaj — wybierz język i ustawienia prywatności

Niezbędne cookies zabezpieczają logowanie i zapamiętują Twoje wybory. Opcjonalne statystyki i filmy YouTube pozostają wyłączone do czasu Twojej zgody. Ustawienia możesz zmienić w stopce. Prywatność