Skip to content


Repository files navigation

Discord Discord

Logo Old School Bot

Old School Bot is a Discord Bot based on Old School RuneScape

For more information on the bot:

Old School Bot is not affiliated with or endorsed by Jagex. Play Old School RS for free at


Old School Bot uses oldschooljs (also made by me), for most of the OSRS related features like: simulating killing monsters, simulating clues, fetching the hiscores, checking worlds, etc. It's completely open-source and free to use.

Suggestions & Bug Reports

To report a bug, click here.

To suggest a new feature, click here


Anyone is free to create PR's with improvements and additions to Old School Bot.

Please lint your code with the projects' ESLint config.

Contributors are listed in this file, and given a Contributor role in the support server. If you have more questions, there are lots of helpful Contributors in the #developers channel on the Discord server.

Setting up the bot to run locally for contributing

To run the bot, you need the following things first: Git, NodeJS v18+, Postgres, Python and a discord bot account.

Setting up a Discord Bot

  1. Head to Discord Developers and create an application.
  2. Once created, click into your Application.
  3. Copy and store the Application ID, you'll need this later on.
  4. Create a Bot on the Bot tab. Copy and store the token for your bot, you'll need this later on.
  5. Ensure your bot has Privileged Gateway Intents > Server Members Intent enabled.
  6. Invite your bot to your server via this URL. Be sure to input your Application ID into the URL.<INSERT APPLICATION ID HERE>&permissions=2198754295617&scope=applications.commands%20bot

Setting up your environment

  1. Clone the repository: git clone
  2. Change into the new directory: cd oldschoolbot
  3. Install the yarn dependency: npm install --global yarn
  4. Make a config file from the example: cp src/config.example.ts src/config.ts
  5. Edit this new config.ts file:
    1. Input your bot token you retrieved earlier into botToken
    2. Input your Application ID you retrieved earlier into BotID
    3. Copy your Discord ID into both OWNER_IDS and ADMIN_IDS. You can get your Discord ID by opening Settings, selecting My Account, selecting the three dots next to your user name and selecting Copy ID. You may need to enable Developer Mode in Advanced Settings to be given this option.
    4. Enter the Server ID where you want to Administer your bot from in SupportServer. You can get this by right clicking the logo of the server and selecting Copy ID.
    5. Enter the Server ID into DEV_SERVER_ID
  6. Make a .env file copy from the example cp .env.example .env
  7. Update this new .env file:
    1. Input your username, password, and schema names into DATABASE_URL and ROBOCHIMP_DATABASE_URL using the format postgresql://USER:PASSWORD@HOST:PORT/DATABASE
    2. Input your Application ID you retrieved earlier into CLIENT_ID
  8. Run yarn then yarn install
  9. Run npx prisma generate to generate the Prisma client files and load the DSN from #6.
  10. Run npx prisma db push to create the tables on the database referenced in .env
  11. Run npx prisma generate --schema=./prisma/robochimp.prisma to generate the Prisma client files and load the DSN from #6 for the robochimp database.
  12. Run npx prisma db push --schema=./prisma/robochimp.prisma to create the tables on the database referenced in .env for the robochimp database.
  13. Run yarn build - then run yarn start. In the future, you can type only yarn start to start the bot.

If you have errors or issues, you can ask us for help in the #developer channel in the discord server.

Shared Testing Server

In addition to being able your develop on your own server as we have done above, there is a shared dev server which can be joined here:

You can also ask Magna to invite your Bot with your invite link above if you so wish.


Self Hosting

Self hosting is not supported.


Old School Bot - A fanmade discord bot based on Old School RuneScape (OSRS)








No releases published


No packages published