SnAssets Library - Particles

## You're allowed to use this mod in your modpacks! <span style="color: #95a5a6;">You may include this mod in public or private Minecraft modpacks, provided the mod file is unmodified and downloaded from its official Modrinth or CurseForge page</span> # SnAssets Asset Library - Particles The SnAssets Particle Library is branch of the general library which adds JUST the particles I regularly use in my own projects. With this library, these particles may be used by any other modder by **making this project a dependency and referencing assets via JSON!** **You can find particle textures for:** smoke, sparks, tracers, bullet casings, bullet holes, explosions, fire, flames, dirt and other debris, glass shards, bubbles, leaves, splinters and more! Reader: SnAssets Particles is a cross-loader Minecraft asset library for other mods to use. It contains particle sprites. `snassets_particles` **How to use:** * Add SnAssets as a dependency for your mod. * Reference particle textures from your own particle JSON, for example: `snassets_particles:bang0` If the texture is inside a subfolder, keep the subfolder path, for example: snassets\_particles:bulletholes/bullethole\_basic This library only provides the texture files. Your own mod still needs to define/register the actual particle type where required. ### Do not copy assets out of this library. It is fine to make SnAssets Particles a dependency and reference assets via JSON or code. It is prohibited to take the actual PNG asset files from this library and paste, bundle, or redistribute them inside your own mod. ## Detailed how to use: <div class="spoiler"><p>&nbsp;</p><p>SnAssets Particles - How to reference assets from another mod<br>====================================================</p><p>Mod id / namespace:</p><p>&nbsp; &nbsp; snassets_particles</p><p>SnAssets Particles is an asset library. Your mod should depend on it, then reference its assets by namespace.<br>Do not copy the actual PNG files into your own mod.<br><br></p><p><strong>Referencing particle textures</strong><br>--------------------------------</p><p>Particle textures are located within:</p><p>&nbsp; &nbsp; assets/snassets_particles/textures/particle/</p><p>When referencing a particle texture from your own particle JSON, use:</p><p>&nbsp; &nbsp; snassets_particles:</p><p>Example SnAssets file:</p><p>&nbsp; &nbsp;assets/snassets_particles/textures/particle/bang0.png</p><p>Reference it from your mod's particle JSON like this:</p><p>&nbsp; &nbsp; assets/examplemod/particles/example_bang.json</p><p>&nbsp; &nbsp; {<br>&nbsp; &nbsp; &nbsp; "textures": <br>&nbsp; &nbsp; }</p><p>Example with multiple frames:</p><p>&nbsp; &nbsp; {<br>&nbsp; &nbsp; &nbsp; "textures": <br>&nbsp; &nbsp; }</p><p>&nbsp;</p><p>If the texture is in a subfolder, keep the subfolder path.</p><p>Example SnAssets file:</p><p>&nbsp; &nbsp; assets/snassets_particles/textures/particle/bulletholes/bullethole_basic.png&nbsp;</p><p>Reference:</p><p>&nbsp; &nbsp; snassets_particles:bulletholes/bullethole_basic&nbsp;</p><p>Important:</p><p>&nbsp; &nbsp;SnAssets Particles only provides the texture files.<br>&nbsp; &nbsp; Your own mod still needs to register or define the particle type if your loader/version requires that.&nbsp;</p><p>&nbsp;</p><p>2. Dependency code<br>----------------------</p><p>Fabric fabric.mod.json:</p><p>&nbsp; &nbsp; {<br>&nbsp; &nbsp; &nbsp; "depends": {<br>&nbsp; &nbsp; &nbsp; &nbsp; "snassets_particles": "*"<br>&nbsp; &nbsp; &nbsp; }<br>&nbsp; &nbsp; }</p><p>Forge / NeoForge mods.toml:</p><p>&nbsp; &nbsp; ]<br>&nbsp; &nbsp; &nbsp; &nbsp; modId="snassets_particles"<br>&nbsp; &nbsp; &nbsp; &nbsp; mandatory=true<br>&nbsp; &nbsp; &nbsp; &nbsp; versionRange="[1.0.0,)"<br>&nbsp; &nbsp; &nbsp; &nbsp; ordering="NONE"<br>&nbsp; &nbsp; &nbsp; &nbsp; side="BOTH"</p><p>Replace "examplemod" with your own mod id.</p><p>3. Usage rule<br>-------------</p><p>Allowed:</p><p>-&gt; &nbsp;Make SnAssets Particles a dependency and reference its textures through JSON or code.</p><p>Not allowed:</p><p>&nbsp; &nbsp; Taking PNG or other asset files out of SnAssets Particles and pasting, bundling, or redistributing them inside your own mod.</p><p>&nbsp;</p></div>