|AISA : AI Character Setup Array|
- The XML code on this page is based on OniSplit v0.9.61.0.
- AISAlevelN_scripts.oni is level specific (it can be found in AE/AEInstaller/vanilla/levelN_Final.dat).
- AISA is still used for a few cutscene characters, even though BINACJBOCharacters has made it redundant.
- If you make an AE package containing an AISA file, you must also include the corresponding ONLV or else Oni will crash.
<?xml version="1.0" encoding="utf-8"?> <Oni> <AISA id="0"> <Characters> [...] </Characters> </AISA> </Oni>
[...] means at least one character. Paste all character data into there (this includes <AISACharacter> and </AISACharacter> tag).
<AISACharacter> <Name></Name> <ScriptId>1000</ScriptId> <FlagId>100</FlagId> <Flags></Flags> <Team>Konoko</Team> <Class>ONCCgriffin_generic</Class> <Scripts> <Spawn></Spawn> <Die></Die> <Combat></Combat> <Alarm></Alarm> <Hurt></Hurt> <Defeated></Defeated> <OutOfAmmo></OutOfAmmo> <NoPath></NoPath> </Scripts> <WeaponClass></WeaponClass> <Ammo>0</Ammo> </AISACharacter>
|XML tag||Content type||Description|
|<?xml version="1.0" encoding="utf-8"?>||string||there's no reason to change this|
|<AISA id="0">||integer||instance id, do not change|
|<AISACharacter>||-||start tag of a character data|
|<Name>||char||name of AISA character|
|<ScriptId>||integer||ID of the character, which you can spawn with the scripting command "chr_create"
If the ID is 0, the character is spawned as a player character, stealing controls (but not focus) from the current player. Focus is transferred as well if the old player is deleted immediately before the new one is created.
If the name field is left blank, the engine will generate an automatic name "ai_#", where # is the runtime ID of the character (first empty slot in memory at the time of the spawning). The ID is not zero-padded: "ai_0, "ai_1", ...
|<FlagId>||integer||flag where character is spawned; must be a valid flag ID (from the BINACJBOFlag list)
In the level Atmospheric Conversion Center (exterior), Bungie used FILM files to teleport AI Konoko and Griffin.
If the flag ID requested by "chr_create" is obsolete or otherwise unavailable, "chr_create" will fail with a message to the console.
|<Flags>||flag||these flags can be also found via onisplit -help enums
|<Team>||flag||these flags can be also found via onisplit -help enums
|<Class>||link||must be a valid ONCC; replaced with first available ONCC if missing
Missing ONCCs are resolved by picking the first available ONCC. If the eventually used ONCC is invalid (e.g., if it has a missing TRAC or if its ONCV is missing from ONVL), Oni will crash. This applies to CHAR a.k.a. "ai2_spawn", AISA a.k.a. "chr_create", and "ai2_chump" (hardcoded to spawn ONCCstriker_easy_1).
Since nearly all the inventory fields are ignored, AISA characters can't be created with inventory items, and so the "out of ammo" script function is irrelevant. The inventory can still be set with scripting (items that the character can use, not what they drop when killed). The NoPath function doesn't seem to work, neither does it seem to work for CHAR.
|<WeaponClass>||link||ONWCname (without file suffix .oni)
Original weapon classes:
|<Ammo>||integer||percentage; 0 - empty, 100 - fully loaded ?|