HeraldAlliance

HeraldAlliance is a hosted Discord bot for Goodgame Empire alliances. It monitors attacks, tracks birds, logs chat, and automatically stations troops when members are under attack. No downloads are required — simply contact on Discord to set up the bot.

Features are fully customizable to match specific alliance needs and preferences.

Contact on Discord to get started with a free trial →

Setup & Requirements

Requirements

  • 1× Discord Server — Setup assistance available to create/customize/design it
  • 1× Trusted Alt Account — Must be in the alliance
  • Password Storage — Alt account and member passwords are securely stored in the database for auto-station functionality
  • Configuration Info — Desired settings and preferences

Keep Updated

Please inform the developer if any of the following details change, as outdated information may cause the bot to malfunction:

  • Alt account name or password
  • Enemy alliance names
  • Alliance member in-game name changes
  • Alliance member password changes (for Auto Station)
  • Alliance members joining or leaving the team
  • Alliance members' new Discord accounts

Troubleshooting:

If the in-game alt account is offline or the Discord bot is offline, the bot is down, likely due to an error. Instantly inform the developer via Discord if any error occurs!

Auto-reconnection is built in so the bot should recover from game maintenances or connection/application errors.

Live Attack Alerts

Monitors incoming attacks and captures against alliance members via Discord. Notifies attacked players and loggers (those who can log in to the account).

Features (All Customizable)

  • Incoming attacks with detailed attack information
  • Incoming capture notifications (outposts, capital, metro, etc.)
  • Attack details from the attacker
  • Defense details from the defender
  • Event attack details (includes the name of the event attacker)
  • Player & logger & role notifications
  • Displays if the currently attacked player is online or offline
  • Notifications only for attacks larger than an attack threshold (e.g., 1500 attackers)
  • Notifications only when defenders exceed defense threshold (e.g., 2500 defenders)
  • Bypass attack threshold for attacks dealing support tools damage
  • Towers, Monus, Labs, Resource Villages, Storm, Berimond attack notifications

Auto Station

When an incoming attack is detected, the bot logs into that account and stations troops from the attacked castle to the configured team bird for 12 hours.

How It Works

  • The bot only logs in if the attacked castle has troops ≥ the Defense Threshold (configurable per alliance, e.g., 2.5k)
  • Example: if your green main castle (1,000,000 troops) is attacked, only the troops from that castle are moved to the bird for 12h — other castles stay put
  • Only VIP commanders are used for stationing (no normal commanders)
  • If the stationed castle has stables & feathers, it will use them; otherwise it won't use a horse
  • All troops are sent to a fixed alliance bird account (team castle)
  • Logs & status messages appear in the auto-station Discord channel

Temporarily Deactivate for Your Account

Send this in-game message into the alliance chat from your account: d[number_of_hours]

Examples: d0.2, d0.5, d0.75, d1, d2, d10, d20, d24

  • The number = hours the bot is disabled for your account
  • number × 60 = minutes disabled
  • 0.2 × 60 = 12 minutes disabled
  • 0.5 × 60 = 30 minutes disabled
  • 1 × 60 = 60 minutes disabled, etc.
  • After the time expires, auto stationing is re-enabled automatically
  • Use d0 to re-enable immediately

Important Mistakes to Avoid

  • NEVER change account username or password without providing updates first. Credentials are stored in the database — changing them will break the bot for that account!
  • No available VIP commanders / VIP not unlocked — VIP commanders must be ready. If using rubies per VIP commander (125 rubies), ensure ruby confirmation trigger is set above that (e.g., 130, 150, 250).
  • Hall of Legends travel cost reduction not maxed — set attack-side travel cost reduction (Penny Pincher) to max to reduce stationing costs.
  • Don't assume OG prevents stationing — if there are troops in a castle and it's attacked, the bot will log in and move them regardless of OG.
  • If kicked while the bot is stationing: don't immediately re-login — wait ~30 seconds for the bot to finish to avoid a double-login problem. Check the dedicated auto-station channel to see what the bot is doing. Especially wait if seeing: "Stationing x amount of troops in progress..."

/station Command

