Touken Ranbu Helper

The Touken Ranbu Helper is a web browser extension that displays useful information about one's game, including sword and troop health, troop count, and predicted smithing results. It gathers this information by reading the data that the server transfers to the player's client game.

The original Helper was made by weibo user moelynn, then translated into English by Oredare, Maitou, Seijuros, and Miiandering.

The new Helper was created by Github user hitomi and updated by helentetsuko and MA Zhenyuan, then translated by Tangelor142.

Original forum thread is here.

Notice

• The extensions now supports use on Mozilla Firefox in addition to Google Chrome
• The Helper is now available as a Chrome Extension App on the Web Store. It is privately listed, so please use the link to download in one simple click.
• Chrome may display a screen on startup regarding the extension - ignore it. The notice is normal behavior. It does this to every unpacked extension, as a safeguard against potentially malicious ones.
• The LITE version of the extension will malfunction for every new sword/kiwame added to the game. Please update the extension accordingly.

Installation

New Version

Current Version: Touken Ranbu Helper v2.2.7 includes up to #202 Himetsuru Ichimonji along with the kiwame of Chiyoganemaru.

• Before installing this version, I highly suggest you take the time to read the Guide/FAQs document linked below. It can help prevent 99% of the issues you will encounter after installing without the need to post your issues on this page, which I cannot check everyday.

Guide/FAQs

Download: Chrome Web Store (Recommended) | Chrome .ZIP/.CRX 
Download: Firefox* .XPI (Recommended)
For Bug Reports: Github

• *To run the Firefox version after installing, you must go to "about:config" in the address bar and change the value of the option below to 0 (zero):

devtools.netmonitor.responseBodyLimit

Current Update: 2021/08/12

• Added Himetsuru Ichimonji and his portrait sprites

Previous Updates:

2021/07/22

• Added Chiyoganemaru Kiwame portrait sprite
• Fixed Hydromen troop short-name for display in Helper
• Fixed display timing of the Master Data warning

2021/06/24

• Fixed issue where "Honmaru" tab would remain completely blank due to issue with Helper not being able to account for zero Koban boxes in inventory
• Fixed "Invalid Date" issue caused by Firefox changing Date parse method.
• Added a colored ring around the Party number of a team sortied in SI map

2021/06/22

• Fixed Hizamaru kiwame injury portrait not appearing
• Added portraits for the newly implemented Azuki and Kenshin kiwames

2021/06/04

