Add it to your guild's server

1. Press Add the bot to a server above (you need Manage Server on that server).
2. Pick your guild's server and press Authorize. The bot asks only for View Channels, Send Messages, Embed Links and Read Message History.
3. Type / in any channel: the Valor Tools commands show up in the list. /help lists them all.
4. Guild leaders: link the server to your guild with /guild connect and pick your channels (see Your guild).

If a channel is locked down, give the bot's role those four permissions there too. It never pings anyone and doesn't read your chat: it only sees the commands and buttons people use with it, and a message when someone right-clicks it and picks one of the bot's Apps.

Link your Valor Tools account

Anyone can use /sim, /launch, /unit, /building, /help and /contact. Everything else acts as you on Valor Tools, so it needs your Discord linked. Linking lets you:

• pick targets and get your launch times from a guild op card (your picks are the same ones the Planner shows);
• use your Planner's worlds and city names in /launch, and see your next hours with /tonight;
• use your guild's claims, scout reports, announcements, support requests and defenses;
• show your player card with /card;
• get your alerts as Discord DMs, and sign in to this site with Discord.

Press Link my Discord above (or type /link in Discord, or use the Discord card on your Account page). You sign in here, Discord asks you to confirm, and you're done. /unlink undoes it.

Every command

In Discord, /help shows this list (only you see it; public: True shows it to the channel), and /help command: opens one command in full, with its examples and every option. Most answers only you can see; the ones marked linked need your Discord linked.

Battles and game numbers

/sim — a battle

Type the troops the way you would in game chat (see Troop short forms). Wall, morale, luck, what the ballistas aim at, medics and prestige are optional. The answer shows the winner, attack against defense, losses and survivors, the wall before and after, the loyalty drop and haul, with a button to open the same battle in the Sim.

• link: paste a battle link (…/s/…) to show that battle.
• target: the defender and wall from your guild's latest scout report of that city (linked; only you see it).
• private: True if only you should see the answer.

/unit and /building — game numbers

From the live game config, like the Sim.

/unit gives attack and defense (research 1–3), speed, haul, cost, population and training time. /building gives what that level costs, the population it adds, points, what it needs first, and the build time at your City Hall level and world speed (world_speed:, default 1).

Troop short forms

The same letters as in game. Capitals are fine, and so are the full names.

• 500k 200z 50r: spaces are enough between troops; commas work too.
• 5k l is 5,000 lancers; 1,500 k is 1,500 knights; 2k k is 2,000 knights. 500k on its own is 500 knights.
• r2 or lvl 3 right after a troop is its research level: 200z r2.

Launch times and your next hours

/launch — send times

Where you're going, the slowest troop you send, and when it should land. Without land: you get the travel time instead. Only you see the answer unless you add public: True.

• from: coordinates, or (linked accounts) your city names from the Planner, or all. Up to 25 cities at once.
• land: 21:30, 21:30:00.500, 5:00 pm, a full date, or a Discord timestamp. A time without a date is the next one to come.
• tz: your time zone, e.g. America/Chicago or UTC-5. Linked accounts default to the time zone of your alerts; otherwise it's UTC.
• world: one of your Planner's worlds (its speeds and map size); otherwise the default world.

/tonight and /incoming

/tonight (linked) is your next 24 hours in one private list: launches with reminders, defense launch-by times and your support pledges, plus build and recruit queues and incoming attacks when you have the Dashboard's live game data. The first five come with buttons to their place on the site; world: shows one world only.

/incoming shows the attacks heading for your cities from the Dashboard's Incoming Intel, city by city, capture attempts (Scholar pace) first, with Defend buttons that open the Defense tab. It needs your Valor account linked on the Dashboard with its Incoming Intel (open to admins while it's being tested).

Guild ops in Discord

