Entry Point

From GECK

Revision as of 18:26, 20 December 2008 by Quetzilla (Talk | contribs) (gun spread settings link)

Entry Points (also known as Code Entry Points) are specific places in the code that are pre-defined. When you create a Perk Entry that refers to an Entry Point, you select from a list of these pre-defined Entry Points. Each one will also have a number of arguments that are relevant to that entry point.

An example entry point might be something like Calculate Weapon Damage, which might occur in the code when the player is attacking an opponent, just before the damage is to be applied. Arguments for this action point might be the attacker (the player), the target, and the weapon being used (if any). The arguments can be used to filter the effect of the entry point against a set of conditions. For example, a perk could modify weapon damage only when the weapon is an energy weapon. In that case, the conditions for the weapon argument would include an IsEnergyWeapon condition check.

Once the entry point and the conditions are specified, the function call for that entry point can be selected from a drop down box. When selected, dialog options specific to that function will be enabled. An example function is the Add Value function. When selected, it will enable a box into which either a positive or negative number can be entered to modify the the current value. In the case of the Calculate Weapon Damage function, the value is the damage that has been currently calculated.

A full example is a perk entry that causes all rifles to do +5 damage against animals. The Calculate Weapon Damage entry point would be selected. In the condition filter for weapon, the IsRifle condition function would be checked. In the condition filter for target, the IsAnimal condition filter would be checked. The function chosen would be the Add Value function, and 5 would be input into the data box for Add Value.

Entry Point Description Effect
Activate Run when the player activates something Presents a choice list to the player that can trigger a script
Add Leveled List On Death Adds a leveled list to the target's inventory when the player kills someone Adds to the inventory of the target
Adjust Book Skill Points Run when the player reads a book Modifies the skill points gained
Adjust Drinking Radiation Run then the player drinks from a water source Modifies the percentage of radiation from 100% to some other value
Adjust Experience Points Run when the player gains any experience Modifies the experience gained
Adjust Gained Skill Points Run when the player gains a level Modifies the default number of skill points available to the player
Adjust Limb Damage Run when the player's limbs are damaged by something Modifies the damage
Adjust Range Penalty Not Implemented N/A
Calculate Buy Price Run when the player tries to barter for items Modifies the default price for an object
Calculate Gun Spread Run when the player's gun spread is calculated Modifies the default spread.
Calculate Inventory AP Cost Not Implemented N/A
Calculate Mine Explode Chance Run when the player comes within proximity of an armed mine Modifies the default chance of 100%
Calculate My Critical Hit Chance Run when calculating the player's critical hit chance Modifies the chance
Calculate My Critical Hit Damage Run when calculating the player's critical hit damage Modifies the damage
Calculate To Hit Chance Run when the player queues a shot in VATS Modifies the default to hit chance for the shot
Calculate Weapon Attack AP Cost Run when the player attacks outside of VATS Modifies the AP cost for attacking
Calculate Weapon Damage Run when calculating the player's weapon damage to any target Modifies the damage
Calculate Weapon Range Not Implemented N/A
Get Bad Karma Not Implemented N/A
Get Disposition Run when an actor is calculating their disposition to the player Modifies the normally calculated disposition
Get Good Karma Not Implemented N/A
Get Max Carry Weight Run when the player's max carry weight is calculated Modifies the default max carry weight
Get Should Assist Not Implemented N/A
Get Should Attack Not Implemented N/A
Hacking Science Bonus Run when the player attempts to hack a terminal Modifies the player's science skill for that hack attempt
Has Concentrated Fire Run when the player enters VATS If the value is modified to be non-zero, the player will be able to use concentrated fire
Has Paralyzing Palm Run when the player enters VATS If the value is modified to be non-zero, the player may use the paralyzing palm
Ignore Broken Lock Run when the player attempts to open a broken lock If the value is modified to be non-zero, another chance will be granted
Ignore Locked Terminal Run when the player attempts to activate a locked terminal If the value is modified to be non-zero, another chance will be granted
Ignore Running During Detection Run when the player is being detected by another actor If the value is modified to be non-zero, running will be ignored
Modify Addiction Chance Run when the player takes a drug Modifies the chance that the player will become addicted
Modify Addiction Duration Run when the player becomes addicted to a drug Modifies the duration of the addiction
Modify Enemy Critical Hit Chance Run when calculating the an enemy's critical hit chance against the player Modifies the chance
Modify Positive Chem Duration Run when the player takes a chem Modifies the duration of the chem
Modify Recovered Health Run when the player's natural healing rate is calculated Modifies a bonus to the natural healing rate
Mysterious Stranger Run when the player enters VATS If the value is modified to be non-zero, the mysterious stranger may appear
Player Kill AP Reward Run when VATS finishes if the player killed at least one enemy Modifies the AP reward from 0 to another value
Personal tools