The Auto Station feature also includes a /station Discord command. This allows you to manually station all troops from your assigned accounts on demand (whenever you want), not just during attacks.

Bird Tracker

Monitor players under "bird" status for the alliance and multiple enemy alliances. Receive notifications when "bird" status for any team or enemy player is set to expire within one day.

Features (All Customizable)

  • Overview of your alliance's birds & non-birds
  • Overview of enemy alliance birds & targets (multiple enemy alliances supported)
  • Automatic notifications for alliance bird expiry

Chat Logger

Monitors in-game chat and automatically forwards every message to a designated channel in Discord. Ensures all in-game messages are logged and seamlessly integrated with Discord chat.

Features (Customizable)

  • Specific Discord channel for message logging
  • Real-time message forwarding
  • Complete chat history preservation

Attack Tracker

Monitors the number of attacks each player initiates, providing insight into who is actively engaging in combat. Statistics refresh weekly.

Features (Customizable)

  • Specific Discord channel for weekly stats
  • Automated weekly reports
  • Identify active vs. passive players

Loot List Tracker

Monitors loot each player collects per week, providing insight into who is actively looting targets. Statistics are created automatically once per week at the week's end.

Features (Customizable)

  • Specific Discord channel for weekly stats
  • Automated weekly reports
  • Identify active vs. passive looters

HeraldApp

HeraldApp is a downloadable desktop application that provides advanced browser automation for Goodgame Empire. It is safer than traditional bots because it runs in a real browser with advanced anti-detection. No passwords are required — users log in themselves.

Available for Windows, macOS, and Linux.

Download HeraldApp →

Quick Start

1

Download & install HeraldApp for your OS

2

Click Start to open the browser and log into your game account

3

Configure your settings, click Apply, and you're running

Control Buttons

  • Start — Opens a browser window and loads the game. Log in with your account.
  • Apply — Saves your current settings and activates the bot with the configured mode.
  • Stop — Stops the bot. The browser stays open so you can play manually.

Auto Attack Mode

The only mode for now. Automatically attacks your configured targets using available commanders.

Warning: Incorrect settings (wrong coordinates, wrong world, etc.) can trigger in-game errors and risk an account ban. Always double-check your config.

Settings

  • Commander Usage — What % of your commanders to use per round (25/50/75/100%)
  • Smart Troops — Prioritizes food troops, then weak mead, then special troops, beef last
  • Only Shield Maiden — Restricts to Shield Maiden commanders only
  • Use-Feather — Uses the feather horse item if you have 1000+, otherwise falls back to coin horse
  • Attack Delay — Seconds between each individual attack (default: 6s)
  • Round Delay — Minutes between complete attack rounds (default: 4min)
  • Attack Lines — Add multiple targets with wave presets (1-30), X/Y coordinates, world selection, and NPC toggle

Always-On Features

These run regardless of which mode is active:

  • Auto Timeskips — Automatically uses the best timeskip item when troops are traveling, saving your rarer items for longer waits
  • Auto Khan Taunt — Taunts Khan when available not working yet

Browser Profiles

Each profile is a separate game account with its own cookies and login state.

  • Profile dropdown — Select which account to load (before starting)
  • + New — Create a new profile
  • Folder — Open the profiles folder on your computer
  • A default profile is created automatically on first launch

Settings Import / Export

Save and load your attack configuration as a JSON file.

  • Export — Saves your current settings to a file
  • Import — Loads settings from a previously saved file
  • Folder — Opens the settings folder on your computer

Shutdown Timer

Set hours and minutes, click Start on the timer. The app and browser close automatically when time's up. Useful for overnight runs.

Important Notes

  • Keep your computer awake — The bot needs an active internet connection. Screen sleep is fine, but don't let the PC sleep. Keep the always on internet connection setting enabled for your PC.
  • In-game errors? Stop immediately — If you see error pop-ups in the game, hit Stop. The bot is doing something invalid.
  • No auto-reconnect — If the bot disconnects (internet loss, crash), restart or refresh the browser manually.

Disclaimer: Using bots may violate the game's Terms of Service. Use at your own risk.