FakeBlock

Blocos falsos baseados em pacotes e schematics no cliente.

Privadasv0.1.0Mundo e construção

RequerTypeWriter0.9.0-beta-177 (BTC build)PacketEventsBTC SkyopcionalDungeonopcional

Criada para a rede BornToCraft. Esta extensão é documentada como referência e não é distribuída.

Suporte

Visão geral

O FakeBlock exibe schematics Sponge (.schem) apenas para jogadores selecionados. Os blocos são enviados por pacotes: o mundo real nunca é modificado, então dois jogadores no mesmo lugar podem ver duas construções diferentes. Um schematic pode seguir uma audience do TypeWriter (uma etapa de quest, um item na mão, uma região), ser reproduzido como uma cinemática ou ser colocado por um jogador com um item de "storage block".

Os blocos podem ser tornados quebráveis no lado do cliente. As quebras são verificadas pelo servidor, podem soltar loot, podem ser limitadas com uma whitelist ou blacklist de itens e são salvas por jogador em um artifact para que a construção continue quebrada após uma reconexão.

Recursos

• Construções por jogador — exiba um schematic para uma audience, para um espectador de cinemática ou para o jogador que o colocou.
• Três âncoras — uma posição fixa no mundo, o mesmo deslocamento em toda ilha do BTC Sky de uma dimensão ou uma posição dentro de uma instância de Dungeon.
• Colocação progressiva — os blocos aparecem na ordem LINEAR, HELICAL ou RANDOM, em uma taxa configurável, ou instantaneamente.
• Distância de visão e de esmaecimento — oculte uma construção além de uma distância e a esmaeça progressivamente.
• Quebra no lado do cliente — quebras validadas pelo servidor com loot, whitelist e blacklist opcionais.
• Estado persistente — blocos quebrados e instâncias colocadas são armazenados em um artifact, por jogador ou por grupo.
• Storage block — dê aos jogadores um item que se desdobra em um schematic quando colocado, de uso único ou recuperável.

Instalação

1. Instale o PacketEvents no servidor.
2. Coloque o JAR do FakeBlock em plugins/Typewriter/extensions/ e reinicie o servidor.
3. Copie seus arquivos .schem para plugins/Typewriter/schematics/. Execute /fakeblock reload depois de adicionar novos arquivos.

Primeiros passos

Mostre uma ponte em ruínas aos jogadores que chegaram a uma etapa de quest:

1. No painel web do TypeWriter, abra uma page manifest e adicione uma entry Schematic Audience.
2. Defina schematic como o nome do arquivo, por exemplo bridge_ruined.schem, e centerLocation como a origem da colagem.
3. Envolva-a em um filtro de audience que corresponda à etapa da quest (por exemplo uma audience de fact ou de quest), para que apenas esses jogadores a vejam.
4. Para permitir que os jogadores removam os escombros, ative breakable, defina dropLoot se necessário e ligue um artifact Schematic State em stateArtifact para que os blocos quebrados sejam lembrados.
5. Publique a page e vá até o local com um jogador que corresponda à audience.

Colocado por jogadores

Para permitir que os jogadores coloquem uma construção por conta própria, use a ação Schematic Block: ela entrega o spawnItem, e colocar esse item desdobra o schematic. singleUse e ownerOnlyRetrieval decidem se ele pode ser recolhido novamente.

Como funciona

Comandos

Todos os comandos exigem typewriter.fakeblock.admin. Aliases: /fb, /schematicblock.

Comando	Descrição
/fakeblock list	Lista todas as instâncias de schematic colocadas.
/fakeblock info <instance-id>	Mostra os detalhes de uma instância.
/fakeblock undo <instance-id>	Remove uma instância colocada.
/fakeblock count [player]	Conta os blocos falsos enviados a um jogador.
/fakeblock reset <player> [entry-id]	Restaura os blocos reais para um jogador, de todas as entries ou de uma entry.
/fakeblock reload	Recarrega os schematics do disco.
/fakeblock debug	Imprime informações de depuração.

Permissões

Permissão	Concede
typewriter.fakeblock.admin	Todos os comandos /fakeblock.

Entries

5 entradas, geradas a partir do código-fonte da extensão.

Ações1

• Schematic BlockPlace a schematic as a block

Audiências2

• Blockify Schematic AudienceDisplay a schematic clientside for an audience with breakable blocks support
• Holding Item AudienceFilters an audience based on if they are holding a specific item

Cinemáticas1

• Blockify Schematic CinematicPaste a schematic (client-side) during a cinematic for the player

Artefatos1

• Schematic State ArtifactArtifact for storing fake block state

Solução de problemas

Nada aparece. Verifique o nome do arquivo em schematic (com a extensão .schem) e se o arquivo está em plugins/Typewriter/schematics/. Execute /fakeblock reload e depois confirme que o jogador está dentro de viewDistance e corresponde à audience.

A construção aparece no lugar errado. Com positionMode: ISLAND_DIMENSION, dimensionOffset é relativo à ilha da dimensão em dimensionTemplateId; com INSTANCE_DIMENSION, a construção só aparece dentro de uma instância ativa de Dungeon (a indicada em instanceId, ou qualquer instância quando está vazio) e instanceOffset fornece suas coordenadas no mundo da instância. Apenas CLASSIC usa centerLocation.

Os blocos quebrados voltam após um reinício. Ligue um artifact Schematic State em stateArtifact (audience) ou position (action). Sem ele, as quebras só existem na memória.

Os jogadores não conseguem quebrar nada. breakable deve estar ativado. Uma whitelist não vazia só permite os itens listados; a blacklist sempre prevalece.

Extensões relacionadas

• BTC Sky — colocação relativa à ilha com ISLAND_DIMENSION.
• Dungeon — instâncias de dungeon usadas por INSTANCE_DIMENSION.