车辆改装件

这个模组允许模组制作者以常规手段无法实现的方式为载具制作模组。您可以制作可安装在载具上的物品修改器来改变其属性。当模组被移除时，原始属性将会恢复！包含了一个示例，但我不建议一次性更改那么多属性。我希望将来能看到更多的载具模组！

更新：此模组是早期版本且未经充分测试。根据我的测试，一切稳定运行且无错误。并非所有属性都能正确更改，但根据我测试过的大部分功能都有效，有些则会出现奇怪的现象。我提前发布是因为现实生活即将忙碌，想与社区分享现有成果！

这是包含在 item_modifiers.xml 中的指南：

================================================================== 基础属性格式

每个属性必须使用以下格式：

<property name="属性名称" value="属性值" param1="操作"/>

• propertyName: 要修改的属性名称（参见下方指南）
• propertyValue: 要设置、添加、减去或乘的值（类型请参阅各属性说明）
• param1: (可选) 要应用的操作。请使用以下之一： vset（设置值） vadd (添加值) vsub（减去值） vmul（乘以值）

示例：

<property name="motorTorqueForward" value="2500" param1="vmul"/>
<property name="canHop" value="true"/>

================================================================== 车辆属性修改指南

此文件包含在作为模组应用时可以修改车辆行为的属性。
这是一个未完成且未经充分测试的版本。虽然根据我的测试一切运行稳定，但部分功能可能无法按预期运作。我提前发布是因为现实生活日渐繁忙，希望能与社区分享这个版本。

请随意使用此内容制作模组。

以下是每个属性类别及其控制内容的说明：

声音属性：

---

hornSound - 改变车辆的喇叭声音。引用自sounds.xml中的声音名称。值：字符串（例如："airhorn_sound"）

bounceSound - 车轮从表面或地形弹起时播放的声音。值：字符串

slideSound - 当车轮在表面上滑动或漂移时播放的声音。值：字符串

turboSound - 涡轮激活时播放的音效。引用sounds.xml中的音效名称。值：字符串

性能特性：

---

motorTorqueForward - 控制车辆前进时的引擎动力。数值越高 = 加速越快。数值类型：数字（浮点数）

motorTorqueBackward - 控制倒车时的引擎动力。数值越高 = 倒车加速越快。数值：数字（浮点数）

motorTorqueTurboForward - 涡轮激活时发动机功率（前进方向）。仅在使用涡轮按钮时生效。数值：数字（浮点数）

motorTorqueTurboBackward - 涡轮激活时的发动机功率（倒车）。仅在使用涡轮按钮时适用。数值：数字（浮点数）

velocityMaxForward - 游戏单位中的最大前进速度。数值越高 = 最高速度越快。值：数字（浮点数）

velocityMaxBackward - 游戏单位中的最大倒车速度。数值越高 = 倒车速度越快。值：数字（浮点数）

velocityMaxTurboForward - 涡轮激活时的最大前进速度。值：数字（浮点数）

velocityMaxTurboBackward - 涡轮激活时的最大倒车速度。值：数字（浮点数）

brakeTorque - 制动功率。数值越高 = 制动距离越短，停车越快。数值：数字（浮点数）

处理属性：

---

steerAngleMax - 最大转向角度。数值越高 = 转弯半径越小，转向越急。数值：数字（浮点数）

steerRate - 转向对输入的反应速度。数值越高 = 转向响应越灵敏。数值：数字（浮点数）

steerCenteringRate - 方向盘回中速度。数值越高 = 自动回正越快。数值：数字（浮点数）

倾斜属性：

---

tiltAngleMax - 车辆转弯时的最大倾斜角度。控制转弯时的倾斜程度。值：数字（浮点数）

tiltThreshold - 倾斜发生前的速度阈值。数值越低 = 在较低速度下倾斜。数值：数字（浮点数）

tiltDampening - 倾斜阻尼效果。数值越高 = 转弯后摆动/晃动越小。数值：数字（浮点数）

tiltDampenThreshold - 倾斜阻尼的速度阈值。控制何时应用阻尼。数值：数字（浮点数）

tiltUpForce - 用于抵消倾斜的施加力。数值越高 = 车辆在转弯时倾斜程度越小。数值：数字（浮点数）

移动属性：

---

canHop - 布尔值，启用车辆跳跃能力。设置为 value="true" 以启用。值：true/false（布尔型）

hopForce - 车辆跳跃时施加的力。格式为"X,Y"向量。数值越高 = 跳跃幅度越大。值类型：字符串（例如："3.2,3.2"）

