Join the new world

Nothing new in this article.
It will just be used as an updated reference 'manual' for the bot.

I noticed the last article I made with a complete guide is 9 months old. The game (and the bot) changed a lot in the last months, some commands were removed, some were added.

You are free to translate/re-publish/modify this page (maybe with a link to this article).

Translations
* Hungarian - thanks to dnbsoldiers
* Spanish - thanks to santirub
* Russian - thanks to dabudetmir


FAQ
None... ask something and I'll add it here.


Upcoming features
.tax command to view product taxes
Improving .market, calculating taxes on products so that you will see the real price.
[maybe] .battle command to view battle status, wall %, score, timer.
[maybe] will link erep bot to my website's database, containing all living citizen data, products and more (when erep devs fix API compressed feeds). This could allow a lot of new commands! For example to see a country's president, a country's congressmen, party and moar (need ideas).


Feedback/requests/whatever
If you have anything you want to suggest, /query martin
or join #fishbot!


Private commands
To use these commands, open a query with eRepublik, or /msg eRepublik

* request
* remove
* news
* nonews

request
Syntax: /msg eRepublik request #yourchannel

This command will make the bot join #yourchannel. You must be founder of the channel to use it. Any channel may request the bot.
For help on registering channels, see: http://forum.rizon.net/showthread.php?20-How-to-Register-my-Channel&postcount=1

remove
Syntax: /msg eRepublik remove #yourchannel

This command will make the bot leave #yourchannel. Again, you must be founder.

news
Syntax: /msg eRepublik news #yourchannel

This optional command will enable the news monitoring feature in your channel. If you choose to enable it, the bot will broadcast eRepublik events (attacks, battle results etc..) to your channel.
Must be founder.

Example:
:: NEWS :: Oaxaca was secured by Poland in the war versus Resistance force of Mexico ::
:: NEWS :: Lapland was conquered by Estonia in the war versus Finland ::

nonews
Syntax: /msg eRepublik nonews #yourchannel

This command will disable news monitoring in your channel.
Must be founder.



Public commands
These commands can be used by anyone in a channel where the bot is present.

First, a clarification on command parameters.
Most of the commands have optional parameters. You can check the available parameters by typing .help COMMAND_NAME. For example, all commands that look up citizen information have --id (-i) and --nick (-n) parameters.
How to use them?
Example: .lp -i 477471 // this means: command lookup, using option i which means it will show the info of ID 477471
.fc -n martin // command fightcalc, using option n which means it will show the damage of the citizen linked to martin's nick.

note: commands between () are just aliases, you can use them instead of typing the command.

Command List
Type .help erepublik to see it.

* avatar
* donate
* fightcalc (fc)
* link
* lookup (lp)
* medals
* register_citizen (regcit, regnick)
* sscalc (ssc)
* company (cp)

* battles
* bestprice (market, bp)
* borders
* country
* currency
* info
* mpps (mpp)
* region
* register_company (regcom)
* value (convert)

Linking an eRepublik citizen to your IRC nick
Using .regnick, you can link a citizen to your IRC nick. This way, you won't have to write your citizen name when using commands on it.
Example, after I used the command ".regnick martin sileno":
20:41 .lp
20:41 :: Martin Sileno [477471] :: Wellness 94.0 :: Strength 3499.875 :: Rank Colonel* [35] 402627/434999 points :: Level 27 (10394 XP) :: Age 1044 days ::
Location Calabria, Republic of Macedonia (FYROM) :: Citizenship Italy :: Work skill Guru (Lvl 12, 354726 pts) :: Employed at Elite - Iron [251339] ::
no need to type my entire citizen name anymore.
Also, this allows other people to use commands on my citizen through my IRC nick, using command option -n:
20:45 .fc -n martin
20:45 :: Martin Sileno (Colonel* [35], 3499.875 strength) influence :: [Q0: 779] [Q1: 935] [Q2: 1091] [Q3: 1247] [Q4: 1403] [Q5: 1559] ::
(quicker than typing .fc martin sileno !)

