天气过渡编辑器 - HTML应用程序 - 模组工具

天气过渡编辑器 - HTML应用程序 - 模组工具

一个供“Env”模组开发者使用的HTML应用程序,用于可视化自定义天气过渡。包含一天中不同时段偏好的选项。还包含随机化过渡的选项。

[b]赛博朋克 2077 天气过渡编辑器[/b]

一个用于编辑赛博朋克 2077 天气状态、过渡、时间曲线和随机天气循环的可视化编辑器。


[b]概述[/b]

[b]赛博朋克 2077 天气过渡编辑器[/b] 是一个独立的基于浏览器的应用程序,用于创建、编辑、可视化、随机化和预览赛博朋克 2077 的天气过渡配置。

该应用程序以交互式图表的形式呈现天气状态及其过渡关系。用户可以通过界面查看、创建、复制、连接和配置天气状态,同时可以以数值或可视化的方式编辑其概率、持续时间和过渡曲线。

该编辑器同时支持独立的 **[b]env.json[/b] 文件以及包含 env.json 和天气 **[b]envparam.json[/b] 文件的 ZIP 压缩包。当 envparam 文件可用时,应用程序会将它们与对应的天气状态关联,并在状态被复制时保留其环境参数数据。

可配置的过渡随机化器可以使用选定的状态、持续时间范围、连接限制、过渡时间和可选的时段偏好来生成天气网络。随后可以使用内置的循环模拟来预览一天或一周内可能的天气序列。

该应用程序在您的网页浏览器中本地运行,无需安装。


[b]功能[/b]

