GBG

Guild Battlegrounds: current and upcoming sectors, player list, province map.

This module supports you during the Guild Battlegrounds (GBG): a live overview shows when sectors unlock, where fighting is going on, how much attrition an attack costs and how the guilds rank. It also offers its own province map, a window with your guild's focus targets, an activity overview of all guild members and a recommendation for province buildings.

The live overview with the upcoming sectors
The live overview with the upcoming sectors

The module consists of several windows:

Window Content
GBG Live overview with four tabs: upcoming sectors, progress, own sectors, ranking
Province map Mini map of the whole battleground
Focus targets The next focus targets of your guild, right on the battleground map
GBG Overview Negotiations, fights and attrition of every guild member, with history
Snapshot Log Single recorded changes, or the daily values of one player
Building Recommendation Better building combinations for one of your own provinces

Opening

  • Menu bar: the GBG icon (see menu bar). Clicking it again closes the window. The icon carries the countdown to the next focus target.
  • After logging in, the icon is red and its tooltip says "Disabled: Visit the GBG map first!". Only once you open the battleground map in the game does the helper receive the map data; the icon then turns normal and can be clicked.
  • Automatically: when you enter the battleground map, the live overview opens by itself once per visit, as soon as the first map data has arrived. You can turn this off in the window's gear with Open window automatically (see settings).
  • The GBG Overview and the Building Recommendation have no menu icon; they only open through actions in the game.
  • The Focus targets window has no menu icon either. It appears by itself on the battleground map as soon as your guild has set a focus target on a foreign sector.
  • GBG Overview, Snapshot Log, province map, Focus targets and Building Recommendation close when you leave the battleground map. The live overview stays open.

Live overview

The GBG window updates continuously from the game data and can stay open during the battles. It can be moved, resized, minimized and moved into a separate browser window with the popout button (see window buttons).

The four tabs only carry icons. From left to right:

Tab Content
1 (hourglass) Upcoming sectors: locked sectors with countdown
2 Progress: sectors currently being fought over
3 Own sectors: your guild's locked sectors with building slots
4 Ranking: all guilds on the battleground

At the top right you find these buttons:

  • Select all selects all rows in the first tab. As soon as at least one row is selected, the button turns into Copy (see copying). The button is only visible in the first tab.
  • Send selected provinces to Discord, Send selected provinces to Discord with selected template and Send selected provinces via web request only appear when rows are selected and a target is set up (see sending).
  • Map opens the province map; clicking it again closes it.

Upcoming sectors

All locked sectors, sorted by the time they unlock. By default only sectors that border your guild's territory (Show only adjacent sectors countdowns) and without your own sectors (Show own sector countdowns).

Column Meaning
Province Colour dot of the owning guild (as on the map), battle type dot (red = fight with the attacking army, blue = with the defending army), guild signal if any, sector name. The tooltip shows the owner.
% Attrition chance of an attack on this sector (can be turned off).
Owner Name of the owning guild (only with Show Guilds).
at Time the sector unlocks, in your local time or – with Display times in server time – in server time.
in Countdown until the sector unlocks.
VP Victory points of the sector (only with Show VP column). With a victory point boost the bonus is shown in green behind it, the tooltip shows the total ("with boost: …").
Discord / web request Buttons to send a single sector (see sending).
Arrow, alert Mark sector on the map and Set Alert or Delete Alert (see marking and alerts).
  • Guild signals: if your guild leadership has marked a sector in the game, a target icon ("Focus target of your guild") or a block icon ("Blocked by your guild") appears in front of the name. Can be turned off with Mark guild's focus target.
  • Underlined name: the connection is safe. At least one adjacent sector of your guild is a starting sector or stays locked at least as long as this sector. The battle type dot additionally gets a frame.
  • Clicking a row selects it for copying and sending; a second click deselects it. The selection is kept when the list updates. On the open province map, selected sectors carry a yellow band; you can also click sectors directly there.
  • Hovering over a row: on the open province map the outline of the sector pulses (also in the own sectors tab).
  • Hovering over a sector on the province map: the row of the sector is highlighted (see map and list).
  • When the countdown runs out, the at column briefly shows !!; the row disappears after five seconds.

Marking and alerts