Linking an eRepublik company to your IRC nick
You can also link a company to your nick with ".regcom company_ID"
After I used that comman😛
20:46 .cp
20:46 :: Ka-Tet guns [196526] :: Q5 Weapons :: Employees 0 :: Country Italy :: Stock 13930 products :: Raw materials 1350.0 Iron ::

---

note: all the following commands (avatar, donate, fightcalc, link, lookup, medals, sscalc) have options:
-i, to look up a citizen by id instead of name
-n, to look up the citizen linked to an IRC nick.

.avatar
Description: gives a link to a citizen's avatar.
Options:
--small (-s) links to the small sized avatar (55x55px)
--medium (-m) links to the medium sized avatar (100x100px)
--large (-l) links to the large sized avatar (142x142px)
Examples:
20:57 .avatar
20:57 :: Martin Sileno's avatar link :: http://static.erepublik.com/uploads/avatars/Citizens/2008/06/08/d072dd3c5f11fbd33d836214edc5ac7a.jpg ::
20:58 .avatar -i 478002 -m
20:58 :: zakuro's avatar link :: http://static.erepublik.com/uploads/avatars/Citizens/2008/06/08/bcb33315e0b11aff3c15c640ae039cd1_100x100.jpg ::

.donate
Description: gives a link to the donation page of a citizen.
Examples:
20:59 .donate elle dinar andari
20:59 :: Elle Dinar Andari's donations :: http://economy.erepublik.com/en/citizen/donate/207162 ::

.fightcalc / .fc
Description: calculates a citizen's influence with different weapon qualities.
Options:
--strength (-s) uses a custom strength
--rank (-r) uses a custom military rank (use rank ID, not name)
--fights (-f) specifies number of fights
--naturalenemy (-e) adds 10% natural enemy bonus to influence
--objective (-o) calculates how many fights are required to make a given amount of influence

