logo bannerlogo banner

yolkbot 1.5 release announcement

last edited: 2026-01-31

yolkbot 1.5 has released, and it is yolkbot's biggest release yet.

terminology (for idiots)

yolkbot 1.5: the new version of yolkbot, which released on 1/25/26. this is what you're reading about. yolkbot 1.4: the previous version of yolkbot, which is what your code runs on now.

what is this? why is this?

yolkbot 1.5 is the gap between yolkbot 1.0 and 2.0. it rewrites a lot of yolkbot's internal systems to be more efficient, stable, and easier to use.

will i have to use yolkbot 1.5?

i will continue to update yolkbot 1.4 after yolkbot 1.5 is released until March 1st, 2026. after this date, yolkbot 1.4 will no longer receive updates or support. (this gives you a month, you can migrate, it's not that difficult)

how do i migrate to yolkbot 1.5?

well, you should probably start by reading about the migration to actions, since that impacts everyone using yolkbot. after that:

node edition

  1. install yolkbot 1.5:
    • npm: npm install yolkbot@latest
    • bun: bun install yolkbot@latest
  2. try your bot! most bots work without any changes.
  3. if your bot breaks, read the new migration guide to see what changes you need to make.

browser edition

simply update your URLs:

  • .../global.js -> https://yolkbot.xyz/browser/global.js
  • .../module.js -> https://yolkbot.xyz/browser/module.js (without the .js should also work in most cases)

what improved in yolkbot 1.5?

  • pathfinding got smarter!
    • new SIMULATION intent allows for better pathfinding, especially when parkour is involved
  • the actions migration! - a new way to do things that were previously done with dispatches
    • bot.dispatch still (and always will) work!
    • if you ask me if bot.dispatch is getting removed i'm blocking you
  • new error handling system with better, more consistent errors
    • new error enums in yolkbot/enums for easy error handling
  • new errorLogger parameter for APIs and Bots, allowing for easier error logging:
    • this is only for things that are really critical errors you may want to look at
    • for advanced users only
import { Bot } from 'yolkbot';
const bot = new Bot({ errorLogger: (...data) => console.error('yolkbot error:', ...data) });
  • bot.getBestTarget - a new utility to get the best target for your bot to target
  • FASTER_RESPAWN intent - bots respawn faster (1s) with this intent enabled
    • without it, bots can respawn in 6s like normal players
    • with it, bots can respawn in 5s (the serversided limit)
  • you can pass simple strings as modes again
    • before: `bot.createPrivateGame('useast', GameMode.FFA, 'castle')
    • after: bot.createPrivateGame('useast', 'ffa', 'castle')
    • the old method will always work :)
  • yolkbot/socket (yolkws) supports autoReconnect!
  • tons of optimizations, making yolkbot faster and more efficient

my code isn't working on 1.5, but it did before!

this may be a bug! join the Discord and let me know :)