Arrow button: Mark sector on the map places an arrow on the battleground map in the game that points at the sector. Several sectors can be marked at the same time; a second click removes the arrow again. The button stays highlighted as long as the sector is marked. Can be turned off with Show arrow button to mark sectors on the map.

Alert button: Set Alert creates a browser alert "Province … unlocks" that fires the configured lead time before the sector unlocks (default 30 seconds). Sectors with an alert show Delete Alert instead. With Set an alert automatically for every sector in the list, every sector in this list gets an alert by itself; if you delete one of them, the helper does not set it again until the next reload. You also find all alerts in the Alerts module.

Progress

All sectors with ongoing conquest progress.

Column Meaning
Province Colour dot of the owner (grey without owner), guild signal if any, name. Tooltip with the owner.
Owner Name of the owning guild or "No owner yet" (only with Show Guilds).
Progress One number per attacking guild, with the icon in that guild's colour. This shows at a glance whether several guilds are fighting for the same sector.
Required Progress needed to conquer the sector.

New progress comes in live, and the row briefly lights up. When a sector is conquered and locked, it disappears here and shows up with a countdown among the upcoming sectors.

Own sectors

All locked sectors of your guild.

Column Meaning
Province Colour dot and name.
Owner Only with Show Guilds.
in Countdown until the sector unlocks; the tooltip shows the time.
Slots Used and available building slots, e.g. "1/3".
VP Victory points (only with Show VP column).

A row has a reddish background if the sector still has free building slots and the attrition chance resulting from its buildings is not yet at the 20 % minimum. Another building is worthwhile there (see Building Recommendation).

Ranking

All guilds on the battleground, sorted by victory points. Your guild is framed.

Column Meaning
# Rank
Guild Colour dot (map colour) and name
Members Number of members
Provinces Number of sectors the guild currently holds
VP Current victory points, updated continuously

Attrition chance

The % column shows the probability that a fight or negotiation on the sector increases your attrition. Province buildings in adjacent sectors of your guild lower this chance; the minimum is 20 %.

  • The helper remembers the buildings in your guild's sectors as soon as the game sends them (on the battleground map or in a sector's building menu). Buildings still under construction do not count.
  • Calculation: 100 % minus the sum of the building bonuses of all known adjacent own sectors, at least 20 %. If the game itself provides a value, the helper takes the lower of the two.
  • - means that neither the game nor the stored buildings provide a value, for example because the building list of a neighbouring sector has changed since it was last loaded.
Colour Value
Light blue 20 % (minimum)
Orange 21–79 %
Red 80 % and more

Copying

Select the rows you want in the first tab (or Select all) and click Copy. The sectors are copied to the clipboard sorted by unlock time, one line per sector, for example:

14:32 🔴 🎯 <sector> [20%] 32 VP
14:47 🔵 <sector> [60%] 24 VP
  • The time is always server time, so it is valid for all guild members. If your time zone differs from server time, a one-time message points this out the first time you copy.
  • Which parts are copied is set in the gear under Copying: Attack colors (🔴/🔵, on by default), Attrition, Focus target of your guild (🎯) and Victory points (all three off by default).

Sending

Instead of copying, you can also send sectors directly:

Which webhook, which templates and which web request profile are used is set in the gear in the Sending tab (see settings). The buttons in the individual rows only appear for sectors that do not belong to your guild.

Province map

The province map of the battleground
The province map of the battleground

