The sounds.yml file controls all audio aspects of the plugin. CoolCars supports both standard Minecraft sounds and custom sounds from your resource pack.
Global Settings (sounds)
Here you define general sound playback parameters.
- enabled: Global toggle for all plugin sounds.
- category: Sound category in Minecraft settings (usually
PLAYERS or NEUTRAL).
Spatial Sound (spatial)
Configures how sound fades as you move away from the vehicle.
- near-distance-blocks: Distance at which the sound is heard at full volume.
- falloff-curve-power: Fading strength. Higher values make the sound get quieter faster as distance increases.
Events and Effects (events)
Each vehicle action can be accompanied by a unique sound.
Key Events:
- engine-start: Sound of the engine starting.
- horn: Horn (klaxon) sound.
- seat-open: Door opening sound when entering.
- landing: Impact sound when hitting the ground.
events:
horn:
enabled: true
key: "coolcars.horn" # Sound key from resource pack or Minecraft
volume: 1.25 # Volume
pitch: 1.00 # Pitch (tone)
radius: 36.0 # Audibility radius in blocks
cooldown-ticks: 24 # Cooldown before reuse
Engine Sounds (engine)
The engine sound system in CoolCars is dynamic. It changes pitch and volume based on RPM and speed.
- idle: Engine sound while stationary.
- driving: Engine sound under load (while moving).
Smooth Transitions (transition)
To prevent the sound from “cutting off” when starting to move, delays are used:
- driving-to-idle-delay-ticks: Smoothness of the transition from driving to idle.
For the best effect, use looped sounds in your resource pack.
Specific Movement Sounds
| Event | Description |
|---|
drift | Tire screech sound during sharp turns or drifting. |
skid | Braking skid sound. |
impact | Collision sound with an obstacle. |
