GBot / Documentation

Every setting has a job. Here is what it does.

Use this as the practical reference for the Settings window. The descriptions follow the names and controls shown in GBot, so you can configure one feature at a time.

01 / Start here

Quick start

Open Settings, enable only the modules you want and set the general timing first. Every feature has its own enable switch in the left menu.

General

Selected backpack

Chooses the backpack used by healing and other routines when they need a normal inventory slot. Options I–IV refer to the four in-game backpacks.

Maximum random delay

Sets the upper limit for the random wait before an action. A lower value is faster; a higher value spaces requests out.

Login delay

Sets the wait used around login or session initialization.

Highlight Underworld items / Highlight new affix items

Visually marks matching items in the game so they are easier to notice while reviewing inventory or packages.

Show Shop box / Show Hidden box

Controls whether the compact GBot panels for shop and hidden or status information are visible on the game page.

Auto collect Daily / Auto collect God Oils

Collects those available rewards automatically. When God Oils are enabled, the Selected gods checkboxes decide which gods are accepted.

Gold notification

Shows a notification when the configured gold event is detected.

02 / Combat

Combat modules

Combat features use the live game page to select an available action. Saved targets are preferences; GBot still checks that the target is currently present before attacking.

Expeditions

Available expedition targets / Refresh

Shows locations and enemies currently available in the live menu. Refresh rereads the game page when the list changes.

Location and enemy

Chooses the saved target for each country. The current country is marked separately; other countries are available for the next visit.

Minimum health

Prevents a new expedition attack below the selected health percentage.

Auto collect bonuses

Allows the bonus rule to choose the first eligible stage with room for another active bonus instead of always using the saved enemy.

Combat report loot / Loot difficulty

Enables report loot handling and chooses whether low or high difficulty loot is accepted.

Remove cooldown / Limit / Used

Chooses no removal, hourglass, or hourglass-or-ruby and sets the daily maximum. Used is read-only and shows the current count.

Travel for Dungeon

Enables the travel tab for automatic dungeon trips. Dungeon travel to and return to select countries, Minimum dungeon points sets the reason to travel, Reduce travel time uses the configured travel reduction, and the three costume checkboxes allow Normal, Medium and Hard costumes during travel.

Dungeon

Settings / Stats tabs

Settings controls the run; Stats shows recorded hourly and weekly combat results.

Location

Selects the dungeon location for the current country.

Is advanced

Tells GBot to continue the advanced dungeon progression when that path is available.

Skip boss / Boss name

Skips the configured boss and identifies its name for the stop rule.

Restart after fail

Sets how many losses are tolerated before the dungeon is restarted or left.

Use gate keys

Allows available gate keys to be used for dungeon progression.

Stop attacking below %

Health safety threshold for dungeon attacks.

Loot / Loot difficulty

Turns report loot collection on and chooses low or high difficulty.

Arena and Circus Turma

Settings / Arena or Circus / Provinciarum / Stats tabs

Settings contains shared limits, the mode tab contains same-server or Provinciarum rules, and Stats shows recorded wins, losses, gold and experience.

Auto stop and hours

Stops attacks for the selected number of hours. The countdown beside it shows when the stop ends.

Run until get chest (Turma)

Keeps Turma running until the configured chest objective is reached.

Level restriction

Limits eligible opponents by level.

Gold raided

Sets the minimum gold target used when choosing an opponent.

Stop after limit / Limit attacks

Stops the feature after the configured number of attacks. Daily attacks is read-only and shows the attacks made today.

Revenge

Allows revenge targets to be considered.

Attack priority 1–3

Orders the sources GBot tries first: League, Players or Highscore.

Same-server attack list / Ignore players / Auto ignore / Lose limit

Defines names to attack, names to skip, whether repeated losses are added to the ignore list, and how many losses trigger that ignore.

Attack score / Select page / Single attack

Enables score-based selection, chooses the score page and optionally limits the score pass to one attack.

Provinciarum filters

Attack players, target-list only, ignored players and ignored servers filter the live list. Max attacks per player and the overall daily limit control volume.

Allow combat simulation / Skip low / Prioritize chance

Uses the local simulator to avoid low-probability attacks and prefer a minimum win chance. Clear cache removes saved simulator profiles.

Turma doll roles / Total win

Assigns each doll Tank, DPS, Healer or Out for the simulator. Total win asks the simulator for a successful team outcome.

Underworld

Enable and run settings

Controls whether GBot starts the Underworld routine and follows the configured route, enemy and progression rules.

Buffs, costumes and healing

Underworld uses its own preparation pass for configured buffs, costumes and health safety before combat.

Loot and return

Collects the selected report loot and returns to regular activities after the run. Persistent recovery state is used if the page reloads during a fight or report.

03 / Inventory & economy

Inventory and economy

These modules move items through inventory, packages, Guild Market, shops and auctions. Rules are evaluated before an item is changed.

Heal

Minimum health

Starts healing when life points fall below this percentage. 99 effectively asks GBot to keep health near full.

Healing backpack

Selects the backpack searched first for food.

Maximum food items from packages

Caps how many food items GBot may bring out of packages during one healing pass.

Auto stop attacks

Pauses combat while healing is required, then releases combat after the health check is complete.

Heal Cervisia

Allows Cervisia to be used as a healing source.

Heal eggs / Select eggs

Allows eggs and, when enabled, lets you select the egg subtypes that may be used.

Buy food

