Echo Shards

Duplicate music discs by surrounding one with echo shards in a crafting table.
Place a disc in the center, ring it with 8 echo shards, and you get the disc back
plus a copy - the echo shards are consumed. A thematic, near-renewable way to
copy the rarer discs, since the newest discs and echo shards both come from the
deep dark.

This item ships in two forms (same mechanic):

• a server plugin (Paper / Spigot / Bukkit / Purpur), and
• a Fabric mod (client+server datapack recipes).

How it works

S S S      S = echo shard
S D S      D = any music disc
S S S      result = that disc, duplicated

Music discs do not stack, so the original disc is handed back to you alongside the
copy - you end up with 2 discs (configurable) for 8 echo shards. Works with
every music disc the game has, including the newest ones.

Plugin

• Auto-registers a duplication recipe for every music disc present on the server
  (forward-compatible: new discs in future updates are covered automatically).
• config.yml:
  • output-amount (default 2) - total discs you end up with per craft (the
    original is returned, so 2 = net +1).
  • allow-only / deny - restrict which discs can be duplicated (by disc name
    without the MUSIC_DISC_ prefix, e.g. creator, precipice, 5).
• /echoshards shows info; /echoshards reload reloads the config
  (permission echoshards.admin, default op).

Fabric mod

• Pure datapack recipes (one crafting_shaped per disc) plus a tiny initializer.
• Requires Fabric API (its resource-loader module is what loads a mod's bundled
  datapack - without it the recipes silently do not exist).
• Duplicated discs carry a max_stack_size: 2 component, which is what makes the
  count-2 result a legal recipe (discs are normally unstackable). The pair stacks
  with itself but not with vanilla copies; jukeboxes treat them normally, and a
  duplicated disc can seed further duplications.
• Covers the full 1.21.11 disc set.

Compatibility

Per-version-LINE builds (see ../MODDING_GUIDE.md):

• Plugin, 1.21.x: EchoShards-1.0.0.jar - built against the 1.21.1 API
  (Java 21, class 65), api-version 1.21, load-tested on Paper 1.21.11. Tags
  1.21.1-1.21.11. No Paper-only classes, no NMS, no dependencies.
• Plugin, 26.1.x: EchoShards-1.0.0-26.1.jar - built against spigot-api
  26.1.2 (Java 25, class 69). Tags 26.1-26.1.2.
• Fabric mod, 1.21.x: EchoShards-fabric-1.0.0.jar - Minecraft 1.21.11,
  Fabric Loader, official Mojang mappings.

Known gaps / honesty

• The plugin was load-tested headless on Paper 1.21.11 (enables clean, 21 disc
  recipes registered); not exhaustively QA'd in a live client.
• Mod (verified 2026-06-10 via fabric/recipe-verify.ps1): all 21 recipes were
  functionally crafted headless on a Fabric 1.21.11 dev server using a Crafter
  rig - each fired a real RecipeManager match and produced its disc at count 2
  (fabric/recipe-status.txt has the per-disc breakdown). Not hand-tested in a
  real client GUI (no client in the build env), and tested only on 1.21.11.
• Because discs are non-stackable, the plugin returns the duplicate via the craft
  event (clean). The mod's count-2 result needs the max_stack_size: 2 component
  to be a legal recipe (the strict 1.20.5+ item codec rejects it otherwise), so
  mod-duplicated discs stack in pairs and do not stack with vanilla copies.
  Recommended: the plugin for servers, the mod for single-player/clients.

---

Original concept by u/Megatrans69 on Reddit (r/minecraftsuggestions). Built by BeansNToast.