ItemsAdder

Blocs, meubles, cultures, HUD et objets ItemsAdder dans les événements, objectifs et faits TypeWriter.

Payantesv1.7Intégrations

NécessiteTypeWriter0.9ItemsAdderQuest (TypeWriter extension)Basic (TypeWriter extension)

Acheter sur VoxelAcheter sur BuiltByBitSupport

Vue d'ensemble

ItemsAdder vous permet d'ajouter à votre serveur des blocs, meubles, objets, cultures, HUD et entités personnalisés grâce à un resource pack. Cette extension les rend tous utilisables dans TypeWriter. Une quête peut demander aux joueurs de casser un minerai personnalisé ou de poser une lampe personnalisée, un dialogue peut réagir à un joueur assis à l'un de vos meubles, et un critère peut vérifier que le joueur tient votre épée personnalisée.

Tout utilise l'identifiant avec namespace d'ItemsAdder (namespace:id, par exemple my_pack:ruby_ore). Rien ici ne crée de contenu : vous continuez à définir les blocs, meubles et objets dans ItemsAdder, puis vous utilisez leurs identifiants dans les entrées TypeWriter.

Fonctionnalités

• Événements de blocs et de meubles — triggers lorsqu'un bloc ou un meuble personnalisé est cassé, posé ou utilisé.
• Événement de pré-pose — un trigger qui se déclenche juste avant l'apparition d'un meuble.
• Mort d'une entité personnalisée — un trigger lorsqu'un joueur tue une entité personnalisée ItemsAdder.
• Objectifs de comptage — cassez ou posez des blocs et meubles personnalisés comme objectif de quête.
• Outils d'inventaire — donnez ou retirez des objets ItemsAdder, et réagissez à leur ramassage, lâcher ou consommation.
• Facts d'objets et du monde — objet tenu, nombre d'objets, utilisations et durabilité restantes, bloc regardé ou sur lequel on se tient, meuble regardé.
• Facts de cultures et de HUD — stade de croissance d'une culture, maturité d'une culture, et visibilité d'un HUD nommé.
• Variables — identifiants et propriétés des objets tenus, blocs et meubles, glyphes d'images de police, et listes du registre, prêts pour n'importe quel texte.
• Entrée de son — utilisez un identifiant de son ItemsAdder partout où TypeWriter demande un son.

Installation

1. Installez ItemsAdder et laissez-le générer son resource pack. Cette extension ne se charge pas sans lui.
2. Assurez-vous que les extensions TypeWriter Quest et Basic sont installées.
3. Téléchargez l'extension depuis les boutiques (voir les boutons du panneau ci-dessus) et placez le JAR dans plugins/Typewriter/extensions/.
4. Redémarrez le serveur.

Premiers pas

Ce pas-à-pas crée une quête qui demande au joueur de casser trois blocs de minerai personnalisé.

1. Dans le panel web, créez une quête avec l'extension Quest et un fact pour stocker la progression (un fact permanent est un bon choix).
2. Sur une page manifest, ajoutez un objectif Break Block.
3. Définissez quest sur votre quête et fact sur le fact de progression. Définissez item sur l'identifiant du bloc, par exemple my_pack:ruby_ore, et amount sur 3. Laissez item vide pour compter n'importe quel bloc personnalisé.
4. Définissez display sur la ligne affichée dans le suivi de quête, par exemple Mine ruby ore. La progression (1/3) est ajoutée automatiquement.
5. Facultatif : reliez onComplete à une séquence qui donne une récompense, par exemple avec Give Item et itemId my_pack:ruby_pendant.
6. Publish (Publier), démarrez la quête et cassez le bloc.

Pour réagir une seule fois au lieu de compter, utilisez un événement : ajoutez une entrée On Custom Block Break à une page de séquence, renseignez blockId, et reliez ses triggers aux entrées à exécuter.

Identifiants de blocs

Listez ce qu'ItemsAdder a chargé avec la variable Registry IDs, ou en jeu avec les commandes d'ItemsAdder, et copiez l'identifiant exact avec namespace.

Fonctionnement

Les événements transportent des données sur ce qui s'est passé. Les entrées déclenchées peuvent lire l'identifiant du bloc ou du meuble et sa position, le clic utilisé (pour l'interaction avec un bloc) et l'objet en main.

Les objectifs comptent chaque position une seule fois par joueur. Casser puis reposer le même bloc au même endroit n'ajoute rien au compte. Ils ne comptent que tant que le joueur a la quête liée active. Les actions annulées (par exemple dans une région protégée) ne comptent pas et ne déclenchent pas d'événements.

Configuration

Les lignes d'objectifs du suivi de quête sont construites à partir de deux snippets TypeWriter que vous pouvez modifier dans le fichier de snippets de TypeWriter :

Snippet	Par défaut
advancedQuest.display	<display> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>)
advancedQuest.completed	<green>✔</green> <st><display></st> <dark_gray>(<gray><current><dark_gray>/<gray><required><dark_gray>)

