Guias / Construção e recursos

Quadros e discos de música personalizados sem substituir os originais

Ambos se tornaram registros de datapack, então você pode adicionar novos em vez de sobrescrever os originais. Veja os dois arquivos que cada um precisa e a regra de proporção que os quadros devem seguir.

2026-06-18

O jeito antigo de conseguir um quadro personalizado era sobrescrever paintings_kristoffer_zetterstrand.png e perder um original. Agora tanto os quadros quanto os discos de música são registros, então você adiciona em vez de substituir.

Quadros precisam de dois arquivos

Uma entrada de datapack que define o quadro:

data/<namespace>/painting_variant/my_art.json

{
  "asset_id": "my_pack:my_art",
  "width": 2,
  "height": 2,
  "title": { "text": "My Art" },
  "author": { "text": "Me" }
}

E um pacote de recursos fornecendo a imagem:

assets/my_pack/textures/painting/my_art.png

width e height são em blocos, e a textura precisa corresponder a essa proporção. O jogo base desenha 16 pixels por bloco, então um quadro 2×1 é 32×16 — mas 64×32 funciona igualmente bem. Erre a proporção e a imagem estica; não há ajuste automático.

Os tamanhos do jogo base vão de 1×1 até 4×4. Tamanhos maiores funcionam, mas precisam de uma parede à altura.

Tornando-o obtenível

Adicionar a variante não a coloca no jogo. Dois caminhos:

• A tag de posicionamento — adicione-a a #minecraft:placeable para que um item de quadro comum possa se tornar nele aleatoriamente.
• Diretamente — /give @p painting[entity_data={id:"minecraft:painting",variant:"my_pack:my_art"}]

A maioria dos criadores de mapa quer o segundo: um quadro específico, não um aleatório.

Discos de música precisam de três

data/<namespace>/jukebox_song/my_song.json

{
  "sound_event": { "sound_id": "my_pack:music/my_song" },
  "description": { "text": "My Artist - My Song" },
  "length_in_seconds": 154,
  "comparator_output": 12
}

Além de sounds.json mapeando esse id de som para um arquivo, mais o próprio .ogg:

assets/my_pack/sounds.json
assets/my_pack/sounds/music/my_song.ogg

Três detalhes importam:

• length_in_seconds precisa estar certo. Ele determina quando o Toca-Discos para — as partículas, sua saída de redstone e o áudio, que é cortado nesse ponto. Longo demais significa silêncio no final; curto demais corta a faixa.
• comparator_output vai de 0 a 15 e é o que um comparador lê. O jogo base tem 22 discos e apenas 15 valores, então sete pares já compartilham um; escolha um valor que nenhum dos discos que sua redstone precisa distinguir use.
• Faça streaming do ogg. "stream": true em sounds.json para qualquer coisa com duração de música.

Depois, dê a ele:

/give @p music_disc_13[jukebox_playable="my_pack:my_song"]

Qualquer item de disco serve como suporte — o componente decide o que toca.

Por que isso é melhor do que sobrescrever

Um pacote que substitui recursos do jogo base entra em conflito com todo outro pacote que faz o mesmo, e quebra quando a Mojang renomeia um arquivo. Adições de registro são separadas por namespace, então dois pacotes que adicionam quadros coexistem. Também é a única abordagem que sobrevive a uma atualização de versão sem edições.

Crie variantes de quadros, músicas de Toca-Discos, totens e emojis de chat em um único zip de pacote de recursos pronto com os Criadores de Pacotes de Conteúdo Personalizado.

Criadores de conteúdo próprio →