Hướng dẫn / Xây dựng & tài nguyên

Thay thế âm thanh bằng gói tài nguyên: sounds.json và yêu cầu định dạng .ogg

Minecraft chỉ phát được Ogg Vorbis, và một sự kiện âm thanh không phải là một tệp. Đây là tệp ánh xạ, cách thêm âm thanh mới thay vì thay thế âm thanh cũ, và lý do tại sao âm thanh của bạn bị im lặng.

2026-06-25

Việc thay thế âm thanh thất bại trong im lặng thường xuyên hơn bất kỳ tính năng gói tài nguyên nào khác, và gần như luôn là một trong hai nguyên nhân: sai định dạng âm thanh, hoặc hiểu nhầm về bản chất của một sự kiện âm thanh.

Chỉ có Ogg Vorbis

Minecraft chỉ phát .ogg (Vorbis) và không gì khác. Một tệp .mp3 hay .wav được đổi tên thành .ogg sẽ không phát được — phần chứa (container) phải thực sự là Ogg.

Âm đơn (mono) và âm lập thể (stereo) cũng quan trọng: chỉ những tệp mono mới được định vị trong không gian 3D. Tệp stereo phát ở âm lượng không đổi ở mọi nơi, điều này đúng với nhạc nền nhưng sai với âm thanh của khối. Nếu âm thanh cái đe tùy chỉnh của bạn có vẻ như đi theo bạn khắp nơi, thì đó là stereo.

Một sự kiện âm thanh là một cái tên, không phải một tệp

entity.pig.ambient là một sự kiện. Nó ánh xạ tới một danh sách các tệp, và mỗi lần một tệp được chọn ngẫu nhiên. Thay thế âm thanh con heo nghĩa là định nghĩa lại sự kiện, chứ không phải thả một tệp vào đâu đó.

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

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

Ba chi tiết:

• replace: true loại bỏ danh sách gốc. Nếu bỏ qua nó, âm thanh của bạn sẽ được thêm vào bể, nên đôi khi nó phát và đôi khi âm thanh gốc phát. Cả hai hành vi đều hữu ích; mặc định là thêm vào.
• Đường dẫn bỏ qua sounds/ và .ogg. custom/my_pig phân giải thành assets/minecraft/sounds/custom/my_pig.ogg.
• sounds.json nằm ở gốc assets/minecraft, không phải bên trong sounds/.

Tùy chọn cho từng tệp

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

• weight thiên lệch việc chọn ngẫu nhiên trong danh sách.
• stream: true dành cho bất cứ thứ gì dài hơn vài giây — nhạc nền và đĩa nhạc. Những tệp dài không được phát trực tuyến sẽ được tải toàn bộ vào bộ nhớ và có thể làm treo client.
• volume không được vượt quá 1.0. To hơn nghĩa là tệp nguồn phải to hơn.

Thêm một âm thanh hoàn toàn mới

Dùng không gian tên (namespace) riêng của bạn để không bị trùng:

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

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

Sau đó dùng /playsound my_pack:spell master @a ~ ~ ~ 1 1. Các sự kiện âm thanh tùy chỉnh hoạt động với /playsound, trong Hộp chơi nhạc thông qua định nghĩa bài hát hộp chơi nhạc, và trong khối đàn thông qua thành phần note_block_sound của đầu người chơi; chúng không tự động gắn vào bất kỳ hành động nào trong game.

Tại sao nó im lặng

1. Không phải Ogg Vorbis thực sự.
2. Đường dẫn có chứa sounds/ hoặc .ogg.
3. sounds.json là JSON không hợp lệ — một dấu phẩy thừa sẽ giết chết toàn bộ tệp, nên mọi âm thanh trong gói đều im lặng, không chỉ âm thanh mới.
4. pack.mcmeta đã lỗi thời — 26.x yêu cầu min_format và max_format, và một gói thiếu chúng sẽ hiển thị là không tương thích.

Các bảng tóm tắt về cấu trúc thư mục gói, việc ánh xạ lại sự kiện âm thanh và hoạt ảnh kết cấu có trong Công cụ tham chiếu gói tài nguyên.

Tra cứu resource pack →