The Torning Discord bot

The Torning bot brings your Torning data into Discord. It does three kinds of work:

• Answers slash commands from you and your faction mates: chain status, war targets, your OC seat, vault balance, market prices and more.
• Posts faction alerts into the channels your leadership picks: crimes, chains, wars, retaliation, banking, armoury and competitions.
• Sends you direct messages about your own account: full bars, finished cooldowns, landing flights, and the watches you set.

Using the bot is free for every member. Putting it in a server needs Ultra (see below).

There is no code to copy and nothing to log in to. The bot works out who you are from the Discord account linked to your Torn profile.

1. In Torn, go to Settings, then Account, then Discord, and link your Discord account.
2. Make sure you have signed in to Torning at least once with your API key.
3. Use any bot command (for example /whoami). The bot reads the link from Torn and recognises you.

Account › Discord shows your progress in the Connection card: Linked in Torn, then Recognised by the bot. Once recognised it shows the Discord name it knows you by. If you change the link in Torn, the bot follows.

When the bot does not know you

• No Discord link in Torn: add it in Torn and run the command again.
• Linked in Torn but never signed in to Torning: sign in once with your API key.
• Torning's Terms or Privacy Policy changed: the bot stops acting for you (no commands, no alerts) until you sign in and accept them. /whoami and /verify still answer so you can see what is wrong.

/whoami shows the Torn account you are linked to, your faction, when you were linked, and whether you still need to accept the current policies.

A faction can run the bot in its server when:

• one of the faction's leaders has Ultra (it unlocks for the whole faction), and
• the Discord module is switched on in Faction › Settings › Manage.

Inviting the bot

You can get the invite link from two places:

• Account › Discord, under Connection: Invite the bot to a server. This button needs Ultra on your own account; without it you see Invite the bot with Ultra.
• Faction › Settings › Discord, on the Overview tab before a server is linked: Invite the bot to Discord.

Adding a bot to a server needs the Manage Server permission on the Discord side. The invite asks for the permissions the bot uses: Administrator (so it can post in private channels such as a bankers channel), View Channels, Send Messages, Embed Links and Manage Roles.

Linking the server with /setup

1. In any channel of the server, run /setup.
2. The bot checks who you are through Torn and links the server to your faction.
3. Go to Faction › Settings › Discord to choose roles and alerts.

Who can run /setup:

• On Discord, only members with Manage Server see the command.
• On Torning, you must be a leader or co-leader, or hold a position with the Manage Discord permission.
• The Discord module must already be on, and the server cannot be linked to another faction.

If the same faction links a server again, its roles and alert channels are kept. Unlink server on the Overview tab disconnects it.

The Discord settings page

Faction › Settings › Discord is open to leaders, co-leaders and positions with Manage Discord. It has six tabs: Overview, Roles, Alerts, Giveaways, Commands and Delivery log.

Once a server is linked, Overview shows Server Connected, how many members hold a bot role, how many alerts are on, and the result of the last member check. Warnings about roles also show here.

On the Roles tab you point the bot at roles in your server. Pick each one from the list, or paste a role ID if Torning cannot read your roles yet (turn on Developer Mode in Discord, right-click a role and choose Copy Role ID).

A member holds either the faction member role or the verified role, never both, depending on whether they are in your faction. When someone joins or leaves the faction, the bot swaps their role on its own. It also checks the whole server every few hours.

The bot never hands out the banker or giveaway roles, so you can point them at roles you manage yourself.

Nicknames

Verified members get their nickname set to Name [ID], using their Torn name and ID. Discord caps nicknames at 32 characters, so a long name is shortened and the ID always fits.

/verify

Resync roles on the Overview tab does the same as /verify all.

Tips

• Discord only lets the bot change roles below its own. If you see "Move the Torning bot's role above it in Server Settings", drag the bot's role higher.
• If vault requests are on but no banker role is set, the Roles tab is flagged, because nobody could settle a request.

