This wiki has been moved to https://github.com/SuperTux/wiki into the mediawiki branch.
A Candle object that was given a name can be controlled by scripts.
A Candle is instantiated via a definition in a level. It can be accessed by its name in scripts and via sector.name in the console.
Example of a definition:
(candle (name "CANDLE1") (burning #f) (x 1632) (y 1088) )
The above object will be exposed under the name CANDLE1 in the scripting engine. Example usage:
|get_burning()||returns true if candle is lighted|
|set_burning(bool burning)||true: light candle, false: extinguish candle|