额外UI API

额外UI API

UI模组库:通过读取运行中的游戏,为游戏的数据获取器扩展游戏未公开的数据,并添加游戏UI功能无法执行的操作。是Extra Data API的继任者。

[size=4][u]Extra UI API[/u][/size]

回答游戏自带的 getter 无法回答的货品、宏、组件和游戏参数问题,并完成游戏自带 UI 函数无法完成的事情。

一个用于 UI 模组的小型库。它为每个 UI 脚本提供一个全局 [b]ExtraUI[/b] 表,其中包含 [b]GetWareDataEx[/b]、[b]GetMacroDataEx[/b] 和 [b]GetComponentDataEx[/b]:调用方式与游戏的 [b]GetWareData[/b]、[b]GetMacroData[/b] 和 [b]GetComponentData[/b] 相同,这些 getter 认识的所有键都会直接透传,此外还有扩展键,其答案从正在运行的游戏本身读取;[b]GetParamsDataEx[/b] 以相同形式添加游戏参数,[b]GetInteractionPoints[/b] 列出玩家当前可以交互的对象,[b]TeleportToAndTakeControlPosition[/b] 可以将玩家从任何位置传送到其某艘船的驾驶位或舰桥控制台,而建造地图函数可以将建造菜单中的浮动模块精确地移动到脚本想要的位置、吸附并放置。

Extra UI API 是 Extra Data API 的继任者:它以自身的名称回答 Extra Data API 所回答的每一个键,所有新功能都放在这里。两者可以并排安装。

