# โ๏ธ Forever Wars
### Turn the open world into a living war. Take territory, hold your guild's keep, and rally your faction when the horns sound.
**Forever Wars** adds a player-run campaign to Azeroth's open world. Capture objectives on seven war fronts, fight over guild keeps and outposts, earn coins in contested mines, and climb the weekly rankings. There's no battleground queue and no separate server: the war happens wherever you are.
> Made for **WoW Forever** (also loads on Classic Era clients). English interface.
---
## ๐บ๏ธ The Territory War
### Seven war fronts
**Arathi Highlands · Loch Modan · Durotar · Ashenvale · Elwynn Forest · Redridge Mountains**, plus **Southshore vs Tarren Mill** in Hillsbrad Foothills.
- Each regular front is a network of capture points leading toward the enemy faction's capital. Take objectives along your faction's routes to unlock the next ones.
- **To capture**, stand in the circle **on foot with PvP enabled**. Enemies in the circle can freeze your progress or push it back, and leaving the circle lets it decay.
- **Taking the enemy capital wins the front.** Your faction gains weekly Territory Domination, and a 15-minute truce follows.
- Hillsbrad is a two-town tug of war between Tarren Mill and Southshore.
### ๐ฐ Guild keeps (5)
In **Stonetalon Mountains, the Wetlands, the Badlands, the Barrens and Mulgore**.
- They can be attacked at any time. A guild member needs **10 minutes** of uncontested capture time to claim one.
- Only the opposing faction can take a keep from you. It stays yours until the enemy captures it or the weekly reset.
### ๐ก๏ธ Guild outposts (9)
One on each regular front, plus **Savix Chapel** (Silverpine), **Aeythyr Lodge** (Eastern Plaguelands) and **Lesi's Bear Cave** (Darkshore).
- The base capture time is **5 minutes**, and you need to be in a guild to capture one.
- Holding a front's outpost makes the enemy take **30 seconds longer** on that front's ordinary points.
### โ๏ธ Mines and coins
- Spend time inside a **mine's circle** or a short-lived **coin spot** to earn coins (an addon resource, not WoW gold). Mining ore nodes in a mine gives a bonus. You can hold up to **120** coins.
- Mines have limited stock that regenerates. You get an alert when the enemy is mining.
- Spend coins on **โ๏ธ Attack** (your faction's next capture is faster) or **๐ก๏ธ Reinforce** (the next enemy capture of a friendly point takes longer). These only change capture timers, never combat stats.
### ๐ Front of the Day
One front is featured each day. Honorable kills there earn extra coins.
---
## ๐ฏ Call to Arms
Click **Call to Arms** (or type `/fwm cta`) and every ally running the addon hears a **war horn** and sees a **raid warning** with your front and zone. It works across guilds, groups and friends, thanks to a hidden relay network. Your faction shares a 4-hour cooldown.
## ๐๏ธ War General
A **party or raid leader** on an active front can take **Command** and become the faction's **General**. Allies see your banner on the world map and minimap. Both factions are warned when a General takes command, and when one falls (with the killer named).
## ๐ฉธ Blood Bounties
Reach a **10-kill streak** and you're marked with a Blood Bounty: enemies can see you on their map until you die. Claiming a bounty earns bonus kill credit.
## ๐ Most Wanted
The **top 5 enemy killers** of the week get a skull on their nameplate, and an optional alert fires when one is close.
## ๐ Leaderboards and Hall of Fame
- Weekly player and guild rankings for open-world honorable kills (at any level, anywhere outside instances), plus keep, outpost and point captures.
- The **weekly reset** (Tuesday 15:00 UTC on NA) starts a new campaign: fresh rankings, domination and territory.
- The **Hall of Fame** keeps past weeks' winning faction, top killers, guilds and capturers.
## ๐งญ Layer ID
A small `#1178`-style badge shows your current layer, and its tooltip lists synced players who are on a different layer. Rampage alerts carry the layer tag too.
---
## ๐ฌ Chat alerts
Every alert starts with a colored tag: **red** for urgent, **gold** for news, **green** for good news for your side. Guild and player names carry their faction crest. A few examples:
```
[Forever War Map] Savanna Bastion: <Blackrock Vanguard> (A) started an assault on <Iron Wolves> (H).
[Forever War Map] Astranaar: under attack by <Silver Hand> (A)!
[Forever War Map] Allied guild <Iron Wolves> (H) on a rampage: 23+ HK by 8+ members in Wetlands!
[Forever War Map] Thrallson calls the faction: Astranaar (Ashenvale)!
[Forever War Map] General Saelith has fallen! Slain by Gorrak.
[Forever War Map] High-priority target close: Varimathras (rank #2 Alliance, 41 kills this week).
```
*(In game, the (H)/(A) markers are faction crest icons.)* You can turn individual alert types on or off with `/fwm alerts`, and send them to their own chat tab with `/fwm chattab`.
## ๐ฅ๏ธ On-screen HUD
Step into any control point and a HUD appears with your coins, the capture progress bar, Attack and Reinforce buttons, the holder's badge (click the arrows to pick another keep or outpost), and a status banner such as **"Keep Assault"** or **"You are on the keep point."** It's draggable, and you can close it until you enter the next circle.
## ๐บ๏ธ World map and minimap
- **World map:** capture circles in faction colors (they pulse while being taken), keep and outpost towers with guild labels, mines, capture timers, and a faction logo on each continent showing who dominates.
- **Minimap:** keep and outpost towers, red and blue tints over held areas, grey circles on unheld points, the General's banner, and pulsing yellow coin spots.
---
## โจ๏ธ Commands
| Command | What it does |
|---|---|
| `/fwm` or `/fwm help` | List all commands |
| `/fwm show` | Open or close the main panel (also the minimap button) |
| `/fwm guide` | Rules, page by page |
| `/fwm lb` | Weekly leaderboard |
| `/fwm hall` | Hall of Fame |
| `/fwm groups` | PvP groups |
| `/fwm cta [zone] [note]` | Call to Arms |
| `/fwm command` | Become your faction's General (party/raid leader) |
| `/fwm fronts` | List the war fronts |
| `/fwm report [front]` | This week's battle report |
| `/fwm way [zone] <x> <y>` | Map pin and arrow to a spot |
| `/fwm wanted [on\|off]` | Most Wanted list and alerts |
| `/fwm guildkills [allies] [on\|off]` | Guild rampage alerts |
| `/fwm alerts` | Choose alert types and chat frame |
| `/fwm chattab` | Create a dedicated chat tab |
| `/fwm macro` | Action bar shortcut |
| `/fwm hud on\|off\|toggle` | Floating coins display |
| `/fwm sync` / `/fwm network` | Ask for a catch-up / check sync health |
| `/fwm status` / `/fwm where` | War state summary / your zone, front, layer and ruleset |
| `/fwm ruleset [pvp\|normal\|rp\|hardcore]` | Your realm's ruleset (data kept separate) |
| `/fwm export` / `/fwm import <code>` | Discord export / apply the bot's war state |
| `/fwm config` | Options page |
| `/fwm bug` | Copyable bug report |
---
## ๐ Quick start
1. Install the addon and log in. A short welcome popup explains the basics.
2. Click the **minimap button** (or `/fwm show`) to open the war panel.
3. Pick a front, type `/pvp` if you aren't flagged, and head to an available objective. The **Next Objective** card tells you where.
4. Stand in the circle until it's yours. Bring friends! ๐ฅ
You don't need to join anything: updates travel through your guild, group, Battle.net friends and the addon's own hidden channel.
---
## ๐ค Discord bot, web map and uploader (optional)
Bring the war to your guild's Discord:
- **Live war map image**, updated in place, plus a **feed** of kills, captures, Calls to Arms and Generals.
- **Leaderboards, Most Wanted, Blood Bounties, Hall of Fame** and a weekly reset announcement.
- An **interactive web war map** (Kalimdor and Eastern Kingdoms) with clickable territories, keeps and outposts.
- `/warstate` gives a code that pastes straight into the addon with `/fwm import`.
To send your records automatically, use the **Forever Wars Uploader**, a small companion app for Windows (also Mac and Linux with Python). It watches the addon's saved data and posts new records after you log out or `/reload`.
**The uploader is a separate download and isn't included in this addon:** ๐ **[Download the uploader (GitHub Releases)](https://github.com/<OWNER>/<REPO>/releases)**
After installing it, type `/linkuploader` in your Discord and paste the code into the app. No uploader? `/fwm export` and the bot's `/submitkills` work too.
---
## โ FAQ
**Do I need the Discord bot?** No. The addon works on its own and shares data player-to-player.
**Does it give combat advantages?** No. Coins only change capture timers. Nothing touches your stats, gear or abilities.
**Do battlegrounds, dungeons or raids count?** No. Only open-world honorable kills count toward the rankings.
**Why does my map or leaderboard look empty?** Data comes from the players your client can reach. Give it a minute after login, or try `/fwm sync`. `/fwm network` shows sync health.
**Can everyone fight on the same layer?** The addon shares the campaign across layers but can't move you between them. Group up with the players involved to join their fight. The layer badge shows who's elsewhere.
**PvP, Normal, RP and Hardcore realms?** Each ruleset keeps its own separate campaign data.
**Will it spam my chat?** Every alert type can be toggled with `/fwm alerts`, or sent to its own tab with `/fwm chattab`.
---
## ๐งฉ Compatibility
- **WoW Forever** client (the primary target) and **Classic Era** clients (Interface 11508/11509).
- Saved data: `ForeverWarMapDB` (account-wide) and `ForeverWarMapCharDB` (per character).
- Interface language: English.
## ๐ฌ Support and community
- Bug? Type `/fwm bug` and paste the block into a comment or our Discord.
- ๐ **[Join the Discord]
*Forever Wars © 2026 GhostKitin. All rights reserved.*