SnAssets Library - Particles

You're allowed to use this mod in your modpacks!

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

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:

SnAssets Particles - How to reference assets from another mod

Mod id / namespace:

snassets_particles

SnAssets Particles is an asset library. Your mod should depend on it, then reference its assets by namespace.
Do not copy the actual PNG files into your own mod.

Referencing particle textures

Particle textures are located within:

assets/snassets_particles/textures/particle/

When referencing a particle texture from your own particle JSON, use:

snassets_particles:

Example SnAssets file:

assets/snassets_particles/textures/particle/bang0.png

Reference it from your mod's particle JSON like this:

assets/examplemod/particles/example_bang.json

{
"textures": [
"snassets_particles:bang0"
]
}

Example with multiple frames:

{
"textures": [
"snassets_particles:bang0",
"snassets_particles:bang1",
"snassets_particles:bang2",
"snassets_particles:bang3"
]
}

If the texture is in a subfolder, keep the subfolder path.

Example SnAssets file:

assets/snassets_particles/textures/particle/bulletholes/bullethole_basic.png

Reference:

snassets_particles:bulletholes/bullethole_basic

Important:

SnAssets Particles only provides the texture files.
Your own mod still needs to register or define the particle type if your loader/version requires that.

2. Dependency code

---

Fabric fabric.mod.json:

{
"depends": {
"snassets_particles": "*"
}
}

Forge / NeoForge mods.toml:

[[dependencies.examplemod]]
modId="snassets_particles"
mandatory=true
versionRange="[1.0.0,)"
ordering="NONE"
side="BOTH"

Replace "examplemod" with your own mod id.

3. Usage rule

---

Allowed:

-> Make SnAssets Particles a dependency and reference its textures through JSON or code.

Not allowed:

Taking PNG or other asset files out of SnAssets Particles and pasting, bundling, or redistributing them inside your own mod.