Skip to content
Traveler - A general movement solution for
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
LICENSE Update Jun 26, 2017
Traveler.js make error code consistent with ts May 13, 2018
tsconfig.json added tsconfig Jun 26, 2017


Traveler is a general-purpose tool for moving your creeps around. Feel free to fork and use in other projects.



  1. Download Traveler.ts or Traveler.js or just copy/paste the code in Traveler.js into a new file using the screeps console.

  2. Add a require statement to main.js:

    • var Traveler = require('Traveler');
    • (in the sim or some private servers you might need to use 'Traveler.js')
  3. Replace situations where you used moveTo with travelTo

    // creep.moveTo(myDestination);

Installation animation

Performance considerations

  1. travelTo creates a new object in creep memory, _trav, which is analogous to the object used by moveTo() for caching the creeps path. For this reason, it will save memory to use either travelTo() or moveTo() with a given creep, but not both.
  2. As with any algorithm where creeps aren't a consideration for pathing by default, you'll have best results when their path has a low chance of including immobile creeps. My creeps rarely reach the "stuck threshold" because I take extra considerations to keep the roads clear.


The file itself has comments, and you can also find documentation in the wiki. I'm also looking for feedback and collaboration to improve Traveler, pull requests welcome!



  • Reorganized type definitions into index.d.ts
  • Fixed bug where public ramparts were not seen as pathable
  • Fixed bug that caused exceptions due to non-existant Memory.rooms


  • Fixed bug that caused options.preferHighway to not prefer highways


  • Fixed bug in the commented line of code that registered whether creeps were in a hostile room or not.
  • New version of Traveler! See what is different here. The old version can still be found here.


  • Fixed a bug where public ramparts were not set as valid positions for pathing in the costmatrix (thanks ricane!)


  • Fixed a bug where pathfinder gets needlessly called when using options.range (thanks helam!)


  • Fixed bug in code that determines whether a room is SK from roomname


  • Eliminated option returnPosition and added returnData
  • Fixed bug where preferHighway would not produce the intended results
  • Fixed bug where ignoreCreep behavior was reversed and creeps could not get unstuck
You can’t perform that action at this time.