FakeBlock

Faux blocs basés sur les paquets et schematics côté client.

Privéesv0.1.0Monde et construction

NécessiteTypeWriter0.9.0-beta-177 (BTC build)PacketEventsBTC SkyfacultatifDungeonfacultatif

Conçue pour le réseau BornToCraft. Cette extension est documentée à titre de référence et n'est pas distribuée.

Support

Présentation

FakeBlock affiche des schematics Sponge (.schem) uniquement à certains joueurs. Les blocs sont envoyés par paquets : le monde réel n'est jamais modifié, de sorte que deux joueurs situés au même endroit peuvent voir deux constructions différentes. Un schematic peut suivre une audience TypeWriter (une étape de quête, un objet en main, une région), être joué comme une cinématique, ou être posé par un joueur avec un objet « bloc de stockage ».

Les blocs peuvent être rendus cassables côté client. Les casses sont vérifiées par le serveur, peuvent donner du butin, peuvent être limitées par une liste blanche ou noire d'objets, et sont sauvegardées par joueur dans un artifact pour que la construction reste détruite après une reconnexion.

Fonctionnalités

• Constructions par joueur — affichez un schematic à une audience, à un spectateur de cinématique, ou au joueur qui l'a posé.
• Trois ancrages — une position fixe dans le monde, le même décalage sur chaque île BTC Sky d'une dimension, ou une position à l'intérieur d'une instance Dungeon.
• Placement progressif — les blocs apparaissent dans l'ordre LINEAR, HELICAL ou RANDOM, à un rythme configurable, ou instantanément.
• Distance de vue et de fondu — masquez une construction au-delà d'une distance et faites-la disparaître progressivement.
• Casse côté client — casses validées par le serveur avec butin, liste blanche et liste noire facultatifs.
• État persistant — les blocs cassés et les instances posées sont stockés dans un artifact, par joueur ou par groupe.
• Bloc de stockage — donnez aux joueurs un objet qui se déploie en schematic lorsqu'il est posé, à usage unique ou récupérable.

Installation

1. Installez PacketEvents sur le serveur.
2. Placez le JAR de FakeBlock dans plugins/Typewriter/extensions/ et redémarrez le serveur.
3. Copiez vos fichiers .schem dans plugins/Typewriter/schematics/. Exécutez /fakeblock reload après avoir ajouté de nouveaux fichiers.

Premiers pas

Montrez un pont en ruine aux joueurs qui ont atteint une étape de quête :

1. Dans le panneau web de TypeWriter, ouvrez une page manifest et ajoutez une entrée Schematic Audience.
2. Définissez schematic sur le nom du fichier, par exemple bridge_ruined.schem, et centerLocation sur l'origine de collage.
3. Enveloppez-la dans un filtre d'audience qui correspond à l'étape de quête (par exemple une audience de fact ou de quête), pour que seuls ces joueurs la voient.
4. Pour laisser les joueurs déblayer les décombres, activez breakable, définissez dropLoot si nécessaire, et liez un artifact Schematic State dans stateArtifact afin que les blocs cassés soient mémorisés.
5. Publiez la page et rendez-vous à l'endroit avec un joueur qui correspond à l'audience.

Posé par les joueurs

Pour laisser les joueurs poser eux-mêmes une construction, utilisez l'action Schematic Block : elle donne le spawnItem, et poser cet objet déploie le schematic. singleUse et ownerOnlyRetrieval déterminent s'il peut être ramassé de nouveau.

Fonctionnement

Commandes

Toutes les commandes nécessitent typewriter.fakeblock.admin. Alias : /fb, /schematicblock.

Commande	Description
/fakeblock list	Liste toutes les instances de schematic posées.
/fakeblock info <instance-id>	Affiche les détails d'une instance.
/fakeblock undo <instance-id>	Retire une instance posée.
/fakeblock count [player]	Compte les faux blocs envoyés à un joueur.
/fakeblock reset <player> [entry-id]	Restaure les vrais blocs pour un joueur, pour toutes les entrées ou pour une seule.
/fakeblock reload	Recharge les schematics depuis le disque.
/fakeblock debug	Affiche des informations de débogage.

Permissions

Permission	Autorise
typewriter.fakeblock.admin	Toutes les commandes /fakeblock.

Entrées

5 entrées, générées depuis la source de l'extension.

Actions1

• Schematic BlockPlace a schematic as a block

Audiences2

• 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

Cinématiques1

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

Artefacts1

• Schematic State ArtifactArtifact for storing fake block state

Dépannage

Rien n'apparaît. Vérifiez le nom du fichier dans schematic (avec l'extension .schem) et que le fichier se trouve dans plugins/Typewriter/schematics/. Exécutez /fakeblock reload, puis assurez-vous que le joueur est dans la viewDistance et correspond à l'audience.

La construction apparaît au mauvais endroit. Avec positionMode: ISLAND_DIMENSION, dimensionOffset est relatif à l'île de la dimension indiquée dans dimensionTemplateId ; avec INSTANCE_DIMENSION, la construction ne s'affiche qu'à l'intérieur d'une instance Dungeon active (celle nommée dans instanceId, ou n'importe quelle instance lorsqu'il est vide) et instanceOffset donne ses coordonnées dans le monde de l'instance. Seul CLASSIC utilise centerLocation.

Les blocs cassés reviennent après un redémarrage. Liez un artifact Schematic State dans stateArtifact (audience) ou position (action). Sans lui, les casses ne vivent qu'en mémoire.

Les joueurs ne peuvent rien casser. breakable doit être activé. Une whitelist non vide n'autorise que les objets listés ; blacklist l'emporte toujours.

Extensions associées

• BTC Sky — placement relatif à l'île avec ISLAND_DIMENSION.
• Dungeon — instances de donjon utilisées par INSTANCE_DIMENSION.