Allows purchases from General Goods when eligible food is not available locally.

Buy food if needed

Restricts the shop purchase to cases where the configured healing pass actually needs food.

Renew shop

Leaves the shop unchanged, refreshes with cloth, or refreshes with rubies according to the selected option.

Protect Gold

Enable / gold threshold

Starts protection when carried gold reaches the configured threshold.

Guild Market item types

Selects which item types may be packaged and listed for protection. This prevents materials or unrelated items from being used.

Package and Guild Market flow

Moves eligible items to packages, lists them on Guild Market and keeps a durable checkpoint until the game confirms the item is gone from inventory.

Interrupted transaction

If navigation interrupts the flow, the pending item name and quantity remain visible and recovery keeps checking until ownership is resolved.

Auto sell

Enable automatic selling

Runs the selected sell rules whenever the relevant shop, packages or inventory page is refreshed.

Search for items

Defines the item-name or rule search used to find candidates.

Qualities

Selects white, green, blue, purple, orange or red items that may be sold.

Item types

Limits selling to selected equipment, usable items, recipes, scrolls, tools or other item classes.

Materials to protect

Names materials that must stay. Matching prefixes and suffixes are skipped as well.

Sell Underworld items

Allows or forbids Underworld items under the same name, prefix and suffix rules.

Do not sell smelt / auction-list items

Protects items already planned for Smelting or present on the auction list.

Refresh shop automatically with cloth when full

Uses cloth to refresh a full shop so another scan can continue.

Sell selected / Sell all

Manual actions apply the active rules immediately to selected candidates or all eligible candidates.

Shop

Shop high quality items

Enables the shop scan and purchase pass for items matching the configured quality and item rules.

Item quality and type filters

Define which shop items are worth buying. Name, resource, level and Underworld rules narrow the result.

Use cloth to refresh

Allows a full shop to be refreshed with cloth, then scanned again.

Auction

Enable auction

Turns automatic auction searching and bidding on.

Search rule

Choose Name Contains, Contains Any, Contains Resource, Contains New Scroll, Name Contains Word, Underworld status, level, starts with or ends with.

Quality, item type and price limits

Filter what can be bid on and set the maximum acceptable price or other configured limits.

Turbo Mode

Runs a short, focused bid pass with tighter timing. It does not replace the normal auction rules.

04 / Crafting & planning

Crafting and planning

Forge and Smelt

Forge / Smelt tabs

Forge selects a recipe and performs the craft; Smelt applies the item rules and queues eligible items.

Item rules

Use name, quality, level, item type, prefix and suffix conditions to decide what may be smelted.

Material rules

Protect or require specific resources before a forge or smelt action is sent.

Queue and planned items

Queued work stays reserved so Auto sell and unrelated inventory actions do not take the same item.

Repair Items

Enable repair

Looks for equipment below the configured condition threshold.

Condition threshold

Sets the percentage below which an item becomes a repair candidate.

Repair scope

Chooses which equipment or inventory spaces may be repaired.

Check again after

When no item can be repaired because resources are missing, this delay prevents constant checks. The minimum is intentionally several minutes so other work can continue.

Repair materials

Defines which materials may be consumed for each repair. Items remain protected when the required resource is unavailable.

Character Planner

Current / Planned

Current is read from the live character. Planned is a separate build that changes only when you edit or reset it.

Equipment slots

Choose an item for each slot and compare its stats, quality, effects, prefixes, suffixes and conditioning.

Reset planned / Hard reset

Copies live equipment into the planned build. This is the explicit reset action; opening the planner does not replace your plan.

Material calculation

Shows needed, owned and missing forging materials for the planned equipment.

Use Costumes

Enable costume use

Allows GBot to activate costumes when the configured condition is met.

Normal, Medium, Hard and healing costumes

Each option controls whether that costume group may be selected for the relevant activity.

Underworld costume handling

Underworld preparation has its own availability and recovery logic so normal costume rotation does not consume its choices.

Pacts & Buffs

Enable pact or buff

Allows the selected pact and buff actions to run when their timers make them due.

Selected effects

Choose which available effects may be applied. The game response is checked before GBot continues.

Underworld preparation

Applies required buffs before the first Underworld fight and releases the task after the result is confirmed.

05 / Account & control

Account and control

Quests

Enable quests

Allows GBot to read available quests and complete eligible quest actions alongside the main routine.

Quest filters and priorities

Choose which quest types or rewards are preferred and how long a quest may occupy the routine.

Quest stats

Shows recorded quest results and lets you reset the displayed period where available.

Telegram

Bot token

Connects your own BotFather bot. The token belongs to your Telegram bot and is stored per character.

Pairing

Pairs a Telegram chat with the current character so only the paired chat can control or query that character.

Status and control commands

Use supported commands such as status, start, stop and send to receive information or control the running script remotely.

Game performance

Performance mode

Reduces unnecessary page work and visual updates while the engine runs.

Animation and background options

Adjusts how much visual activity the game keeps while GBot performs background actions.

Engine controls

Start / Stop

Start begins the scheduler. Stop cancels future work and leaves the game state untouched.

Pause

Temporarily defers normal work while the pause state is active. Recovery and safety checks can still finish an already-confirmed operation.

Status

Waiting for work means no eligible task is due at that moment. The status line changes when a feature owns the next action.

Automatic recovery

Long actions keep checkpoints and reconcile after navigation or reload. This is why a package, repair or Underworld action can continue without repeating an already completed request.