Built by: Megafont

Contents:

About This Wiki  -  How to use and edit this wiki, type conventions used within, etc.

Pop Scripting Basics  -  Populous Scripting basics, such as comments

Pop Script Commands  -  Listing of Pop Script commands

       DO STATE Commands  -  Listing of Pop Script DO STATE commands

       DO Commands  -  Listing of Pop Script DO commands

Internal Attribute Variables   -  Listing of Pop Script Internal Attribute Variables

Level Listing  -  A list of all Populous: The Beginning levels with various info about each, such as what AI scripts it uses

Incomplete Knowledge Listing  -  A list of everything that we don't yet fully understand about Pop Scripting

Tutorials  -  Tutorials can be found in here

Glossary  -  You can find definitions for various terms and things in here

Comments:

Line comment: Any code followed by a double forward slash ( // ) until the end of the line is ignored by the compiler.

Block comment: A block comment begins with /* and ends with */.  Any code between them is ignored by the compiler. A block comment can span multiple lines. Blank lines are ignored.

Examples:

The script must end with the SCRIPT_END command.  Any code after it is ignored.

 
Example:

{
   // some code
   // in here
}
SCRIPT_END

To use a variable, use the $ prefix followed by the variable name.  It can be up to 32 characters long, but can't contain spaces.  The maximum number of user variables allowed is 64.

You can assign a value to a variable by using the SET Command.

Examples:

$a_variable

// set the value of $my_var to 2
SET $my_var    2

// assign a value from another variable
SET $my_var2   $another_var
SET $my_var3   INT_B_BUILDING_SMALL_HUT

Constants:

Examples:

0
1
12
206

// assign a constant to a variable
SET $var 25

SET

INCREMENT

MULTIPLY

DIVIDE

IF, ELSE, ENDIF

EVERY

DO  -  Executes a command.  See the following sections about the commands you can execute with DO.

        DO STATE Commands
       
        DO Commands

This section contains known information about all of the Populous Scripting DO commands.  Click on a command name below to go to its command documentation page.  Note that some commands can be used in the initialization section of a script, while others won't work if you try to use them there.

A DO                ATTACK   B DO         BUILD_AT         BUILD_DRUM_TOWER         BUILD_MAIN_DRUM_TOWER   C DO         CAMERA_ROTATION         CLEAR_ALL_MSG         CLEAR_GUARDING_FROM         CLEAR_STANDING_PEOPLE         CONVERT_AT_MARKER         COUNT_ANGELS         COUNT_BLUE_IN_HOUSES         COUNT_BLUE_SHAPES         COUNT_BLUE_WITH_BUILD_COMMAND         COUNT_PEOPLE_IN_MARKER         CREATE_MSG_INFORMATION         CREATE_MSG_INFORMATION_ZOOM         CREATE_MSG_NARRATIVE   D DO         DEFEND_SHAMAN         DELAY_MAIN_DRUM_TOWER         DELETE_SMOKE_STUFF         DESELECT_ALL_BLUE_PEOPLE         DISABLE_USER_INPUTS         DONT_TARGET_BLUE_DRUM_TOWERS         DONT_TARGET_BLUE_SHAMAN         DONT_TARGET_FIREWARRIORS   E DO         ENABLE_USER_INPUTS   F DO         FIX_WILD_IN_AREA         FLASH_BUTTON         FLYBY_CREATE_NEW         FLYBY_SET_END_TARGET         FLYBY_SET_EVENT_ANGLE         FLYBY_SET_EVENT_POS         FLYBY_SET_EVENT_TOOLTIP         FLYBY_SET_EVENT_ZOOM         FLYBY_START         FLYBY_STOP   G DO         GET_HEAD_TRIGGER_COUNT         GET_HEIGHT_AT_POS         GET_NUM_ONE_OFF_SPELLS         GET_NUM_PEOPLE_BEING_PREACHED         GET_SPELLS_CAST         GIVE_MANA_TO_PLAYER         GIVE_ONE_SHOT         GIVE_PLAYER_SPELL         GUARD_AT_MARKER         GUARD_BETWEEN_MARKERS   H DO                HAS_TIMER_REACHED_ZERO         I DO         I_HAVE_ONE_SHOT         IS_BUILDING_NEAR         IS_PLAYER_IN_WORLD_VIEW         IS_PRISON_ON_LEVEL         IS_SHAMAN_AVAILABLE_FOR_ATTACK         IS_SHAMAN_IN_AREA

K DO         KILL_TEAM_IN_AREA   M DO         MARKER_ENTRIES         MARVELLOUS_HOUSE_DEATH         MOVE_SHAMAN_TO_MARKER   N DO         NAV_CHECK   O DO         ONLY_STAND_AT_MARKERS         OPEN_DIALOG   P DO         PARTIAL_BUILDING_COUNT         PRAY_AT_HEAD         PREACH_AT_MARKER         PUT_PERSON_IN_DT   R DO         REMOVE_HEAD_AT_POS         REMOVE_PLAYER_THING         REMOVE_TIMER         RESET_BASE_MARKER   S DO         SEND_ALL_PEOPLE_TO_MARKER         SEND_BLUE_PEOPLE_TO_MARKER         SEND_SHAMAN_DEFENDERS_HOME         SET_ATTACK_VARIABLE         SET_BASE_MARKER         SET_BASE_RADIUS         SET_BUCKET_COUNT_FOR_SPELL         SET_BUILDING_DIRECTION         SET_DEFENCE_RADIUS         SET_DRUM_TOWER_POS         SET_MARKER_ENTRY         SET_MSG_AUTO_OPEN_DLG         SET_MSG_DELETE_ON_OK         SET_MSG_TIMEOUT         SET_NO_BLUE_REINC         SET_SPELL_ENTRY         SET_TIMER_GOING         SET_WOOD_COLLECTION_RADII         SPELL_ATTACK         STATE_SPELL_DEFENCE         STOP_CAMERA_ROTATION   T DO         TARGET_BLUE_DRUM_TOWERS         TARGET_BLUE_SHAMAN         TARGET_FIREWARRIORS         TRACK_SHAMAN_TO_ANGLE         TRACK_TO_MARKER         TRAIN_PEOPLE_NOW         TRIGGER_LEVEL_LOST         TRIGGER_LEVEL_WON         TRIGGER_THING         TURN_PANEL_ON         V DO         VEHICLE_PATROL         Z DO         ZOOM_TO