From Creatures Wikia

Jump to: navigation, search

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 itself the name of a CAOS command! See CAOS (command).


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.141593).

Lists of CAOS Commands by Game

Note: These are incomplete.

Also all C3 CAOS commands listed in a batch file

History of CAOS versions

Full commented scripts


CAOS Chaos - A pair of tutorials for C3/DS by AquaShee

External links

Personal tools