Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?


Failed to load latest commit information.

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.


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