SnAssets Engines - How to reference engine sounds from another mod
===================================================================

Mod id / namespace:

    snassets_engines

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

1. Referencing engine sounds
----------------------------

Engine sound files are located here inside SnAssets Engines:

    snassets_engines:engines/...

SnAssets Engines also includes:

    assets/snassets_engines/sounds.json

That file defines sound event IDs for all included OGG files.

Example SnAssets Engines sound file:

    assets/snassets_engines/sounds/engines/camaro/example.ogg

Generated sound event ID:

    snassets_engines:engines/camaro/example

Do not include ".ogg" when referencing sounds.

Recommended compatibility method
--------------------------------

For best compatibility, define your own sound event in your mod and point it at the SnAssets Engines OGG file.

Example file in your mod:

    assets/examplemod/sounds.json

{
      "vehicle.engine.example": {
        "sounds": [
          "snassets_engines:engines/camaro/example"
        ]
      }
    }

Your mod would then play:

    examplemod:vehicle.engine.example

This lets your mod own the sound event while SnAssets Engines provides the actual audio file.

2. Dependency examples
----------------------

Fabric fabric.mod.json:

    {
      "depends": {
        "snassets_engines": "*"
      }
    }

Forge / NeoForge mods.toml:

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

Replace "examplemod" with your own mod id.

3. Usage rule
-------------

Allowed:

    Make SnAssets Engines a dependency and reference its sounds through JSON or code.

Not allowed:

    Taking OGG files out of SnAssets Engines and pasting, bundling, or redistributing them inside your own mod.