Nexo
Vue d'ensemble
Nexo ajoute des objets, blocs et meubles personnalisés à votre serveur. Cette extension les intègre à TypeWriter : une quête peut demander aux joueurs de casser un minerai personnalisé ou de poser vos meubles, une séquence peut démarrer lorsqu'un joueur frappe un bloc, et des critères peuvent vérifier ce qu'un joueur tient ou regarde.
Tout est adressé par l'identifiant d'objet Nexo, par exemple ruby_ore ou oak_chair. Vous continuez à définir le contenu dans Nexo ; cette extension ne fait que le lire et y réagir.
Fonctionnalités
- Événements de blocs — casse, pose, interaction, dégâts (un joueur commence à miner) et butin lâché pour les blocs personnalisés.
- Événements de meubles — casse, pose, interaction et dégâts pour les meubles, avec un filtre facultatif d'identifiant BetterModel.
- 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 Nexo, et réagissez à leur ramassage, lâcher ou consommation.
- Facts d'objets — objet tenu, nombre d'objets, et si l'objet tenu utilise une mécanique donnée.
- Facts du monde — bloc regardé ou sur lequel on se tient, meuble regardé, état de lumière d'un meuble, et temps nécessaire pour casser un bloc.
- Variables — identifiants et propriétés des objets tenus et des blocs et meubles dans le champ de vision, ainsi que des listes de registre et de tags.
- Entrée de son — utilisez un identifiant de son Nexo partout où TypeWriter demande un son.
Installation
- Installez Nexo sur votre serveur. Cette extension ne se charge pas sans lui.
- Assurez-vous que les extensions TypeWriter Quest et Basic sont installées.
- Téléchargez l'extension depuis les boutiques (voir les boutons du panneau ci-dessus) et placez le JAR dans
plugins/Typewriter/extensions/. - Redémarrez le serveur.
Premiers pas
Ce pas-à-pas démarre une séquence lorsqu'un joueur fait un clic droit sur un bloc personnalisé, et compte des meubles pour une quête.
- Sur une page sequence, ajoutez un événement Nexo Block Interact.
- Définissez
blockIdsur l'identifiant du bloc Nexo,actionsurRIGHT_CLICK, et relieztriggersaux entrées à exécuter, par exemple un dialogue. - Pour une tâche de comptage, créez une quête et un fact de progression, puis ajoutez un objectif Place Furniture.
- Définissez
quest,fact,itemsur l'identifiant du meuble etamountsur5. Renseignezdisplayavec la ligne du suivi, et reliezonCompleteà une séquence de récompense si vous en voulez une. - Publish (Publier) et testez avec un joueur qui a la quête active.
La variable Registry IDs liste chaque identifiant d'objet, de bloc ou de meuble que Nexo a chargé. La variable Tag Items liste les objets d'un tag Nexo.
Fonctionnement
Les événements transmettent aux entrées déclenchées ce qui s'est passé : l'identifiant du bloc ou du meuble, sa position et, pour un meuble, l'identifiant BetterModel. L'événement de butin lâché transmet aussi le nombre de piles et d'objets lâchés.
Les objectifs comptent chaque position une seule fois par joueur : poser puis casser à nouveau le même endroit ne s'additionne donc pas. Ils ne comptent que tant que le joueur a la quête liée active. Les actions annulées sont ignorées.
Le filtre betterModelId sur les événements et objectifs de meubles correspond à la clé bettermodel_id du meuble dans votre configuration Nexo. Laissez-le vide pour l'ignorer.
Configuration
Les lignes d'objectifs du suivi de quête sont construites à partir de deux snippets 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
- Nexo Give Item ActionGive a Nexo item to the player
- Nexo Remove Item ActionRemove a Nexo item from the player
Événements12
- Nexo on Customblock Break EventTriggers when a Nexo custom block is broken
- Nexo on Customblock Damage EventTriggers when a player starts breaking a Nexo custom block
- Nexo on Customblock Drop Loot EventTriggers when a Nexo custom block drops loot
- Nexo on Customblock Interact EventTriggers when a Nexo custom block is interacted with
- Nexo on Customblock Place EventTriggers when a Nexo custom block is placed
- Nexo on Furniture Break EventTriggers when a Nexo furniture is broken
- Nexo on Furniture Damage EventTriggers when a player hits a Nexo furniture
- Nexo on Furniture Interact EventTriggers when a Nexo furniture is interacted with
- Nexo on Furniture Place EventTriggers when a Nexo furniture is placed
- Nexo on Item Consume EventTriggers when the player consumes a Nexo item
- Nexo on Item Drop EventTriggers when the player drops a Nexo item
- Nexo on Item Pickup EventTriggers when the player picks up a Nexo item
Objectifs4
- Nexo Break Customblock ObjectiveAn objective to break Nexo custom blocks
- Nexo Break Furniture ObjectiveAn objective to break Nexo furniture
- Nexo Place Customblock ObjectiveAn objective to place Nexo custom blocks
- Nexo Place Furniture ObjectiveAn objective to place Nexo furniture
Faits8
- Nexo Break Time FactTicks this player needs to break the Nexo block they are looking at
- Nexo Furniture Light State FactWhether the Nexo furniture the player looks at is lit
- Nexo Holding Item FactWhether the player is holding a Nexo item
- Nexo Item Count FactHow many of a Nexo item the player carries
- Nexo Item Has Mechanic FactWhether the held Nexo item uses a given mechanic
- Nexo Looking at Block FactWhether the player is looking at a Nexo custom block
- Nexo Looking at Furniture FactWhether the player is looking at Nexo furniture
- Nexo Standing on Block FactWhether the player is standing on a Nexo custom block
Variables8
- Nexo Furniture Property VariableA property of the Nexo furniture the player is looking at
- Nexo Item in Hand ID VariableThe Nexo ID of the item the player holds
- Nexo Item Property VariableA property of the Nexo item the player holds
- Nexo Looking at Block ID VariableThe Nexo ID of the block the player is looking at
- Nexo Looking at Furniture ID VariableThe Nexo ID of the furniture the player is looking at
- Nexo Registry Ids VariableThe list of IDs Nexo has loaded
- Nexo Standing on Block ID VariableThe Nexo ID of the block the player stands on
- Nexo Tag Items VariableThe Nexo items carrying a given tag
Sons1
- Nexo SoundNexo Sound
Dépannage
L'extension n'apparaît pas dans le panel. Nexo n'est pas installé ou ne s'est pas activé. Chaque entrée appelle l'API de Nexo : l'extension refuse donc de se charger sans le plugin.
Un événement ne se déclenche jamais. Utilisez exactement l'identifiant d'objet Nexo (ruby_ore). Un identifiant vide correspond à n'importe quoi. Si vous avez renseigné location, seule cette position de bloc correspond. Les événements annulés par un autre plugin sont ignorés. Pour un meuble, un betterModelId qui ne correspond pas au bettermodel_id du meuble bloque l'événement.
L'objectif n'avance pas. Le joueur doit avoir la quête liée active, et fact doit être défini. Chaque position de bloc ne compte qu'une fois par joueur.
Les variables de registre ou de tags sont vides. Nexo charge ses objets en arrière-plan. Ces variables ne renvoient rien tant que Nexo n'a pas fini de charger : ne les lisez donc pas pendant le démarrage du serveur.
Un fact renvoie toujours 0. L'objet ou le bloc n'est pas un élément de Nexo. Les facts de blocs vérifient le premier bloc situé à moins de range blocs (5 par défaut). Le fact de temps de casse renvoie 0 lorsque le bloc cible ne peut pas être cassé par Nexo. Le fact de mécanique nécessite l'identifiant exact de la mécanique Nexo.
Give Item ne donne rien. L'itemId est inconnu de Nexo : aucun objet n'est donc construit. Les restes qui ne rentrent pas sont lâchés aux pieds du joueur sauf si dropOverflow est désactivé.
Extensions associées
- ItemsAdder et Craft Engine — la même intégration pour les autres plugins de contenu personnalisé.