FakeBlock

Bloques falsos basados en paquetes y schematics en el cliente.

Privadasv0.1.0Mundo y construcción

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

Creada para la red BornToCraft. Esta extensión está documentada como referencia y no se distribuye.

Soporte

Descripción general

FakeBlock muestra schematics de Sponge (.schem) solo a los jugadores seleccionados. Los bloques se envían mediante paquetes: el mundo real nunca se modifica, de modo que dos jugadores situados en el mismo lugar pueden ver dos construcciones distintas. Un schematic puede seguir a una audiencia de TypeWriter (una etapa de misión, un objeto en la mano, una región), reproducirse como una cinemática o ser colocado por un jugador con un objeto "bloque de almacenamiento".

Los bloques pueden hacerse rompibles en el cliente. Las roturas las comprueba el servidor, pueden soltar botín, se pueden limitar con una lista blanca o negra de objetos y se guardan por jugador en un artefacto, para que la construcción siga rota tras una reconexión.

Características

• Construcciones por jugador: muestra un schematic a una audiencia, a un espectador de una cinemática o al jugador que lo colocó.
• Tres anclajes: una posición fija del mundo, el mismo desfase en cada isla de BTC Sky de una dimensión, o una posición dentro de una instancia de Dungeon.
• Colocación progresiva: los bloques aparecen en orden LINEAR, HELICAL o RANDOM, a un ritmo configurable, o al instante.
• Distancia de visión y de desvanecimiento: oculta una construcción más allá de una distancia y la desvanece progresivamente.
• Rotura en el cliente: roturas validadas por el servidor con botín, lista blanca y lista negra opcionales.
• Estado persistente: los bloques rotos y las instancias colocadas se almacenan en un artefacto, por jugador o por grupo.
• Bloque de almacenamiento: entrega a los jugadores un objeto que se despliega en un schematic al colocarlo, de un solo uso o recuperable.

Instalación

1. Instala PacketEvents en el servidor.
2. Coloca el JAR de FakeBlock en plugins/Typewriter/extensions/ y reinicia el servidor.
3. Copia tus archivos .schem en plugins/Typewriter/schematics/. Ejecuta /fakeblock reload después de añadir archivos nuevos.

Primeros pasos

Muestra un puente en ruinas a los jugadores que hayan llegado a una etapa de una misión:

1. En el panel web de TypeWriter, abre una página de manifiesto y añade una entrada Schematic Audience.
2. Establece schematic en el nombre del archivo, por ejemplo bridge_ruined.schem, y centerLocation en el origen de pegado.
3. Envuélvela en un filtro de audiencia que coincida con la etapa de la misión (por ejemplo, una audiencia de hecho o de misión), de modo que solo la vean esos jugadores.
4. Para que los jugadores puedan despejar los escombros, activa breakable, establece dropLoot si es necesario y enlaza un artefacto Schematic State en stateArtifact para que se recuerden los bloques rotos.
5. Publica la página y acércate al lugar con un jugador que cumpla la audiencia.

Colocado por jugadores

Para que los jugadores coloquen una construcción por sí mismos, usa la acción Schematic Block: entrega el spawnItem, y al colocar ese objeto se despliega el schematic. singleUse y ownerOnlyRetrieval deciden si se puede volver a recoger.

Cómo funciona

Comandos

Todos los comandos requieren typewriter.fakeblock.admin. Alias: /fb, /schematicblock.

Comando	Descripción
/fakeblock list	Lista todas las instancias de schematic colocadas.
/fakeblock info <instance-id>	Muestra los detalles de una instancia.
/fakeblock undo <instance-id>	Elimina una instancia colocada.
/fakeblock count [player]	Cuenta los bloques falsos enviados a un jugador.
/fakeblock reset <player> [entry-id]	Restaura los bloques reales para un jugador, para todas las entradas o para una entrada.
/fakeblock reload	Recarga los schematics desde el disco.
/fakeblock debug	Imprime información de depuración.

Permisos

Permiso	Concede
typewriter.fakeblock.admin	Todos los comandos /fakeblock.

Entradas

5 entradas, generadas a partir del código fuente de la extensión.

Acciones1

• Schematic BlockPlace a schematic as a block

Audiencias2

• 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

Artefactos1

• Schematic State ArtifactArtifact for storing fake block state

Resolución de problemas

No aparece nada. Comprueba el nombre del archivo en schematic (con la extensión .schem) y que el archivo está en plugins/Typewriter/schematics/. Ejecuta /fakeblock reload y asegúrate de que el jugador está dentro de viewDistance y cumple la audiencia.

La construcción aparece en un lugar equivocado. Con positionMode: ISLAND_DIMENSION, dimensionOffset es relativo a la isla de la dimensión indicada en dimensionTemplateId; con INSTANCE_DIMENSION, la construcción solo se muestra dentro de una instancia de Dungeon activa (la indicada en instanceId, o cualquier instancia cuando está vacío) y instanceOffset da sus coordenadas en el mundo de la instancia. Solo CLASSIC usa centerLocation.

Los bloques rotos vuelven tras un reinicio. Enlaza un artefacto Schematic State en stateArtifact (audiencia) o position (acción). Sin él, las roturas solo viven en memoria.

Los jugadores no pueden romper nada. breakable debe estar activado. Una whitelist no vacía solo permite los objetos enumerados; blacklist siempre prevalece.

Extensiones relacionadas

• BTC Sky: colocación relativa a la isla con ISLAND_DIMENSION.
• Dungeon: instancias de mazmorra usadas por INSTANCE_DIMENSION.