Skip to content


Switch branches/tags

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, send me a message on discord.

Setting up the bot to run locally for contributing

To run the bot, you need the following things first: Git, NodeJS v12+, Postgres, a discord bot account

  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, input your bot token and Postgres database details; be sure to read the comments for any additional instructions.
  6. Go to and ensure your bot has Privileged Gateway Intents > Server Members Intent enabled.
  7. Create a file called .env in your project's root directory with the content (change as necessary for your DB, this is known as a DSN): DATABASE_URL=postgresql://postgres:postgres@localhost:5432/postgres?schema=public
  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 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.



  1. Old School Bot uses Klasa, a discord bot framework, if you have questions as to how Klasa works, or are interested in making your own Klasa bot, you can check it out here.

  2. The trivia questions/answers are not public in this repository, to prevent people from cheating. However, you can still submit some to be added. If you wish to submit some to be added, just ask me in the developer channel in our server. There are currently 260+ trivia questions.

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