VS：模拟战争

VS Analog Warfare（模拟战争）

VS Analog Warfare 为安装在瓦尔基里天空（Valkyrien Skies）飞船上的机械动力：大炮（Create Big Cannons）武器添加了模拟光学瞄具和提升游戏体验的载具支持工具。

功能特性

模拟瞄具：添加了一个实体瞄具方块，具有可调变焦、自由视角、弹道分划标记、测距和瞄准归零功能。该瞄具会利用检测到的大炮和炮弹配置来显示瞄准信息，并始终与移动中的瓦尔基里天空飞船保持对齐。使用遥远地平线（Distant Horizon）API 实现低消耗测距。

载具设置方块：记录可能无法通过普通 VMod 原理图保存的载具配置操作，包括方块改动、线传驾驶（Drive By Wire）连接、DBW 控制器连接、轨道工坊（Trackwork）设置以及 Tallyho 实体放置。支持可选的机械动力：末影能量（Create Ender Transmission）发射器隔离。记录的设置操作可在载具被粘贴后重放。跨载具保存的已记录操作由 Vmod 保留，无需备用方块。

地面碰撞禁用器：禁用瓦尔基里天空飞船与游戏内地面之间的碰撞。即使方块被破坏或世界重新加载，碰撞禁用状态依然保持，可通过 VMod 或模拟螺丝刀恢复。

载具挂载把手：将一个或多个命名的机械动力座椅链接到一个把手上，允许玩家从中心访问点选择并乘坐载具座椅。玩家在离开座椅时也可被传送回把手位置。支持红石开关锁定。使用 Vmod 保存时，跨载具链接同样会被保留。

模拟螺丝刀：用于配置载具设置方块、将载具挂载把手与座椅链接，以及恢复地面碰撞。

可选兼容性：在选定分支支持的情况下，提供与 VMod、Tallyho、线传驾驶、轨道工坊、机械动力：调校控制器（Create Tweaked Controllers）、机械动力：末影传输（Create Ender Transmission）和遥远地平线的可选集成。

分支与依赖

两个版本均面向 Minecraft 1.20.1 和 Forge 47 或更新版本。各分支使用不同版本的瓦尔基里天空、机械动力和机械动力：大炮。主分支（main）：VS2.4，机械动力 6。vs2.3 分支：VS2.3，机械动力 5。

vs2.3 分支

硬性依赖

依赖项	模组 ID	所需版本
我的世界	minecraft	1.20.1
Forge	forge	47.x
瓦尔基里天空 2.3	valkyrienskies	[2.3.0-beta.5, 2.4.0)
机械动力	create	[0.5.1.j, 0.6.0)
机械动力：大炮	createbigcannons	[5.8.2, 5.9.0)

可选集成

依赖项	模组 ID	已验证版本	提供的功能
瓦尔基里模组（VMod）	valkyrien_mod	0.1.3	VMod 原理图放置后自动重放载具设置；地面碰撞状态持久化
线传驾驶	drivebywire	0.0.6b	DBW 连接记录/恢复和控制器集成
轨道工坊增强（Trackwork Plus）	trackwork	1.0.2c	悬挂刚度记录/恢复
机械动力：末影传输	createendertransmission	2.0.7-1.20.1	载具发射器隔离与配对
机械动力：调校控制器	create_tweaked_controllers	1.20.1-1.2.4	控制器连接记录/恢复
Tallyho	tallyho	3.5.4b	Tallyho 武器/实体记录与重放
遥远地平线	distanthorizons	兼容 API 的版本	扩展瞄具/测距仪地形支持

main 分支（主分支）

硬性依赖

依赖项	模组 ID	所需版本
我的世界	minecraft	1.20.1
Forge	forge	47.x
瓦尔基里天空 2.4+	valkyrienskies	[2.4.7, 2.5.0)
机械动力	create	[6.0.8, 6.1.0)
机械动力：大炮	createbigcannons	[5.10.2, 6.0.0)

可选集成

依赖项	模组 ID	已验证版本	提供的功能
瓦尔基里模组（VMod）	valkyrien_mod	0.1.3	VMod 原理图放置后自动重放载具设置；地面碰撞状态持久化
线传驾驶	drivebywire	0.0.6b	DBW 连接记录/恢复和控制器集成
轨道工坊增强（Trackwork Plus）	trackwork	1.0.2c	悬挂刚度记录/恢复
机械动力：末影传输	createendertransmission	2.0.7-1.20.1	载具发射器隔离与配对
机械动力：调校控制器	create_tweaked_controllers	1.20.1-1.2.4	控制器连接记录/恢复
遥远地平线	distanthorizons	兼容 API 的版本	扩展瞄具/测距仪地形支持

Tallyho 仅由 vs2.3 分支集成。main 分支不包含 Tallyho 重放兼容层。

致谢

VS Analog Warfare 是由 Erika 创建的独立模组。

• 模拟瞄具的概念部分灵感来源于 StratoDonut 制作的 Tallyho 模组。在项目初期规划中，Tallyho 也被用作参考。
• VS Analog Warfare 使用独立实现，不包含 Tallyho 的源代码或资源。
• 该模组旨在兼容机械动力、机械动力：大炮和瓦尔基里天空 2。
• 可选集成包括 VMod、线传驾驶、轨道工坊、机械动力：调校控制器、机械动力：末影传输、遥远地平线，以及适用分支支持的 Tallyho。
• 使用 MixinExtras 提供 mixin 注入支持。
• 方块模型使用 Blockbench 创建。
• 我的世界和 Minecraft Forge 提供了本项目的游戏和模组加载器平台。
• 使用 DH API 实现低消耗的跨区块距离射线检测。实现参考了 Ping Wheel。

请分别支持并遵守每个依赖项和可选集成模组的许可协议与分发条款。

许可协议

VS Analog Warfare 以 GNU 通用公共许可证第三版（GPL-3.0）发布。

源代码和许可证随项目一同提供。对 VS Analog Warfare 的任何再分发或修改都必须遵守 GPL-3.0 许可证。

AI 使用声明

VS Analog Warfare 的绝大部分源代码是在大型语言模型工具的辅助下生成的。

人类作者提供了项目方向、功能构想、设计决策、测试、调试、资源创建、集成决策以及最终发布决策。已发布的代码由人类作者测试并汇编完成，其对发布的项目负责。