WG-GUI

This update focuses on improving plugin functionality, integration with WorldGuard, user experience, performance boost, permissions rework and bugfixes.

WG-GUI 1.11 contains major changes to configuration files and supports automatic update from versions 1.10-1.10.2.
If you are updating from version older than 1.10, you need to run WG-GUI 1.10.x first and then 1.11 to handle update properly (if you don’t want to do so, make all necessary changes to configuration files manually, I mention all of them below).

1. New feature: „Teleport to region” – self-explanatory, it takes location set as „teleport” flag value for given region or it isn’t specified, it takes center of that region.
   It doesn’t check whether location is safe for survival-mode players, so be cautious.
   To access this feature, open „Region options” for selected region and click on „Teleport to this region” button.
   Permission to access feature: wggui.regionoptions.teleport
   
   //proxy.spigotmc.org/4354f755d071a682c4d1e8963349ecb2d46d1cc0/68747470733a2f2f6d616369656a6e6965727a7769636b692e706c2f77702d636f6e74656e742f75706c6f6164732f323032362f31312f57472d475549315f31312d54656c65706f72742e676966" rel="noopener nofollow" target="_blank">https://proxy.spigotmc.org/4354f755d071a682c4d1e8963349ecb2d46d1cc0/68747470733a2f2f6d616369656a6e6965727a7769636b692e706c2f77702d636f6e74656e742f75706c6f6164732f323032362f31312f57472d475549315f31312d54656c65706f72742e676966" alt="[​IMG]" data-url="https://maciejnierzwicki.pl/wp-content/uploads/2026/11/WG-GUI1_11-Teleport.gif" />
   
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   INV_REGION_OPTIONS_TELEPORT: "Teleport to this region"
   INV_REGION_OPTIONS_TELEPORT_DESCRIPTION:
   - "Teleport to the center of this region."
   - " "
   - "&e&oBe cautious when in survival mode, as this may"
   - "&e&oteleport you to a location that is not safe."
   CHAT_TELEPORTED_TO_REGION: "&fTeleported to region &a<region>&f."
2. New feature: „Manage child regions” – this opens a view with all regions that have set our currently selected region as „parent” region. From there we can:
   
   * Edit selected child-region (it moves us to „Region options” view of that region) – by left-clicking on button
   * Unset our region as parent of that child-region – by right-clicking on button
   * Completely remove that child-region – by shift + right-clicking on button
   
   To access this feature, open „Region options” for selected region and click on „Manage child regions” button.
   Permission to access feature: wggui.regionoptions.childregions
   
   Child regions menu presentation
   
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   INV_REGION_OPTIONS_CHILDREGIONS: "Manage child regions"
   INV_REGION_OPTIONS_CHILDREGIONS_TITLE: "Child regions"
   INV_REGION_OPTIONS_CHILDREGIONS_REGION:
   - "&fRegion: &a<region>"
   - " "
   - "&7Left-click &f- edit this region"
   - "&7Right-click &fwhite- unset parent of this region"
   - "&7Shift + right-click &f- completely remove this region"
   INV_REGION_OPTIONS_CHILDREGIONS_COUNT_DISPLAYNAME: "&fRegions count: &a<count>"
   
   Configuration files changes (config.yml):
   
   Added lines:
   
   Code (YAML):

   Items:
   ManageChildRegionsOptionItem: HONEY_BLOCK
   ManageChildRegionsCountItem: PAPER
