Light Dust
Light Dust 是一款轻量级的客户端模组,为你的世界增添了漂浮的尘埃。它基于交互式物理引擎构建,尘埃会对光照、天气以及你所探索的确切生物群系做出反应。
从 v1.9.5+ 版本开始,本模组内置了游戏内配置菜单(无需依赖其他模组),你可以通过以下路径找到它:菜单 -> 模组 -> lightdust -> 配置
功能特性
- 你可以通过查看下方的配置选项看到其中一些效果!但由于可列出的内容实在太多,建议直接通过游戏内配置菜单进行浏览。
生成与性能
spawnMode (默认: FANCY): 在 FANCY(精致)和 FAST(快速)模式之间选择以生成尘埃。
fastSpawnChecks (默认: 120): FAST 模式的计算预算。随机采样数量。数值越低 = 帧率越好。
fancySpawnChecks (默认: 1200): FANCY 模式的计算预算。BFS(广度优先搜索)映射的最大方块数。如果设置过低会限制半径。注意:如果你将 fastSpawnChecks 设置为大于 400 的值,建议切换到 FANCY 模式。
enableMaxYLevel (默认: false): 切换高度限制功能。
maxYLevel (默认: 60): 尘埃停止生成的 Y 轴坐标高度。
ambientRadius (默认: 10): 尘埃尝试在玩家周围多远的范围内生成。
ambientHardCapRadius (默认: 12): 尘埃存在的绝对最大距离。超过此距离的粒子会被立即删除。
ambientBlockCap (默认: 14): 单个方块内允许的最大尘埃密度。
minBlockLight (默认: 6): 环境尘埃生成所需的最低方块光照等级。
daytimeLightDiff (默认: 5): 白天尘埃生成所需的方块光照与天空光照之间的最小差值。
falloffDistance (默认: 6): 从玩家开始减少尘埃密度的距离。
falloffMultiplier (默认: 0.3): 应用于超出衰减距离后的最大粒子上限的乘数。
enableOcclusionCulling (默认: true): 使用视线(LOS)光线追踪技术,防止尘埃在实心墙壁后方生成。
视觉效果与环境
useHdParticles (默认: true): 切换高清尘埃粒子或启用旧版粒子。注意:如果使用此选项,建议略微降低粒子大小和不透明度的数值。(建议分别设置为 0.016 和 0.18)
enableDynamicBlockColors (默认: true): 切换方块颜色继承系统。
ambientDustOpacity (默认: 0.18): 环境尘埃的基础不透明度。
particleSize (默认: 0.016): 调整环境尘埃粒子的视觉大小。
particleLifetime (默认: 200): 控制尘埃粒子存在的时间长度(以刻为单位)。
enableWind: 全局禁用所有基于风和天气的方向性推力效果。
windSpeedClear (默认: 0.25): 调整晴朗天气下的全局风力漂移速度。
windSpeedRain (默认: 0.35): 调整下雨天气下的全局风力漂移速度。
windSpeedThunder (默认: 0.5): 调整雷雨天气下的全局风力漂移速度。
disableDuringRain (默认: false): 切换以防止在下雨期间户外尘埃的生成或存在。
disableDuringThunder (默认: false): 切换以防止在雷雨期间户外尘埃的生成或存在。
交互与动作
enableBlockBreakingDust: 切换方块被破坏时粒子向指定方向喷射的效果。
breakParticleCount (默认值: 12): 控制方块破碎碎片的数量。
breakParticleSpeed (默认值: 0.1): 控制方块破碎碎片的速度。
actionDustGravity (默认值: 2.0): 控制碎片撞击表面时的下落速度。
actionDustBounce (默认值: 0.2): 控制碎片撞击表面时的反弹力度。
breakVacuumRadius (默认值: 1.2): 环境灰尘被吸附至已破坏方块的半径(以方块为单位)。
enableBreakVacuum (默认值: true): 切换方块破碎时的真空吸附效果。
breakVacuumForce (默认值: 10.0): 控制灰尘被吸向已破坏方块的力度。
enableCaveTremors: 切换由监守者音波冲击和爆炸引起的天花板灰尘掉落效果。
caveTremorParticleCount (默认值: 90): 爆炸期间掉落碎片的基准密度。
tremorEpicenterMultiplier (默认值: 5.0): 控制爆炸中心的强度。
tremorFalloffExponent (默认值: 6.0): 控制强度从爆炸中心向外衰减的速度。
tremorCeilingBias (默认值: 0.75): 调整天花板生成与地面生成的比例。
tremorFloorKickForce (默认值: 2.1): 调整地面灰尘向上的力。
tremorWavefrontThickness (默认值: 6.0): 控制扩张冲击波区域的深度。
tremorMaxGravity (默认值: 40.0): 调整中心区域碎片的重量。
tremorMinGravity (默认值: 1.0): 调整边缘区域碎片的重量。
tremorRoofMultiplier (默认值: 0.4): 应用于从天花板掉落的灰尘的重力乘数。
tremorFloorMultiplier (默认值: 0.2): 应用于从地面扬起灰尘的重力乘数。
enablePlayerInteraction: 切换玩家移动、挥动武器和举盾是否会扰动环境灰尘。
playerInteractRadius (默认值: 4.0): 玩家移动物理推开灰尘粒子的半径。
enableHeavyLandingDust: 切换重着陆时扬起的灰尘环效果。
heavyLandingMaxParticles (默认值: 96): 控制承受摔落伤害时生成的粒子数量。
heavyLandingParticleMultiplier (默认值: 12): 控制承受摔落伤害时生成的粒子倍率。
heavyLandingUpwardSpeed (默认值: 0.2): 控制重着陆灰尘环向上运动的速度。
heavyLandingOutwardSpeed (默认值: 0.12): 控制重着陆灰尘环向外扩散的形状/速度。
heavyLandingAmbientPush (默认值: 1.0): 控制着陆时推开周围灰尘的冲击波力量。
heavyLandingAmbientRadius (默认值: 4.0): 控制着陆时推开周围灰尘的冲击波半径。
enableThermalUpdrafts: 切换热块上方上升的热力学物理效应和上升气流。
heatBlocks (默认值: DEFAULT_HEAT_BLOCKS): 用于产生热上升气流的发光方块列表。
Dynamic Lights 兼容性
enableHandheldLights (默认值: false): 如果为 true,手持物品将作为假光源,允许灰尘生成并为灰尘着色。
handheldLightItems (默认值: DEFAULT_HANDHELD_LIGHTS): 物品/标签及其光照属性的列表。格式:'modid:item_name=半径,#十六进制颜色' 或 '#modid:tag=半径,#十六进制颜色'。
实验性功能 (experimental.toml)
enableCaveDrafts (默认值: true): 启用洞穴内的气压和穿堂风效果。
caveDraftStrength (默认值: 0.85): 乘数,用于调节洞穴内风的流速。
enableEntityDisturbance (默认值: true): 允许非玩家实体(生物/投射物)扬起并扰动灰尘。此功能硬限制为仅追踪最近的 6 个移动实体。
entityScanRate (默认值: 4): 模组扫描附近实体的频率(以刻为单位)。
entityPushStrength (默认值: 0.05): 实体穿过灰尘时对灰尘的推力大小。
enableAdvancedWindMath (默认值: true): 启用复杂的空间湍流和扫掠式风力物理效果。
enableWindDeflection (默认值: true): 允许风 realistically(逼真地)将灰尘吹过隧道。
enableDustSettling (默认值: true): 允许灰尘粒子在接触地面时视觉上沉降。
颜色与 tinting 设置 (colors.toml)
tintStrength (默认值: 0.75): 调整彩色灯光对灰尘着色的强度。(如果使用 Hd dust,建议提高该值,例如 0.75)。
customTints: 用于灰尘着色的发光方块及其十六进制颜色列表。
customBiomeTints: 使用十六进制代码定义生物群系的基准环境颜色。
caveBiomeTriggers: 将特定方块映射到十六进制颜色,以改变地下环境的视觉效果。
常见问题解答
问:它与真黑(True Dark)类模组兼容吗?
答: 是的。它应该可以正常工作。不过,您可能需要调整灰尘的不透明度。
问:它与光影(Shaders)兼容吗?
答: 是的。但是,光影通常会改变透明度的渲染方式。如果灰尘看起来过于透明/不可见,请在配置文件中增加 ambientDustOpacity 的值(尝试设为 0.45 或更高)。
问:它在大型整合包中会导致卡顿吗?
答: 它专为轻量级设计。该模组拥有大量的优化选项,包括新添加的视锥剔除(LOS)和半球系统,以及遮挡剔除(Occlusion Culling),可跳过实心墙壁后的粒子渲染。如果您仍然出现掉帧,可以禁用 enableAdvancedWindMath 或在配置中降低粒子上限。
问:我可以改变灰尘的颜色吗?
A: 是的!你可以在 colors.toml 配置文件中更改光源的色调(customTints)、任意生物群系的基色(customBiomeTints),并通过特定方块触发地下的颜色效果(caveBiomeTriggers)。
Q:这是否支持模组添加的生物群系和洞穴?
A: 可以的。只需在配置文件的相应列表中填入模组生物群系的 ID 或模组方块,并指定一个十六进制颜色值即可正常使用。
Q:如何禁用方块破坏粒子效果?
A: 在配置文件中将 breakParticleCount 设置为 0。
Light Dust
Light Dust is a lightweight client side mod that adds floating dust to your world. Built with interactive physics, dust reacts to light, weather, and the exact biome you are exploring.
As of v1.9.5+ this mod has an in game config menu (no dependencies) which you can find by doing: menu -> mods -> lightdust -> config
Features
- You can see some of them by looking at the config options below! But there really is a lot to list so I suggest looking at in via in game config menu.
Spawning & Performance
spawnMode (Default: FANCY): Choose between FANCY and FAST for spawning dust.
fastSpawnChecks (Default: 120): Math budget for FAST mode. Random sample count. Lower = Better FPS.
fancySpawnChecks (Default: 1200): Math budget for FANCY mode. Max blocks mapped by BFS. Restricts radius if too low. Note: If you set fastSpawnChecks to any value >400, I would suggest swapping to fancy.
enableMaxYLevel (Default: false): Toggle for the height limit.
maxYLevel (Default: 60): The height coordinate where dust stops spawning.
ambientRadius (Default: 10): How far away from the player dust will attempt to spawn.
ambientHardCapRadius (Default: 12): The absolute maximum distance dust can exist. Particles further than this are deleted instantly.
ambientBlockCap (Default: 14): The maximum density of dust allowed in a single block.
minBlockLight (Default: 6): The minimum block light level required for ambient dust to spawn.
daytimeLightDiff (Default: 5): The minimum difference between Block Light and Sky Light required for dust to spawn during the day.
falloffDistance (Default: 6): Distance from the player where dust density starts to decrease.
falloffMultiplier (Default: 0.3): Multiplier applied to the max particle cap beyond the falloff distance.
enableOcclusionCulling (Default: true): Uses LOS raytracing to prevent dust from spawning behind solid walls.
Visuals & Environment
useHdParticles (Default: true): Toggle for the HD dust particles or use the legacy version. Note that if you use this you should lower the values for particle size and opacity slightly. (I suggest 0.016 and 0.18 respectively)
enableDynamicBlockColors (Default: true): Toggle for the block color inheritance system.
ambientDustOpacity (Default: 0.18): Base opacity for ambient dust.
particleSize (Default: 0.016): Adjust the visual size of the ambient dust particles.
particleLifetime (Default: 200): Control how long (in ticks) dust particles stick around.
enableWind: Globally disables all wind and weather based directional pushing.
windSpeedClear (Default: 0.25): Adjusts global wind drift during clear weather.
windSpeedRain (Default: 0.35): Adjusts global wind drift during rain.
windSpeedThunder (Default: 0.5): Adjusts global wind drift during thunder.
disableDuringRain (Default: false): Toggles to prevent outdoor dust from spawning or existing during rain.
disableDuringThunder (Default: false): Toggles to prevent outdoor dust from spawning or existing during thunder.
Interactions & Actions
enableBlockBreakingDust: Toggles the directional burst of dust particles when a block is destroyed.
breakParticleCount (Default: 12): Controls the volume of the block-breaking debris.
breakParticleSpeed (Default: 0.1): Controls the speed of the block-breaking debris.
actionDustGravity (Default: 2.0): Controls the fall speed of debris hitting surfaces.
actionDustBounce (Default: 0.2): Controls the bounciness of debris hitting surfaces.
breakVacuumRadius (Default: 1.2): The radius in blocks that ambient dust is pulled toward a broken block.
enableBreakVacuum (Default: true): Toggle for the vacuum effect when a block breaks.
breakVacuumForce (Default: 10.0): How strong the dust is pulled toward the broken block.
enableCaveTremors: Toggles the ceiling dust falling from Warden sonic booms and explosions.
caveTremorParticleCount (Default: 90): The base density of falling debris during explosions.
tremorEpicenterMultiplier (Default: 5.0): Controls intensity at the blast center.
tremorFalloffExponent (Default: 6.0): Controls how quickly intensity fades from the blast center.
tremorCeilingBias (Default: 0.75): Adjusts the ratio of ceiling-to-floor spawns.
tremorFloorKickForce (Default: 2.1): Adjusts the upward force for floor dust.
tremorWavefrontThickness (Default: 6.0): Controls the depth of the expanding shockwave zone.
tremorMaxGravity (Default: 40.0): Adjusts the weight of debris at the center.
tremorMinGravity (Default: 1.0): Adjusts the weight of debris at the outer edge.
tremorRoofMultiplier (Default: 0.4): Multiplier for the gravity applied to dust falling from the ceiling.
tremorFloorMultiplier (Default: 0.2): Multiplier for the gravity applied to dust kicked up from the floor.
enablePlayerInteraction: Toggles whether player movement, weapon swinging, and shielding disturbs ambient dust.
playerInteractRadius (Default: 4.0): The radius at which player movements physically push dust particles.
enableHeavyLandingDust: Toggles the ring of dust kicked up from heavy landings.
heavyLandingMaxParticles (Default: 96): Controls how many particles spawn when taking fall damage.
heavyLandingParticleMultiplier (Default: 12): Controls the multiplier for particles spawned when taking fall damage.
heavyLandingUpwardSpeed (Default: 0.2): Controls the speed of the heavy landing dust ring upward.
heavyLandingOutwardSpeed (Default: 0.12): Controls the shape of the heavy landing dust ring outward.
heavyLandingAmbientPush (Default: 1.0): Controls the shockwave force that pushes ambient dust away when you land.
heavyLandingAmbientRadius (Default: 4.0): Controls the shockwave radius that pushes ambient dust away when you land.
enableThermalUpdrafts: Toggles the rising heat physics and updrafts above heat blocks.
heatBlocks (Default: DEFAULT_HEAT_BLOCKS): List of blocks that emit heat for thermal updrafts.
Dynamic Lights Compat
enableHandheldLights (Default: false): If true, items held in your hand will act as fake light sources, allowing dust to spawn and coloring the dust.
handheldLightItems (Default: DEFAULT_HANDHELD_LIGHTS): List of items/tags and their light properties. Format: 'modid:item_name=radius,#HEXCOLOR' or '#modid:tag=radius,#HEXCOLOR'.
Experimental Features (experimental.toml)
enableCaveDrafts (Default: true): Enables air pressure and drafts inside caves.
caveDraftStrength (Default: 0.85): Multiplier for the speed of wind drafts inside caves.
enableEntityDisturbance (Default: true): Allows non-player entities (mobs/projectiles) to kick up and disturb dust. This is hard capped to only track the 6 closest moving entities.
entityScanRate (Default: 4): How often in ticks the mod scans for nearby entities.
entityPushStrength (Default: 0.05): How strongly entities push dust when moving through it.
enableAdvancedWindMath (Default: true): Enable complex spatial turbulence and sweeping wind physics.
enableWindDeflection (Default: true): Allows wind to realistically blow dust down tunnels.
enableDustSettling (Default: true): Allows dust particles to visually settle when hitting the ground.
Color & Tinting Settings (colors.toml)
tintStrength (Default: 0.75): Adjusts how strongly colored lights tint the dust. (suggest higher values if using Hd dust ex: 0.75).
customTints: A list of light-emitting blocks and their hex colors for dust tinting.
customBiomeTints: Define base ambient colors for biomes using hex codes.
caveBiomeTriggers: Map specific blocks to a hex color for underground environment changes.
Q&A
Q: Does this work with true dark mods?
A: Yes. It should work with them. However, you may need to change the opacity of the dust.
Q: Does this work with Shaders?
A: Yes. However, shaders often change how transparency renders. If the dust looks too invisible, increase ambientDustOpacity in the config (try 0.45 or higher).
Q: Will this cause lag in big modpacks?
A: It is designed specifically to be lightweight. The mod has a ton of optimization options such as the newly added LOS and Hemisphere system aswell as Occlusion Culling to skip particle rendering behind solid walls. If you still drop frames, you can disable enableAdvancedWindMath or lower the particle caps in the configs.
Q: Can I change the color of the dust?
A: Yes! You can change the tint of light sources (customTints), the base color of any biome (customBiomeTints), and trigger colors underground using specific blocks (caveBiomeTriggers) in the colors.toml config.
Q: Does this work with modded biomes and caves?
A: Yep. Just add the modded biome ID or the modded blocks to the respective lists in the config, assign a hex color, and it should work just fine.
Q: How do I disable the Block Break particles?
A: Set breakParticleCount to 0 in the config.
评论 0
登录后参与评分
还没有评论,来抢沙发吧