Criar conteúdo
Criar a construção
Não há restrições sobre o que você pode construir para o BetterStructures, embora seja recomendado manter o tamanho das estruturas abaixo de 100x100x100 blocos por razões de adequação ao mundo e desempenho. Dito isso, ele pode facilmente lidar com estruturas muito maiores.
Blocos especiais
O BetterStructures tem dois blocos especiais: barreiras e bedrock. Qualquer outro bloco que o WorldEdit possa colar será colado normalmente, mas blocos de barreira e bedrock são a exceção.
| Bloco | Comportamento | Caso de uso |
|---|---|---|
| Barreira | Não coloca nenhum bloco naquela posição - preserva o terreno original | Arredondar bordas da colagem, moldar paredes a cavernas, integração natural |
| Bedrock | Garante que um bloco sólido exista. Se for ar/líquido, substitui pelo material do pedestal | Criar pisos para trilhos, garantir que o piso exista sem sobrescrever blocos existentes |
Placas de spawn
O BetterStructures pode usar placas com texto específico para gerar mobs e chefes do EliteMobs e MythicMobs em locais específicos.
Nota: as placas de spawn são consumidas quando a estrutura é colada - o BetterStructures substitui o bloco da placa por ar no momento em que gera a entidade, de modo que os jogadores nunca as veem. Uma placa cuja tag não é reconhecida é simplesmente colada como uma placa comum e permanece visível.
| Tipo de placa | Linha 1 | Linha 2-4 | Plugin necessário |
|---|---|---|---|
| Mobs vanilla | [spawn] | Tipo de entidade na linha 2 | Nenhum |
| EliteMobs | [elitemobs] | Nome do arquivo do chefe, distribuído pelas linhas 2-4 | EliteMobs |
| MythicMobs | [mythicmobs] | Nome do mob na linha 2, nível opcional na linha 3 | MythicMobs |
Qualquer placa funciona. Todos os tipos de madeira e tanto as variantes em pé como as de parede são aceitas, incluindo placas suspensas e placas de tipos de madeira adicionados depois de o plugin ter sido escrito - a verificação é sobre o bloco ser uma placa, não sobre uma lista fixa de materiais.
A linha de nível do MythicMobs é opcional. Deixe a linha 3 vazia e o mob aparece no nível 1.
Exemplos de placas de spawn
Mobs vanilla
[spawn]
ZOMBIE
Gera um zumbi persistente naquela localização. Funciona para qualquer Spigot EntityType, incluindo suportes de armadura e cristais do End.
EliteMobs
[elitemobs]
test_boss_with
_a_long_name
.yml
Nomes de arquivo longos podem abranger várias linhas. As arenas de combate são protegidas pelo WorldGuard até que todos os chefes sejam eliminados.
MythicMobs
[mythicmobs]
SkeletalKnight
10
Gera um SkeletalKnight no nível 10.
Schematics
Os schematics são arquivos gerados pelo WorldEdit ou FastAsyncWorldEdit que contêm os blocos da construção que o BetterStructures utilizará. O BetterStructures usa o formato de arquivo .schem (o padrão moderno do WorldEdit). Certifique-se de salvar seus schematics no formato .schem, não no formato legado .schematic.
Instruções detalhadas sobre como criar um schematic não estão incluídas aqui, pois estão documentadas detalhadamente nas documentações do WorldEdit e FastAsyncWorldEdit, mas geralmente é feito da seguinte forma:
- Escolha um canto da construção e use o comando
//pos1 - Escolha o canto diagonalmente oposto e use o comando
//pos2 - Use o comando
//copy - Use o comando
/schem save <schematicname>onde<schematicName>é o nome do arquivo que você deseja usar para seu schematic.
Certifique-se de executar o comando //pos1 no ponto 1 e //pos2 no ponto 2!
Ponto de ancoragem
Os pontos de ancoragem são onde você executa o comando //copy para o schematic. Eles determinam o ponto de origem da estrutura quando colocada no mundo.
| Tipo de construção | Posição de ancoragem recomendada | Razão |
|---|---|---|
| Superfície | Ponto mais baixo do chão | Garante alinhamento correto com o solo |
| Subterrâneo | No topo da construção | Permite determinar corretamente a profundidade de enterramento |
| Líquido | Na superfície da água | Posicionamento correto na superfície da água |
| Ar/Céu | No topo da construção | Posicionamento correto de altitude |
Importante: Esteja sempre muito perto ou diretamente acima das construções ao copiar. Quanto mais longe você estiver, mais lag a operação de colagem causará.
Configurações de schematic
Cada arquivo de schematic tem uma configuração de schematic. Se um arquivo de schematic acabou de ser adicionado ao servidor, a configuração será gerada após uma reinicialização ou após /betterstructures reload.
O .yml é gerado na mesma pasta que o .schem. A pasta plugins/BetterStructures/schematics é percorrida recursivamente, portanto um pacote de conteúdo que distribui os seus schematics em uma subpasta tem as suas configurações escritas nessa mesma subpasta. Os nomes de arquivo devem ser únicos em toda a árvore schematics: dois arquivos .schem com o mesmo nome em pastas diferentes tornam a busca de configuração ambígua, e o BetterStructures agora se recusa a iniciar em vez de adivinhar qual deles você queria.
Um .yml sem um .schem correspondente é ignorado com um aviso, e a estrutura não é registrada.
Essas configurações permitem definir as seguintes opções para a colagem do schematic:
| Chave | Padrão | Obrigatório | Descrição |
|---|---|---|---|
isEnabled | true | ❌ | Se o schematic está habilitado. Se desabilitado, não será colocado em nenhum lugar. |
weight | 1.0 | ❌ | Peso de seleção. Maior = mais provável de ser escolhido. 2.0 = 2x mais provável, 0.5 = metade da probabilidade. |
pedestalMaterial | Auto-detectar | ❌ | Material para blocos de pedestal (nomes de Material do Spigot). Auto-detecta o melhor ajuste se não for definido. |
generatorConfigFilename | - | ✅ | Nome do arquivo de configuração do gerador incluindo a extensão .yml. Schematics sem isso não serão gerados. |
treasureFile | Padrão do gerador | ❌ | Substitui o arquivo de tesouro para os baús desta estrutura. Geralmente é melhor modificar o gerador em vez disso. |
barrelTreasureFilename | Padrão do gerador | ❌ | Substitui o arquivo de tesouro para os barris desta estrutura. Assume o que o gerador (ou o seu fallback treasure_barrel_food.yml) fornecer. |
Recipientes de loot: o BetterStructures detecta automaticamente baús, baús armadilhados e caixas de shulker simples (sem cor) colocados dentro dos schematics e os preenche com o arquivo de tesouro de baús. Os barris são preenchidos separadamente usando o arquivo de tesouro de barris (padrão treasure_barrel_food.yml), e podem ser desativados por gerador com generateLootInBarrels: false. Não são necessárias placas especiais nem configurações para marcar esses recipientes.
Geradores desativados: se o gerador indicado por generatorConfigFilename tiver isEnabled: false, o schematic é totalmente ignorado, mesmo que o próprio isEnabled do schematic seja true.
Detalhes de configuração
pedestalMaterial
Os pedestais são blocos colocados sob edifícios de superfície/subterrâneos para preencher espaços de ar e melhorar a integração com o terreno. Estes também são os blocos que substituem os blocos de bedrock no schematic.
Quando nada é definido, o plugin analisa os blocos abaixo do local de colocação da estrutura e seleciona o tipo de material mais comum usando seleção aleatória ponderada. Padrões: Nether = netherrack, End = pedra do End, Outro = pedra.
generatorConfigFilename
Exemplo: generatorConfigFilename: generator_surface_global.yml
O arquivo do gerador é encontrado na pasta de configuração de geradores.
treasureFile
Consulte a documentação de arquivos de tesouro e a documentação de geradores para mais detalhes.
Personalizar conteúdo
Tudo o que é distribuído no BetterStructures é editável. Você pode modificar quaisquer arquivos de schematic e configurações de gerador ao seu gosto.
O guia de criação de conteúdo acima também é um guia que pode ajudá-lo a editar conteúdo existente.
Solução de problemas
Se sua estrutura não aparece, verifique se:
- O arquivo de schematic está no formato .schem
- Uma configuração de gerador válida está especificada
- A opção isEnabled está definida como true, tanto na configuração do schematic como no gerador para o qual ele aponta
- Sua versão do WorldEdit/FastAsyncWorldEdit é compatível
- O
.ymldo schematic está ao lado do.schem, e não em uma árvore perdidaplugins/BetterStructures/plugins/BetterStructures/.... Versões antigas escreviam as configurações nesse caminho errado, o que deixava as estruturas distribuídas sem gerador e silenciosamente impedia que aparecessem. Se você vir essa pasta, as configurações dentro dela nunca foram lidas - apague-a e deixe o plugin regenerar as configurações no lugar certo.
Se o servidor se recusar a iniciar com uma mensagem sobre um nome de arquivo de schematic duplicado, você tem o mesmo nome de .schem em duas pastas diferentes dentro de schematics (ou modules). Renomeie um deles.
A pasta .schematic_cache
O BetterStructures guarda cópias convertidas dos seus schematics em plugins/BetterStructures/.schematic_cache. Os arquivos .schem distribuídos são salvos em uma versão de dados mais antiga do Minecraft, e convertê-los a cada inicialização é a parte mais cara de carregar uma instalação completa de conteúdo, por isso o resultado convertido é armazenado e reutilizado.
Você não precisa gerenciar essa pasta:
- as entradas são indexadas pelo conteúdo do schematic, pela sua versão do Minecraft e pela sua versão do WorldEdit, portanto editar um schematic ou atualizar qualquer um dos plugins reconstrói automaticamente as entradas afetadas
- entradas que já não correspondem a nenhum schematic (por exemplo, depois de remover um pacote de conteúdo) são removidas na inicialização
- é sempre apenas uma otimização - se uma entrada estiver faltando, ilegível ou falhar na verificação, o
.schemoriginal é lido em vez dela
É seguro apagar; a próxima inicialização simplesmente reconstrói a pasta e demora mais.
"Skipped N unsupported legacy block entries"
Os arquivos .schem distribuídos registram a versão do Minecraft em que foram salvos, então o WorldEdit passa as suas block entities pelo conversor de dados da Mojang ao carregá-los. Entradas cujo tipo já não existe - minecraft:bed é a mais comum, já que as block entities de cama desapareceram na 1.13, quando a cor da cama passou para o block state - falham na conversão e são registradas pelo servidor no nível ERROR, uma vez por bloco. Uma instalação completa de conteúdo produz centenas de linhas idênticas que parecem uma instalação quebrada, mas são inofensivas: o bloco em si é convertido sem problemas e a estrutura é colada corretamente.
O BetterStructures reduz esse ruído a uma única linha informativa que indica quantas entradas foram ignoradas e quais chaves estavam envolvidas. Não há nada a corrigir quando você a vê.
Se as placas de spawn não funcionam:
- Verifique se o formato da placa corresponde exatamente aos exemplos
- Para EliteMobs/MythicMobs, certifique-se de que os plugins estejam instalados
- Verifique se os tipos de entidade/nomes de mob estão escritos corretamente
- Consulte os logs do servidor para mensagens de erro específicas