                     BATTLECRUISER 3000AD GAME BUILDER SYSTEM
                     ========================================

Last updated : 01/01/00

===============================================================================
                                TABLE OF CONTENTS
===============================================================================

1.0  INTRODUCTION
1.1   - Scripting concepts
1.2   - AI Discussion
1.3   - AG Discussion
1.4   - Race/Caste Discussion
1.5   - Importing/Creating world entities
1.6   - Restrictions in GBS 'lite'
2.0  GAME WORLD CREATION
3.0  SCRIPTING CONCEPTS
3.1   - The GBS Parser
3.2   - Layout & Syntax
3.3   - Object Identifiers
3.4   - Logical Layout & Organization
3.5   - Read Only: System Files
3.6   - Creating A MISCON Description File
3.7   - Filename Convention
3.8   - GBS File Types
3.9   - Planning & Creating Scripts
3.10  - Easy Steps For Creating Scripts
3.11  - Distributing Scripts
3.12  - Script Development Tips
4.0  THE SCRIPT & OBJECT PARSER
4.1   - Script Blocks Explained
4.2   - Parsing A Script
4.3   - Parsing An Object
4.4   - Universal Time Format
5.0  SCRIPT BLOCKS EXPLAINED
5.1   - [ACM]
5.2   - [DYNAMIC]
5.3   - [AI]
5.4   - [EVENT]
5.5   - [SETS]
5.6   - [MACRO]
5.7   - [REGION]
5.8   - [CLASS]
5.9   - [COMMS]
6.0  START/STOP 'nav' commands
      - @date|time|inactive
      - NEAR <objectA> <distance> <objectB>
      - IN <region>
      - ORBIT <object> <distance> <speed> [roll angle] [pitch angle]
      - ESCORT <object> <distance> <position>
6.1  START/STOP 'action' commands
      - CRUISE <object>
      - DOCK <object> [time]
      - FLEE
      - HYPERJUMP <region>
      - INTERCEPT <object>
      - JUMP <object>
      - ORBIT <object> <distance> <speed> [roll angle] [pitch angle]
7.0  SYSTEM EVENT TRIGGERS
      - !ARRIVED <region>
      - !CREATED <object>
      - !DAMAGED <object>,<amount>
      - !DESTROYED <victim>,[attacker]
      - !DETECT <race|caste|object>,[<...>]
      - !DISABLED <object>
      - !DOCKED <object>
      - !EXIST <object>
      - !NOEXIST <object>
      - !REACH <object>
      - !REGION_SECURE <region>
      - !STARTUP
      - !UNDER_ATTACK [object]
7.1  SYSTEM EVENT ACTIONS
      - ACM_NEXT
      - ACM_OFF <caste>
      - ACM_SKIP_ENABLE <on|off>
      - ACTIVATE <object>
      - ADD_MEDAL <0..7>,<num>
      - ADD_STORE <object>,<qty>,<itm_num>,...
      - ATTACK <object>
      - AUTOGEN <on/off> [region]
      - BROADCAST <"message">
      - CAP [region]
      - CAPTURE <object>
      - CLEAR_GUEST <id>,[officer,"message","sfx"]
      - CLEAR_INTRUDER <id>,[officer,"message","sfx"]
      - CLEAR_PRISONER <id>,[officer,"message","sfx"]
      - CLOAK <on|off|ai> [object]
      - CLOAKING <on|off|ai> [object]
      - COURTMARTIAL <on|off>
      - CREATE <num>, [set_member...]
      - CREATE_GUEST <id>,"name",<loc>,[officer,"message","sfx"]
      - CREATE_HOSTILE <race>,<caste>,<class>,<num>,[id]
      - CREATE_INTRUDER <id>,<loc>,[officer,"message","sfx"]
      - CREATE_PRISONER <id>,<loc>,[officer,"message","sfx"]
      - CRUISE <object>
      - DAMAGE_SYSTEM <ship>,<system>,<amount>
      - DEACTIVATE <object>
      - DEFEND <object>
      - DEL_STORE <object>,<qty>,<itm_num>,...
      - DESTROY <object>,<time>,<mode>
      - DOCK <object> [time]
      - EMIT_SOS <on|off|ai> [object]
      - EP_ADD [amount]
      - EP_DEC [amount]
      - ESCORT <object> [on|off]
      - FLAG1..9 <on|off> <object>
      - FLEE [region]
      - FLEETRTB [platform]
      - HALT <on|off|ai> [object]
      - HYPERJUMP <region>
      - IF/IFNOT/THEN/ELSE/ENDIF/RETURN
         HERE <object>, HERE <BC|PLAYER>, ACM <id>, EXIST <object>
         DESTROYED <object>, DOCKED <object>, EMIT_SOS <object>, CLOAK <object>
         DISABLED <object>, FLAG1..9 <object>, <object> IN <region>,
         <object> ESCORT, <object> TOWED, <object1> TOW <object2>
         <object> CONTAINS <item>, <object> TAKEOVER <race> <caste>
         <object> UNDER_ATTACK, <object> DAMAGED <amount>, CMA, EPGE <amount>
         RANK <0..4>
      - IGNORE <on|off>
      - INVINCIBLE <on|off> [object]
      - JETTISON_STORE <object>
      - JUMP <object>
      - LAUNCH [caste],<object|class>,<num>,<orders>
         LAY,SWEEP,TOW,CAP,SAD,SEAD,SAR,PATROl,ESCORT,ATTACK,DEFEND,DOCK
         JUMP,HYPERJUMP,FLEE,RECOVER
      - LAUNCHES <on|off|ai> [object]
      - LAY [region] [object_type]
      - MOD_ALLIANCE <raceA>,<raceB>,<value>
      - MOVE_ALL_STORE <objectA>,<objectB>
      - MOVE_STORE <objectA>,<objectB>,<qty>,<itm_num>,...
      - ORBIT <object> <distance>,<speed>,[roll],[pitch]
      - PATROL [region]
      - PATROLZ <object>, <regionA,<regionB>,...
      - PTEAUTOGENOBJ <region>,<class>,<map_num>,<num>,<x>,<y>
      - PTEDESTROYPLANET <planet>
      - REBUILD <object>
      - RECOVER <object>
      - REENABLE <time>
      - RESET_UNDER_ATTACK <object>
      - RESUPPLY <time> <objectA> <objectB> [crew,fuel,repair,weapons
                 ships,items_set,stores|all]
      - RTB [platform]
      - SAD [region]
      - SAR [region] [object_type]
      - SAY [officer],"message",[<"sfx">]
      - SEAD [region]
      - SET_CAREER <caste>
      - SET_RANK <0..4>
      - SIGNAL <event> [time]
      - SLAVE [on|off] <object>
      - SWEEP [region] [object_type]
      - TOW <object to tow> [deliver action] [destination] [final action]
      - WEAPONS <on|off|ai> [object]
      - VIOLATION_ADD [amount]
      - VIOLATION_DEC [amount]
      - XC_INIT
      - XC_REARM <0..9>
