Skip to content
TORNLIFE More

[Bot ] Eve User Guide

Started by Multipass [1955315] on in Tools & Userscripts.

35 replies · 675 views · thread synced · 5 days ago · View on torn.com
About this thread

Posts archived: 36 / 36 posts (100%) · the total is Torn's reply count + the opening post at the last fetch

Counted by TornLife from the archived posts.

Archived posts
36
Discussion span
→
Authority score
56 / 100
Historical score
23 / 100
Story score
39 / 100
Engagement score
68 / 100

People posting, likes and official posts are not counted for this thread yet: on threads longer than one page they come from a periodic pass over the archive, which has not covered it.

Multipass [1955315]
**Work in progress please ignore**

Intro



This bot is designed to help leadership teams run facs and help with gathering data about your faction and its members. Eve is not designed to help with attacking (bar one command so far) or mugging or really anything in Torn directly - its an admin tool designed to minimise time manually entering data.


Ethos


Eve is built with the site stated intentions for the API in mind. No user command in the bot ever triggers more than a single API call. The calls which gather information about the entire fac (which do require multiple calls - 1 per member +4 for gym challenge data) run only once a day and are not triggered by a user or via the bot.


Privacy and Keys


Facs that have chosen to use Eve should be aware that in order for it to function it stores all the player data it captures forever. This means that when you run a command (for example: tell me how many Xanax everyone in the fac took over the last 7 days) it can return a response instantly - because it doesn’t have to make an API call for every member in your fac - or any API call at all for that example. Eve collected the data each day and kept it. This also means data is “stale” in that any changes to player data won’t be captured until the next time it runs (once per day at 1am TCT - in the hope that Torns internal crons have completed by then).


As Eve runs on a hosted server, I can access all this data. I have no desire to look at what amounts to endless spreadsheets or to bother keeping tabs on any fac other than ours, but for full disclosure I want you to know I could look at this data if I chose to.

Eve currently requires a Limited API key to run. This is to pull information for fac gym challenges so Eve can tell you how much energy people spent training. Also worth mentioning that every stat except these could be gathered for any fac using any key.


That said, there is a considerable amount of trust required to give any player access to your API key. I have never and will never betray that trust. I would also remind all players that they can and should periodically check the usage on their API keys. You can see when calls are made using your key.

Multipass [1955315]
Stats than are tracked by Eve (player personal stats and crimes) are listed here. The stats are named exactly as published by the Torn API. These stat names can be used in some commands in Eve. I'm slowly adding explanations for these as some are not obvious.


ATTACKING - DONE
attackswon
attackslost
attacksdraw
attacksassisted
defendswon
defendslost
defendsstalemated
yourunaway
theyrunaway
unarmoredwon
bestkillstreak
attackhits
attackmisses
attackdamage
bestdamage
onehitkills
attackcriticalhits
attacksstealthed
retals
moneymugged
largestmug
highestbeaten



TRAINING - DONE
strengthtrained
defensetrained
speedtrained
dexteritytrained
totaltrained


JOBS - DONE
jobpointsused
trainsreceived


TRADING - DONE
itemsbought
auctionswon
auctionsells
itemssent
cityitemsbought
pointsbought


JAIL - DONE
jailed
peoplebusted
failedbusts
peoplebought
peopleboughtspent


HOSPITAL - DONE
hospital
medicalitemsused
bloodwithdrawn
reviveskill
revives
revivesreceived


FINISHING HITS - DONE
heahits - Heavy artillery
machits - Machine guns
rifhits - Rifles
smghits - Sub machine guns
shohits - Shotguns
pishits - Pistols
grehits - Temporary weapons (grenades)
piehits - Piercing weapons
slahits - Slashing weapons
chahits - Mechanical weapons (we think)
axehits - Clubbing weapons (we think)
h2hhits - Hand-to-hand


COMMUNICATION
mailssent
friendmailssent
factionmailssent
companymailssent
spousemailssent
classifiedadsplaced
personalsplaced


CRIMINAL OFFENSES
total
selling_illegal_products
theft
auto_theft
drug_deals
computer_crimes
fraud_crimes
murder
other
organisedcrimes


BOUNTIES
bountiesplaced
totalbountyspent
bountiescollected
totalbountyreward
bountiesreceived
receivedbountyvalue


ITEMS - DONE
cityfinds
itemsdumped
dumpfinds
dumpsearches

boostersused
consumablesused
candyused
alcoholused
energydrinkused
statenhancersused
virusescoded
weaponsbought


TRAVEL - DONE
traveltimes
traveltime
itemsboughtabroad
attackswonabroad
defendslostabroad
argtravel
mextravel
dubtravel
hawtravel
japtravel
lontravel
soutravel
switravel
chitravel
cantravel
caytravel


DRUGS - DONE
drugsused
overdosed
rehabs
rehabcost
cantaken
exttaken
kettaken
lsdtaken
opitaken
shrtaken
spetaken
pcptaken
victaken
xantaken


MISSIONS
missionscompleted
contractscompleted
dukecontractscompleted
missioncreditsearned


RACING
racingpointsearned
racesentered
raceswon


OTHER
networth
useractivity
timesloggedin
activestreak
bestactivestreak
awards
refills
nerverefills
tokenrefills
meritsbought
daysbeendonator
arrestsmade

Find me a home
elo
roundsfired
specialammoused
hollowammoused
tracerammoused
piercingammoused
incendiaryammoused

itemslooted
respectforfaction
territoryjoins
territorytime
booksread
Multipass [1955315]
PERSONAL STATS AND CRIMES METRICS

!count


Count lists how much a specific stat has increased over x number of days for everyone in the fac. This command works with any of the stats listed in the stats list above.

For example:

!count xantaken 7 will list how much Xanax each fac member used over the last 7 days.

!count totaltrained 10 will list how much energy each fac member spent in the gym over the last 10 days.

[image: profileimages.torn.com]

!mean

This command is exactly like count except it take the average for the time period specified. So !mean xantaken 10 returns everyones average xan usage for last 10 days (the count divided by the number of days specified).




Multipass [1955315]
CSV EXPORTS

As well as listing this data in a discord message, you can export any combination of these stats into a CSV that will open as a spreadsheet. Each stat will be a column header and each row will be a fac member.

!csvlist

This lists the stats that will be in the csv as columns next time a csv is generated.

[image: profileimages.torn.com]

!csvadd [statname]

This will add a stat to the list so it is included in the next csv that gets generated. Eg !csvadd xantaken

[image: profileimages.torn.com]

!csvrm [statname]

This removes a stat from the list. Eg !csvrm xantaken

[image: profileimages.torn.com]

!csvdays [number_of_days]

This generates the csv, using the stats from !csvlist and for the number of days specified.

[image: profileimages.torn.com]

Multipass [1955315]
API CALLS

There are some commands which do require live information. Only one API call is made when these commands are run.

!onliners

Lists every member of your fac that is currently online.

[image: profileimages.torn.com]


!hitme [facID]

Using the ID provided, this lists every member of that fac that is coming out of hospital in the next 30 minutes, ordered by soonest discharge and with a link to their profile page.

[image: profileimages.torn.com]

!fbal

This is a legacy command that was made before the feature was added to torn and lists the fac balance minus the sum of player balances.

[image: profileimages.torn.com]

!rbal

Again legacy before this was introduced to tornstats. This lists your faction respect and shows how much is locked into perks that can’t be unset vs how much is “flexible”.

[image: profileimages.torn.com]

!balscsv

This exports a csv of all your fac members and their money balances in the faction bank.

[image: profileimages.torn.com]