详细参考信息 - SFSE

[color=#f4cccc][b][u][size=4]关于此工具：[/size][/u][/b]

[size=3]这是一个 SFSE 插件，让你可以在游戏内查看并记录派系、魔法效果、法术、特长、持久化（促进者）、关键词以及许多其他 Actor 和对象引用数据，全部通过一条控制台命令访问。[/size]

[size=4][b][u]GetReferenceInfo、GetRefInfo：[/u][/b][/size]

[size=3]用于访问引用信息的控制台命令。在控制台中选择一个 Actor 引用或对象引用（“Ref”），然后输入 GetReferenceInfo（或 GetRefInfo，两者都有效且效果相同）。或者，你可以输入它们的 RefID，例如 5986.GetRefInfo。（可由 Papyrus 调用）。

GetReferenceInfo 有可选参数，可以在其后输入，以返回关于 Ref 的各种特殊信息。[/size]


[b][u][size=4]有效的可选参数：[/size][/u][/b]

[size=3]默认情况下，GetReferenceInfo 只返回“基础数据”，例如来源插件文件、3D 坐标、名称、EditorID、数据标记、基础表单等。要查看或记录“附加数据”，例如 MagicEffect、Perk、Persistence Promoter 表单，请使用下面的参数。[/size]

[size=3][b]参数示例[/b]：[/size]

5986.GetRefInfo editorid （这会返回基础数据，并显示 EditorID（因为默认只显示 FormID））
5986.GetRefInfo keyword （这会返回基础数据和关键词数据）
5986.GetRefInfo "keyword editorid" （这会返回基础数据、关键词数据，并显示 EditorID）
5986.GetRefInfo "keyword editorid names" （这会返回基础数据、关键词数据，显示 EditorID 和名称（相应地显示 DisplayName / FullName））
5986.GetRefInfo "keyword editorid name log" （（……见上）并且不会在控制台日志中显示结果，而是在 ..\Starfield\Data\SFSE 中创建一个日志文件）
5986.GetRefInfo "keyword editorid name logtofile_MyLogFile" （（……见上）但日志文件将是 "MyLogFile.txt"，而不是默认日志文件名）
5986.GetRefInfo "spells name aliases" （返回法术、任务别名，并同时显示名称）
5986.GetRefInfo "promoters" （返回该引用的 Persistence Promoter 表单；因为既未请求显示 EditorID 也未请求显示名称，所以只显示它们的 FormID）
5986.GetRefInfo all （返回所有受支持的引用数据；注意：日志记录、名称和 EditorID 仍必须单独请求；因此 "all" 标记只意味着“返回所有数据”）
5986.GetRefInfo "names magiceffects" （返回 ActiveMagicEffect（包含持续时间、强度和已用时间），并同时显示它们的名称）
5986.GetRefInfo "spells names" （返回法术及其名称，例如 (( [000070CB] ('Crew Stealth - Chameleon' )) )
5986.GetRefInfo "log all" （将所有内容记录到日志文件）
5986.GetRefInfo "logall"

[b][size=3]说明：[/size][/b]

- 某些数据仅适用于 Actor 引用（例如 Perk）
- 大多数参数都有仅为方便而提供的替代版本：但所有同类型参数，例如 "editorid" 和 "edid" 都可以
- 默认日志文件名为 { GetRefInfo_RefID_date_and_time }，例如 "GetRefInfo_00000014_2024-03-29_14-31-38"
- 使用双引号 " " 来保护多词参数，如上所示
[size=3][b]
全局参数[/b]：适用于所有（基础和附加）数据[/size]

- 在 FormID 旁显示 EditorID --> { editorid, edid, editorids }
- 显示名称（相应地显示 DisplayName / FullName） --> { name, names, tesfullname, fullname, fullnames }
- 记录到文件而不是控制台 --> { log, logging, loggingmode, logtofile }
- 记录到自定义名称的文件而不是默认文件 --> { logtofile_(...) } - 将 (...) 替换为文件名（不带文件扩展名）
- 拆分长行 --> { linebreak, breakline, splitline, splitlongline, breaklongline, oneentryperline, entryperline } - 也全部接受复数形式
- 返回所有受支持的附加数据 --> { all, doall, dumpall, processall } 这会覆盖下面看到的所有数据参数
- 记录所有受支持的附加数据 --> { logall }

[size=3][b]数据参数[/b]：用于返回附加数据[/size]

- 显示 Persistence Promoter 表单 --> { promoter, promoters, persistence }
- 显示关键词数据 --> { keyword, keywords, kwda, keyworddata }
- 显示 AI 数据（AI Package、Combat State、LifeState） --> { ai, aipackage, package, packages, aipackagedata, aidata }
- 显示 Perk --> { perk, perks, skill, skills, perkdata, skilldata }
- 显示法术 --> { spell, spells, spelldata }
- 显示 ActiveMagicEffect 数据 --> { activeeffect, activeeffects, magiceffect, magiceffects, activemagiceffect, activemagiceffects, effect, effects, activeeffectdata, effectdata, magiceffectdata }
- 显示派系 --> { faction, factions, factiondata }
- 显示别名 --> { alias, aliases, aliasdata, questalias, questaliases }[/color]
[color=#f4cccc] - 显示 LinkedRef --> { linkedref, linkedrefs, alllinkedrefs }[/color]
[color=#f4cccc] - 显示 LinkedRefChildren (RefsLinkedToMe) --> { linkedrefchildren, linkedrefschildren, refslinkedtome, linkedtome, reflinkedtome, allrefslinkedtome }[/color]
[color=#f4cccc] - 显示 ExtraDataList --> { extra, extradata, extralist, extradatalist, bsextradata, extras, extradatas }


[b][u][size=4]受支持的引用数据：[/size][/u][/b]

---> [b]名称[/b]
（适用于所有受支持的数据；相应地优先使用 DisplayName 或 TESFullName（xEdit 中的 "FULL - Name"））

---> [b]RefID[/b]
（它的存在是为了明确是否在控制台中选择了正确的引用）

---> [b]原生对象句柄[/b]
（用于开发目的；游戏用于标识游戏世界中引用的另一个 ID）

---> Ref 的 [b]内存地址[/b]
（用于开发目的）

---> [b]BaseID[/b]
（包含 Ref 基础数据的基础表单的 FormID）

---> [b]LeveledCharacter/LeveledActorBase[/b]
（仅适用于 Actor Ref，例如他们是通用船员）

---> 基础表单的 [b]内存地址[/b]
（用于开发目的）

---> [b]Pack-In[/b] 和 [b]StorageCell
[/b] （创建该 Ref 的 Pack-In；以及该 Pack-In 的 "Storage Cell"（SF1Edit >> Pack-In >> CNAM - Cell））

---> [b]位置[/b]
（Ref 的 CurrentLocation）

---> [b]飞船[/b]
（Ref 所在的 Current Spaceship；与坐标一起返回）

---> [b]星球、生物群系、恒星系[/b]

---> [b]位置 [/b]和 [b]旋转[/b]
（全局坐标和角度：x, y, z）

---> 与玩家的 [b]距离[/b]
（以米和码为单位）

---> [b]ParentCell[/b]
（Ref 所在的 Cell）
---> [b]Worldspace[/b]
（Ref 所在的 Worldspace；除了 ID 之外，它通常显示 "Jemison" 或 "Porrima II" 或 'Space'）

---> [b]Persistence Promoter[/b]
（使 Ref 保持持久化的表单数组；某些 Game Form 交互可能要求某些 ref 变为持久化，参见 [PP] 标记）

---> [b]来源插件（Mod）文件[/b]
（Ref 来自哪个插件、mod（.esm/.esp）；对于运行时创建的 NPC 和 Leveled NPC，这是其基础表单记录所在的位置）

---> [b]覆盖（Mod）文件[/b]
（哪个插件覆盖了 Ref 和基础表单的记录）

---> [b]插件类型（Full/Medium/Small）[/b]
（插件类型；分别针对 Ref 和基础表单）

---> [b]EditorID[/b]
（适用于所有受支持的数据）

---> [b]FormFlags[/b]、[b]ChangeFlags[/b]、[b]BaseFormFlags[/b]、[b]BaseChangeFlags[/b]
（标记存储不同类型的数据；要么是记录标记，要么是游戏内设置的标记）

---> [b]派系[/b]
（该 actor 所属的派系数组）

---> [b]AI Package
[/b] （控制该 actor 的 AI）

---> [b]CombatState[/b]
（在对 NPC 执行 "MoveTo Player" 之前值得检查一下，以防万一）

---> [b]LifeState[/b]
（死亡的 NPC 通常无法 MoveTo；这有助于将其与其他情况区分开来）

---> [b]Perk[/b]
（该 actor 当前拥有的 Perk（“技能”）数组）

---> [b]法术[/b]
（该 actor 当前拥有的法术数组）

---> [b]ActiveMagicEffect：[/b]包含持续时间、强度、已用时间和来源表单
（来源通常是药水、法术和对象改造（例如参见传奇武器的 ActorValue 修改器））

---> [b]关键词
[/b] （附加到 Ref 的关键词数组；无论是通过 OMOD 应用还是从基础表单继承，都无关紧要：全都在这里）

---> [b]别名[/b]
（Ref 被填充到的任务别名数组）

---> [b]LinkedRef[/b]
（Ref 链接到的引用数组；如适用则包含链接关键词）

---> [b]LinkedRefChildren (RefsLinkedToMe)[/b]
（链接到 Ref 的引用数组；如适用则包含链接关键词）

---> [b]ExtraDataList[/b]
（Ref 的 ExtraDataList 包含的 BSExtraData 类型；包含对象类名和内存地址）


[b][u][size=4]说明：[/size][/u][/b]

---> 关于玩家引用 (00000014)
---> 玩家始终加载在内存中，但不是因为被提升（硬编码编辑器设置的持久化）

---> 关于原生对象句柄
---> 另一个用于标识引用的“ID”，因为游戏并不完全依赖 FormID
---> 例如，当打开以物易物或交易菜单时，游戏使用它来存储目标库存所有者
---> 在 Starfield 中，玩家引用的对象句柄始终为 1；GetReferenceInfo 有意不为玩家返回它

---> 关于与玩家的距离
---> 如果 Ref 和玩家在同一个 Worldspace 中，则最可靠；否则返回距离最近“worldspace gate”的距离

---> 关于数据标记
---> FormFlags：其中大多数是你在 SF1Edit 中看到的记录标记（BaseFormFlags 是所选 ref 的基础表单的标记）
---> ChangeFlags：游戏设置的特殊标记。（它们可能看起来不合理，但从技术上讲数据应该是正确的）。

---> 信息更丰富的“选中的控制台引用行”（最顶部的那一行）来自我的另一个 mod [url=https://www.nexusmods.com/starfield/mods/8167]Starfield Console Extender[/url]


[u][size=4][b]需求：[/b][/size][/u]

[url=https://www.nexusmods.com/starfield/mods/106]Starfield Script Extender
[/url][url=https://www.nexusmods.com/starfield/mods/3256]Address Library for SFSE Plugins[/url][/color]