The BattleBots Handbook

Andreas Agorander Bluefire@bluefire.nu

1. Introduction

• 1.1 General Description
• 1.2 Changes

2. Installation

• 2.1 How to obtain BattleBots
• 2.2 Requirements
• 2.3 Compilation and installation

3. Getting started: crash course

• 3.1 Quick start: Creating bots
• 3.2 Quick start: simulating

4. The way BattleBots works

• 4.1 The arena
• 4.2 The bots
• 4.3 Config Rules

5. The bot-creator

• 5.1 Components of bot creator

6. The BattleBots assembler language

• 6.1 Basics of the mnemonics
• 6.2 Symbols:
• 6.3 The "Red Tape" tags:

7. Running simulations

• 7.1 Running normal battle simulation
• 7.2 Running survival battle simulation
• 7.3 Running deatchmatch battle simulation
• 7.4 Running league tournaments
• 7.5 Running KOTH tournaments
• 7.6 Running Cup tournaments

8. Creating your config

9. Details of devices

• 9.1 CPU:
• 9.2 Engine:
• 9.3 Steering:
• 9.4 Plasmagun:
• 9.5 Armor:
• 9.6 Scanner:
• 9.7 fuel:
• 9.8 Turret:
• 9.9 Time-device:
• 9.10 Shield device:
• 9.11 Repair device:
• 9.12 Radio device:
• 9.13 Minelayer:
• 9.14 Missile:
• 9.15 beam
• 9.16 AS-Rocket
• 9.17 chaff
• 9.18 Scanwarner/detector
• 9.19 Chiller
• 9.20 Cloak device

10. Details of instructions

• 10.1 mov
• 10.2 nop
• 10.3 movsb/movsw
• 10.4 stosb/stosw
• 10.5 lodsb/lodsw
• 10.6 push
• 10.7 pop
• 10.8 xchg
• 10.9 test
• 10.10 cmp/icmp
• 10.11 cmpsb
• 10.12 jmp
• 10.13 jz,jnz,jae,jbe,ja,jb,cj,cjn
• 10.14 lz,lnz,la,lb,lae,lbe
• 10.15 loop
• 10.16 call
• 10.17 ret
• 10.18 iret
• 10.19 cli,sti
• 10.20 out
• 10.21 in
• 10.22 inc,dec
• 10.23 add,sub
• 10.24 and,or,xor
• 10.25 shr,shl
• 10.26 ishr,ishl
• 10.27 ror,rol
• 10.28 int
• 10.29 mul/imul
• 10.30 div/idiv
• 10.31 sin
• 10.32 cos
• 10.33 sinfunc
• 10.34 cosfunc
• 10.35 atanfunc
• 10.36 rnd
• 10.37 hwait
• 10.38 sqr
• 10.39 msg
• 10.40 err
• 10.41 readfile / writefile

11. "Physical" details of objects

• 11.1 Speeds:
• 11.2 Explosion strength
• 11.3 Heat generated
• 11.4 Fuel used

12. Questions and Answers

• 12.1 Windows version

13. Credits

14. Copyright