Nexo
  • 🏠Home
  • 📜Main Changelog
  • ❓FAQ
  • General Usage
    • ⌨️Commands
    • 🧑‍🍳Recipes
  • Migrate
    • ☄️Oraxen → Nexo
    • 📦ItemsAdder → Nexo
  • Configuration
    • ⚙️Plugin settings
    • ResourcePack
    • ⚒️Items
      • Special Item Appearance
    • ⛑️Custom Armors
      • 🪽Custom Elytras (1.21.2+)
      • Component Based (1.21.2+)
      • Trims Based (1.20-1.21.1)
    • 🌀Glyphs
      • 🎞️Animated Glyphs
      • 🖼️Multi-Bitmap Glyph
      • 🔗Reference Glyph
    • 🎵Sounds
  • Mechanics
    • 🪑Furniture Mechanic
      • 🎯Hitbox
      • 🖇️Connectable Furniture
      • 🪑Seat Mechanic
      • 🛏️Bed Mechanic
      • 💡Light Mechanic
      • 🧑‍🌾Farming Mechanic
    • 📦Custom Block Mechanics
      • ChorusBlock Mechanic
      • 🎶NoteBlock Mechanic
        • Stripped Log Mechanic
        • Directional Mechanic
      • 🧵StringBlock Mechanic
    • 🔱Custom Trident
    • Other Mechanics
    • ClickAction Mechanic
    • Custom Mechanic
  • ➕Addons
    • 🚪Carpentry
    • 🧩Core Shaders
      • Text Effects by Akis
  • Compatibility
    • ModelEngine - custom mobs
    • MythicMobs - custom mobs
    • MythicCrucible
    • MMOItems
  • Community Guides
    • Vendors
    • API
Powered by GitBook
On this page
  1. Configuration

Sounds

PreviousReference GlyphNextFurniture Mechanic

Last updated 16 days ago

Nexo allows you to register custom sounds that can be used in /playsoundor other plugins The most basic of sounds can be configured like below by editing `plugins/Nexo/sounds.yml`

sounds:
  - id: block.custom.mysound   # id: namespace:id
    sound: nexo:mysound.ogg    # References assets/nexo/sounds/mysound.ogg
    #sounds:                   # Optional, list of sounds where a random will be selected
    #  - mysound.ogg
    #  - mysound2.ogg

There are also some more properties you can tweak if needed, but for majority of cases, the above default will be enough. A detailed explanation of each property can be found

#https://minecraft.wiki/w/Sounds.json
sounds:
  - id: nexo:music.something
    sound: nexo:music/something.ogg
    sounds:                                  # Alternative if you have more than 1 sound-file
      - nexo:music/something.ogg
      - nexo:music/something2.ogg
    stream: true                             # Optional, defaults to false
    preload: true                            # Optional, defaults to false
    volume: 1f                               # Optional, defaults to 1f
    pitch: 1f                                # Optional, defaults to 1f
    weight: 1                                # Optional, defaults to 1
    attenuation_distance: 13                 # Optional, defaults to 16
    jukebox_playable:                        # Optional, Used for registering a custom music-disc sound
      comparator_output: 15                  # Optional, defaults to 15, must be in 1..15
      range: X                               # Optional, If omitted, the sound will have a variable range.
      length_in_seconds: 2.5
      description: Description

Replacing sounds

If you wanna replace sounds already in minecraft, you can do so by doing

sounds:
  - id: block.glass.place # removes vanilla sound
    sounds: []
    replace: true
  - id: block.glass.break # replaces vanilla sound with custom sound
    sound: nexo:customglasssound
    replace: true

There is also jukebox_playablewhich is used to register sounds used in custom music discs Nexo will generate the necessary datapack for this, which you can then reference in of your item

🎵
here
JukeboxPlayable-Component