53
edits
Difference between revisions of "AddForm - FormList"
m
→Order of items in the list
DavidJCobb (talk | contribs) (more RE; figured out list ordering for good) |
DavidJCobb (talk | contribs) |
||
| (3 intermediate revisions by the same user not shown) | |||
| Line 24: | Line 24: | ||
== Notes == | == Notes == | ||
=== Order of items in the list === | === Order of items in the list === | ||
FormLists are divided into three sections. First are all of the forms that are initially present in the FormList per its definition in the Creation Kit. | FormLists are divided into three sections. First are any forms that were created during play (form ID starts with 0xFF) and were added to the FormList by scripts. Next are all of the forms that are initially present in the FormList per its definition in the Creation Kit. Last are any forms that were not created during play (form ID does not start with 0xFF) and were added to the FormList by scripts. This means that FormLists will not necessarily store forms in the order they were added to the list. | ||
Consider a FormList that has forms ''A'', ''B'', ''C'', and ''D'' added to it in the Creation Kit. | Consider a FormList that has forms ''A'', ''B'', ''C'', and ''D'' added to it in the Creation Kit. | ||
| Line 32: | Line 32: | ||
Now, consider a FormList that has forms ''T'', ''U'', and ''V'' added to it in the Creation Kit. | Now, consider a FormList that has forms ''T'', ''U'', and ''V'' added to it in the Creation Kit. | ||
Suppose a script adds forms ''W'', ''X'', ''Y'', and ''Z'' to the FormList; however, forms ''W'' and ''X'' are forms that were created during play (e.g. ObjectReferences spawned via PlaceAtMe), while forms ''Y'' and ''Z'' are forms defined in the user's load order. The FormList will now contain: ''T U V Y Z | Suppose a script adds forms ''W'', ''X'', ''Y'', and ''Z'' to the FormList; however, forms ''W'' and ''X'' are forms that were created during play (e.g. ObjectReferences spawned via PlaceAtMe), while forms ''Y'' and ''Z'' are forms defined in the user's load order. The FormList will now contain: ''W X T U V Y Z''. | ||
One last detail. Suppose a FormList initially contains ''A'', ''B'', and ''C'', and a script adds ''D'', ''E'', ''F'', and ''G'' to it; the FormList therefore contains ''A B C D E F G''. Now, suppose the user saves the game and updates a mod, and the mod update adds ''G'' to the FormList. What happens? Does ''G'' end up in the list twice, and if not, which position does it use? Well, when the user loads the game, the FormList will be initialized to contain ''A B C G''; then, the script-added forms from the savedata will be imported into the list, avoiding duplicates (the same underlying function is used for this part of savedata loading as for the AddForm function itself). This means that the FormList will end up containing ''A B C G D E F''. | |||
Reverse-engineers should be aware that in memory, the list of non-temporary forms comes before the list of temporary forms; however, the underlying function for [[GetAt - FormList]] checks the latter first, treating the start of the latter as index 0. | |||
=== Other notes === | === Other notes === | ||