Category:List Functions

From GECK
Jump to: navigation, search

Functions that manipulate or utilize FormLists.

Notes

When modifying form lists via script, using NVSE commands, there are a few ground rules to follow.

A distinction should be made between:

  • Case (1): Forms originally in the list in the ESM/ESP file it was created, including overrides by other files.
  • Case (2): Forms added to the list using the vanilla command AddFormToFormList.
  • Case (3): Forms added to the list using the NVSE command ListAddForm.

Form lists are not wholly baked in the save file - only the changes are baked. That is, only those forms which were added to the list via script, and only those that were added using AddFormToFormList.

The following applies only when using the NVSE commands (AddFormToFormList is considered safe to use in almost all circumstances).

  • Adding a form: Never at an index where there are case (1)/(2) forms at higher indices (higher means larger i.e. nearer the bottom of the list).
  • Removing/replacing a form: Case (2)/(3) forms only; NEVER case (1) forms.

In general, using the NVSE form list commands with form lists that were not originally empty is not recommended.

  • Note about AddFormToFormList: On rare cases, the game fails to save the changes done with AddFormToFormlist. This is not a common occurence, but if it happens all further saves deriving from that one will be affected. This can happen at any time during a playthrough regardless of the time where the formlist was edited.

See Also