Start here

BotWithUs scripts can be written in Java, Python or Lua. Whichever you choose, your script does not talk to the game directly. It runs inside a script host, a program the BotWithUs launcher installs and starts for you. The host reads live game state, hands it to your script, and sends your script's actions back to the game.

Which language should I pick?

• Java is the most complete option today, and the only one you can sell or share through the Script Market right now. It is the right choice if you want to publish a script.
• Python is the quickest way to try an idea. Save a file and run it, with no build step.
• Lua is small and simple, with no build step either. Its scripts run on one thread and pace themselves in game ticks.

Python and Lua run in the same native host, bwu_host, and see the same game state.

Where scripts go

~ is your Windows user folder, so ~/.botwithus/scripts/python is %USERPROFILE%\.botwithus\scripts\python.

Running a script on your own machine

1. Start the game through the BotWithUs launcher, so a client is running with BotWithUs attached.
2. Put your script in the folder for its language (above).
3. Open the host, pick your script and the client to run it on, and start it.

You can also run Python and Lua scripts from a console:

bwu_host --py $HOME\.botwithus\scripts\python\hello.py
bwu_host --lua $HOME\.botwithus\scripts\lua\woodcutter.lua

Each language section explains its own way of running scripts in detail.

Where to next

• Java: project setup
• Python: your first script
• Lua: your first script
• SDN: publishing through the Script Market