The Alerts tab lists every alert your faction can use. An alert only appears when the module it reads from is on. To switch one on you need Manage Discord (leaders and co-leaders always have it) and also the permission to see the data it posts, because whoever picks the channel decides who reads it.

The banking alerts depend on Accounting, which is in private beta, so they only appear for factions it has been switched on for.

Extra Torn API calls

• Live retaliation alert adds about 1,440 Torn API calls a day against one member's key.
• The two chain alerts read the chain every 30 seconds while your faction is chaining, and once every two minutes otherwise.

Each alert is a row with a switch, a channel, a mention setting and two buttons.

1. Choose a channel. An alert cannot be switched on until it has one ("Pick a channel first"). If Torning cannot read your channels, paste a channel ID instead.
2. Flip the switch to turn it on.
3. Pick a mention: No ping, Ping the member, or Ping a server role (then choose the Role to ping).
4. Set the timing where the alert has one (see below).

Each group header has Set channel for all with Apply, plus Enable all and Disable all. Use the category chips or Search alerts to narrow the list.

Timing options

Preview and test

• The eye button (Preview embed) shows the message as Discord would draw it, without posting anything.
• The paper plane button (Send a test message) posts a sample to the alert's channel. Use it to check the bot can post there.

Pausing notifications

Use Pause notifications at the top of the Alerts tab to quieten whole categories for an event.

1. Tick the Alert categories to pause.
2. Set the Start (leave it for now) and End. Times follow your TCT / Local clock switch.
3. Write a Reason or tap a preset (Ranked war, Chain, Raid, Maintenance). The channel is told the reason.
4. Press Pause.

The bot announces in the channel when a pause starts and when it ends. A running pause shows Resume now; a scheduled one shows Cancel.

Delivery log

The Delivery log tab lists the last 25 posts to your server, filtered by All, Delivered or Failed. A failed post shows Discord's error, which is usually the first place to look when an alert did not appear.

Every command has an access level:

Torning sets these levels; the defaults are shown in the command tables below. On top of the level, a command that reads a module (Chains, Accounting) refuses to run while that module is off, and tells you a leader can turn it on.

The Commands tab on Faction › Settings › Discord lists every command with its current status for your faction: Public (Everyone), Faction Members, Leaders Only, Module Disabled or Admin Disabled. Filter it by category.

These are Public and work for anyone the bot recognises. Replies are private unless noted.

/alerts

Turning an alert on from Discord also grants the Personal Alerts consent for you.

/travel

/market and /stocks

/loot (NPC bosses)

/watch (price watches)

Direction is "At or below target" or "At or above target". Leave it out and the bot picks: a price under today's means you are waiting for a drop.

/stakeout

/whoami and /verify

/whoami shows your linked Torn account and faction. /verify is covered in the roles section above.

These are Faction member commands: they need you to be in the faction and only run in your own faction's server. Some need a position permission, which a leader grants on Faction › Settings › Manage.

/members (also /member)

/faction

A grouped version of the same tools:

• /faction members with online, offline, okay, flying, hospital, revivable, inactive, discord, xanax, lookup and activity.
• /faction crimes with missing-members and status, the same as /oc.

/oc

/chain (Chains module)

/war (needs View wars)

All /war replies post in the channel.

Other faction commands

/banking (also /bank)

Faction member commands that need the Accounting module, used in your faction's server.

Leadership and server commands

The bot can message you privately about your own account. Nothing here is visible to your faction. Set them up on Account › Discord under Reminders, or with /alerts.

They need the Personal Alerts consent: press Grant access on the card. Each one you switch on makes Torning read your bars, cooldowns and travel from your own API key every minute. If the bot has not seen you yet, the card says so: link Discord in Torn and use a command once.

Custom triggers

• Without a trigger, a reminder fires at full (or at zero for a cooldown).
• Switch a reminder on, then type in the Custom trigger box and press Enter. Reset clears it.
• From Discord, use /alerts threshold.

