CAOS (Creatures Agent Object Script) is the generic name for the embedded scripting language used in all games in the Creatures series. Note that the details of CAOS vary from engine to engine, but all incarnations have some overarching similarities. CAOS is used to make objects such as COBs or agents, and even controls breeding patterns in worlds - there are many tutorials (see External Links) which can help you to learn the CAOS language.
- Looking for a quick fix? Here are some C3/DS CAOS Codes.
CAOS is a register-based language, with a set of opcodes with fixed argument lists. Local variables are not supported. The basic unit of CAOS code is the command which can be injected and executed by the engine. However, CAOS is mostly used in scripts, blocks of code identified by four integers - three identifying the object for which the script applies (0 may be used as a wildcard), and one identifying the event the script triggers on. Those form the backbone of the actual game, declaring the different forms of interactions between the different COBs or agents (a term for the programming objects introduced with Creatures 3 - every gadget or even creature in the world is an agent) by defining actions to be taken when certain events happen (from time triggered ones to collisions with other objects or even clicks).
Each script may contain subroutines; however as these cannot be shared and do not have local variables, they are little more than a convenience.
CAOS scripts have 100 registers of the form VAxx to use to hold temporary variables. In addition, an object may be selected into the special register TARG, and then 100 attributes of the object may be accessed with registers of the form OVxx. In most cases an object must be selected into TARG before it is acted upon. Using the command AVAR to access the OVxx variables of an agent without having to fiddle with TARG, one can implement simple arrays.
Note that while Creatures and Creatures 2, for performance reasons, use unsigned bytes (0-255) as integer types, later versions of the engine use 'normal' 32-bit integers (which can be very large) as well as floating point numbers (eg: 3.141592).
History of CAOS versions
- Creatures: Initial incarnation of CAOS.
- Creatures 2: Improved game engine. CAOS now supports physics.
- Creatures Adventures: New game engine - the Creatures Evolution Engine. Support for strings and file I/O is added. CAOS exceptions are much less likely to cause engine crashes.
- Creatures 3: Incremental improvements and changes to Creatures Adventures engine.
- Docking Station: Incremental improvements to Creatures 3 engine. Includes networking support (Babel).
- Sea-Monkeys: Incremental improvements and changes to Docking Station engine, without DS's Babel.
Full commented scripts
- Creatures 1 CAOS guide (PDF)
- Creatures 2 CAOS guide (DOC)
- How to generate the Creatures 3 CAOS guide
- C1 and C3 CAOS tutorials
- Helen's Bibble Directory - C2 CAOS tutorials
- Getting Started with CAOS - C3/DS
- AquaShee's CAOS Chaos - C3/DS
- Discussion on CAOS as image based programming language, and history of CAOS