3. New feature: „Region overview” – this opens a view with most frequently checked data about region (name, boundaries, owners/members, flags, parent-region, priority). From that view you can also access Region Options menu. You can customize how data is presented, e.g. limit number of flags being shown.
   
   To access this feature, open „Select region” view for a world and right-click on a button representing region. Alternatively, Region Overview opens automatically when you type WorldGuard’s /rg info command (more about it on later paragraph describing that feature).
   
   Permissions to access feature:
   „wggui.selectregion.overview” [allows opening of region overview]
   „wggui.regionoverview.basicinfo” [allows access to region id, boundaries and priority info]
   „wggui.regionoverview.membership” [allows access to owners and members info]
   „wggui.regionoverview.parentchildren” [allows access to parent-region and dependent regions info]
   „wggui.regionoverview.flags” [allows access to flags info]
   „wggui.regionoverview.options” [allows access to Region Options menu for region]
   
   //proxy.spigotmc.org/58efd3a35ae470b641f8f3c9c26dd3a0fca45505/68747470733a2f2f6d616369656a6e6965727a7769636b692e706c2f77702d636f6e74656e742f75706c6f6164732f323032362f31312f57472d475549315f31312d526567696f6e4f766572766965772e676966" rel="noopener nofollow" target="_blank">https://proxy.spigotmc.org/58efd3a35ae470b641f8f3c9c26dd3a0fca45505/68747470733a2f2f6d616369656a6e6965727a7769636b692e706c2f77702d636f6e74656e742f75706c6f6164732f323032362f31312f57472d475549315f31312d526567696f6e4f766572766965772e676966" alt="[​IMG]" data-url="https://maciejnierzwicki.pl/wp-content/uploads/2026/11/WG-GUI1_11-RegionOverview.gif" />
   
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   INV_REGION_OVERVIEW_TITLE: "Region overview"
   INV_REGION_OVERVIEW_BASIC_NAME: "Basic region info"
   INV_REGION_OVERVIEW_BASIC_DESCRIPTION:
   - "&9Region name&f: &a<region>"
   - " "
   - "&9Boundaries&f:"
   - "&a<point1> -> <point2> &7&o[<boundaries_type>]"
   - " "
   - "&9Priority&f: &a<priority>"
   INV_REGION_OVERVIEW_MEMBERSHIP_NAME: "&fRegion owners and members"
   INV_REGION_OVERVIEW_MEMBERSHIP_OWNERS_DESCRIPTION:
   - "&9Owners&f: &a<ownerscount>"
   - " "
   INV_REGION_OVERVIEW_MEMBERSHIP_MEMBERS_DESCRIPTION:
   - " "
   - "&9Members&f: &a<memberscount>"
   - " "
   INV_REGION_OVERVIEW_MEMBERSHIP_DESCRIPTION_PLAYER_ENTRY:
   "&a<playerName>"
   INV_REGION_OVERVIEW_MEMBERSHIP_DESCRIPTION_PLAYER_ENTRY_SEPARATOR: "&7, "
   INV_REGION_OVERVIEW_MEMBERSHIP_DESCRIPTION_HIDDEN_PLAYERS_REPLACEMENT: " &7&o(+ <hiddenFlagsCount> players…)"
   INV_REGION_OVERVIEW_MEMBERSHIP_NONE: "&7&o(no players)"
   INV_REGION_OVERVIEW_PARENT_CHILDREN: "Parent and child regions"
   INV_REGION_OVERVIEW_PARENT_CHILDREN_DESCRIPTION:
   - "&9Parent region&f: &a<parentregion>"
   - " "
   - "&9Child regions&f: &a<childregions>"
   
   INV_REGION_OVERVIEW_PARENT_CHILDREN_PARENT_NONE: "&7&o(not set)"
   INV_REGION_OVERVIEW_PARENT_CHILDREN_CHILDREN_NONE: "&7&o(no child regions)"
   INV_REGION_OVERVIEW_FLAGS: "Region flags"
   INV_REGION_OVERVIEW_FLAGS_DESCRIPTION:
   - "&9Flags modified&f: &a<flagscount>"
   - " "
   - "&9Flags values&f:"
   INV_REGION_OVERVIEW_FLAGS_NONE: "&7&o(no flags modified)"
   INV_REGION_OVERVIEW_FLAGS_DESCRIPTION_FLAG_ENTRY: "&f<flagName>&7: &a<flagValue>"
   INV_REGION_OVERVIEW_FLAGS_DESCRIPTION_FLAG_ENTRY_SEPARATOR: "&7, ”
   INV_REGION_OVERVIEW_FLAGS_DESCRIPTION_HIDDEN_FLAGS_REPLACEMENT: " &7&o(+ <hiddenFlagsCount> flags…)"
   INV_REGION_OVERVIEW_OPTIONS: "Region options"
   INV_REGION_OVERVIEW_OPTIONS_DESCRIPTION:
   - "&fGo to region options"
   INV_REGION_OVERVIEW_CUBOID_BOUNDARIES_TYPE_NAME: "□ Cuboid"
   INV_REGION_OVERVIEW_POLY2D_BOUNDARIES_TYPE_NAME: "⬡ 2D Polygon"
   INV_REGION_OVERVIEW_GLOBAL_BOUNDARIES_TYPE_NAME: "∞ Global"
   UNKNOWN_REGION_TYPE_REPLACEMENT: "Unknown region type"
   Configuration files changes (config.yml):
   
   Added lines (inside Items section):
   
   Code (YAML):

   Items:
     RegionOverviewBasicInfoItem: NAME_TAG
     RegionOverviewMembershipItem: TOTEM_OF_UNDYING
     RegionOverviewParentChildrenItem: HONEY_BLOCK
     RegionOverviewFlagsItem: REDSTONE_TORCH
     RegionOverviewOptionsItem: REPEATER
   Added lines (outside Items section):
   
   Code (YAML):

   # Maximum number of lines reserved for presenting flags and their values in "Region overview" menu.
   RegionOverviewFlagsMaxLines: 5
   # Maximum number of flags presented in one line in "Region overview" menu.
   RegionOverviewFlagsMaxInLine: 2
   # Maximum number of lines reserved for presenting owners and members (limit applies to both separately) in "Region overview" menu.
   RegionOverviewMembershipMaxLines: 3
   # Maximum number of owners and members (limit applies to both separately) presented in one line in "Region overview" menu.
   RegionOverviewMembershipMaxInLine: 3