8.0  RESERVED SCRIPTING ID KEYWORDS
      - General Purpose
          THIS, THIS_REGION,IT,DISABLED,SOS_EMIT,LEADER,PLATFORM,TARGET,
          ANYTHING
      - Player's crafts
          PLAYER, BC, IC, SC, ATV
      - Player's personnel
          OFFICER, PILOT, MARINE, SENGINEER, FENGINEER, GUEST, PRISONER,
          INTRUDER, MEDIC
      - Interstellar objects
          FLUXFIELD, WORMHOLE, JUMPPOINT, HAZARD, PLANET, MOON
      - Object classes
          CARGOPOD, ODS, LAUNCHPAD, FIGHTER, CRUISER, CARRIER, TRANSPORT,
          SHUTTLE, CRAFT, NAVAL, STRATEGIC, TACTICAL, INTERSTELLAR,
          SPECIAL, LFCRAFT, BASE, PLANT, STRUCTURE, BUILDING, CITY, FACTORY,
          STARBASE, STARSTATION, RADAR, MARINE, TROOPS, PERSONNEL, SAM, SAL,
          VEHICLE, COLLATERAL, MISC, PROBE, SATELLITE
      - Artifacts
          HSD, ENM, ORB, TAS, KMR, TCD, PAD, RANDOM, RDECODER, JAC
9.0  ALIEN NATIONS/CASTES
      - Alien Castes
        Military, EarthCOM, Police, Marine, Raider, Insurgent, Assassin
        Mercenary, Criminal, Explorer, Colonist, Scientist, Diplomat, Trader
        Paramedic, Worker, Commercial, Journalist, Tourist, Hacker, SEngineer
        FEngineer, Hazard, Aggressive, Harmless, Anycaste
      - Alien Nations
        Terran, Syrion, Kandorian, Empirian, Vesperon, Droidan, Falkerie,
        Mandorian, Gammulan, Zelon, Valkerie, Credian, Galaxian (hidden)
      - Alien nation alliances (default)
10.0 PLAYER SHIP SPECIFICATIONS
      - Ship personnel
      - Ship locations
      - Ship systems
11.0 WORLD DATABASE
      - List of space/planet regions    (see NAVCHART.PDF)
      - List of space region jump links (see NAVLINKS.PDF)

12.0 OBJECT DATABASE
      - List of scripting objects       (see OBJECTS.TXT)
      - Object AI parameters
13.0 A SAMPLE SCRIPT
      - A complete script showing several techniques (see BC3K9800.SCR)
13.1 TRADING ITEMS DATABASE
      - List of valid trading items that can be used as object 'stores'
14.0 CREATING NEW GAME OBJECTS
      - Steps for creating 3D objects
      - Object AI parameters (embedded & scripted)
      - Importing 3DStudio or MAX object models
      - Using TED to embed object characteristics
      - Using CV3D to convert .ASC models to .3D format
      - Using PREPARE to parse object models
      - How to use new objects in BC3K
      - How to view new objects using BC3K
15.0 REPLACING GAME SOUNDFX AND MUSIC
