Guides / Building & Resources

Zastępowanie dźwięków za pomocą pakietu zasobów: sounds.json i wymóg .ogg

Minecraft odtwarza tylko Ogg Vorbis, a zdarzenie dźwiękowe to nie plik. Oto plik mapowania, jak dodać dźwięk zamiast go zastępować i dlaczego Twój jest cichy.

2026-06-25

Zastępowanie dźwięków często kończy się niepowodzeniem bez żadnego komunikatu, częściej niż jakakolwiek inna funkcja pakietów zasobów, a przyczyną są prawie zawsze dwie rzeczy: niewłaściwy format audio lub niezrozumienie, czym jest zdarzenie dźwiękowe.

Tylko Ogg Vorbis

Minecraft odtwarza .ogg (Vorbis) i nic innego. Plik .mp3 lub .wav zmieniony na .ogg nie zostanie odtworzony — kontener musi być faktycznie Ogg.

Ważna jest również różnica między mono a stereo: tylko pliki mono są pozycjonowane w przestrzeni 3D. Plik stereo odtwarzany jest ze stałą głośnością wszędzie, co jest odpowiednie dla muzyki, ale nie dla dźwięku bloku. Jeśli Twój niestandardowy dźwięk Kowadła wydaje się za Tobą podążać, to jest to plik stereo.

Zdarzenie dźwiękowe to nazwa, nie plik

entity.pig.ambient to zdarzenie. Mapuje się ono do listy plików, z której za każdym razem losowo wybierany jest jeden. Zastąpienie dźwięku Świni oznacza przedefiniowanie zdarzenia, a nie wrzucenie pliku gdzieś.

assets/minecraft/
├── sounds.json
└── sounds/custom/my_pig.ogg

{
  "entity.pig.ambient": {
    "replace": true,
    "sounds": [ "custom/my_pig" ]
  }
}

Trzy szczegóły:

• replace: true odrzuca waniliową listę. Jeśli go pominiesz, Twój dźwięk zostanie dodany do Basenu, więc będzie odtwarzany czasami, a oryginalny innym razem. Oba zachowania są użyteczne; domyślnie jest to dodawanie.
• Ścieżki pomijają sounds/ i .ogg. custom/my_pig rozwiązuje się do assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json znajduje się w katalogu głównym assets/minecraft, a nie wewnątrz sounds/.

Opcje dla poszczególnych plików

"sounds": [
  { "name": "custom/my_pig", "volume": 0.8, "pitch": 1.2, "weight": 3, "stream": false }
]

• weight wpływa na losowy wybór w ramach listy.
• stream: true dla wszystkiego, co trwa dłużej niż kilka sekund — muzyka i płyty. Niestrumieniowane długie pliki są wczytywane w całości do pamięci i mogą zawiesić klienta.
• volume nie może przekroczyć 1.0. Głośniej oznacza głośniejszy plik źródłowy.

Dodawanie zupełnie nowego dźwięku

Użyj własnej przestrzeni nazw, aby nic się nie kolidowało:

assets/my_pack/sounds.json
assets/my_pack/sounds/spell.ogg

{ "spell": { "sounds": ["spell"] } }

Następnie /playsound my_pack:spell master @a ~ ~ ~ 1 1. Niestandardowe zdarzenia dźwiękowe działają z /playsound oraz w blokach nutowych za pośrednictwem definicji utworu Szafy grającej; nie są one automatycznie przypisywane do żadnej akcji w grze.

Dlaczego jest cicho

1. To nie jest prawdziwy Ogg Vorbis.
2. Ścieżka zawiera sounds/ lub .ogg.
3. sounds.json to nieprawidłowy JSON — końcowy przecinek zabija cały plik, więc każdy dźwięk w pakiecie milknie, nie tylko ten nowy.
4. Zły pack_format, więc pakiet się ładuje, ale zasoby są ignorowane.

Ściągawki dotyczące struktury folderów pakietu, ponownego mapowania zdarzeń dźwiękowych i animowanych tekstur znajdują się w Narzędziach referencyjnych pakietów zasobów.

Materiały o pakietach zasobów →