4. New feature: /rg info & /rg list commands override
   
   This feature allows to takeover WorldGuard’s /region info and /region list commands execution and let WG-GUI handle output. It is enabled by default and you can disable it from config.yml file.
   
   When player enters /region info command, WG-GUI firstly checks whether player has access to original WorldGuard permission to that command – if not, WG-GUI does nothing and player gets WorldGuard’s response indicating lack of permission. If player has access to that command, WG-GUI checks for a matching region – if name was not provided with command, it looks for regions at player’s current position and returns all regions player has access to. If there was only one match, a Region Overview menu is presented to player, if there are more matches, a „Select region” menu is presented with matching regions from where player can select region before getting its information.
   
   When player enters /region list command, WG-GUI firstly checks whether player has access to original WorldGuard permission to that command – if not, WG-GUI does nothing and player gets WorldGuard’s response indicating lack of permission. If player has access to that command, WG-GUI performs exact regions lookup like WorldGuard would do and supports all original command arguments. Results are being shown in „Select region” menu from where player can go to region options menu or region overview.
   
   When this feature is enabled, players can still use original WorldGuard’s commands by type them in form „/worldguard:rg info (…)” & „/worldguard:rg list (...)”
   
   Configuration files changes (config.yml):
   
   Added lines:
   
   Code (YAML):

   # If true, WorldGuard' '/region list' command will be overridden to open WG-GUI' "Select region" menu with regions matching command query, instead of letting WorldGuard handle command response.
   # It is still possible to force use of WorldGuard' command by executing /worldguard:region list instead of /region list.
   OverrideRgListCommand: true
   
   # If true, WorldGuard' '/region info' command player will be overriden to open WG-GUI' "Region quick overview" menu for region at player current position. If there are more regions, selection menu containing them will be shown.
   # It is still possible to force use of WorldGuard' command by executing /worldguard:region info instead of /region info.
   OverrideWorldGuardRgInfoCommand: true
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   CHAT_NO_REGIONS_FOUND: "<white>No regions found."
5. New feature: Escaping and customization of keywords used when awaiting player text input
   
   When player was in a state that required to enter some value into chat, strings like „edit”, „q”, „create” were reserved for certain actions and couldn’t have been used as values. Now it is possible to use these keywords as values by escaping them with „\” character.
   Moreover, these keywords can be replaced with different ones in config.yml file.
   
   Configuration files changes (config.yml):
   
   Added lines:
   
   Code (YAML):

   # Keyword used to confirm region creation in chat.
   ChatInputCreateKeyword: "create"
   # Keyword used to confirm region boundaries editing in chat.
   ChatInputEditKeyword: "edit"
   # Keyword uset to cancel region creation/editing in chat.
   ChatInputQuitKeyword: "q"
   # Keyword used to set flag value when non-chat input is accepted.
   ChatInputSetKeyword: "set"
   Configuration files changes (lang.yml):
   
   Modified lines:
   
   Code (YAML):

   CHAT_TYPE_REGION_NAME: "&fType name of your region. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_PLAYER_NAME: "&fType name of player you want to add/remove. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_FLAG_VALUE_STRING: "&fType new String value for &a<flagName> &fflag. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_FLAG_VALUE_INT: "&fType new numeric value (without decimals) for &a<flagName> &fflag. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_FLAG_VALUE_DOUBLE: "&fType new numeric value (with optional decimals) for &a<flagName> &fflag. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_FLAG_VALUE_LOCATION: "&fGo to the desired location for &a<flagName> &fflag and type '<set_keyword_repl>'. If you want to abort, type '<quit_keyword_repl>'."
   CHAT_TYPE_FLAG_VALUE_SET: "&fType value (prefixed with '+' character) you want to add to &a<flagName> &fflag. If you want to remove existing element, enter its name prefixed with '-' character. If you want to add/remove more than one element at once, separate them with commas. If you want to abort, type '<quit_keyword_repl>'. Example values: '+/heal', '+ZOMBIE', '-/unwantedcommand,/command2'"
   CHAT_SELECT_REGION_BOUNDARIES: "&fUse WorldEdit to select region boundaries and type '<create_keyword_repl>' (or '<edit_keyword_repl>' if you're editing an existsing region). If you want to abort, type '<quit_keyword_repl>'."
   CHAT_HINT_ESCAPE_SPECIAL_KEYWORDS: "&fHint: If you wish your input to match one of keywords like '<quit_keyword_repl>' you can escape them by prefixing with backslash character '\\'."
