Modlog for modders

[Commando]

Need a host for the modlog.

[General BlackDragon]

Commando convinced me to post my own thingy that includes a list of odf stuff i got from Space, and all my note's from the 1.3 changelog on additions and stuff... I edited some of the descriptions to be more accurate. The rest can be found in commando's modlog of things added to 1.3, the maximum charachter limit of 20000 wont allow me to post mine

- LIST OF ODF COMMANDS

[GameObjectClass]
Basename - Base configuration for ODF, this decides what groups, wireframes, unit icons, and such not that the unit uses be default name.
GeometryScale - Makes model on this ship smaller or larger. 1.0 is default, less is smaller, more is greater.
GeometryName - Name of the XSI or X file used for this object.
MrMFactor - Never actually used this, but its obviously the rate of MRM used on this ship...I belive some BZ2 units use this, so I would look at those for examples.
AnimCount - Amount of animations used for a ship. You could probably have as many as you want. But of course, BZ2 will only use the ones the code wants.
AnimName - Name of animation for the unit, BZ2 is very restrictive with these names.
AnimFile - Filename of the XSI (Does BZ2's version of X support anims?) with the animations.
CockpitScale - Samething as Geo. Scale but for the ship's cockpit model.
CockpitName - Name of cockpit model XSI or X file for the ship.
AnimCountCockpit - Amount of animations for Cockpit of the unit...never tried this on anything.
AnimeNameCockpit - Same thing as AnimName but for Cockpit.
AnimFileCockpit - Same thing as AnimFile but for cockpit.
ScrapCost - Amount of Scrap unit costs to build. Values can be in the thousands range from what I have seen.
ScrapValue - amount of scrap dropped/recycled when it dies
PowerCost - Amount of power required to build and how much it takes up when its built. works on units as well as buildings. Can use negetive values to make it give power too.
BuildTime - Time in seconds for how long it takes to build.
CustomCost - Scrap Cost used for unit when you customize it's weapons.
CustomTime - Same as Cust. Cost but for build time.
BuildRequire - What type of terrain is required for the building to be placed on. Valid values are: N (None) F (Flat) A (Adjacent) B (Base)
BuildSupport - Same values for Build Require are used here, gives the support of that type. Like if its B for Base, it will be able to have buildings that require B built next to it. (Like the Recycler would have this)
MaxHealth - Amount of "HP" the unit has.
AddHealth - How much health can be regenerated a second. Usually 0.
MaxAmmo - Amount of Ammo the unit has.
AddAmmo - Add health's version for Ammo.
UnitName - Name for unit displayed on the HUD ingame.
UnitIcon - name of the file used as the unit icon. Can be any filetype BZ2 supports. By Default it is a TGA file with Icon as a prefix and the name of the basename of the unit.
UnitStatus - Same as UnitIcon, but for the Unit's wireframe. Prefix for this is Wire.
AiName - Name of the AI process for the unit. (See lower for a full list)
AiName2 - Same as AIName, but I belive this is the process used for the unit if its on an Enemy team from you.
WeaponMask - Links the HPs an AI unit will fire when attacking. HPs are lined up backwards, so 00000 is HP 54321. You can enable an HP on by using 1 rather than a 0. If all are 0's then unit will only fire first weapon, it will only fire more if the first weapon is linked. (Like an ISDF Scout)
CollisionRadius - Self Explanitory. For units this is how much they avoid things by, how far they will spread out/go around.
Nation - Race name setting in the ODF. Does NOT work.
ImageSignature - Self Explanitory. Based on the signature the locking time for Image locking missiles (Like Shadowers) is modified.
HeatSignature - Same as above, but for Thermal missiles. (Hornet)
RadarSignature - Same as above, but for Radar Missiles. (Comet Cruise, Radar Popper, ect.)
ExplosionName - Name of ODF for the explosion file for this unit. BZ2 uses a default value for this, which 1.3 can specifically be modified for a certain race.
InfoName - Name of the INF file BZ2 will use when you target the unit with your identifier. ("I" Key)
CanCollide - I belive its only for buildings. Tells if the unit is "Ethereal" or if it is collidable. If left alone BZ2 looks for a collision box for this. If turned on BZ2 makes its own box. Collision Radius modifies this somewhat.
IsTerrain - Dunno about this...must tell if its a Terrain Class unit or not.
OwnsTerrain - Tells BZ2 if it takes up terrain or not. If it doesn,'t stuff can be built over it.
BoxCollide - If on BZ2 uses a Box collision box for this unit. (Usually for units, probably only works for buildings if there is no collision box present and CanCollide is on) if off then BZ2 will use a Sphere collision.
NeedPilot - Tells BZ2 if this ship can have a pilot inside of it. (This is automatically off for some class)
CanDetect - Tells BZ2 if this unit can be detected on radar, also cant order something to attack it.
CanInteract - Tells BZ2 if this unit can interact with the player's Reticle.
CanSnipe - Tells BZ2 if this unit can be sniped or not...its invalid if the ship can't have a pilot in it.
IsAssault - Flag for AI units to tell if they should morph and/or use their assault weapon for attacking this unit. As usual 0 is no and 1 is yes.
IsSingle - In 1.2 this command tells that once this is build the player can't make anymore of this classlabel anymore. (Like the Bomber Bay) 1.3 changes this to limiting to Basename rather than Classlabel.
IsGrouped - Does this unit take up an F# group?
NeedGroup - Needs a free F# group to build.
IsLimited - Adds this unit to the MP unit limit.
NeedLimit - Needs a atleast 1 free slot in the unit limit to build.
ArmorClass - Armor class for unit, weapons do certain damage to units depending on its armor. Applicable values are N (None) L (Light) and H (Heavy).
ShieldClass - Supposedly configs what shield class the unit has. Never used it, it DOES work, although I don't know if it will show a shield effect or not though on the unit. Its defaulted to N (None) applicable values are S (Stasis) D (Deflection) and A (Absorbtion).
RequireCount - Amount of units/buildings required to build.
RequireText - Text displayed when you don't have the build requirements.
RequireName - Name of the ODF that is require. Depending on the count Require Name and text have # at the end of them. Each # goes in order from 1-whatever stating which part of the RequireCount it is. This is the same for things like Animations and Cockpit anims.
ProvideCount - Works the same way as require's stuff does. if you build this unit whatever ODF is in the providename area is set as if that building exists. So if I upgrade ibfact to ibafact it will work, but some units buildable that are in ibfact that are also in ibafact may require ibfact to be buildable, I belive if the providename is ibfact then those units will still be buildable.
ProvideName - Name of provided ODF.
UpgradeName - Name of the ODF the unit can be upgraded into, you can only have one of these per unit.
AlwaysClip - Yes or No type flag, defines ship clipping...never used this.
WeaponHard - Name of the Hardpoint on the ship this weapon will be on. It can be anything, but BZ2 only recognises certain ones. Each weapon command uses a number at the end like the Anim and Require count stuff, the number is which of the 5 weapons on a ship it is.
VisualHard - Name of the HP that the weapon's model is displayed at. (See the pilots for an example)
RecoilName - Another Weapon command, tells BZ2 which part of the model that has a 'kickback' when its corresponding weapon is fired.
WeaponAssault - Tells if this weapon should be used against an assault target or a combat target. Like IsAsault, 1 is Assault and 0 is Combat.
WeaponName - Name of the ODF used as the weapon.
LightHard - Uses a # to indentify like a Weapon command. Not sure if there is a light HP limit...
LightName - ODF name for the light.
EffectHard - uses # identification like Weapons and Lights.
EffectName - ODF file the effect uses.
TurretCount - yet another # identified command. Amount of turrets on a unit.
TurretName - Name of part of the unit mesh that is a turret, BZ2 only recognises certain ones.

[CraftClass]
RangeScan - This would be the maximum Radar Range.
PeriodScan - Amount of time between radar pings.
WeaponPitch - Self Explanitory
FilterFactor - Absolutely no idea WHATSOEVER. You can have a maximum of 4, ranging from 0-3.
SelectOtherMsg - Voice Over command for when you select the unit and it is doing something...other...
SelectWaitMsg - VO Command for when you select the unit and it is doing nothing.
SelectGoMsg - VO for when you select unit and it is en' route.
SelectFollowMsg - VO for when you select unit and it is Following something, I belive this counts for following you too.
SelectAttackMsg - VO for when you select unit while its attacking.
SelectPickupMsg - Never used before, probably a VO for when you select it and its en' route to picking you up.
SelectDropoffMsg - VO for when you select a unit thats going through DropOff...Dropoff is considering by very few units, examples would be when an APC is en route to dropping off Soldiers or when a Bomber is moving to drop its payload. (Not Bomber can't use it)
SelectDeployMsg - VO for when you select a unit while its deploying.
SelectUser1Msg - VO for when you select a unit doing a special task. (Like Servicing or Building, ect.)
SelectUser2Msg - VO for a Second situation like User1.
OtherMsg - VO for when unit does...other...
Gomsg - VO for when unit goes somewhere.
GoObjectMsg - VO for when unit is told to go to an object. (Dunno if this works since usually when they go to an object they either follow or defend...could be a CMD_DEFEND VO though)
FollowMsg - VO for when a unit is told to follow and object. (Usually vecs, buildings use Defend rather than Follow)
FollowMeMsg - VO for when a unit is told to follow you.
RepairMsg - VO for when unit is told to repair...no way to initiate command as far as I know.
ReloadMsg - same for Repair but for ammo. No way to activate aside from DLL, but could produce unknown effects since the command asks the AI to tell the Armory to give it Ammo or Health (depending on command) dunno if it will still work if the Armory can't even build it in the first place.
RescueMsg - VO for when unit is told to pick you up.
RecycleMsg - VO for when unit is told to Recycle.
HoldMsg - VO for when unit is told to Hold Position.
User1Msg - VO for special actions. (Like Servicing a unit)
User2Msg - VO for a second special action.
DeploedMsg - VO for when unit is finished deploying. (Turret Deployed! For BZ1. )
PackedMsg - VO for when Recycler is done undeploying. Obviously impossible in BZ2 now...although its possible it could work on turrets and such as a VO for when it is finished undeploying...never tried it.
KilledMsg - VO played when unit kills a target given to it when told to through MODE_ATTACK. (player telling it to)
DiedMsg - Old BZ1 VO where it would play a VO when unit died. Used for Betty VOs which BZ2 does by other configuration ODFs, never worked in BZ2.
BraccelFactor - AI command I belive, never tweaked it much. According to Zero Angel its the 'Width' in which an AI unit will strafe.
VelFactor - Velocity Factor between how far back and forth the AI will move the ship.
StrafeFactor - How often the unit will change its strafe direction.
OmegaScale - Not sure, AI command. could have something to do with pitch.
AlphaScale - Same...
SteerFactor - Self Explanitory.
OmegaFactor - According to ZA its a form of Target Lead "Smoothing" for the AI.
OmegaScaleTurret - Whatever OmegaScale is for, this is its version for a ships turret.
AlphaScaleTurret - Same as above.
SteerFactorTurret - Mainly, how loosely a unit will turn its turret under AI control.
OmegaFactorTurret - I guess TL "Smoothing" for an AI unit's turret
AvoidSpeed - Probably speed at which the AI will avoid enemy units.
TopSpeed - Self Explanitory, AI command.
EngageRange - Range at which the AI will decide its time to start attacking the Enemy...and/or go into Defense Mode.
FollowRange - Most likely the distance from the ship it keeps when following.
BlastDist - Basicly a range at which a unit will stand in a holding position and just blast his guns at an enemy unit.
AttackTask - AI task used for when the player tells an AI unit to attack.
DefendTask - AI task for when unit is in defense mode. (When Enemy AI aproches it instead of it approaching the enemy. GTs use this most of course)
WaitTask - AI task used when unit is just sitting there.
SpecialTask - AI task for when it does something...special.
SubAttackTask - Secondary AI Attack Task.
SubAttackClass - Class for which the AI is told when to execute these Tasks. uses 3 letters. The first letter can be N or A. N is attack ground only, A is include Air. 2nd letter is either N or D. N for regular attack and D for being deployed before attacking. 3rd letter is either N or S. N is use the engage range to attack and S is to use Weapon Range.
TeamTransferable - Tells if the player can distribute this unit to others in MP.
CanRescue - Enables disables the #5 Rescue command in 1.3. In 1.2 this could be used, but only for Wingman class units. (And I belive its not in the [CraftClass] area for 1.2)
EjectRatio - Ratio at which an AI pilot will eject or not from a ship when it blows.
XplSnipe - Explosion ODF used for when a ship is sniped.
XplChunk - Explosion ODF used for the chuncks when a ship is killed.
XplCrash - Explosion ODF used for when the ship's "crashing mesh" blows.

[HoverCraftClass]
velocForward - self explanitory
velocReverse - self explanitory
velocStrafe - self explanitory
accelThrust - self explanitory
accelBrake  - self explanitory
accelDragStop - how fast it stops once hands are off controls
accelJump  - self explanitory

setAltitude - how high off the ground

alphaTrack - springs speed it rights itself
alphaDamp - shocks

pitchPitch - nose up
pitchThrust - nose down

rollStrafe - rolls while strafing
omegaSpin - spinning in place speed
omegaTurn - turning while moving speed
alphaSteer - how fast it responds to steering
rollSteer - rolls while steering

soundThrust - sound of engines at forward and idle
soundTurbo - sound of engines forward and turning

REFERENCES:

Unit classes:

Commtower
i76building
Supplydepot
Factory
Jammer
Powerlung
Extractor
Turret
Armory
Sensor
Person
Morphtank
Artillery
Howitzer
Assaulttank
Tug
Constructionrig
RecyclerVehicle
Scavenger
Service
Turrettank
fv_walker
iv_walker
Bomberbay
Commbunker
Artifact
Minelayer
Shieldtower
i76sign
powerplant
powered
teleportal
barracks
SAV
APC
bomber
Wingman
Kingofthehill

Weapons:

"arccannon", "blink", "cannon", "chargegun", "damagefield", "dispenser", "forcefield", "imagelauncher", "imagerefract", "jetpack", "launcher", "machinegun", "magnetgun", "mortar", "multilauncher", "radardamper", "radarlauncher", "detonator", "salvolauncher", "satchelpack", "shieldup", "targeting", "terrainexpose", "thermallauncher", "torpedolauncher"

Ordnance:

"anchor", "beam", "bouncebomb", "bullet", "grenade", "imagemissile", "lasermissile", "laserpopper", "targeting", "lockdown", "magnetshell", "missile", "popper", "pulse", "radarmissile", "radarpopper", "seismic" (broken), "snipershell", "thermalmissile"

Dispensed:

"flare", "magnet", "mine", "proximity", "satchel", "seeker", "spraybomb", "tripmine" (proximity mine that builds object), "weaponmine"

AI Names:

CommTowerProcess
BuildingProcess
GunTowerFriend
GunTowerEnemy
ArmoryProcess
PersonFriend
PersonEnemy
AttachWingman
AttachOffensive
AssaultTankProcess
TugFriend
TugEnemy
RigFriend
RigEnemy
DeployBuildingFriend
DeployBuildingEnemy
ScavProcess
ScoutFriend
ScoutEnemy
SentryProcess
ServiceProcess
TankFriend
TankEnemy
TurretTankFriend
TurretTankEnemy
GechProcess
GechFriend
GechEnemy
SoldierProcess
APCProcess
BomberProcess
SAVFriend
SAVEnemy
RocketTankFriend
RocketTankEnemy
SupportProcess
WingmanFriend
WingmanEnemy
PowerUpProcess
TorpedoProcess
CombatFriend
CombatEnemy
MineLayerFriend
MineLayerEnemy
MorphTankFriend
MorphTankEnemy
TugProcess
AnimalProcess
AlternateAnimalProcess
boidprocess

Texture Blends:

Zero
One
Srccolor
Invsrccolor
srcalpha
invsrcalpha
dstcolor
invdstcolor
dstalpha
invdstalpha
scralphasat

All of those are Src Mode...the same can be used for dst mode.

tex mode:

decal
modulate
decalalpha
modulatealpha
decalmask
modulatemask
add

[DrummaDude]

can you explain what each texture blend and mode do?

[General BlackDragon]

I didnt make that list, SpAce posted it on his forum, but i know that "one one modulate" is for colored things, and "Srcalpha srcalpha invsrcalpha" is for black/white things, like smoke.

Experiment with them, see what you get. Who knows, you might turn something into a hippy weapon lol

[spAce]

The list is made by OvermindDL1 btw.
And thx for that log Commando.

[OvermindDL1]

Not me, made by Tempest Storm, I just gathered them into a structure (basically rearranging).

[Huscar]

lol, I bet Tempest got them from sb. else too

[General BlackDragon]

whatever,...they come from a very long list of people who...dont know.

[BZZERKER]

I think TS got them as very small snippets of code from Ken.

[Huscar]

And here we see how the knowledge evolved. I bet Ken got an even messier form of these commands from sb. else

[BZZERKER]

Maybe it was that silly little code elf running around Pandi at night.

[OvermindDL1]

And here we see how the knowledge evolved. I bet Ken got an even messier form of these commands from sb. else

I doubt that, considering he had access to the source itself.

[Spawn]

Think about how messy the source probablly is

[Ultraken]

Think about how messy the source probablly is

Not as bad as some I've seen, but it need a good refactoring.  (Not that that's going to happen, mind you.) 

[OvermindDL1]

How does it compare to the FS2 source?

Or even worse, the Serious Engine 1 mod source... *shudder*