Hísëa

Intensity (0-50%)

Explanation: Controls how thick the mist appears. Higher values create denser, more visible mist. At maximum values, the mist becomes very noticeable and creates a thick fog effect.

Code wise: Scales the number and size of particles generated. Internally stored as a float (0.0-5.0) where:

• Each 10% in UI = 1.0 in code
• Affects both particle scale and spawn rate
• Influences particle lifetime calculation

Velocity (0-200%)

Explanation: Determines how fast the mist particles move. Low values create still, hanging mist. Higher values create flowing, drifting mist that moves more dramatically through the space.

Code wise: Stored as a float (0.0-2.0) and directly multiplied with the motion values:

 .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
  )

Lifetime (5-30 seconds)

Explanation: Controls how long mist particles remain visible before fading away. Longer lifetimes create a more persistent mist effect, while shorter lifetimes create a more ephemeral, wispy effect.

Code wise: Stored as ticks (100-600) where:

• Each second = 20 ticks (Minecraft runs at 20 ticks per second)
• Directly used in the particle builder:

.setLifetime(lifetime)

Color (RGB)

Explanation: Sets the color of the mist particles. Can be used to create atmospheric effects like colored fog, magical mist, toxic clouds, steam with different temperatures, etc.

Code wise: Stored as a standard RGB integer (0x000000 to 0xFFFFFF):

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

Transparency (0-100%)

Explanation: Controls how see-through the mist appears. Lower values make translucent, ghostly mist that barely obscures the view. Higher values create more opaque mist that can hide elements behind it.

Code-wise: Stored as a float (0.0-1.0) and used in transparency gradient calculation:

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

This creates a smooth fade-in/fade-out effect with the peak visibility controlled by this setting.

Radius (1-100 blocks)

Explanation: Determines how far the mist spreads from the source block. Larger radius creates fog that covers more area, while smaller radius creates concentrated clouds.

Code wise: Stored as an integer and used to scale particle position offsets:

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

Enabled (On/Off)

Explanation: Simple toggle to turn mist emission on or off without removing the block. Useful for temporarily disabling effects or switching between different scenes.

Code wise: Stored as a boolean and checked before spawning any particles:

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

Technical Implementation Notes

• Client-Server Sync: All settings are stored on the server in the block entity and synced to connected clients
• Persistence: Settings are saved to the world's NBT data for restoration after server restarts
• Efficiency: Particles use visibility checks and optimizations to minimize performance impact
• Last Used Settings: The mod remembers your last used settings when placing new blocks