You are viewing a potentially older version of this package. View all versions.
thereisnouser-ParticleOptimizer-0.1.0 icon

ParticleOptimizer

Reduce or disable selected mining and destruction particle effects for a cleaner view in Stonewards.

Date uploaded a week ago
Version 0.1.0
Download link thereisnouser-ParticleOptimizer-0.1.0.zip
Downloads 74
Dependency string thereisnouser-ParticleOptimizer-0.1.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305

README

Stonewards Particle Optimizer

Keep mining and destruction scenes cleaner by reducing or disabling selected particle effects in Stonewards. The mod filters local visual effects rather than intentionally changing how digging or destruction works.

✨ Features

  • Cleaner mining — filter particles from terrain hits and rock breaking.
  • Less destruction clutter — filter recognized prop-hit and wall-break particles.
  • Adjustable effects — choose vanilla, reduced, or disabled particles for each category.
  • Automatic operation — no hotkeys or in-game menu required.

🎮 How to use

Launch Stonewards with the mod enabled. It automatically filters the selected visual effects; all four categories are disabled by default.

⚙️ Configuration

After the first launch, edit:

BepInEx/config/com.thereisnouser.stonewards.particleoptimizer.cfg

The settings DigHit, DigBreak, PropHit, and WallBreak each support:

  • Vanilla — show normal effects.
  • Reduced — allow 25% of effect spawn events.
  • Disabled — suppress the selected effects (default).

For best results, edit the file while the game is closed.

📦 Installation

Install the package using r2modman or another compatible Thunderstore mod manager, then launch Stonewards through the manager. BepInEx 5 is required.

🔧 Compatibility

  • Game: Stonewards; exact supported game version not yet established.
  • Mod loader: BepInEx 5.
  • Multiplayer: Designed for client-side visual filtering; host/client behavior has not been independently verified.

⚠️ Known limitations

  • Not every particle effect is covered. Some effects may share IDs and be hidden in other situations.
  • FPS improvements vary by system and scene and have not been benchmarked.

🔗 Links

GitHub · Report an issue · Changelog


Made by thereisnouser

CHANGELOG

Changelog

0.1.1

  • Updated GitHub and Thunderstore documentation to the current description standard.
  • Synchronized plugin, project, and Thunderstore package versions for the 0.1.1 release.
  • Particle filtering behavior is unchanged from 0.1.0.

0.1.0

  • Initial client-side filter for mining hit/break VFX, prop hit VFX and wall destruction VFX.
  • Three effect modes: Vanilla, Reduced (25% spawn events), Disabled.
  • Discovers VFX IDs from game's ScriptableObjects and loaded props.
  • BepInEx configuration and PowerShell build/install script.
  • Game actions and Mirror networking logic deliberately unmodified.