6. Updates to „Select region” menu
   
   * It is now possible to show regions in reverse order – to do so, just right-click on existing „Change region visibility” item. To access this, player needs „wggui.selectregion.visibility.reverse” permission.
   
   * You can set whether regions should be shown in reverse order by default in config.yml file (by default plugin uses normal order)
   
   Configuration files changes (config.yml):
   Added lines:
   
   Code (YAML):

   # If true, regions shown in "Select region" menu will be sorted in reverse order by default. Players can switch order from GUI.
   DisplayRegionsInReverseOrderByDefault: false
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   INV_SELECT_REGIONVISIBILITY_ALL_REVERSED:
   - "Showing all regions (reverse order)"
   - " "
   - "Left-click: switch to owned regions only"
   - "Right-click: switch to normal order"
   INV_SELECT_REGIONVISIBILITY_OWNED_REVERSED:
   - "Showing owned regions (reverse order)"
   - " "
   - "Left-click: switch to all regions"
   - "Right-click: switch to normal order"
   INV_SELECT_REGION_ENTRY_NAME: "<white><regionName>"
   INV_SELECT_REGION_ENTRY_DESCRIPTION_1:
   - "Left-click: edit this region"
   INV_SELECT_REGION_ENTRY_DESCRIPTION_2:
   - "Right-click: region overview"
7. Updates to „Region options” menu
   
   * „Set/unset parent-region” item now shows current parent region id in its lore or a text indicating that parent is not set.
   * Inventory title is now more customizable, allowing to decide whether to display region id or not.
   * Positions of buttons are now dynamically calculated depending on what player has access to, resulting in a more structured look.
   
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   INV_REGION_OPTIONS_PARENT_NONE: "&7&o(not set)"
   Modified lines:
   
   Code (YAML):

   INV_REGION_OPTIONS_PARENT_DESCRIPTION:
   - "Current parent region: &a<parentregion>"
   - " "
   - "Left-click - set parent region"
   - "Right-click - unset current parent region"
   INV_REGION_OPTIONS: "Region Options (<region_name>)"
8. Updates to region templates configuration
   
   When working with templates in region-templates.yml file it is now possible to omit template icon, and when declaring flags it is possible to omit value and group keys and set everything in one line, like shown below:
   
   
   Code (YAML):

   Templates:
     Empty:
     DisplayName: "Empty"
     Description:
    - "&eEmpty template."
     Flags:
       interact: allow -g members
   pvp: deny
   Old format of declaring flag values and groups is still supported.
   When icon is not declared, plugin uses default icon set in config.yml.
   
   Configuration files changes (config.yml):
   
   Added lines:
   
   Code (YAML):

   Items:
   DefaultRegionTemplateItem: PAPER