[code]
local name, volume, effects = ExtraUI.GetWareDataEx("energycells", "name", "volume", "productioneffects")
-- effects = { default = { work = 0.43, sunlight = 1, efficiency = 1 }, terran = { work = 0.43, sunlight = 1, efficiency = 1 } }
local work = ExtraUI.GetWareDataEx("hullparts", "productioneffects.default.work")
-- work = 0.37
local box, bays = ExtraUI.GetMacroDataEx("pier_par_harbor_03_macro", "boundingbox", "dockingbays")
-- box = { max = { x, y, z }, centre = { x, y, z }, radius = n }; bays = three rows, one per docking bay
local magnet = ExtraUI.GetComponentDataEx(playerId, "lootmagnet")
-- magnet = true while the player's loot magnet is on; playerId as every UI script has it, ConvertStringTo64Bit(tostring(C.GetPlayerID()))
local points = ExtraUI.GetInteractionPoints(C.GetPlayerContainerID())
-- points = one row per seat, door, console or person the player can interact with on the ship or station they are on:
-- { id = 1571, component = ..., connection = "connection06", action = "Take Command of Ship", actionclass = "ControlPositionAction",
-- controlposition = "pilot", actiontextid = 58, possible = true, softtarget = true, ... }
if ExtraUI.CanTeleportToAndTakeControlPosition(shipId, "pilot", true) then
ExtraUI.TeleportToAndTakeControlPosition(shipId, "pilot", true, function(ok, reason) --[[ ok = true: the player flies the ship ]] end)
end
[/code]
[size=3][u][b]Features[/b][/u][/size]
[list]
[] [b][b]ExtraUI.GetWareDataEx(wareId, key, ...)[/b][/b] - 每个键返回一个结果,按顺序,完全如同 [b]GetWareData[/b] 所回答的那样。[b]GetWareData[/b] 认识的键由 [b]GetWareData[/b] 回答;下面的扩展键由本库回答。
[
] [b][b]productioneffects[/b][/b] - 一个表,按货品的每种生产方法各有一个条目([b]default[/b]、[b]terran[/b]、...),每个条目为 [b]{ work = n, sunlight = n, efficiency = n }[/b]:该方法生产效果的产品因子,按游戏解析的结果。[b]work[/b] 是模块在满劳动力时达到的劳动力加成([b]0.43[/b] = +43%),[b]sunlight[/b] 是光照敏感度(能量电池上为 [b]1[/b],其他为 [b]0[/b]),[b]efficiency[/b] 是基础因子([b]1[/b])。[b]GetWareData[/b]、生产模块的库条目以及任务总监均不暴露这些;游戏仅通过 [b]GetProductionModuleData[/b] 为已存在的模块报告它们。
[] [b][b]productioneffects.<method>[/b][/b] - 某一方法的同一张表,当货品没有该方法时为 [b]nil[/b]。
[
] [b][b]productioneffects.<method>.<type>[/b][/b] - 一个数字,[b]type[/b] 为 [b]work[/b]、[b]sunlight[/b] 或 [b]efficiency[/b]。
[] [b][b]ExtraUI.GetMacroDataEx(macroId, key, ...)[/b][/b] - 对 [b]GetMacroData[/b] 的相同形式,带有以下扩展键:
[list]
[
] [b][b]boundingbox[/b][/b] - [b]{ max = { x, y, z }, centre = { x, y, z }, radius = n }[/b]:宏的碰撞部分周围的盒子,单位为米,[b]max[/b] 是围绕 [b]centre[/b] 的半延伸量。它是游戏自身用于测试模块放置的盒子。
[] [b][b]fullboundingbox[/b][/b] - 相同形状,围绕宏的每个部分,包括不碰撞的效果和灯光(或宏的模型为自身设置的盒子,当它设置了一个时)。
[
] [b][b]connections[/b][/b] - 宏的每个连接,为行 [b]{ name, tags, position, direction, rows, macro, count, group }[/b]:[b]tags[/b] 是连接的标签名,[b]position[/b] 以米为单位在宏的坐标系中,[b]rows[/b] 是其旋转的三行([b]direction[/b] 是第三行),[b]macro[/b] 是连接在那里的宏(如果有),[b]count[/b] 是宏自身有多少个连接使用它(飞船制造车间的 [b]buildprocessor[/b] 连接:它同时建造的每艘飞船一个),[b]group[/b] 是连接的组(如果有)(舰桥控制台的 [b]navigationcontrol[/b],传送器的 [b]transporter_01[/b])。
[] [b][b]connections.<tag>[/b][/b] - 仅带有该标签的连接。
[
] [b][b]snapconnections[/b][/b] - 模块与其他模块吸附所使用的连接。
[] [b][b]dockingbays[/b][/b] - 停靠舱,不包括共享其标签的飞船存储。
[
] [b][b]exclusionzones[/b][/b] - 带有接近区的连接,每行带有该区的 [b]sizetag[/b]、[b]size[/b](完整延伸量,单位为米)和 [b]centre[/b]。
[] [b][b]builderclasses[/b][/b]、[b][b]equipclasses[/b][/b]、[b][b]supplyclasses[/b][/b] - 对于建造模块,它建造、装备和补给的飞船类别([b]{ "ship_s", "ship_m" }[/b],没有时为 [b]{}[/b]);对其他任何宏为 [b]nil[/b]。
[
] [b][b]buildsets[/b][/b] - 模块可以建造于其中的空间站类型,按其 [b]<build><sets>[/b] 所列([b]{ "factory", "headquarters_player" }[/b],没有时为 [b]{}[/b]);对于类别不派生自 [b]destructible[/b] 的宏为 [b]nil[/b]。
[] [b][b]workforcerace[/b][/b] - 对于居住模块,其劳动力的种族([b]"argon"[/b]);对其他任何宏为 [b]nil[/b]。
[
] [b][b]numpierdocks[/b][/b] - 对于码头,其附有多少个停靠舱;对其他任何宏为 [b]nil[/b]。
[/list][] [b][b]ExtraUI.GetComponentDataEx(componentId, key, ...)[/b][/b] - 对 [b]GetComponentData[/b] 的相同形式,带有以下扩展键:
[list]
[
] [b][b]lootmagnet[/b][/b] - 玩家的战利品磁铁开启时为 [b]true[/b],关闭时为 [b]false[/b]。只有玩家对象会回答;任何其他组件给出 [b]nil[/b]。
[/list][] [b][b]ExtraUI.GetParamsDataEx(key, ...)[/b][/b] - 游戏参数,每个键返回一个结果,每次调用时实时读取,因此其他模组的补丁也会计入:
[list]
[
] [b][b]exclusionzones[/b][/b] - 按标签的接近区形状:[b]{ [tag] = { size = { x, y, z }, centre = { x, y, z } } }[/b]。
[/list][] [b][b]ExtraUI.GetInteractionPoints(componentId)[/b][/b] - 玩家当前可以交互的一切,步行或飞行中:准星会为其提供动作的座位、门、传送器、控制台和人,无论准星是否指向它们。每个点一行;带有 [b]componentId[/b] 时仅返回该组件上或内部的点(玩家所在的房间、飞船或空间站),不带时返回全部。当无法读取游戏构建时为 [b]nil[/b]。一行包含:
[list]
[
] [b][b]id[/b][/b] - 游戏自身给该点的 id,即其 [b]GetActionInfo(id)[/b] 和 [b]PerformAction(id, 1)[/b] 所接受的 id。只要该点存在它就保持有效,因此在基于旧行执行操作前请重新读取列表。
[] [b][b]component[/b][/b]、[b][b]connection[/b][/b] - 该点所属的对象:一个人是其自身的组件,座位或门是其飞船或房间的一个连接。游戏的 [b]HasTag(component, connection, "shipconsole")[/b] 命名了某些种类([b]shipconsole[/b]、[b]hack[/b]、[b]inventoryworkbench[/b]、[b]chair[/b]),但并非全部:舰桥控制台和大多数传送器门没有自身的标签,因此应依赖 [b]actionclass[/b] 和 [b]controlposition[/b] 作为标签。
[
] [b][b]type[/b][/b] - 游戏对该点的种类([b]firstperson[/b]、[b]firstpersondetails[/b],飞行中为目标种类)。
[] [b][b]action[/b][/b]、[b][b]actiontype[/b][/b] - 准星显示的文字([b]Take Command of Ship[/b]、[b]Talk[/b]),以玩家的语言表示,以及游戏的动作种类([b]use[/b]、[b]comm[/b]);当该点不提供动作时为 [b]nil[/b]。
[
] [b][b]actionclass[/b][/b] - 它是哪个动作,按游戏自身代码的命名,在所有语言中相同且与构建无关:[b]ControlPositionAction[/b] 用于驾驶位和每个舰桥控制台,[b]ActivateTransporterRoomAction[/b]、[b]FirstPersonAction[/b] 用于要交谈的人,[b]OpenDoorAction[/b]、[b]OpenCrateAction[/b]、[b]HackPanelAction[/b]、[b]CycleAirlockAction[/b] 等等。当该点没有动作或有多个动作时为 [b]nil[/b]。
[] [b][b]actionclasses[/b][/b] - 该点所有动作的类别,按游戏的顺序:座位、门或人有一个条目;飞行中的目标有多个,其简单的“Interact”会打开一个动作菜单。当无法深入读取游戏构建时为 [b]nil[/b]。
[
] [b][b]controlposition[/b][/b] - 对于座位或控制台:它所代表的控制位置,[b]pilot[/b]、[b]navigation[/b]、[b]flight[/b]、[b]comms[/b]、[b]engineering[/b]、[b]gunner[/b] 或 [b]coordination[/b](舰队控制台),即 [b]TeleportToAndTakeControlPosition[/b] 所接受的名称。对于其他任何对象为 [b]nil[/b]。
[] [b][b]actiontextid[/b][/b] - 它是哪个动作,在所有语言中相同:该文本在游戏文本页 1010“UI Action Names”上的 id([b]58[/b] Take Command of Ship,[b]23[/b] Talk,[b]57[/b] Sit,[b]32[/b] Use Transporter Room,[b]65[/b] Access Navigation Console)。请比较此 id 或 [b]actionclass[/b],而不是 [b]action[/b]。当该页持有相同文本两次时给出较低的 id([b]15[/b] 用于“Use”,[b]13[/b] 用于“Hack”);当文本不来自该页时为 [b]nil[/b],如飞行中目标的简单“Interact”。
[
] [b][b]possible[/b][/b] - 动作可以从玩家所站位置执行;否则 [b]PerformAction[/b] 会拒绝它。
[] [b][b]instant[/b][/b] - 交互键立即执行动作;当为 [b]false[/b] 时它会打开交互菜单([b]C.ShowInteractMenu(component, connection, id)[/b])。
[
] [b][b]numactions[/b][/b]、[b][b]numdisplayed[/b][/b]、[b][b]displaystate[/b][/b] - 游戏对该点的动作计数和显示状态。
[] [b][b]softtarget[/b][/b] - 准星指向的点上为 [b]true[/b]。
[
] [b][b]missiontarget[/b][/b] - 任务目标上为 [b]true[/b]。
[/list][] [b][b]ExtraUI.TeleportToAndTakeControlPosition(shipId, position, force, callback)[/b][/b] - 将玩家安置在其某艘船的控制位置上,无论玩家身在何处:步行中、另一艘船的驾驶位、另一个星区。[b]position[/b] 为 [b]"pilot"[/b](驾驶位),或以下舰桥控制台之一:[b]"navigation"[/b]、[b]"flight"[/b]、[b]"comms"[/b]、[b]"engineering"[/b]、[b]"coordination"[/b]、[b]"gunner"[/b]。在驾驶位上,没有 [b]force[/b] 时 manned 岗位会被拒绝([b]occupied[/b]);带有 [b]force[/b] 时,岗位上的人员会被要求先离开,完全如同游戏在玩家接管时所做的,并在玩家起身后自行回到岗位;飞船的命令保持在队列中。不在船上的玩家会被传送到那里。驾驶位适用于任何大小的飞船,包括带有舰桥的飞船;控制台仅在飞船的舰桥有其一时适用。在控制台上,游戏会执行其自身控制台所做的:玩家被放置在舰桥上,控制台的菜单打开(导航、工程和舰队控制台打开地图,通信打开消息,飞行和炮术打开飞船交互);“Get up”离开它。站在控制台旁的船员会留在那里,[b]force[/b] 对控制台没有影响。当接管已开始时返回 [b]true[/b],否则返回 [b]false[/b] 和原因。[b]callback(ok, reason)[/b] 是可选的,且恰好获得一次结果:当玩家驾驶飞船或持有控制台时为 [b]true[/b],通常在一秒内,否则为 [b]false[/b] 和原因。
[
] [b][b]ExtraUI.CanTeleportToAndTakeControlPosition(shipId, position, force)[/b][/b] - [b]TeleportToAndTakeControlPosition[/b] 在执行任何操作前运行的检查:[b]true[/b],或 [b]false[/b] 和原因。两个函数的原因:
[list]
[] [b][b]unavailable[/b][/b] - 无法读取游戏构建(见 [b]Available()[/b])。
[
] [b][b]busy[/b][/b] - 先前的接管仍在进行中。
[] [b][b]position not supported[/b][/b] - 不是七个名称之一。
[
] [b][b]not a ship[/b][/b]、[b][b]not owned[/b][/b] - 仅限玩家自己的飞船;无人机和激光塔不算作飞船,如同游戏的财产列表。
[] [b][b]already controlled[/b][/b] - 玩家已经驾驶该飞船,或已经在该飞船上持有该控制台。
[
] [b][b]position not found[/b][/b] - 飞船的舰桥没有这样的控制台(没有舰桥的飞船只有驾驶位)。
[] [b][b]critical order[/b][/b] - 仅驾驶位:飞船的当前命令处于其关键状态,例如停靠接近;在其结束后再试。
[
] [b][b]occupied[/b][/b] - 仅驾驶位,无 [b]force[/b]:有人坐在岗位上。
[] [b][b]teleport: <answer>[/b][/b] - 玩家不在船上且游戏拒绝传送;[b]<answer>[/b] 是游戏自身的原因。
[
] [b][b]timeout[/b][/b]、[b][b]not seated[/b][/b] - 仅来自回调:飞行员未离开岗位或玩家未在 15 游戏秒内到达,或游戏未将玩家安置。被要求离开的飞行员会被送回。
[/list][] [b]建造地图[/b] - 建造菜单自身的编辑器,用于在 [b]AddMacroToConstructionMap[/b] 之后浮动的模块。[b]holomap[/b] 是建造菜单的全息地图([b]menu.holomap[/b]);姿态在计划坐标系中:[b]{ x, y, z, rows }[/b],[b]rows[/b] 为三行 [b]{ x, y, z }[/b] 旋转行。当没有浮动对象或无法访问编辑器时,每个函数返回 [b]nil[/b](或 [b]false[/b])。
[list]
[
] [b][b]ExtraUI.GetConstructionMapFloatingPose(holomap)[/b][/b] - 浮动模块所在的位置。
[] [b][b]ExtraUI.SetConstructionMapFloatingPose(holomap, pos, rows)[/b][/b] - 移动它;[b]rows[/b] 为 [b]nil[/b] 时保持其旋转。移动成功时为 [b]true[/b]。
[
] [b][b]ExtraUI.GetConstructionMapSnap(holomap)[/b][/b] - 在浮动姿态下运行编辑器自身的吸附搜索,即拖动时运行的搜索:[b]{ snapped, valid, entryIdx, connection, predecessorConnection, pose }[/b]。[b]entryIdx[/b] 是它吸附到的从 0 开始的计划条目,[b]connection[/b] 是浮动模块的连接,[b]predecessorConnection[/b] 是该条目的连接,[b]pose[/b] 是吸附将模块放置的位置,[b]valid[/b] 是编辑器的判定(接近区、地块、其他模块)。
[] [b][b]ExtraUI.GetConstructionMapEntryPose(holomap, idx)[/b][/b] - 计划条目 [b]idx[/b](从 0 开始,包括已建造的模块)的精确姿态,以及 [b]count[/b],计划条目的数量。
[
] [b][b]ExtraUI.DropConstructionMapFloating(holomap)[/b][/b] - 将模块放置在它所在的位置,如同玩家的点击,也在鼠标光标停留在其上时(否则编辑器会拒绝该点击)。
[] [b][b]ExtraUI.PlaceConstructionMapFloating(holomap, pos, rows)[/b][/b] - 当编辑器判定该姿态有效时,在一次调用中移动、吸附并放置:吸附结果加上 [b]dropped[/b]。
[/list][
] [b][b]ExtraUI.Available()[/b][/b] - 六个标志:货品键在此游戏构建上能否回答,宏键和参数键能否回答,组件键能否回答,交互点能否回答,控制位置能否回答,建造地图函数能否回答。第三个和第五个需要玩家存在,因此在游戏仍在加载时为 [b]false[/b]。
[] [b][b]ExtraUI.Relocate()[/b][/b] - 忘记本库关于此游戏构建所发现的内容,包括它为何放弃某一部分,以便下次调用时重新读取游戏。
[
] [b][b]ExtraUI.ExtendedKeys[/b][/b] - 按 getter([b]ware[/b]、[b]macro[/b]、[b]component[/b]、[b]params[/b])列出的扩展键名称。
[] 失败时关闭:在本库无法识别的游戏构建上,每个扩展键都回答 [b]nil[/b],并且游戏日志中有一行说明原因。本库仅在建造地图方面写入游戏内存:浮动模块的姿态、一次吸附搜索期间的编辑器拖动标志,以及放置前其拾取的条目。[b]TeleportToAndTakeControlPosition[/b] 仅调用游戏自身的例程,即“Take Command of Ship”和舰桥控制台背后的那个。
[/list][size=3][u][b]Limitations[/b][/u][/size]
[list]
[
] 此模组要求在扩展设置中禁用 [b]Protected UI Mode[/b]。
[] 这些函数存在于菜单的 UI 状态([b]ui/addons[/b])中,几乎所有 UI 模组都在该状态下运行。它们不可用于 [b]ui/core[/b] 状态的脚本。
[
] 仅限 Windows 游戏:在原生 Linux 构建上,扩展键回答 [b]nil[/b]。通过 Proton 或 Wine 在 Linux 上运行的 Windows 游戏应可工作。
[] 已在 [b]X4: Foundations[/b] 8.00 和 9.00(GOG)上验证。本库在信任其读取的任何内容之前,会将游戏数据与游戏自身的 getter 进行比对,因此未知构建给出 [b]nil[/b] 答案,绝不会给出错误答案。
[
] [b]GetInteractionPoints[/b]:游戏仅为玩家周围的对象保留点:玩家所站飞船的舰桥,或空间站的整个停靠区及其停靠舱、房间和人员,但不包括空间站的其余部分。玩家刚离开的飞船的点可能在列表中保留一段时间,且点可能不带动作;将玩家的飞船或空间站作为 [b]componentId[/b] 传入,并跳过没有 [b]action[/b] 的行。
[] 本库关于游戏构建所发现的内容会在会话之间保留。游戏代码不匹配的部分在该构建上保持关闭,直到调用 [b]Relocate()[/b];游戏数据不匹配的部分(例如某个模组更改了一个众所周知的货品或宏)会在下次存档加载或 UI 重载后重试。如果游戏在读取某部分时停止,它会再试一次,然后保持关闭。
[
] 建造地图:编辑器会在模块被浮出的那一帧拒绝放置,因此在一帧中浮出它,在之后的帧中放置它;放置是否成功体现在计划条目的数量上。
[] [b]TeleportToAndTakeControlPosition[/b] 一次只运行一次接管,且不会在存档加载或 UI 重载后继续存在:那时仍在进行中的接管的回调永远不会被调用。接管开始时已打开的菜单保持打开,位于新岗位的菜单之上。
[
] 效果是游戏的解析值:未定义某类型效果的方法会报告该类型的游戏默认值,[b]work[/b] 和 [b]sunlight[/b] 为 [b]0[/b],[b]efficiency[/b] 为 [b]1[/b]。
[/list][size=3][u][b]Requirements[/b][/u][/size]
[list]
[] [b]X4: Foundations[/b] 8.00 或更高版本。
[
] Chem ODun 的 [b]Lua Log API[/b],版本 [b]1.00[/b] 或更高。 <br />[list] <br />[*] 可通过 Steam 获取 - [url=https://steamcommunity.com/sharedfiles/filedetails/?id=3823580916]Lua Log API[/url] <br />[*] 或通过 Nexus Mods - [url=https://www.nexusmods.com/x4foundations/mods/2473]Lua Log API[/url] <br />[/list][/list][size=3][u][b]Installation[/b][/u][/size] <br /> <br />你可以通过 Steam 客户端下载最新版本 - [url=https://steamcommunity.com/sharedfiles/filedetails/?id=3839783822]Extra UI API[/url] <br />或通过 Nexus Mods - [url=https://www.nexusmods.com/x4foundations/mods/2602]Extra UI API[/url] <br /> <br />[size=3][u][b]Save state[/b][/u][/size] <br /> <br />[b]No[/b](移除扩展不会破坏存档)。 <br /> <br />[size=3][u][b]Usage[/b][/u][/size] <br />[list=1] <br />[*] 将本库作为依赖项添加到模组的 [b]content.xml[/b] 中,以便它在你的模组之前安装和加载: <br />[/list] [code] <br /> &lt;dependency id="ws_3839783822" optional="false" name="Extra UI API" version="100"&gt;&lt;/dependency&gt; <br /> [/code][list=1] <br />[*] 将本库的 UI 插件作为依赖项添加到模组的 [b]ui.xml[/b] 中,以便 [b]ExtraUI[/b] 在你的 Lua 文件运行时存在: <br />[/list] [code] <br /> &lt;dependency name="extra_ui_api" /&gt; <br /> [/code][list=1] <br />[*] 从你的 Lua 代码中调用这些函数: <br />[/list] [code] <br /> local effects = ExtraUI.GetWareDataEx("refinedmetals", "productioneffects.default") <br /> if effects then <br /> local fullWorkforceOutput = baseOutput * (1 + effects.work) <br /> end <br /> [/code] <br />对于可选依赖项,省略第 2 步:对未安装的库的插件依赖会使你的插件加载失败。改为在调用时查找该表: <br /> <br />[code] <br />local effects = ExtraUI and ExtraUI.GetWareDataEx("refinedmetals", "productioneffects.default") <br />[/code] <br />[size=3][u][i]Debug output[/i][/u][/size] <br /> <br />本库通过 Lua Log API 写入其日志行,标记为 [b]ExtraUI:[/b]。错误始终写入。如需更多,可从 Lua 使用 [b]ExtraUI.SetDebugLevel("debug")[/b] 或 [b]ExtraUI.SetDebugLevel("trace")[/b] 设置级别,或从任务总监将 [b]player.entity.$ExtraUiApiConfig.$debugLevel[/b] 设置为 [b]'debug'[/b] 或 [b]'trace'[/b>,并以该级别作为参数触发 Lua 事件 [b]ExtraUiApi.SetDebugLevel[/b]。本库没有自己的选项页面。 <br /> <br />[size=3][u][i]Moving from Extra Data API[/i][/u][/size] <br />[list] <br />[*] 将 [b]content.xml[/b] 中的 [b]Extra Data API[/b] 依赖项和 [b]ui.xml[/b] 中的 [b]extra_data_api[/b] 插件依赖项替换为上面的那些。 <br />[*] 在你的 Lua 代码中将 [b]ExtraData.[/b] 替换为 [b]ExtraUI.[/b]。调用、键和答案相同。 <br />[*] 裸全局变量 [b]GetWareDataEx[/b]、[b]GetMacroDataEx[/b]、[b]GetComponentDataEx[/b] 和 [b]GetParamsDataEx[/b] 已移除:通过 [b]ExtraUI[/b] 调用它们。 <br />[*] [b]Available()[/b] 返回六个标志,而不是 Extra Data API 1.03 的三个;前三个含义相同。 <br />[/list][size=3][u][b]How it works[/b][/u][/size] <br /> <br />游戏将所有货品、其生产方法及其效果保存在一个注册表中,游戏自身的 [b]GetProductionMethodResources[/b] 函数首先查找该注册表。本库在首次请求扩展键时,在正在运行的游戏内找到该查找一次,沿着它到达注册表,并读取游戏所读取的相同数据结构。在回答任何内容之前,它会将几个众所周知货品的体积和价格,以及它触及的每种方法的时间和数量,与 [b]GetWareData[/b] 和游戏的生产方法信息所报告的内容进行比对。任何一处不一致都会在本次会话中关闭货品键。 <br /> <br />宏键的工作方式相同:本库沿着游戏自身的 [b]GetMacroClass[/b] 到达宏注册表,并沿着建造菜单自身的代码到达接近区表。它在回答之前将每个连接与其名称哈希进行核对,并将几个众所周知的宏与其文件进行核对,任何不匹配都会关闭宏键。劳动力种族通过游戏自身 [b]GetAllRaces[/b] 所读取的种族注册表获得;其中的每个种族都必须与其名称哈希匹配,并且三个原版居住模块必须显示其文件的种族和其库条目的容量。四个原版模块的建造集必须与其文件匹配。两个盒子键读取宏对其模型盒子的副本,在众所周知的宏上,两个副本都必须等于模型自身的盒子。其中任何一项不匹配都只会关闭其对应的键。 <br /> <br />战利品磁铁键读取游戏自身 [b]ToggleLootMagnet[/b] 所翻转的那一个字节。本库在正在运行的游戏内找到该函数的代码,沿着它到达玩家对象,要求游戏的 [b]SetLootMagnetActive[/b] 以相同方式到达相同对象,并在回答之前检查该字节是纯 0 或 1。 <br /> <br />交互点是游戏自身的列表:对于玩家周围所有可以对其采取行动的对象,游戏保留一个带有 id 的小记录,其准星、目标监视器和交互菜单都基于这些 id 工作。本库沿着游戏自身的 [b]GetMessageDetails3[/b] 到达这些记录的表,要求查找代码逐字节匹配、表的计数等于它所遍历的记录数,并且准星下的记录在其中,然后仅收集 id:一行中的每个值都由游戏自身针对该 id 的函数回答。 <br /> <br />建造地图函数以游戏自身 [b]AddFloatingSequenceToConstructionPlan[/b] 和 [b]ResetConstructionMapModuleRotation[/b] 的方式到达建造菜单的编辑器:两者都逐字节匹配,必须到达相同的注册表和解析器,并且编辑器的更新例程及其拖动标志必须在重置例程所说的位置,然后才读取或写入任何内容。与游戏报告的计划不一致的计划条目姿态是调用者停止的信号;只有在编辑器自身的 getter 确认其字段后,才会在放置前清除拾取的条目。 <br /> <br />[size=3][u][b]Credits[/b][/u][/size] <br />[list] <br />[*] 作者:Chem ODun,在 [url=https://next.nexusmods.com/profile/ChemODun/mods?gameId=2659]Nexus Mods[/url] 和 [url=https://steamcommunity.com/id/chemodun/myworkshopfiles/?appid=392160]Steam Workshop[/url]
[] [i]"X4: Foundations"[/i] 是 [url=https://www.egosoft.com]Egosoft[/url] 的商标。
[/list][size=3][u][b]Acknowledgements[/b][/u][/size]
[list]
[
] [url=https://www.egosoft.com]EGOSOFT[/url] - 感谢 X 系列。
[/list][size=3][u][b]Changelog[/b][/u][/size]

[size=3][u][i][1.00] - 2026-11-15[/i][/u][/size]
[list]
[] 新增
[list]
[
] Extra Data API 1.03 的全部功能,位于全局 [b]ExtraUI[/b] 之下
[] [b]GetInteractionPoints[/b]:玩家当前可以交互的一切
[
] [b]TeleportToAndTakeControlPosition[/b] 和 [b]CanTeleportToAndTakeControlPosition[/b]:从任何位置将玩家安置在其某艘船的驾驶位或舰桥控制台
[] [b]connections[/b] 行带有连接的 [b]group[/b]
[
] 建造地图函数:移动、吸附和放置建造菜单的浮动模块
[*] [b]Relocate[/b]:重新读取游戏构建
[/list][/list]