
Vintage Story Mod DB · Vintage Story mod
Particles Plus
Note2: 1.22 version requires ImGui 1.2.0 or higher Demo Video Features: • Presets for: • Terra Preta (enabled by default) • High Fertility Soil (enabled by default) • Peat (disabled by default) • Blue Clay (disabled by default) • Red Clay (disabled by
Quick answer
Which Particles Plus release should I use?
Particles Plus 2.5.8 targets 1.22.0, 1.22.1, 1.22.2. It must be installed on the client. Do not install it on the dedicated server. 1 required mod needs a matching file.
Where it goes
Is Particles Plus required on the client, server, or both?
It must be installed on the client. Do not install it on the dedicated server.
This Vintage Story file is marked client-only.
What else does Particles Plus 2.5.8 need?
2.5.8. Change the file and its required mods may change too.
Install ImGui first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
We only count dependency files that match this setup. A file for another loader does not fill the gap.
Before you install it
Add Particles Plus without breaking your instance.
Built for Particles Plus 2.5.8. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 2.5.8. It targets 1.22.0, 1.22.1, 1.22.2; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install ImGui first, but 1 required mod has no matching file for this setup. Do not mix loader builds to force a match.
- 03
Put it on the correct side
It must be installed on the client. Do not install it on the dedicated server.
- 04
Pick the file you checked
Use the “Get this file” button beside 2.5.8. It opens that exact file at the source.
About this project
What does Particles Plus add?
Note2: 1.22 version requires ImGui 1.2.0 or higher
Demo Video
Features:
- Presets for:
- Terra Preta (enabled by default)
- High Fertility Soil (enabled by default)
- Peat (disabled by default)
- Blue Clay (disabled by default)
- Red Clay (disabled by default)
- Cracked Vessels (enabled by default)
- Bony Soil (enabled by default)
- Resin (enabled by default)
- Meteoric Iron (enabled by default)
- Loose Ore Bits (disabled by default)
- Copper Ore (disabled by default)
- 4 Particles presets, you can add those to w/e you want.
- GUI configuration: enable/disable particles, add new presets within the game ("P" key by default)
- Toggle all active presets on/off from GUI or with hotkey ("CTRL + P" by default)
- Technically customizable particles (requires config file editing)
Adding custom particles:
If you want to add custom particles you can do it in the mod's config. You should be familiar with:
- JSON formating
- Wildcards and Regex
- AdvancedParticleProperties Class properties from VintageStory API.
Just follow default config format. I highly recommend to use Modding Tools by Maltiez for creating / exporting particles code.
edit: Modding Tools are very outdated
Planned:
- Particles editor
Q and A:
Q: Mod doesn't work on the server but works on SP
A: Some servers only allow whitelisted mods, others have a blacklist for certain mods. This mod is probably not allowed on that server.
Q: Can the render distance of the particles be changed?
A: No, it uses vanilla particle system and it renders exactly the same way as any particle in the game.
Q: "P" / "CTRL + P" does something else
A: Go to Settings > Controls and rebind Particles Plus hotkeys to something else.
Not working with 1.22: Delete old config file.
Edit: Should be handled automatically in 2.5.8... hopefully :)
If you need any help you can ask on Discord
Project description from Vintage Story Mod DB.
Pick your setup
Particles Plus releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.22.3
1 loader build1.22.2
1 loader build1.22.1
1 loader build1.22.0-rc.8
1 loader build1.22.0-rc.7
1 loader build1.22.0-rc.6
1 loader build1.22.0-rc.5
1 loader build1.22.0-rc.4
1 loader build1.22.0-rc.3
1 loader build1.22.0-rc.2
1 loader build1.22.0-rc.1
1 loader build1.22.0-pre.5
1 loader buildShowing the newest 12 of 30 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Particles Plus versions and loaders
2.5.8
particlesplus-2.5.8.zip
24 Apr 2026
2.5.7
particlesplus-2.5.7.zip
24 Apr 2026
2.5.6
particlesplus-2.5.6.zip
24 Apr 2026
2.5.2
particlesplus-2.5.2.zip
15 Apr 2026
2.3.3
particlesplus-2.3.3.zip
15 Apr 2026
2.5.0
ParticlesPlus-2.5.0.zip
14 Apr 2026
2.4.1
particlesplus_2.4.1.zip
14 Apr 2026
2.3.2
particlesplus-2.3.2.zip
2 Apr 2026
2.4.0
particlesplus_2.4.0.zip
12 Mar 2026
2.3.1
particlesplus-2.3.1.zip
1 Aug 2025
2.3.0
particlesplus-2.3.0.zip
1 Aug 2025
2.2.0
particlesplus-2.2.0.zip
23 Jul 2025
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.