Entrées

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

Actions2

• Itemsadder Give Item ActionGive an ItemsAdder item to the player
• Itemsadder Remove Item ActionRemove an ItemsAdder item from the player

Événements11

• Itemsadder on Item Consume EventTriggers when the player consumes an ItemsAdder item
• Itemsadder on Item Drop EventTriggers when the player drops an ItemsAdder item
• Itemsadder on Item Pickup EventTriggers when the player picks up an ItemsAdder item
• On Custom Entity Death EventTriggers when a custom entity is killed by the player
• On Customblock Break EventTriggers when a custom block is broken
• On Customblock Interact EventTriggers when a custom block is interacted with
• On Customblock Place EventTriggers when a custom block is placed
• On Furniture Break EventTriggers when a furniture is broken
• On Furniture Interact EventTriggers when a furniture is interacted with
• On Furniture Place EventTriggers when a furniture is placed
• On Furniture Pre Place EventTriggers just before a furniture is placed

Objectifs4

• Break Customblock ObjectiveAn objective to break blocks
• Break Furniture ObjectiveAn objective to break furniture
• Place Customblock ObjectiveAn objective to place blocks
• Place Furniture ObjectiveAn objective to place furniture

Faits10

• Itemsadder Crop Age FactGrowth stage of the ItemsAdder crop the player is looking at
• Itemsadder Crop Fully Grown FactWhether the ItemsAdder crop the player is looking at is ripe
• Itemsadder Holding Item FactWhether the player is holding an ItemsAdder item
• Itemsadder HUD Visible FactWhether a named ItemsAdder HUD is visible to the player
• Itemsadder Item Count FactHow many of an ItemsAdder item the player carries
• Itemsadder Item Durability FactCustom durability left on the held ItemsAdder item
• Itemsadder Item Usages FactUses left on the held ItemsAdder item
• Itemsadder Looking at Block FactWhether the player is looking at an ItemsAdder block
• Itemsadder Looking at Furniture FactWhether the player is looking at ItemsAdder furniture
• Itemsadder Standing on Block FactWhether the player is standing on an ItemsAdder block

Variables7

• Itemsadder Font Image VariableThe characters that render an ItemsAdder font image
• Itemsadder Item in Hand ID VariableThe ItemsAdder ID of the item the player holds
• Itemsadder Item Property VariableA property of the ItemsAdder item the player holds
• Itemsadder Looking at Block ID VariableThe ItemsAdder ID of the block the player is looking at
• Itemsadder Looking at Furniture ID VariableThe ItemsAdder ID of the furniture the player is looking at
• Itemsadder Registry Ids VariableThe list of IDs ItemsAdder has loaded
• Itemsadder Standing on Block ID VariableThe ItemsAdder ID of the block the player stands on

Sons1

• Itemsadder SoundItemsAdder Sound

Dépannage

L'extension n'apparaît pas dans le panel. ItemsAdder n'est pas installé ou ne s'est pas activé. Chaque entrée appelle l'API d'ItemsAdder : l'extension refuse donc de se charger sans le plugin.

Un événement ne se déclenche jamais. Vérifiez l'identifiant : il doit s'agir du namespace:id complet, et pas seulement de l'id. Un identifiant vide correspond à n'importe quoi. Si vous avez renseigné location, seule cette position de bloc exacte correspond. Les événements annulés par un autre plugin (un plugin de protection par exemple) sont ignorés.

L'objectif n'avance pas. Le joueur doit avoir la quête liée active, et un fact doit être défini sur l'objectif. La même position de bloc ne compte qu'une fois par joueur.

Un fact renvoie toujours 0. L'objet tenu ou le bloc n'est pas un élément d'ItemsAdder. Les facts qui regardent des blocs ne vérifient que le premier bloc situé à moins de range blocs (5 par défaut). Les facts d'utilisations et de durabilité renvoient 0 lorsque l'objet n'a ni utilisations ni durabilité personnalisée.

La variable Registry IDs est vide. ItemsAdder charge son contenu en arrière-plan. La variable ne renvoie rien tant qu'ItemsAdder n'a pas signalé que ses objets sont chargés : ne la lisez donc pas pendant le démarrage.

Give Item ne donne rien. L'itemId est inconnu d'ItemsAdder : aucun objet n'est donc construit et rien n'est donné. L'action indique 0 donné. Les restes qui ne rentrent pas sont lâchés aux pieds du joueur sauf si dropOverflow est désactivé.

Le fact de HUD vaut toujours 0. L'identifiant du HUD doit exister dans ItemsAdder et le joueur doit le posséder. ItemsAdder ne peut pas lister les HUD : le fact ne vérifie donc que celui que vous nommez.

Extensions associées

• Nexo et Craft Engine — la même intégration pour les autres plugins de contenu personnalisé.