[list] []**[b]交互式天气过渡图表*
天气状态以节点形式显示,其过渡关系以节点之间的连接线表示。 [/] [][b]独立 env.json 导入
导入 WolvenKit 导出的 env.json,将其天气状态、曲线和过渡加载到编辑器中。 [/] [][b]ZIP 压缩包导入
导入包含 env.json 及相关 envparam.json 文件的压缩包。 [/] [][b]envparam.json 支持
导入的天气参数文件会与对应的天气状态关联,并在导出时保留。 [/] [][b]创建新的天气状态
直接在应用程序内创建额外的天气状态,并配置其曲线和过渡。 [/] [][b]复制天气状态
基于现有状态创建新状态,包括其天气状态设置和出向过渡结构。 [/] [][b]为复制状态保留 envparam 数据
当带有导入的 envparam.json 的状态被复制时,其 envparam 数据会被复制到新状态。这包括完整的原始 [b]areaParameters[/b] 数据。 [/] [][b]自动生成 envparam**
从零创建的状态会获得一个可导出的 envparam.json,其中包含空的 areaParameters 集合。 [/] [][b]创建和移除过渡
通过图表或过渡控件连接天气状态,并移除不再需要的连接。 [/] [][b]编辑现有过渡
配置过渡的源状态和目标状态,以及它们的过渡持续时间和概率曲线。 [/] [][b]天气状态曲线编辑
配置: [list] []概率[/] []最小持续时间[/] []最大持续时间[/] []过渡持续时间[/] [/list][/] [][b]过渡曲线编辑
配置: [list] []过渡持续时间[/] []概率[/] [/list][/] [][b]数值曲线编辑器
直接编辑单个曲线点的时间和值。 [/] [][b]可视化曲线编辑器
以图形方式查看和操作曲线点。 [/] [][b]曲线点控件
添加点、删除点、按时间排序点,以及配置 X/Y 吸附增量。 [/] [][b]空过渡概率支持
可以通过曲线编辑器将过渡概率显式设置为 null。 [/] [][b]入向和出向过渡视图
聚焦于从选定状态出发的过渡,或切换图表以显示指向该状态的过渡。 [/] [][b]每状态随机化控件
每个天气状态都有自己的复选框,控制其是否参与自动过渡随机化。 [/] [][b]自动纳入随机化
已参与导入的 env.json 中过渡的状态会自动启用。没有现有过渡的状态默认不参与,除非用户手动启用。 [/] [][b]过渡感知纳入
创建涉及某状态的过渡时,会自动为该状态启用过渡随机化。之后仍可随时手动切换纳入状态。 [/] [][b]高级过渡随机化器
使用可配置的状态持续时间、过渡持续时间、连接要求和时段偏好来生成新的天气过渡网络。 [/] [][b]随机化状态持续时间
在可配置的全局限制范围内生成各个天气持续时间值。 [/] [][b]可配置的过渡持续时间范围
设置生成过渡时使用的最小和最大过渡时间。 [/] [][b]可配置的图表连接性
控制参与天气状态的最小和最大入向及出向连接数。 [/] [][b]时段偏好
为各个天气状态指定一天中的偏好时段。 [/] [][b]随机化时段范围
自动为参与的天气状态生成偏好时间范围。 [/] [][b]天气循环模拟
使用当前状态和过渡配置模拟可能的天气序列。 [/] [][b]24 小时预览
预览一个游戏日内可能的天气循环。 [/] [][b]一周预览
模拟 168 个游戏小时内的天气行为。 [/] [][b]随机化器预览
过渡随机化器包含自己的循环预览,因此可以在应用生成的设置之前进行评估。 [/] [][b]可重复运行的模拟
从同一配置生成更多可能的序列。 [/] [][b]自动图表布局
在工作区内自动整理天气状态节点。 [/] [][b]适应视图
自动框选当前显示的过渡图表。 [/] [][b]多选
使用框选或 Shift+点击选择多个天气状态节点。 [/] [][b]组移动
将选定的天气状态一起移动。 [/] [][b]图表平移和缩放
直接在工作区内导航较大的过渡网络。 [/] [][b]上下文菜单
右键点击状态、过渡或图表以获取相关的编辑命令。 [/] [][b]撤销和重做
撤销或恢复编辑操作,包括图表更改、曲线编辑和随机化纳入更改。 [/] [][b]JSON 和 ZIP 导出
以适合您项目的格式导出编辑后的环境配置。 [/] [][b]生成状态的 ZIP 导出
ZIP 导出可以包含在应用程序内创建或复制的天气状态所生成的 envparam.json 文件。[/*] [/list]


[b]导入项目[/b]

该应用程序支持两种导入工作流程。

[b]导入 env.json[/b]

点击 [b]IMPORT JSON / ZIP [/b] 并选择您通过 WolvenKit 导出的 **[b]env.json[/b]。

应用程序将加载文件中包含的天气状态、状态曲线和过渡信息,并显示生成的天气网络。

[b]导入 ZIP[/b]

您也可以导入包含以下内容的 ZIP: [list] [*]环境的 **[b]env.json[/b][/] []相关的天气 **[b]envparam.json[/b] 文件[/*] [/list]应用程序会识别压缩包中的相关文件,并将可用的 envparam 文件与对应的天气状态关联。

导入的压缩包内容会被保留,以便后续 ZIP 导出。

此工作流程还允许复制的天气状态继承其源状态的完整 envparam 数据。


[b]天气状态面板[/b]

应用程序左侧包含 **[b]Weather States[/b] 列表。

选择一个天气状态以在图表中聚焦它并查看其过渡网络。

默认情况下,图表聚焦于从选定状态出发的过渡。

启用 [b]Show incoming transitions [/b] 以改为显示指向选定状态的过渡。

每个状态还有一个复选框,控制其是否参与 [b]过渡随机化。

初始复选框状态是自动确定的: [list] []已参与导入的 env.json 中过渡的状态会被纳入。[/] []没有现有过渡的状态不会被纳入。[/] []用户创建的过渡所涉及的状态会自动纳入。[/] [/list]之后始终可以手动切换复选框。

每个状态旁边的 **[b]Duplicate[/b] 按钮会基于该状态创建一个新的天气状态。


[b]创建天气状态[/b]

点击 [b]+STATE[/b]

为新天气状态输入一个唯一名称。

例如:

[code]24h_weather_my_custom_weather[/code]

新状态会添加到天气配置中,并带有可编辑的默认曲线。

由于新创建的状态没有导入的环境参数资源,应用程序还会准备一个新的 envparam.json,其中包含空的 **[b]areaParameters[/b] 集合。

当项目以 ZIP 格式导出时,此 envparam.json 会被包含在内。

然后您可以配置该状态的曲线,并将其连接到其他天气状态。


[b]复制天气状态[/b]

使用天气状态旁边的 **[b]Duplicate[/b] 按钮或相应的图表上下文菜单命令。

为新状态输入一个唯一名称。

应用程序会基于源状态创建一个单独的状态,并复制其出向过渡结构。

如果源状态有导入的 envparam.json,应用程序还会为新状态创建一个副本。

[b]完整的源 envparam 数据会被保留,包括其 areaParameters。[/b]

这允许新状态保留其来源状态的环境参数。

如果源状态是在编辑器内创建的,没有导入的 areaParameters,则其复制的 envparam 使用相应的空 areaParameters 结构。


[b]使用过渡[/b]

过渡决定了哪些天气状态可以跟随其他状态。

点击 [b]+TRANSITION [/b] 以使用过渡控件创建过渡。

也可以直接通过图表的连接控件创建过渡。

选择源天气状态和目标天气状态以建立连接。

当创建涉及之前未纳入状态的过渡时,该状态会自动启用过渡随机化。

可以选中并编辑单个过渡。

过渡设置包括: [list] []源天气状态[/] []目标天气状态[/] []过渡持续时间曲线[/] []概率曲线[/] [/list]过渡概率还支持专用的 **[b]Null[/b] 选项。


[b]编辑天气状态曲线[/b]

选择一个天气状态,在右侧的 **[b]Curveset[/b] 面板中显示其可编辑曲线。

天气状态包含以下曲线类别:

[b]概率
控制该状态在游戏日内的概率。

[b]最小持续时间
控制与该天气状态关联的最小持续时间。

[b]最大持续时间
控制与该天气状态关联的最大持续时间。

[b]过渡持续时间
控制该状态的过渡持续时间数据。

每条曲线由时间/值点组成。

曲线工具允许您: [list] []以数值方式编辑时间。[/] []以数值方式编辑值。[/] []添加点。[/] []删除选定的点。[/] []按小时排序点。[/] []通过可视化曲线显示操作点。[/] []配置水平吸附。[/] []配置垂直吸附。[/] [/list]双击状态会打开其更大的专用编辑界面。


[b]编辑过渡曲线
选择过渡以检查其曲线。

过渡提供: [list] []**[b]过渡持续时间*[/] [][b]概率[/*] [/list]它们使用与天气状态相同的数值和可视化曲线编辑系统。

还可以通过曲线控件将过渡概率显式更改为 [b]null。


[b]过渡随机化
点击 [b]RANDOMIZE [/b] 打开过渡随机化界面。

随机化器仅对在 [b]Weather States 面板中启用纳入复选框的天气状态进行操作。

这允许在生成新的过渡网络之前选择确切的参与状态池。

随机化界面提供了对生成天气循环多个方面的控件。

[b]天气持续时间范围
配置参与状态使用的全局持续时间限制。

使用 [b]RANDOMIZE DURATIONS [/b] 在配置的限制范围内生成各个值。

在应用生成的配置之前,也可以单独编辑生成的状态值。

[b]过渡持续时间
配置最小和最大过渡持续时间。

这些值决定了生成过渡时间时使用的范围。

[b]图表连接性
配置: [list] []最小入向链接数[/] []最大入向链接数[/] []最小出向链接数[/] []最大出向链接数[/] [/list]这些值决定了随机化器尝试在参与状态之间创建多少个连接。

[b]时段偏好
时段偏好允许各个天气状态偏好游戏日中的指定时段。

这些范围可以手动输入,或使用 [b]RANDOMIZE TOD。 生成。

生成的概率曲线随后会考虑分配给参与状态的偏好时段。

如果当前配置不需要,也可以禁用时段偏好生成。

[b]随机化预览
随机化窗口包含天气循环预览。

使用可用的持续时间选项和 [b]Re-run 控件,以当前随机化设置模拟不同的可能序列。

当配置准备就绪后,选择 [b]APPLY GRAPH & DURATIONS [/b] 将生成的过渡网络和持续时间配置应用到项目中。


[b]天气循环预览
主界面的底部包含 [b]Cycle Preview。

这会使用当前配置的天气网络模拟可能的天气状态序列。

提供两种模拟长度: [list] []**[b]1 Day* = 24 个游戏小时。[/] [][b]1 Week = 168 个游戏小时。[/*] [/list]选择 [b]Re-run 生成另一个可能的序列。

天气选择是概率性的,因此多次模拟可能从同一配置产生不同的序列。


[b]图表控件
中央天气图表支持直接鼠标交互。

[b]移动状态
[code]拖动状态节点[/code]

[b]框选
[code]在图表空白区域拖动[/code]

[b]在当前选择中添加/移除状态
[code]Shift + 左键点击[/code]

[b]移动选定的状态
[code]拖动选定的组[/code]

[b]平移图表
[code]Alt + 拖动[/code] 或使用鼠标中键。

[b]缩放
[code]鼠标滚轮[/code]

[b]创建过渡
[code]从状态的连接端口拖动[/code]

[b]选择状态或过渡
[code]左键点击[/code]

[b]打开完整编辑器
[code]双击[/code]

[b]打开上下文菜单
[code]右键点击[/code]

[b]移除选定的过渡
[code]Delete[/code]

[b]清除当前选择
[code]Escape[/code]

工具栏还提供: [list] []**[b]Fit View* - 框选当前显示的图表。[/] [][b]Auto Layout - 自动整理图表节点。[/*] [/list]


[b]撤销和重做

编辑器维护编辑历史。

使用工具栏控件或: [code]Ctrl + Z[/code] 以撤销。

使用: [code]Ctrl + Y[/code] 以重做。

历史系统涵盖支持的图表更改、曲线编辑、状态修改和过渡随机化纳入更改。


[b]导出项目

可用的导出行为取决于最初导入的内容。

[b]从 ZIP 导入的项目
从压缩包加载的项目会导出为 ZIP。

压缩包保留导入的项目内容,同时纳入编辑后的环境配置。

为新建或复制的状态生成的 envparam 文件也会在适用时包含在内。

复制状态的 envparam 会保留源状态的环境参数数据,包括其 areaParameters。

[b]从 env.json 导入的项目
如果项目是从独立的 env.json 加载的,点击 [b]Export 会显示明确的导出选项: [list] []**[b]Export ZIP*[/] [][b]Export JSON[/] [][b]Cancel[/*] [/list]如果没有创建或复制其他天气状态,可以根据偏好选择任一格式。

如果 [b]已经 创建或复制了天气状态,导出对话框会解释两种格式之间的区别。

[b]Export ZIP
包含: [list] []编辑后的 env.json[/] []为适用的创建/复制天气状态生成的 envparam.json 文件[/] [/list]

[b]Export JSON
仅导出: [list] []编辑后的 env.json[/] [/list]生成的 envparam.json 文件 [b]不会 包含在独立 JSON 导出中。

对于包含在应用程序内创建或复制状态的项目,当需要这些状态的 envparam 文件时,请选择 ZIP 导出。


[b]建议使用流程

[list=1] []使用 WolvenKit 将要处理的环境资源导出为 JSON。[/] []如果您希望编辑器保留现有天气状态的环境参数,也请将相关的 envparam 资源导出为 JSON。[/] []将 env.json 和 envparam.json 文件放入一个 ZIP,或单独使用 env.json。[/] []在浏览器中打开天气过渡编辑器。[/] []点击 [b]Import JSON / ZIP。[/] []选择您的 JSON 文件或 ZIP 压缩包。[/] []从左侧面板选择天气状态以查看其配置。[/] []当您想查看指向选定状态的连接时,使用 [b]Show incoming transitions。[/] []使用天气状态旁边的复选框确定哪些状态有资格参与过渡随机化。[/] []根据需要创建或复制其他天气状态。[/] []配置状态概率和持续时间曲线。[/] []根据需要创建、编辑或移除过渡。[/] []配置各个过渡的持续时间和概率曲线。[/] []如果您想生成新的过渡网络,打开 [b]Randomize。[/] []配置状态持续时间、过渡持续时间、连接限制和可选的时段偏好。[/] []使用内置模拟预览可能的天气序列。[/] []对配置满意后应用生成的图表。[/] []使用主 Cycle Preview 模拟生成的项目。[/] []导出完成的配置。[/] []如果您需要为编辑器内创建或复制的状态生成 envparam 文件,请选择 ZIP 导出。[/] []在您的赛博朋克 2077 模组项目中适当使用生成的文件。[/] [/list]


[b]提示
[list] []使用随机化复选框来定义过渡生成器允许使用的确切天气状态集合。[/] []复选框根据导入的过渡网络初始化,因此已参与过渡的状态会自动启用。[/] []当您想查看哪些状态可以指向当前选定的天气状态时,使用 [b]Show incoming transitions。[/] []在聚焦大型天气网络的不同部分后,使用 [b]Fit View。[/] []使用 [b]Auto Layout 自动重新整理图表节点。[/] []一周模拟比一天预览提供更长的天气配置样本。[/] []在评估概率性天气行为时,多次重新运行模拟,因为同一配置可能产生不同的序列。[/] []当某些天气状态应在一天中的特定时段被偏好时,可以使用时段偏好。[/] []如果某个状态不应参与生成的过渡,请在应用过渡随机化器之前禁用其复选框。[/] []如果您计划复制现有天气状态并希望保留其完整环境参数,请将其 envparam.json 作为项目 ZIP 的一部分导入。[/] []从零创建的状态会获得一个包含空 areaParameters 集合的 envparam.json。[/] []复制状态在源状态数据可用时会继承其 envparam 数据,包括其 areaParameters。[/] []当项目作为独立 env.json 导入时,如果您需要为应用程序内创建或复制的状态生成 envparam 文件,请使用 ZIP 导出。[/] []独立 JSON 导出仅包含编辑后的 env.json。[/] []在试验图表结构、曲线和随机化设置时使用撤销和重做。[/] []在应用生成的网络之前使用随机化器的预览,然后在之后使用主 Cycle Preview 检查生成的项目配置。[/] [/list]


[b]为天气模组项目而设计
赛博朋克 2077 天气过渡编辑器提供了一个单一界面来处理天气循环配置的不同组成部分。

它可用于涉及以下内容的项目: [list] []自定义天气循环[/] []额外天气状态[/] []天气预设变体[/] []依赖时段的天气行为[/] []自定义状态概率曲线[/] []自定义状态持续时间曲线[/] []自定义过渡持续时间[/] []自定义过渡网络[/] []随机化过渡网络[/] []继承环境参数的复制天气预设[/] []天气循环模拟和测试[/] [/list]天气状态、过渡、曲线、envparam 数据、随机化设置和循环预览都可以在同一个应用程序中管理。


**[b]导入 • 配置 • 连接 • 随机化 • 预览 • 导出

感谢 WolvenKit 开发团队和赛博朋克 2077 模组社区的所有辛勤工作[/b]