• Fixed Repair timer so that it does not convert hours over 24 into day values and then not show them.
• Implemented "Enemy List" (which includes enemies' base stats) and "Battled Enemy Log" (also with base stats, level, and location)

2021/06/04

• Added small Notice about potentially locked forges and repair rooms when first starting the helper
• Fixed Double Kiwi emoji for swords with only one name and the no kiwi emoji for Hizamaru and Higekiri
• Added an option to "Download Enemies base stats" (still working on Enemies Battled Log)
• Forge Notifications can now be properly turned off
• Added Missing SI: Keichou Kumamoto boss icon and new enemy Rarity 1 Kunai (from VoT Flower Gathering)
• Other minor fixes

2021/05/26

• Fixed Kiwame Return Notification
  • Notification of sword's return would pop-up before sword should have come back and notification would not pop-up at actual return time
  • Now notification is properly appearing at the time of the sword's return and only then

2021/05/26

• Minor: Fixed Misspelling of Yamanbagiri Chogi's name in filter causing both Manba and him to appear as 'Yamanbagiri' to EN players
• Minor: Removed extra floating overlay for first enemy in Sortie/Front Lines tab

2021/05/25

• Updated Kiwame Training tracker icon (requires a refresh of game before it starts working properly after install)
• Added Notifications for Rare Drops, Repairs, Forge, Duty/IA, Surveys/Expeds and Kiwame Training

2021/05/22

• Minor: Added missing released Kiwame icons up to Akashi Kuniyuki and Hyuuga Masamune.

2021/05/22

• Has all regular sword icons up to #200 Murakumo Gou.

---

Full Version

Currently broken Do NOT install!!!

Current Full Version: The issue that prevented the Full version from working has been found! Expect to see it updated soon!

Download: GitHub

Current Update:

Previous Updates:

2019/07/03

• Added Kiwame yaris.
• Added new version of Jurakutei 2 map
• Added Chougi and other event swords to special drop list for future events
• Minor Updates
  • Fixed rare sword drop notifications
  • Corrected "Heshikiri" to "Hasebe"
  • Minor cosmetic update to Battle Log and Battle Map when entering Boss or Sub-Boss (event only) nodes
  • Added missing R2 Tachi icon.

2019/06/01

• Has all swords up to Hizen.
• Added English translation for UI, Sword Names, Troop Names, Horse, Items, Battle Formation, etc.
• Enhanced Notifications (excluding the ones that appear on launch of tool) are now embedded in the tool itself. No more OS notification.

---

Lite Version

Current Lite Version: Touken Ranbu Helper 1.8.4 up to #202 Himetsuru Ichimonji and includes kiwame for Chiyoganemaru.

Download: Chrome Web Store (Recommended) | Chrome .ZIP/.CRX 
Download: Firefox .XPI (Recommended)

Now that the tool is available through the Add-on/Extension tools of their respective browser, I am retiring the LITE Patch because it's too much work to upkeep for very little return.

Current Update: 2021/08/15

• Added #202 Himetsuru Ichimonji's crest.

Previous Updates:

2021/08/12

• Added #202 Himetsuru Ichimonji. (His crest will be missing, see Notice above)

2021/06/22

• Corrected EXP mapping for Special (4*) rarity Tachi kiwame swords.

2021/05/21

• Minor: Small fixes and Johren EN server compatibility update.

2021/04/28

• Added new swords: Taikou Samonji, Samidare Gou, Oochidori Juumonji Yari, Hanjin, Ichimonji Norimune, Murakumo Gou.

2020/08/20

• Fix: Large swords experience maps were switch around. They are now showing correct exp.

2020/08/19

• Fixed Nihongou rarity rating from 3->4 and 4->5 for kiwame form along with proper equip quantities.
• Fixed the original three R3 Uchigatana's type from 'Tachi' to 'Uchigatana'.
• Included missing Kiwame Sayo crest.
• Added Tachiwame sword info and exp map.
• Minor: Tachi kiwame exp map was missing the last table entry for leveling 98 -> 99.

2020/08/10

• Added new sword #188 Nikkou Ichimonji

2020/08/01

• Added new sword #188
• Fixed spelling mistakes in last versions patch notes.
• Added placeholders for upcoming sword (this will prevent the helper from breaking in the time it takes to get the new swords implemented in the tool)

2020/08/01

• Added new sword Chiganemaru
• Resized sword icons 182/184.
• Fixed Firefox Date/Time errors caused by difference in browsers' handling of "Date" Objects. Chrome handles Date parsing differently than Firefox and other browsers.

2020/04/30

• Added new swords #182 Kokindenjunotachi and #184 Jizou Yukihira
• Updated the drop lists to reflect most recent event drops

2020/04/16

• Minor update to 'About' section
• Added placeholders for upcoming swords (this will prevent the helper from breaking in the time it takes to get the new swords implemented in the tool)
• Fixed bug where going to repair rooms would break helper
• Updated the drop lists to reflect most recent event drops

2020/03/26

• Fixed Kuwana Gou experience points
• Added LITE-Patch for Kuwana Gou experience fix

2020/03/13

• Releases now have an official Firefox version
• Fixed version numbering

2020/03/01

• Added all swords and crests up to #180 Sanchoumou (including #21 Onimaru Kunitsuna
• Added new horse Iwaigogou, gift from Mission K10 for 5th Saniwa Anniversary.
• Changed download link from Google Drive to GitHub (easier to update)

2019/08/19

• Minor bug fixes

2019/08/01

• Added Water Artillery troops from event to tool.
• Added new tantou #170 Chatannakiri.
• Revamped Super Rare and Rare Drop lists.

2019/07/03

• Added Kiwame yaris and their exp pools to helper tool.
• Minor fix fixed misspelling of Nenekirimaru's name.
• Added Chougi to rare drop lists because of Jurakutei 2

2019/04/27

• Minor Update Added Hizen and Nankai to rare drop list for the event.
• Fixed Repair notification.
  • It will now properly show the name of the sword being fixed up.
  • Also it uses its own settings now instead of piggy-backing off of the Expedition ones.

2019/04/25

• Added Nankaitarou Chouson, Hizen Tadahiro, and Iwaiyongou (4th Saniwa Anniversary gift horse).

2019/02/28

• Added Kiwame Ishikirimaru and Hotarumaru experience points.

2018/11/01

• Minor Update: Yamanbagiri Chougi is displayed as "Chougi" to avoid confusion.

2018/07/26

• Fixed a bug wherein party information would not update when using the game's party disbandment function.
• Push notifications for newer sword drops updated.

2018/04/17

• Fixed a bug wherein horses after Mochizuki (No. 08) did not display properly.

2018/01/30

• Event-exclusive "Bean Thrower" troops have been added to prevent malfunction.

2017/12/13

• Fixed incompatibility caused by previous maintenance: Dec 13 2017 [14:00 - 16:00] [GMT+9]

2017/11/02

• Compatibility for unreleased Kiwame (Tantou, Wakizashi, Uchigatana) has been implemented.

2017/10/31

• Minor Update: Heshikiri has been renamed to Hasebe.

2017/10/17

• Uchigatana Kiwame now have their experience points properly displayed.

2017/09/15

• Wakizashi Kiwame now have their experience points properly displayed (level 55).

2017/08/10

• Wakizashi Kiwame now have their experience points properly displayed.

2017/07/27

• Mouri Toushirou has been added to the rare and super rare sword drop list.

2017/07/04

• Tomoegata Naginata update now shows party formation. Thank you to Atari for the fix.

2017/01/17

• Rare and super rare swords have been updated to include newer boss drop and event swords since 2015. Thank you to Akhime for the updated code.

2016/08/15

• Kiwame swords now have their experience points properly displayed. Thank you to Divest for the fix.

Instructions

Download

• For Chrome (Choose 1 only):
  1. Download and extract the .zip to a location you can easily navigate to, or
  2. Download the .crx, or
  3. Visit the Web Store and click "Add to Chrome"
• For Firefox:
  1. Download the .xpi and Firefox will automatically install it.

Load on Chrome

(Only necessary if you did not already install it from the Web Store)

1. Open Google Chrome
2. Open the Chrome menu > More Tools > Extensions to view the extensions page (you can also open it by typing chrome://extensions in the address bar)
3. For the ZIP file:
   • Toggle the "Developer Mode" on top right of the page
   • Click "Load unpacked extension..." button
   • Choose the 'Touken Ranbu Helper' folder you just unzipped before. Do not select the folders inside it.
4. For the CRX file:
   • Toggle the "Developer Mode" on top right of the page
     • You may need to restart the browser for the changes to apply
   • Drag and drop the .crx file on the extension page and it will prompt you to add it to the browser.
     • Chrome will not allow you to install an .crx file that did not come directly from the browser window. That means you may not be able to install the file if you drag it directly from your download directory to the Extension window. Best option is to drag it from either the Downloads page or from the Downloads bar at the bottom on the menu.

Load on Firefox

(Only necessary if you did not already automatically install it from .xpi file)

1. Open Firefox
2. Navigate Application Menu > Add-ons and Themes to open the add-ons manager (you can also open it by pressing Ctrl+Shift+A OR typing about:addons in the address bar)
3. Press the Tool button (the gear icon) and select "Install Add-on From File..."
4. Select the .xpi file (if you did not automatically install previously)

Use

1. Launch the Touken Ranbu web game
2. Open the Developer tools when the DMM and Nitro+ logos appear
   • (Chrome: Ctrl+Shift+I OR F12 for Windows / Cmd+Opt+I for Mac)
   • (Firefox: Ctrl+Shift+C OR F12 for Windows / Cmd+Option+C for Mac)
3. On the top row of developer tools, you'll see 'TRH-Lite' for the Lite version, 'TRH-Full' for the Full version, and '~Tourabu~' for the New Version. Click whichever you installed.
   • If you do not see extension panel title from Point 3, press the double caret [>>].
4. There is an option on the same row on the far right to change the developer tools' orientation:
   • Chrome: Press the vertical ellipsis, under 'Dock Side' select your orientation.
   • Firefox: Press the ellipsis, select your orientation.
5. Use the Helper and follow on screen instructions!

Note

If updates ever stop coming for the LITE version, you can switch to the .zip version and edit the relevant file to add new Swords and equipment yourself. Just follow the instructions in this comment: Direct Link to Comment