Hísëa

Hísëa（Quenya 中意为“misty”）是为 ArdaCraft 项目开发的一个模组。它添加了可生成雾效的方块，除非玩家将该方块拿在手中，否则这些方块对用户是不可见的。这些方块没有碰撞，这意味着玩家可以在建筑中添加有趣的细节，例如瀑布水雾、热水浴升起的蒸汽以及雾气，而不会干扰探索或沉浸感。

这些方块生成的雾效有多个方面可通过 ctrl+右键进行配置：

更详细的说明如下。

Hísëa 使用说明

强度（0-50%）

说明：控制雾气看起来有多浓。数值越高，雾越浓、越明显。在最大值时，雾会非常显眼，并形成厚重的浓雾效果。

从代码角度看：它会缩放生成粒子的数量和大小。内部存储为 float（0.0-5.0），其中：

• UI 中每 10% = 代码中的 1.0
• 同时影响粒子缩放和生成速率
• 影响粒子生命周期计算

速度（0-200%）

说明：决定雾粒子的移动速度。较低的值会产生静止、悬浮的雾；较高的值会产生流动、漂移更明显的雾，使其在空间中更有动态感。

从代码角度看：存储为 float（0.0-2.0），并直接与运动值相乘：

 .setMotion(
      velocityMultiplier == 0 ? 0 : (world.getRandom().nextFloat() * 0.01f) * Math.signum(offsetX) * velocityMultiplier,
      velocityMultiplier == 0 ? 0 : (world.getRandom().nextFloat() * 0.005f) * velocityMultiplier, // Slower vertical
      velocityMultiplier == 0 ? 0 : (world.getRandom().nextFloat() * 0.01f) * Math.signum(offsetZ) * velocityMultiplier
  )

持续时间（5-30 秒）

说明：控制雾粒子在淡出前可见的时间长度。更长的持续时间会产生更持久的雾效，而更短的持续时间会带来更短暂、更轻盈的效果。

从代码角度看：以刻（ticks，100-600）存储，其中：

• 每 1 秒 = 20 ticks（Minecraft 以每秒 20 ticks 运行）
• 直接用于粒子构建器：

.setLifetime(lifetime)

颜色（RGB）

说明：设置雾粒子的颜色。可用于创造各种氛围效果，例如彩色雾、魔法迷雾、有毒云雾、不同温度的蒸汽等。

从代码角度看：存储为标准 RGB 整数（0x000000 到 0xFFFFFF）：

  .setColorData(ColorParticleData.create(particleColor).build())

透明度（0-100%）

说明：控制雾气的透视程度。较低的值会产生半透明、幽灵般、几乎不遮挡视线的雾；较高的值会产生更不透明的雾，能够遮住其后的元素。

从代码角度看：存储为 float（0.0-1.0），并用于透明度渐变计算：

  .setTransparencyData(
      GenericParticleData.create(0.001f, 0.7f * customTransparency, 0f)
      .setEasing(Easing.EXPO_OUT, Easing.SINE_OUT)
      .build()
  )

这会创建平滑的淡入/淡出效果，而可见度峰值由此设置控制。

半径（1-100 格）

说明：决定雾气从源方块向外扩散的距离。更大的半径会形成覆盖更大范围的雾，而更小的半径会形成更集中的云雾。

从代码角度看：存储为整数，并用于缩放粒子位置偏移：

  double radiusScale = customRadius / 3.0; // Scale factor where 3 is the default radius
  double scaledOffsetX = offsetX * radiusScale;
  double scaledOffsetZ = offsetZ * radiusScale;

启用（开/关）

说明：一个简单的开关，可在不移除方块的情况下开启或关闭雾气发射。适合临时禁用效果，或在不同场景之间切换。

从代码角度看：存储为 boolean，并在生成任何粒子前进行检查：

  if (cachedEnabled != null && !cachedEnabled) {
      // Block has been disabled by the user
      return;
  }

技术实现说明

• 客户端-服务端同步：所有设置都存储在服务端的方块实体中，并同步给已连接的客户端
• 持久化：设置会保存到世界的 NBT 数据中，以便在服务器重启后恢复
• 效率：粒子使用可见性检查和优化措施，以尽量减少性能影响
• 上次使用的设置：放置新方块时，模组会记住你上次使用的设置

该模组由 Divined 为 ArdaCraft 开发（Discord：.divined）。非常感谢 Effective 的开发者们提供的帮助。

项目图标鸣谢 Instagram 上的 kameh.space。