The Map button in the live overview opens a mini map of the whole battleground (window title "ProvinceMap"), for both map types of the game (hexagon map and ring map). Each sector shows:

  • Fill colour: colour of the owning guild, grey without owner. Starting sectors carry the guild's flag.
  • Short name of the sector, above it one dot per building slot (·, ·· or ···).
  • Battle type dot next to the short name for foreign sectors: red for the attacking army, blue for the defending army.
  • Unlock time (hours:minutes) for locked sectors.
  • Progress bars: one bar per attacking guild in its colour.
  • Guild signals of your guild as a semi-transparent watermark (only with Mark guild's focus target).

Controls:

  • Zoom switches between the full view and an enlarged view. Hold the mouse button to move the visible area.
  • Hovering over a sector shows a tooltip with the sector's data and highlights its row in the live overview (see map and list).
  • Clicking a sector selects it for copying and sending if it is listed among the upcoming sectors (see selecting sectors on the map).
  • When you hover over a row in the live overview, the outline of the sector pulses on the map.
  • The popout button moves the map into a separate browser window (see window buttons).

The map draws conquests, progress and owner changes live.

Map and list

The province map with the tooltip of a sector and the highlighted row in the live overview
The province map with the tooltip of a sector and the highlighted row in the live overview

While the mouse rests on a sector of the province map, the following happens:

  • Outline: the sector gets a steady outline on the map.
  • Row in the live overview: the row of the sector gets a highlighted background and a yellow bar on its left – among the upcoming sectors, in the progress tab and among the own sectors. If the row is outside the visible area, the list scrolls to it as soon as the mouse rests for a moment.
  • Dot on the tab: if the row only exists in a tab that is not open right now, a yellow dot on that tab shows where to find it.
  • Earlier neighbours: if the sector is locked, all adjacent sectors that are locked as well and unlock earlier get a white dashed band and a light tint. The sector can be reached from them first.
  • Tooltip: a tooltip with the sector's data appears at the mouse pointer. Countdown, progress and the selection hint keep updating while the mouse stays there.

The tooltip contains:

Row Content
Header Colour dot of the owning guild, battle type dot, guild signal if any (only with Mark guild's focus target), the sector as in the list and its name.
Owner Name of the owning guild or "No owner yet".
at Unlock time, only for locked sectors. In server time with Display times in server time.
in Countdown until the sector unlocks, only for locked sectors.
Progress Only for open sectors that are being fought over: colour dot, progress and required progress per attacking guild.
Slots Only for your guild's sectors: used and available building slots.
Attrition Only for foreign sectors and when a value is known: attrition chance in the colours of the list.
VP Victory points of the sector; with a victory point boost the bonus follows in green.
Opens earlier next to it The adjacent sectors that unlock earlier: colour dot of the owner, sector and time, earliest first.
Click: select for copying or Click: remove from selection Only for sectors listed among the upcoming sectors.

Selecting sectors on the map

Clicking a sector on the province map selects its row among the upcoming sectors for copying and sending, just like clicking the row itself. A second click removes the sector from the selection.

  • This works for every sector listed among the upcoming sectors. Over these sectors the mouse pointer changes, and the tooltip names the action.
  • Selected sectors carry a yellow band along the inside of their outline on the map – no matter whether you selected them on the map, in the list or with Select all.
  • Dragging the enlarged map with the mouse button held down does not count as a click.
  • The selection is kept when the live overview updates.

Focus targets

The Focus targets window on the battleground map
The Focus targets window on the battleground map

The Focus targets window lists the next focus targets of your guild in a few rows on the battleground map – even when the live overview is closed. A focus target is a sector that your guild leadership has marked with the target signal in the game and that does not belong to your guild. Own sectors with a focus signal and sectors with the block signal do not count.

The window appears by itself when all of this applies:

  • You are on the battleground map.
  • There is at least one focus target.
  • Show the next focus targets on the battleground map is turned on (on by default, see settings).
  • You have not closed the window during this visit to the map (see moving and closing).

When there is no focus target left, the window disappears; it returns with the next focus signal. The setting Mark guild's focus target has no effect on it.

Open targets come first, followed by the locked ones in the order they unlock. Number of focus targets sets how many targets the window shows at most (default 5).

What a row shows

Part Meaning
Colour dot Colour of the owning guild, grey without owner.
Battle type dot Red = fight with the attacking army, blue = with the defending army.
Sector Name as in the live overview. It is green for open sectors. The tooltip gives the name of the sector and the owner.
Attrition Attrition chance of an attack, in the colours of the live overview; - when no value is known.
Status Unlock time, countdown or conquest progress (see below).
Alert button Set Alert or Delete Alert (see alert).

The status depends on how long the sector stays locked:

State Display
Unlocks in more than 30 minutes at and the unlock time – in your local time, or in server time with Display times in server time.
Unlocks within the next 30 minutes in and a countdown in minutes and seconds.
Unlocks in less than 3 minutes The countdown is yellow and the row gets a yellow bar on its left.
Sector is open Conquest progress: colour dot and progress of your guild, next to it colour dot and progress of the strongest other guild, followed by a slash and the required progress.

Alert

The alert button at the end of the row sets and deletes the same alert as the button among the upcoming sectors (see marking and alerts). Both places show the same state, and the alert is also listed in the Alerts module.

The button is missing when the sector is already open or unlocks sooner than the Sector alert lead time (seconds) – a new alert would come too late. If an alert is already set for the sector, the button for deleting it stays.

Marking the sector in the game

Clicking a row places an arrow on the battleground map in the game that points at the sector – like the arrow button among the upcoming sectors (Mark sector on the map, see marking and alerts). A second click removes the arrow. Rows whose sector carries an arrow have a brighter background. This also works when Show arrow button to mark sectors on the map is turned off.

Moving and closing

  • Moving: drag the window by its title bar to a free spot on the map. The helper remembers the position (see moving). The very first time, the window sits at the top centre of the screen.
  • Collapsing: the triangle collapses the window to its title bar (see collapse).
  • Closing: the cross closes the window. It then stays away until you enter the battleground map the next time or save the settings of the live overview. To turn it off permanently, use Show the next focus targets on the battleground map.
The GBG menu icon with the countdown to the next focus target
The GBG menu icon with the countdown to the next focus target

On the GBG icon in the menu bar, a small counter shows how long it takes until the next locked focus target of your guild unlocks.

  • Format: to the second – "1:05:30" from one hour on, "12:05" below, only the seconds ("42s") during the last minute.
  • Last five minutes: the counter turns yellow, during the last minute red.
  • No locked focus target: the counter is hidden. This also applies when all focus targets are already open.
  • Away from the battleground map: the countdown keeps running. The helper then calculates with the map data it received last. After logging in, it only appears once you have opened the battleground map.
  • The countdown does not depend on the Focus targets window: it also runs when you have closed the window or turned it off.
  • Turning it off: with Show the countdown to the next focus target on the menu button in the settings (on by default).

GBG Overview

The GBG Overview with the gains since the last snapshot
The GBG Overview with the gains since the last snapshot

The GBG Overview shows the battle activity of all guild members. It opens as soon as you open your guild's battleground ranking in the game. Every time you open it, a snapshot is saved: the helper compares the values with the previous opening and remembers the differences.

The setting GBG Player Pop Up turns the window off. Snapshots are still recorded.

At the top of the window:

  • GBG Round with <, > and a drop-down: browses through all saved rounds (period from–to). Past rounds show the last state you saw during that round.
  • ↑ (progress filter, current round only): shows the number of members with new progress since the last snapshot. One click hides everyone else, a second click shows everybody again. The filter stays active the next time the window opens.
  • Snapshot Log (current round only): opens the Snapshot Log.
  • The title bar shows "Last snapshot: … ago": how long ago the ranking was previously opened.
Column Meaning
Guild Member Rank, portrait and name; your own row is marked.
Negotiations (icon) Negotiations won
Fights (icon) Fights won
Total Fights + 2 × negotiations
Attrition The player's attrition

The number in brackets behind each heading is the total for the whole guild. Members with gains since the last snapshot have a green background, and the gain is shown behind the values (↑ 3).

Clicking a row (current round only) opens the daily values of this player.

In the gear of the GBG Overview (see window buttons):

  • show GBG round selector, show progress filter and show snapshot log button show or hide the controls at the top; Save applies the change.
  • Export: CSV or JSON saves the current table as a file.

Snapshot Log

The Snapshot Log window lists every recorded change of the current round individually, newest first.

  • The button at the top shows the period and opens a calendar to narrow it down.
  • Columns: Date (with the time of the snapshot), Guild Member, negotiations, fights and Total – each the gain in that snapshot. Click a heading to sort.

Daily values of a player

After clicking a row in the GBG Overview, the same window shows this player's history: the name and the period of the round at the top, then the note on accuracy and one row per day with Date, negotiations, fights and Total. Clicking a day expands the individual snapshots of that day with their times below it; a second click collapses them again. This table can also be sorted by clicking a heading.

Building Recommendation

If the setting Show GBG Building Recommendation is on (off by default), the Building Recommendation opens as soon as you open the building menu of one of your own provinces in the game. It suggests building combinations that achieve more than the buildings already standing there. As soon as you prepare a fight or start a negotiation, it closes.

Column Meaning
To Build Buildings of the combination as images (tooltip with the name). Buildings that already stand and remain are shown faded.
Chance Sum of the building bonuses of the whole combination: the chance that a fight in adjacent sectors causes no attrition. At most 80 % (equals the 20 % minimum attrition chance).
Costs (left number) The largest share of the Guild Treasury stock that a single good of the new buildings uses. The tooltip lists every good ("…% of … stock (era)").
Costs (right number) Sum of all goods needed (tooltip "Absolute Costs").
  • The list is sorted by Chance, best chance first. Each new chance level starts with a dividing line; the better value for chance, costs or absolute costs is highlighted.
  • Combinations are hidden if a single good would need more than the whole Guild Treasury stock, and if they are not cheaper than an already listed combination with the same or a better chance.
  • If the existing buildings already reach 80 %, the window does not open.

The buildings the helper sees here are also used for the attrition chance in the live overview.

Showing rewards

With the setting Rewards Bar Info (off by default), the helper shows the rewards you receive for conquered sectors in the Guild Battlegrounds and in the Guild Expedition as short pop-ups at the right edge of the screen. Each one fades out after about ten seconds.

Settings

The gear of the live overview (see window buttons) opens the settings in four tabs. Save applies everything and rebuilds the window. A closed Focus targets window returns when you save.

Setting Default Effect
Open window automatically on Opens the live overview when you enter the battleground map.
Show Guilds off Owner column in the first three tabs.
Show only adjacent sectors countdowns on Upcoming sectors only if they border your guild's territory.
Show own sector countdowns off Also lists your own locked sectors among the upcoming sectors.
Show VP column off VP column for upcoming and own sectors.
Show attrition column on % column for upcoming sectors.
Mark guild's focus target on Guild signals in the tables and on the province map.
Show arrow button to mark sectors on the map on Arrow button for upcoming sectors.
Show the next focus targets on the battleground map on Shows the Focus targets window on the battleground map.
Number of focus targets 5 How many targets the Focus targets window shows at most, 1–8.
Show the countdown to the next focus target on the menu button on Shows the countdown on the menu icon.

Under Elements to copy you choose what each line contains when copying: Attack colors (on), Attrition (off), Focus target of your guild (🎯) (off), Victory points (off). Time and name are always included.

Setting Default Effect
Display times in server time off at column and tooltips in server time instead of local time.
Offset to servertime (minutes) empty The helper detects the offset itself; the detected value is shown greyed out in the field. Only enter a value if it is wrong. Leaving it empty or entering the detected value means automatic.
Sector alert lead time (seconds) 30 How long before unlocking an alert fires, 5–3600.
Set an alert automatically for every sector in the list off Sets an alert for every upcoming sector in the list.

Section Discord Webhooks: webhook, Template for single sectors, Template for multiple provinces, and Send sectors automatically with Lead time (seconds) and Skip at attrition chance of (%). Section Web Requests: the profile for Send via web request. If there is no webhook or profile yet, the Open button leads to the respective module. All details: Discord Webhooks and Web Requests.

Global settings that affect this module:

FAQ

The menu bar icon is red and does not react. The helper has no map data yet. Open the battleground map in the game once.

The % column only shows "-". The helper does not know the buildings of the adjacent own sectors yet, and the game provides no value of its own. The buildings come in as soon as the game sends them on the battleground map or in the sector's building menu.

The copied times do not match the table. Copying always uses server time, while the table shows your local time by default. Turn on Display times in server time and both will match.

The Focus targets window does not appear. It only shows on the battleground map and only when your guild has set a focus signal on a sector it does not own. If you closed it, it only returns the next time you enter the map or when you save the settings. Also check Show the next focus targets on the battleground map there.

A click on the province map does not select the sector. Only sectors that are currently listed among the upcoming sectors in the live overview can be selected. The live overview has to be open for this, and filters such as Show only adjacent sectors countdowns determine which sectors are listed there.

The GBG Overview does not appear. It only opens via the battleground ranking in the game, not via the menu bar. If GBG Player Pop Up is off, it stays invisible.

The Building Recommendation does not appear. Check Show GBG Building Recommendation. The window also only appears if there is a better combination than the existing buildings and the game sends the Guild Treasury stock when the building menu opens.

Can my guild see my snapshots? No. They are stored only in your browser. To share them, use the CSV/JSON export.

See also