For op leaders (and your guild's officers)

1. Share the op from the Planner as usual (Share as guild op).
2. In your guild's channel, type /op connect and pick the op from the list (or paste its link). If the leader set an ops channel with /guild here, new ops on the Guild tab post there by themselves.
3. The bot posts the op's live card: every target with its landing time in each reader's own time zone, the timed-capture waves, and who is hitting what.

The card updates itself when you change the op or players pick targets, and the bot posts a short note saying what you changed. It also posts a heads-up 60, 15 and 2 minutes before each landing (add callouts: False to skip those). /op disconnect stops it; deleting the op marks the card as taken down. Connecting the op in another channel moves the card there.

/op strength (or the card's Strength button) shows what the players bring to each target and wave, who shares what and how many scholars are short, with Ask for numbers (once every 20 minutes).

For players

1. Press Pick my targets on the card. A menu only you can see opens.
2. Choose every target you're hitting; for a timed capture, the waves you're sending (rams, clearing, capture). Changes save when you close the menu.
3. Press My launch times on the card, or type /op mine: your launch times for the targets you picked, worked out from your Planner cities exactly like the Planner's Launch schedule, with Remind me.

One player captures each timed target: whoever picks it first holds it. The leader (and the officers of the op's guild) can take a capture over or free it from their own menu, and the player who held it is told. Officers can also connect and disconnect the op's card, and change the op's targets from their Planner (Edit the op). Anyone in the guild can look at an op privately with /op show.

Your guild in Discord

The Guild tab is your guild's shared board: claims (so nobody hits the same city twice), scout reports, announcements, members, support requests and your guild ops. All of it works in Discord too.

For the leader (once)

1. Make the guild on the Guild tab, add the bot to your server, and type /guild connect there (you need Manage Server).
2. In each channel you want to use, type /guild here and pick what goes there: the claims board (one message the bot keeps current, and pins if it's allowed to), guild op cards, scout reports, announcements, support requests and defense, or officers only (officer announcements; make sure only officers can see that channel).
3. In Settings on the Guild tab, pick the member role (players with it join the guild from Discord; losing it takes them out) and the officer role. The bot checks players' roles whenever they use it.

/guild disconnect unlinks the server (Manage Server too).

For everyone

• /guild join joins this server's guild (you need its member role). /guild show is your guild at a glance; /guild members is the roster: in-game names, roles, Discord linked or not, when they joined (public: True shows it to the channel).
• /claim target: 503,520 claims a city for the guild (add city:, owner:, note:, and time: 12h or 3d for how long: up to the guild's maximum, which is also what you get without it).
• /editclaim target: 503,520 changes it: city:, owner:, note: (a dash clears one), time:, move_to: if it's on the wrong city, or renew: True to start its time again.
• /release target: 503,520 gives it up (done: True when it's captured or cleared, delete: True for one made by mistake). Officers can change, release or delete anyone's claim.
• /claims shows the board (public: True for the channel); /claims mine: True shows yours with Release and Renew (Renew all renews every one at once).
• /intel target: 503,520: is it taken, and what did the last scout see there (troops, wall, buildings, resources, kept screenshots), with Sim this. Without a target, /intel lists the guild's newest scout reports (owner: and world: narrow them).
• /scout target: 503,520 troops: 81l 372s 351z 40sc 1345k wall: 0 saves a scout report (resources: 12400 9800 5100 adds what was spied). Or attach the spy report instead: /scout screenshot: (see Screenshots).
• Officers: /announce message: … sends an announcement to the guild's alerts and DMs, and posts it in the announcements channel (officers_only: True for officers only, pin: True to pin it on the Guild tab). With the Guild Pass, later: in 2h (or 21:00, or a date) sets it for later, and cancel: takes one back.

If you're in more than one guild, add guild: to say which.

Support requests and defense

Support requests

1. /support ask target: 427,379 land: 21:11:40 posts a request card in the guild's support channel. Add mode: (land by the time to stack, or at exactly the time to snipe the scholars, with until: when the first scholar lands), wanted:, troops:, attack: and note:.
2. Guildmates press Pledge support on the card (or type /support pledge) and pick one of their Planner cities in a private menu, with its launch-by time. Each pledge gets a DM reminder before it's time to launch; the card shows the pledges and says when it's covered.
3. /support list shows the guild's open requests. /support close closes, calls off or opens one again (the player who asked, or an officer). Asking again with a new time moves the pledges' launch-by times and reminders.

Your defenses

• /defense show (private): the attacks, capture odds, your plan from the Defense tab and launch-by times, with Remind me, Ask the guild (a support request with the plan's own times) and Share with the guild.
• /defense share posts a live card in the support channel that follows your plan as you change it. It never names your cities or your supporters' cities. /defense stop takes it down.
• /defense captures post: True posts capture attempts on your cities (attacks at Scholar pace, found by the Incoming Intel add-on) in the support channel, with Ask the guild and, with the Guild Pass, Who can reach in time (guildmates who share their defensive troops in the War room, privately; never how many).

Screenshots

Send the bot a screenshot from the game and it reads it for you. Type /screenshot and attach the picture, or right-click (long-press) a message with one › Apps › Read screenshot. What it read only you can see, so you can check it first.

• A spy report: the city, its owner, the wall, the troops and the resources. Save it as your guild's scout report, Edit, then save to fix a number, or Sim this.
• Your Rally Point: your troops at home and in the city, with Attack with these and Defend with these in the Sim. Add target: 503,520 and the bot sims your attack against that city's last scout report.
• Anything else, like a battle report: Keep it on a city (note: adds a note), and your guild sees it on the Guild tab and with /intel.

The bot reads screenshots with an AI model, which can misread a number now and then, so always check before you save. Check in the reader opens the same picture in the site's own reader, which runs on your phone or computer. If the bot can't read it (it reads a limited number a day), it gives you that button straight away.

Valor Tools doesn't keep your pictures. A screenshot you keep for the guild stays on Discord: in your own message, or posted by the bot in the guild's scout reports channel.

Right-click a message › Apps

Right-click any message (long-press on a phone) › Apps:

• Claim this, Is it taken? and Plan attack read the coordinates in that message (Plan attack adds the city to your Planner).
• Log as scout saves the scout report written out in it, or reads its picture.
• Read screenshot reads the picture in it, like /screenshot.

Player cards

/card shows your player card: your career kill scores added up across your worlds, and your titles, with Open card to see it on the site. Make yours, and choose who can see it, on your Account page › Player card.

• Your own card needs your Discord linked. It shows to the channel; add private: True to show it only to you. A card open to your guildmates only is always shown just to you.
• player: shows someone else's card by in-game name, if it's open to everyone. Only you see it unless you add public: True.

Alerts by DM

Type /alerts dm: True, or tick Send my alerts as Discord DMs on your Account page or in the app's bell menu. You get the same alerts as the app, with the same settings: launch reminders, guild op changes, target picks, announcements, support and defense reminders, and gifts. Some come with buttons (Pick my targets, Defend, My pledges). The bot sends a test DM straight away.

Discord only lets the bot DM you if you're in a server that has the bot and you allow DMs from that server's members (the server's name → Privacy Settings). If a DM can't be delivered, DMs switch off and your Account page says why.

Contact Valor Support

Type /contact and pick what it's about (a purchase, your account, something that isn't working, your data, anything else), then say what happened. You get a private thread with the Valor Support team, and they answer there. Press Reply in the thread to add anything.

• Anyone can use it. With your Discord linked (/link) and your Valor game account linked on your Dashboard, the team knows it's you straight away.
• Never post passwords, card numbers or email addresses. Valor Support will never ask for them.
• No Discord? Write to us at support.valor-reforged-tools.com.

If something's wrong

• Not sure how a command works: type /help command: and pick it. You get what it does, who can use it, examples and every option.
• "I can't post here" on /op connect or /guild here: give the bot View Channels, Send Messages, Embed Links and Read Message History in that channel.
• "Only the op's leader can connect it": the player who shared the op, or an officer of its guild, connects it with their own linked Discord.
• The buttons ask me to link: link your Discord once (above); the buttons then act as you.
• A guild command says I'm not in the guild: ask your leader for the member role, then /guild join.
• No DMs: check the server's Privacy Settings, then run /alerts dm: True again for a new test DM.
• Times look off: /launch uses the time zone in tz: (or your alerts' time zone); the exact send time is shown to the millisecond. Times on cards are Discord timestamps, shown in each reader's own time zone.
• A new command doesn't show up: Discord can take a minute to update the list. Restart Discord (or press Ctrl+R / Cmd+R) if it's still missing.
• Anything else: support@quarkgames.com.