9. Updates related to receiving WG-GUI item
   
   * Plugin now checks whether player has inventory space before trying to give them an item used to open WG-GUI menu. In case of no space, a message is being sent.
   * Plugin now avoids giving player WG-GUI item if they already have one in their inventory.
   This behavior can be disabled in config.yml file.
   * Plugin now can set WG-GUI item as held one after giving it to player – this is disabled by default and can be enabled in config.yml file.
   
   Configuration files changes (config.yml):
   
   Added lines:
   
   Code (YAML):

   # If true, player won't receive GUI item when they already have it in their inventory.
   PreventReceivingGuiItemWhenAlreadyPresent: true
   # If true, GUI item will be set as the held item when given to player. The item previously held will be placed in player's inventory.
   SetGuiItemAsHeldItemAfterReceiving: false
   Configuration files changes (lang.yml):
   
   Added lines:
   
   Code (YAML):

   CHAT_NOT_ENOUGH_FREE_INVENTORY_SPACE: "&fYou don't have enough free inventory space."
   CHAT_GUIITEM_ALREADY_PRESENT: "&fYou already have WG-GUI item in your inventory."
10. Updates to „Edit region boundaries” option
    
    When player selects „Edit region boundaries” for a region that is in a different world than player currently is in, plugin teleports player to that world and then editing session continues. This behavior can be disabled in config.yml file.
    
    Configuration files changes (config.yml):
    
    Added lines:
    
    Code (YAML):

    # If true, when player is entering 'edit boundaries' mode and selected region is in different world, they will be automatically teleported to that world's spawn location.
    SwitchPlayerWorldWhenEditingBoundaries: true
11. Updates to region creation and renaming
    
    It is now possible to control regular expression used when parsing strings used as region names when creating new region or renaming existing region.
    By default, regex matches one from WorldGuard plugin – it can be more more restrictive but not more permissive.
    
    Configuration files changes (config.yml):
    
    Added lines:
    
    Code (YAML):

    # Pattern which region names must match. By default it is the same as in WorldGuard, which allows letters, numbers, underscores, commas, hyphens, plus signs, slashes and single quotes.
    # You can make it more strict but not less strict than WorldGuard's pattern.
    RegionNamePattern: "^[A-Za-z0-9_,'\\-\\+/]{1,}"
    Configuration files changes (lang.yml):
    
    Added lines:
    
    Code (YAML):

    CHAT_REGEX_REGIONNAME: "&fYour input may contain only letters, numbers and '&a_&f', '&a,&f', '&a-&f', '&a+&f', '&a/&f', '&a'&f' characters."
    Removed lines:
    
    Code (YAML):

    CHAT_REGEX_GENERAL: "&fYour input may contain only letters, numbers and '/', '_' characters."
12. Plugin permissions refactor
    
    Plugin permissions have been completely reworked to look more structured and clear.
    Old permissions are still supported, but they will be dropped somewhere in the future. Transition to new permissions is recommended whenever possible.
    
    
    <button class="button bbCodeSpoilerButton ToggleTrigger Tooltip JsOnly" type="button" data-target="&gt; .SpoilerTarget">Spoiler: Permissions changes</button>
13. Minor improvements to existing features
    
    * Default list of commands allowed during region boundaries selection session have been expanded.
    * WG-GUI now ensures existence of global (__global__) region before loading „Select region” menu
    * Players’ heads shown in „Remove owner/member” menus are now being sorted by players’ names alphabetically.
    * Players’ heads used in „Remove owner/member” menus are briefly background preloaded which significantly reduces waiting times for these menus to appear for a player.
    * Added „lava-harden’ flag description from WorldGuard plugin and „tchest-items-transfer”, „tchest-open” flags descriptions from TrashChest plugin
    
    
14. Bugfixes
    
    Fixed issue: HideUnsafeOptionsFromGlobalRegion setting from config.yml was being read incorrectly and was always set to true.
    Fixed issue: When clicking on „Remove this region” button in Region Options menu, plugin wasn’t checking if player is allowed to remove region if they weren’t owner of that region.
    Fixed issue: After renaming region, it wasn't marked as „last modified” by player performing action.
    Fixed issue: After clicking on „Edit last modified region” and then going back with „Exit” button, player was incorrectly moved to „Select region’ menu instead of to main menu.
    Fixed issue: In some cases, „Remove member/owner” menu wasn’t opening for a player and instead of it an exception was being shown in server log.