Datapack Jukebox Buffs

Pack type: Datapack · Location: data/<namespace>/jukebox_songs/<name>.json

Part of Customizing Create: Storage. New to datapacks? Start with Datapacks there.

When a music disc plays in a backpack with the Jukebox Upgrade, it gives the player mob effects ("buffs"). Each song's buffs come from one JSON file, so a datapack can give buffs to any disc, including discs from other mods, and change or remove the built-in ones.

Contents

• File format
• Built-in buffs
• Adding, changing and removing buffs
• How buffs are applied
• Reference: song and effect IDs

---

File format

{
  "song": "minecraft:cat",
  "player_only": false,
  "effects": [
    {
      "effect": "minecraft:speed",
      "amplifier": 0
    }
  ]
}

Field	Required	Default	Description
song	Yes	—	The jukebox song ID, from the minecraft:jukebox_song registry. This is not the disc's item ID; e.g. Music Disc 13 plays minecraft:13. See song IDs.
player_only	No	false	true gives the buffs only from a worn backpack. A backpack placed as a block plays the song but gives no buffs.
effects	Yes	—	Up to 3 effects. Extra effects are ignored with a warning in the log, and a repeated effect is only used once.

Each effect has:

Field	Required	Default	Description
effect	Yes	—	A mob effect ID, from vanilla, Create: Storage or any other mod. See effect IDs.
amplifier	No	0	The effect level, counting from 0: 0 is level I, 1 is level II, and so on.

---

Built-in buffs

Create: Storage ships these files in data/fxntstorage/jukebox_songs/:

Disc	File	Buffs
13	13.json	Phantom Ward
Cat	cat.json	Repel Creepers
Creator (Music Box)	creator_music_box.json	Regeneration I, Absorption I
Far	far.json	Slow Falling I
5	5.json	Night Vision I, Regeneration I
Mall	mall.json	Jump Boost II, Speed I
Mellohi	mellohi.json	Calm Endermen
Otherside	otherside.json	Regeneration II
Pigstep	pigstep.json	Pacify Piglins
Precipice	precipice.json	Resistance I
Relic	relic.json	Haste I
Stal	stal.json	Invisibility I
Strad	strad.json	Luck II
Wait	wait.json	Water Breathing I
Ward	ward.json	Strength II
Tears	tears.json	Fire Resistance I (added by VanillaBackport)
Lava Chicken	lava_chicken.json	Speed III (added by VanillaBackport)

Discs not listed here (Blocks, Chirp, 11, Creator) play without buffs until a datapack adds them.

---

Adding, changing and removing buffs

Buffs are matched by the song field, and each song has only one set of buffs. The file's name and namespace don't matter for matching. This means:

• To change a built-in disc, override its file: use the same path in your datapack, data/fxntstorage/jukebox_songs/<file from the table above>. Your file replaces the built-in one.
• To add buffs to a disc that has none, put a file anywhere under jukebox_songs/, e.g. data/mypack/jukebox_songs/blocks.json.
• To remove a built-in disc's buffs, override its file with an empty effects list.

Don't give the same song a second file under a different path. Only one of the two is used, and which one is not predictable. Always override the built-in file instead.

Upgrading from 1.3.5 or earlier: the Music Disc 5 file was renamed from five.json to 5.json in 1.3.6. If your pack overrides data/fxntstorage/jukebox_songs/five.json, rename your file to 5.json. Otherwise both files are loaded for the same song.

Examples

Change the Cat disc from Repel Creepers to Luck I. File: data/fxntstorage/jukebox_songs/cat.json

{
  "song": "minecraft:cat",
  "effects": [
    { "effect": "minecraft:luck" }
  ]
}

Add buffs to a disc from another mod, for worn backpacks only. File: data/mypack/jukebox_songs/my_disc.json

{
  "song": "mymod:my_disc",
  "player_only": true,
  "effects": [
    { "effect": "minecraft:haste", "amplifier": 1 },
    { "effect": "minecraft:night_vision" }
  ]
}

Remove the Ward disc's buffs. File: data/fxntstorage/jukebox_songs/ward.json

{
  "song": "minecraft:ward",
  "effects": []
}

---

How buffs are applied

Worn backpack: the wearer gets the buffs with no time limit while the disc plays, like a beacon. They are removed as soon as the disc stops or is taken out.

Placed backpack: every player within range gets the buffs. The default range is 16 blocks, set by jukeboxBuffRange. The buffs are refreshed every 2 seconds and last 6 seconds, so they wear off shortly after a player walks out of range. A player who already has the same effect from a worn backpack keeps that one.

All buffs are ambient, with fewer particles like beacon effects, and show their icon in the HUD.

Server operators can turn the whole system off, or change the range, in the jukebox_upgrade server config. When jukeboxBuffsEnabled is false, no buffs are given no matter what datapacks contain.

Troubleshooting

• A file has a JSON error: it is skipped and the error is logged in latest.log on /reload.
• The song or effect ID doesn't exist: nothing is logged. The disc simply gives no buffs (or skips that effect). Double-check the IDs against the tables below.

---

Reference: song and effect IDs

Vanilla song IDs

Disc	Song ID
13	minecraft:13
Cat	minecraft:cat
Blocks	minecraft:blocks
Chirp	minecraft:chirp
Far	minecraft:far
Mall	minecraft:mall
Mellohi	minecraft:mellohi
Stal	minecraft:stal
Strad	minecraft:strad
Ward	minecraft:ward
11	minecraft:11
Wait	minecraft:wait
Pigstep	minecraft:pigstep
Otherside	minecraft:otherside
5	minecraft:5
Relic	minecraft:relic
Precipice	minecraft:precipice
Creator	minecraft:creator
Creator (Music Box)	minecraft:creator_music_box

For discs from other mods, use that mod's jukebox song ID. A mod's songs are defined in its data/<namespace>/jukebox_song/ folder, and the file name is the ID.

Effect IDs

Create: Storage adds these effects, which are only useful from Jukebox buffs:

Effect ID	Name	What it does
fxntstorage:repel_creepers	Repel Creepers	Creepers run away and won't target the player
fxntstorage:pacify_piglins	Pacify Piglins	Piglins don't attack on sight, as if the player wore gold
fxntstorage:calm_endermen	Calm Endermen	Endermen don't get angry when looked at (they still fight back if hit)
fxntstorage:phantom_ward	Phantom Ward	Phantoms break off their swoop before they reach the player

Any vanilla effect works too, e.g. minecraft:speed, minecraft:haste, minecraft:strength, minecraft:jump_boost, minecraft:regeneration, minecraft:resistance, minecraft:fire_resistance, minecraft:water_breathing, minecraft:night_vision, minecraft:slow_falling, minecraft:luck, minecraft:absorption, minecraft:invisibility and minecraft:hero_of_the_village.