unstickForce - 用于帮助车辆脱困的施加力。数值越高 = 车辆越容易脱困。数值：数字（浮点数）

upAngleMax - 车辆可攀爬的最大上坡角度。数值越高 = 陡坡攀爬能力越强。数值：数字（浮点数）

upForce - 用于向上移动的施加力。数值越高 = 爬坡能力越强。数值：数字（浮点数）

相机属性：

---

cameraDistance - 相机与载具的距离。格式为“X,Y”向量。数值越高 = 相机越远。值：字符串（例如，“3.0,2.8”）

cameraTurnRate - 相机旋转速度。格式为“X,Y”向量。数值越高 = 相机转动越快。值：字符串（例如“2.0,1.8”）

视觉属性：

---

headlightColor - 前照灯光束的RGB或RGBA颜色。格式为"R,G,B"或"R,G,B,A"，数值范围0-255。可选的第四个值（A）设置光束和发射材质的透明度。值：字符串

headlightIntensity - 控制所有头灯和改装灯光束的强度（亮度）。数值越高 = 灯光越亮。数值：数字（浮点数）

wheelPtlScale - 车轮粒子效果（灰尘等）的缩放比例。数值越高 = 视觉效果越大。值：数字（浮点数）

环境属性：

---

airDragVelScale - 空气阻力对速度的影响。数值越低 = 空气阻力越大，最高速度越慢。数值：数字（浮点数）

airDragAngVelScale - 影响旋转的空气阻力。数值越低 = 旋转阻力越大。数值：数字（浮点数）

水属性：（有点问题，还没怎么测试）

---

waterDragY - 水中垂直阻力。数值越高 = 车辆在水中下沉越快。数值：数字（浮点数）

waterDragVelScale - 水中速度衰减系数。数值越低 = 水中速度衰减越明显。数值：数字（浮点数）

waterDragVelMaxScale - 水中最大速度降低。控制水中的最高速度。值：数字（浮点数）

waterLiftY - 水中的浮力。数值越高 = 漂浮越多，下沉越少。数值：数字（浮点数）

waterLiftDepth - 浮力生效的深度。控制水中漂浮阈值。值：数字（浮点数）

waterLiftForce - 浮力强度。数值越高 = 漂浮效果越强。数值：数字（浮点数）

引擎属性：

---

IsEngineRunning - 强制车辆启动并使引擎始终保持运行状态。值：true/false（布尔型）

悬挂属性：

---

tireSuspensionPercent - 对所有车轮的轮胎悬挂百分比进行乘法调整。数值越高 = 悬挂越软，数值越低 = 悬挂越硬。数值：数字（浮点数，例如：1.5）

摩擦特性：

---

forwardStiffnessBase - 对所有车轮的前向摩擦力进行倍增。较低值 = 更多滑动，较高值 = 更强抓地力。数值：数字（浮点数，例如 0.8）

sideStiffnessBase - 对所有车轮的侧向摩擦力进行倍增。数值越低 = 越容易漂移/打滑，数值越高 = 稳定性越强。数值：数字（浮点数，例如0.7）

伤害属性：

---

effectEntityDamagePer - 乘以载具对实体造成的伤害。数值越高 = 对僵尸/玩家造成的伤害越大。数值：数字（浮点数）

effectBlockDamagePer - 车辆对方块造成的伤害倍率。数值越高，方块破坏力越强。数值：数字（浮点数）

effectSelfDamagePer - 乘以载具自身受到的伤害。数值越低 = 耐久度越高，数值越高 = 受到的伤害越多。数值：数字（浮点数）

effectStrongSelfDamagePer - 强化自伤事件（如爆炸）的倍率。值：数字（浮点数）

---

数值属性的操作属性：

---

对于任何数值属性（浮点数或向量），您可以使用可选的 'param1' 属性来控制数值的应用方式：

param1="vset"    - 将属性设置为指定值（省略时使用默认值）
param1="vadd"    - 将指定值添加到当前属性值
param1="vsub"    - 从当前属性值中减去指定值
param1="vmul"    - 将当前属性值乘以指定值

示例用法：

<property name="motorTorqueForward" value="500" param1="vadd"/>
<property name="velocityMaxForward" value="0.8" param1="vmul"/>
<property name="brakeTorque" value="10000" param1="vset"/>
<property name="hopForce" value="1.0,2.0" param1="vadd"/>

所有数值结果均被限制为零或更高，以防止出现负值。