Switching a reminder off forgets anything it was waiting for, so turning it back on later does not send you a stale message.

Rows on your dashboard's Daily checklist can also ping you by DM when they become due. That needs Discord linked and Personal Alerts granted too.

Watches are set from Discord and arrive by DM. Account › Discord lists your active ones under Watches, in four sections:

On the page, each watch shows when you set it. Press the bin icon to remove one, or Clear all to remove a whole section. Player stakeouts show the target's current status and an Attack button.

If the page warns that your Discord account is not linked yet, the bot has nowhere to send these DMs. Link Discord in Torn and use a command once.

Giveaways run in your faction's linked server. You must be in the server's faction to use /giveaway.

Who can host

• Player giveaways (the default): holders of the Player giveaway role or the Faction giveaway role.
• Faction giveaways (official): holders of the Faction giveaway role.
• Leaders, co-leaders and positions with Manage Discord can host either type.

The host, leadership, and holders of the matching role can also cancel, reroll and verify logs.

Creating one

/giveaway create takes:

Entering

Press Enter Giveaway on the card. Press it again to leave. View Entries lists who is in. Entrants at level 50 and above get a second ticket, and level 100 a third, which improves their odds in the draw.

The draw

The bot draws winners automatically when time runs out, updates the card, announces the winners in the channel and DMs them. To draw early, use /giveaway end (id).

Delivery logs

When a log is required, the ended card shows the deadline and these buttons:

• Send Prize opens a Torn trade with the first winner.
• Submit Delivery Log opens a form for the trade log or proof. You can also use /giveaway confirm-log (id, log).
• Proof posted by the host or leadership counts as verified straight away. Proof posted by a winner waits for the host or leadership to press Verify Log.

When the deadline is two hours away, the bot posts a reminder in the channel and DMs the host. After the deadline the giveaway is marked overdue.

Rerolling, cancelling and listing

The Giveaways tab

On Faction › Settings › Discord, the Giveaways tab lets you set the Default Giveaway Channel and the Default Log Confirmation Deadline (1 to 168 hours, 24 by default), then Save Giveaway Settings.

Below that you see how many giveaways were hosted, total entries and the Log Verification Rate (the tick marks 80%), plus a list you can filter by All, Active, Pending Log and Ended. From the list you can Draw Now, Verify Log or Reroll.

These cards land in the channel chosen for the Vault request alert (your bankers channel), pinging whoever that alert is set to mention. They need the Accounting module, a bankers channel and a banker role set on the Roles tab.

Vault requests

1. A member runs /banking withdraw. They can only ask for what they hold, and can have one request open at a time.
2. The card shows who is asking, how much, their balance and when the request expires (after 60 minutes).
3. A banker presses Pay. It opens Torn's give-money form with the member and amount filled in, and marks the request paid on the way. Torning locks it once the faction vault log shows the money move.
4. Or a banker presses Cancel.

• Only holders of the banker role can settle a card. Bankers do not need a Torning account.
• A settled card that the vault log has not matched shows Reopen, which asks for a reason.
• The member gets a DM at each step (raised, paid, cancelled, expired) and can cancel their own request from it or with /banking cancel.
• Requests also appear on Faction › Bank, where bankers can pay or cancel them too, and stay in step with the cards.

Reimbursement tickets

When a member runs /banking register-reimbursement, a ticket is posted with the amount, reason and any receipt. It expires after 7 days. The card has Review in Accounting (approve or reject on Torning) and Pay on Torn. The member is sent a DM with Cancel my request, and another when the ticket is approved or rejected (with the reason).

Armoury requests

/armory request posts a card asking for an item and quantity. If no bankers channel is set, the card is posted where the command was run instead. The card has Approve, Decline and a link to the Torn armoury. Only positions with Manage accounting can approve or decline. Loan the item on Torn as usual.