Tarkov Price Twitch Bot

The goal of this bot is to provide information to chatters and streamers of which items are valuable to sell.

I use this to run my Twitch bot, tarkovpricerbot.

Running your own personal bot

• Create a Twitch app at Twitch's dev console. Set the redirect URI to https://twitchapps.com/tokengen/. Take note of the Client ID. If the "Submit" button doesn't work, it may be because of illegal characters or phrases in the name.

• Create a Twitch account; this will be your bot account. It is recommended that you verify the account with a phone number to avoid complications with being unable to chat without VIP/mod. If you are only intending to use this bot for your own channel, you can just mod it.

• While logged in to the bot's Twitch account, copy & visit the below URI, replacing <YOUR TWITCH APP CLIENT ID> with your Client ID noted in the first step.

https://id.twitch.tv/oauth2/authorize
    ?response_type=token
    &client_id=<YOUR TWITCH APP CLIENT ID>
    &redirect_uri=https://twitchapps.com/tokengen/
    &scope=chat:read+chat:edit
    &state=test

• You will receive your OAuth token here. DO NOT SHARE IT WITH ANYONE.

• Go into index.mts

  • Replace the username field containing yourbotaccountusername with your bot's username.

  • Replace the password field containing yourbotaccountoauth with your OAUTH TOKEN, NOT YOUR PASSWORD.

  • Place your desired channel(s) in the channels array. If your channel URL is twitch.tv/foobar then it should look like 'foobar' in the array.

Compile & run

Option 1 (Containerized)

• Install Docker and run docker compose up --build (include -d to run the container detached from the terminal) to build and launch a container that will run the bot. This is recommended for dedicated servers.

Option 2 (Simpler)

• Install tsx via the npm command npm install -g tsx and run tsx index.mts in the repo root folder to launch the bot.
• You may have to run npm i once in the project directory to install the required packages.

Usage

Price check: !p <name> or !price <name> in Twitch Chat where <name> is the name of an item.

Trader-only price check: !t <name> or !trader <name> or !traders <name> in Twitch Chat where <name> is the name of an item.

Thanks

• tmi.js for Twitch interaction
• tarkov.dev for EFT API
• js-search for easy search indexing