GBG
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 module consists of several windows:
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 theBuilding 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:
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).
- 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.
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.
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
Ranking
All guilds on the battleground, sorted by victory points. Your guild is framed.
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.
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:
- to a Discord channel via Discord Webhooks – individually or as a selection, with the default text or your own template, and optionally automatically shortly before they open,
- to your own server via Web Requests.
Which webhook, which templates and which web request profile are used is set in the gear in the Sending tab (see
Province map
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
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:
Selecting sectors on the map
Clicking a sector on the province map selects its row among the
- 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 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
The status depends on how long the sector stays locked:
Alert
The alert button at the end of the row sets and deletes the same alert as the button among the upcoming sectors (see
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
Not in Firefox
The arrows rely on a technique that only Chromium browsers such as Chrome and Edge provide. In Firefox, clicking a row does not place an arrow.
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.
Countdown on the menu icon
On the GBG icon in the menu bar, a small counter shows how long it takes until the next locked
- 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 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.
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
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.
Note
All values come from your own snapshots and are stored only in your browser. If you open the ranking rarely, one snapshot covers several actions and the assignment to days becomes inaccurate. When a new round starts, the helper deletes the snapshots of the old round; its final state remains available via GBG Round.
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.
- 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
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
Under Elements to copy you choose what each line contains when
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:
- GBG Player Pop Up – show the GBG Overview when the battleground ranking is opened (on by default).
- Show GBG Building Recommendation – Building Recommendation in the building menu of an own province (off by default).
- Rewards Bar Info – show received rewards (off by default).
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
A click on the province map does not select the sector.
Only sectors that are currently listed among the
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.