Note: this command can work even if eRepublik API is offline if you provide atleast -s and -r options. (no need to look up citizen data if the bot knows strength and rank, it's enough to calc influence)

Examples:
Simplest usage,
21:07 .fc
21:07 :: Martin Sileno (Colonel* [35], 3499.875 strength) influence :: [Q0: 779] [Q1: 935] [Q2: 1091] [Q3: 1247] [Q4: 1403] [Q5: 1559] ::

To calculate my influence against Natural Enemy,
21:08 .fc -e
21:08 :: Martin Sileno (Colonel* [35], 3499.875 strength, against Natural Enemy) influence :: [Q0: 857] [Q1: 1029] [Q2: 1201] [Q3: 1372] [Q4: 1544] [Q5: 1715] ::

To calculate my influence against my Natural Enemy after 30 fights,
21:08 .fc -e -f 30
21:08 :: Martin Sileno (Colonel* [35], 3499.875 strength, against Natural Enemy) influence in 30 fights :: [Q0: 25710] [Q1: 30870] [Q2: 36030] [Q3: 41160] [Q4:
46320] [Q5: 51450] ::

To calculate influence of a citizen with 3500 strength and rank 37, this command will work even if API is offline and times out,
21:09 .fc -s 3500 -r 37
21:09 :: (Colonel*** [37], 3500 strength) influence :: [Q0: 819] [Q1: 982] [Q2: 1146] [Q3: 1310] [Q4: 1474] [Q5: 1638] ::

To calculate how many fights I need to make 70000 influence,
21:10 .fc -o 70000
21:10 :: Martin Sileno (Colonel* [35], 3499.875 strength) fights required for 70000 influence :: [Q0: 90] [Q1: 75] [Q2: 65] [Q3: 57] [Q4: 50] [Q5: 45] ::

To calculate how many fights I need to make 70000 influence against my Natural Enemy if I had 5000 strength,
21:11 .fc -o 70000 -e -s 5000
21:11 :: Martin Sileno (Colonel* [35], 5000 strength, against Natural Enemy) fights required for 70000 influence :: [Q0: 59] [Q1: 50] [Q2: 43] [Q3: 37] [Q4: 33]
[Q5: 30] ::

There could be a lot more examples, mixing all the options....

.link
Description: gives a link to the donation page of a citizen.
Examples:
21:13 .link
21:13 :: Martin Sileno's profile :: http://www.erepublik.com/en/citizen/profile/477471 ::

.medals
Description: medals owned by a citizen.
Examples:
21:15 .medals -n elle
21:15 :: Elle Dinar Andari :: Medals 139 :: 68x Hero :: 29x Hard Worker :: 21x Super Trooper :: 10x Congressman :: 7x Society Builder :: 2x Campaign Hero :: 1x
Media Mogul :: 1x Resistance Hero ::

.sscalc / .ssc
Description: calculates days/gold required for the next SuperSoldier medal.
Options:
--strength (-s) uses a custom strength
--friends (-f) how many friends used in training (0, 1, 2)
--naturalenemy (-e) adds 10% natural enemy bonus to training

Note: this command can work even if API is offline and times out. The only required option is -s.
Examples:
Training everyday with 2 friends as booster,
21:20 .ssc zakuro -f 2
21:20 :: zakuro (3932.529 strength, 2 friends) days/gold required until next SuperSoldier medal (at 4000 strength) :: [+10% 9 (0.0g)] [+50% 8 (1.52g)] [+100% 6
(8.94g)] [+200% 4 (7.16g)] ::

With 2 friends as booster and 10% natural enemy bonus,
21:23 .ssc -n elle -f 2 -e
21:23 :: Elle Dinar Andari (5379.88 strength, 2 friends, with Natural Enemy bonus) days/gold required until next SuperSoldier medal (at 5500 strength) :: [+10% 16
(0.0g)] [+50% 13 (2.47g)] [+100% 10 (14.9g)] [+200% 7 (12.53g)] ::

With 3411 strength (this works even if API is unavailable),
21:52 .ssc -s 3411
21:52 :: (3411 strength, 0 friends) days/gold required until next SuperSoldier medal (at 3500 strength) :: [+10% 14 (0.0g)] [+50% 11 (2.09g)] [+100% 9 (13.41g)]
[+200% 6 (10.74g)] ::

etc, etc...

.company / .cp
Description: gives some information on a company
Usage: ".cp COMPANY_ID"
Known issues: stock may be wrong, it's a bug in API.
Example:
21:57 .cp 182310
21:57 :: 1WAY Grains [182310] :: Q1 Grain :: Employees 2 :: Country Italy :: Stock 20910 products ::

.battles
Descriptions: lists all active battles, or battles matching a search string.
Usage: ".battles" or ".battles region/country", in the second case it will only list battles involving the given region/country.
Example:
21:59 .battles
21:59 :: Active battles :: New Zealand vs Australia in Victoria :: Germany vs Belgium in Wallonia :: Poland vs Brazil in Canary Islands :: Republic of Macedonia
(FYROM) vs Bulgaria in Ruse :: Iran vs China in Sistan and Baluchistan :: Pakistan vs China in Punjab :: Egypt vs Greece in Sinai :: Romania vs Hungary in
Maramures ::
21:59 :: Active battles :: USA vs Mexico in Baja :: Italy vs Republic of Macedonia (FYROM) in Calabria :: Hungary vs Romania in Crisana :: Ukraine vs Russia in
Taurida :: Serbia vs Russia in North Caucasus :: Switzerland vs Slovenia in Graubunden :: USA vs Spain in Castilla y Leon :: France vs Spain in Loire Valley
::
21:59 :: Active battles :: Slovenia vs Switzerland in Svizzera italiana :: Greece vs Turkey in Mediterranean Coast of Turkey ::

Battles in USA,
22:03 .battles USA
22:03 :: Active battles [USA] :: USA vs Mexico in Baja :: USA vs Spain in Castilla y Leon ::

Battles in region Calabria,
22:04 .battles calabria
22:04 :: Active battles [calabria] :: Italy vs Republic of Macedonia (FYROM) in Calabria ::

.bestprice / .bp / .market
Description: shows the best offer in the selected market.
Usage: ".bp INDUSTRY COUNTRY QUALITY".
Known issues: the price is without import/vat taxes, so it may be very different from the actual one.
Examples:
22:08 .bp weapon indonesia 5
22:08 :: Best offer for Q5 Weapons in Indonesia :: Price 29.81IDR (0.14905G), 3 available :: Link http://economy.erepublik.com/en/market/49/15/5 ::

You can also use the country code,
22:09 .bp food it 4
22:09 :: Best offer for Q4 Food in Italy :: Price 2.61ITL (0.01566G), 123 available :: Link http://economy.erepublik.com/en/market/10/1/4 ::

Or shorten the industry name,
22:10 .bp h fr 1
22:10 :: Best offer for Q1 Housing in France :: Price 186.92FRF (0.93460G), 1 available :: Link http://economy.erepublik.com/en/market/11/3/1 ::

.borders
Description: lists borders of a region.
Usage: ".borders REGION_NAME" or ".borders -i REGION_ID".
Note: you can use a shortened region name.
Examples:
22:12 .borders paris
22:12 :: Borders of Paris Isle of France, Spain :: Polan😛 Upper Normandy, Picardy, Champagne Ardenne, Burgundy :: Spain: Loire Valley ::

22:13 .borders java
22:13 :: Borders of Java, Indonesia :: Indonesia: Sumatra, Lesser Sunda Islands, Western Australia, Kalimantan ::

.country
Description: information about a country.
Usage: ".country COUNTRY_NAME" or ".country -i COUNTRY_ID".
Note: you can use a country code instead of name.
Examples:
22:14 .country italy
22:14 :: Italy [10] :: Population 1031 :: Citizen fee 5 ITL :: 3 regions ::
22:14 .country id
22:14 :: Indonesia [49] :: Population 11044 :: Citizen fee 5 IDR :: 12 regions ::

.currency
Description: exchange rates of a currency.
Known issues: sell rate is often wrong. Blame eRepublik API.
22:17 .currency usd
22:17 :: USD :: Buy rate 0.005 :: Sell rate 82.95 :: Spread -58.52% ::

.info
Description: gives bot version and other info.
22:17 .info
22:17 :: Rizon eRepublik Bot :: Version 3.2 :: Developers ElChE and martin- :: Help/feedback #fishbot ::

.mpps / .mpp
Description: shows a country's active mpp list and their expiration date.
Usage: ".mpp COUNTRY_NAME" or ".mpp -i COUNTRY_ID".
Note: you can use a country code instead of name.
Examples:
22:19 .mpp it
22:19 :: Italy :: 7 MPPs :: Bulgaria 24/04 :: Ukraine 13/05 :: Croatia 20/04 :: USA 13/05 :: China 28/04 :: Romania 05/05 :: Ireland 11/05 ::

22:21 .mpp -i 1
22:21 :: Romania :: 14 MPPs :: Argentina 18/05 :: Israel 03/05 :: Greece 15/06 :: Finland 13/05 :: South Korea 17/05 :: Ukraine 23/04 :: China 10/05 :: Australia
30/04 :: USA 04/05 :: Croatia 15/05 :: Italy 05/05 :: Bulgaria 13/05 :: Brazil 15/05 :: France 18/05 ::

.region
Description: information on a region.
Usage: ".region REGION_NAME" or ".region -i REGION_ID".
Note: you can use a shortened region name.
Examples:
22:22 .region liao
22:22 :: Liaoning, China [375] :: Population 335 :: Resource Iron :: Cost to attack/RW 58.5 Gold ::

.value / .convert
Description: converts an amount of currency to gold or vice versa.
Usage: ".value AMOUNT CURRENCY" or ".value AMOUNT gold CURRENCY".
Known issues: again, sell rate is often wrong. Blame eRepublik API.
Examples:
22:24 .value 300 itl
22:24 :: Value of 300 ITL in GOLD :: Selling ITL 1.80000 [rate 0.006] :: Buying GOLD 3.63636 [rate 82.500] ::

22:25 .value 50 gold rub
22:25 :: Value of 50 GOLD in RUB :: Selling GOLD 4999.50000 [rate 99.990] :: Buying RUB 10000.00000 [rate 0.005] ::