yolkbot 1.5 release announcement

yolkbot 1.5 was yolkbot's major release, deemed 'the biggest yet' with many breaking changes. the deadline has been reached, meaning previous versions of yolkbot are now deprecated and no longer supported. if you haven't migrated to yolkbot 1.5 yet, you should probably do that soon!

terminology (for idiots)

yolkbot 1.5: the new version of yolkbot, which released on 1/25/26. yolkbot 1.4: the previous version of yolkbot, which has been deprecated.

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.

do i have to use yolkbot 1.5?

yes. the deadline for migrating to yolkbot 1.5 has been reached, and yolkbot 1.4 is no longer supported. if you don't migrate, your bot will entirely stop working at some point in the future

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 the yolkbot latest as usual:
   • 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 :)