Répertorie les fonctions, événements, variables, etc. que vous pouvez utiliser lors du codage de mods pour Ficterra en Miniscript.
Événements
Fonctions d'événement
bind(event, func) – Lie une fonction (func) à appeler lorsqu'un événement se déclenche. L'événement doit provenir de la liste ci-dessous (Event.x), la fonction doit être une fonction que vous avez créée. Utilisez @myFunction pour référencer une fonction.
Liste des événements
Event.OnBiomeEntered – Se déclenche lorsque votre joueur entre dans un biome
id - l'identifiant du biome
nom – le nom du biome
Event.OnItemEquipped – Se déclenche lorsque votre joueur équipe un objet
id - l'identifiant de l'élément
nom - le nom de l'élément
Event.OnItemUnEquipped – Se déclenche lorsque votre joueur déséquipe un objet
id - l'identifiant de l'élément
nom - le nom de l'élément
Event.OnKilledMonster – Se déclenche lorsque vos joueurs tuent un monstre
id - l'identifiant du monstre (identifiant de l'objet du monstre)
nom - le nom du monstre
totalKilled - nombre de monstres avec le même identifiant que ce joueur a tués
Event.OnGainedItem – Se déclenche lorsque votre joueur gagne un objet
id - l'identifiant de l'élément
nom - le nom de l'élément
totalAmount - le montant de l'objet que votre joueur a maintenant
Event.OnRemovedItem – Se déclenche lorsque votre joueur perd un objet
id - l'identifiant de l'élément
nom - le nom de l'élément
totalAmount - le montant de l'objet que votre joueur a maintenant
Event.OnFinishedCrafting – Se déclenche lorsque votre joueur termine la fabrication
id - l'identifiant du plan d'artisanat
nom - le nom du plan d'artisanat
Event.OnFinishedResearch – Se déclenche lorsque votre joueur a terminé la recherche
id - l'identifiant de la recherche
nom – le nom de la recherche
Event.OnCompletedQuest – Se déclenche lorsque votre joueur termine une quête
id - l'identifiant de la quête
Event.OnPlayerMoved - Déclencher lorsque votre joueur a bougé
playerId – identifiant réseau du joueur
Événements d'élément
Fonctions d'événement d'élément
bindToItem(itemEvent, func, itemId) – Lie une fonction (func) à appeler lorsqu'un événement d'élément se déclenche pour un type d'élément spécifique. L'événement d'élément doit provenir de la liste ci-dessous (ItemEvent.x), la fonction doit être une fonction que vous avez créée et l'élément Id est l'identifiant de l'élément auquel cela s'applique. Utilisez @myFunction pour référencer une fonction.
bindItemUpdate(func, itemId, setupFunc) – Lie une fonction (func) à appeler dans la boucle de mise à jour d'un élément. L'itemId est l'identifiant de l'élément auquel cela s'applique, func est la fonction qui est appelée lorsque l'élément est mis à jour (à chaque tick) et setupFunc est une fonction qui s'exécute une fois pour configurer les valeurs ou tout ce dont vous pourriez avoir besoin pour la boucle. Utilisez @myFunction pour référencer une fonction.
Liste des événements de l'élément
ItemEvent.OnTriggerEntered - Se déclenche lorsqu'un objet entre dans cette zone de déclenchement d'objets (s'il en a un)
objectId - l'identifiant d'instance unique de l'objet
itemId – l'identifiant de l'objet
playerEnteredId - identifiant du joueur entrant (si entré par un joueur)
objectEnteredId - id de l'objet entrant (si entré par un objet)
ItemEvent.OnTriggerExited - Se déclenche lorsqu'un objet quitte cette zone de déclenchement d'objets (s'il en a un)
objectId - l'identifiant d'instance unique de l'objet
itemId – l'identifiant de l'objet
playerEnteredId - identifiant du joueur entrant (s'il est sorti par un joueur)
objectEnteredId - id de l'objet entrant (si quitté par un objet)
ItemEvent.OnInteract – Se déclenche lorsqu'un joueur interagit avec un objet
objectId - l'identifiant d'instance unique de l'objet
itemId – l'identifiant de l'objet
playerId - identifiant net du joueur qui interagit
ItemEvent.OnPlaceableCreated – Se déclenche lorsqu'un objet est créé dans le monde
objectId - l'identifiant d'instance unique de l'objet
itemId – l'identifiant de l'objet
Données d'article
ItemData.Strength – Force d'un cube
ItemData.MoveSpeed – Bonus de vitesse sur le cube
ItemData.Metallic – Aspect métallique du Cube (de 0 à 1)
ItemData.Smoothness - Aspect lisse d'un cube (de 0 à 1)
Type de dommage
Ceci est une liste de toutes les valeurs de type de dommage
- DamageType.Sharp
- DamageType.Blunt
- DamageType.Piercing
- DamageType.Fire
- DamageType.Glace
- DamageType.Électrique
- DamageType.Poison
- DamageType.Métal
- DamageType.Wood
- DamageType.Stone
- DamageType.Sonic
- DamageType.Eau
- DamageType.Martial
- DamageType.Radiation
- DamageType.Acid
- DamageType.Jade
Stat
Ceci est une liste de tous les types de statistiques
- Stat.Santé
- Stat.Endurance
- Stat. Vitesse
- Stat.Carry_Limit
- Armure statistique
- Stat.Travail du bois
- Stat.Maçonnerie
- Stat.Forgeron
- Dégâts statistiques
- Stat.Attack_Speed
- Stat.Cooldown_Reduction
- Stat.Body_Type
- Stat.Elemental_Power
- Stat.Repos_Guérison
- Stat.Crit_Chance
- Stat.Pénétration
- Stat.Maîtrise
- Esquive de statistiques
- Bloc statistique
- Stat.Battle_Regen
- Stat.Life_Vol
- Stat.Mend_Wounds
Variables et fonctions globales
- vector(x,y,z) - Crée un vecteur 3D avec x,y,z comme coordonnées (x est à droite, y est en haut, z est en avant)
- color(r,g,b,a) – Crée une couleur RGBA
- r – valeur rouge (0-1)
- g – valeur verte (0-1)
- b – valeur bleue (0-1)
- a - valeur alpha (0-1, 0 est entièrement transparent, 1 est opaque)
- addVector(v1, v2) – Ajoute deux vecteurs, v1 et v2 et renvoie le vecteur résultant
- saveWorldStorage() - Enregistre vos données personnalisées associées au monde ou au jeu
- loadWorldStorage() – Charge vos données personnalisées associées au monde ou au jeu
- savePlayerStorage() - Enregistre vos données personnalisées associées aux joueurs
- loadPlayerStorage() – Charge vos données personnalisées associées aux joueurs
- getItemId(itemName, [modIdentifier]) - Obtient un identifiant d'élément à partir du nom d'un élément et d'un identifiant de mod facultatif
- getQuestId(questName, [modIdentifier]) - Obtient un identifiant de quête à partir du nom d'une quête et facultatif
- identifiant de module
- getResearchId(researchName, [modIdentifier]) - Obtient un identifiant de recherche à partir du nom d'une recherche et d'un identifiant de mod facultatif
- getCubeId(cubeName, [modIdentifier]) - Obtient un identifiant de cube à partir du nom d'un cube et d'un identifiant de mod facultatif
- hasQuest(questId) – Renvoie 1 si vous avez la quête, 0 sinon
- deltaTime() – Renvoie le temps écoulé depuis la dernière mise à jour
- getPlayer(playerId) - Obtient un objet joueur à partir de son identifiant
- getLocalPlayer() - Obtient l'objet joueur pour votre playergetPlace
- able(placeableId) – Obtient un objet placable à partir de son identifiant unique
- giveItem(itemId, [amount],[playerId]) - Donne un 'montant' d'item d'itemId au joueur avec l'id playerId. Le montant est par défaut 1 et playerId est par défaut l'identifiant de votre joueur
- takeItem(itemId, [amount],[playerId]) - Prend une "quantité" d'élément d'itemId au joueur avec l'id playerId. Le montant est par défaut 1 et playerId est par défaut l'identifiant de votre joueur
- giveQuest(questId, [ignorePrereq]) – Donne une quête de 'questId' à votre joueur. Passez 1 à ignorePrereq si vous souhaitez ignorer la vérification des prérequis pour la quête
- playMusic (musicName) - Joue de la musique avec un nom donné
- playSfx(sfxName) - Joue un effet sonore avec un nom donné
- playSfxAtPoint(sfxName, position) - Joue un effet sonore avec un nom donné à une certaine position. La position est un vecteur
- takeDamage(target, damage, damageTypeId) – La cible subit des dégâts égaux à 'damage' du type 'damageTypeId'. La cible peut être soit un playerId, soit un object Id.
- DamageTypeId provient de DamageType.X
- soin (cible, montant) – Provoque un soin de la cible égal au montant. La cible peut être soit un playerId, soit un object Id.
- runCommand(command) – Exécute une commande de console. Il s'agit de l'une des commandes pouvant être saisies dans la console en jeu
- moveTo(objectId,position,speed) – Déplace un objet vers une position se déplaçant à une vitesse donnée
- rotateTo(objectId,rotation,speed) – Fait pivoter un objet dans une rotation avec une vitesse angulaire de vitesse. La rotation est en angles euler
- annoncer (texte) - Affiche le texte à l'écran
- getPlayerCount() – Renvoie le nombre de joueurs dans le jeu
- createPlaceable(itemId,position) – Crée un nouvel objet placable de l'élément avec itemId à une position. Renvoie l'identifiant d'instance unique de l'objet placable
- setItemData(key,value,itemId) – Définit une valeur de tous les éléments de itemId. La clé provient de ItemData.X.
- getItemData(key,itemId) – Renvoie une valeur de tous les éléments de itemId. La clé provient de ItemData.X.
En outre, l'objet d'inventaire a 1 méthode :
- hasItem(itemId, amount) - vérifie si l'inventaire contient au moins le montant d'un article donné par itemId. Le montant par défaut est 1.
Joueur
Ces fonctions sont appelées sur un objet Player, c'est-à-dire player.func()
- getPosition() – renvoie la position du joueur
- getRotation() - renvoie la rotation du joueur (en angles euler)
- getDirection() - renvoie la direction dans laquelle le joueur fait face
- getCurrentStat(stat) - obtient la valeur actuelle de la statistique d'un joueur. La statistique provient de Stat.X
- getMaxStat(stat) - obtient la valeur maximale de la statistique d'un joueur. La statistique provient de Stat.X
- setCurrentStat(stat) - définit la valeur actuelle de la statistique d'un joueur. La statistique provient de Stat.X
- setMaxStat(stat) - définit la valeur maximale de la statistique d'un joueur. La statistique provient de Stat.X
- inventaire () - obtient l'objet d'inventaire du joueur
- giveItem(itemId,amount) - donne au joueur le "montant" d'un objet avec itemId
- takeItem(itemId,amount) - prend le 'montant' du joueur d'un article avec itemId
- respawn () - fait réapparaître le joueur
- unlock(researchName) – déverrouille une recherche pour ce joueur
- giveResearch(researchName) - donne une recherche en option pour ce joueur à rechercher
Placable
Ces fonctions sont pour un objet Placeable, c'est-à-dire placeable.function()
- getPosition() - renvoie la position du placable
- getRotation() - renvoie la rotation du placable (en angles euler)
- setPosition(position) - définit la position du plaçable
- setRotation(rotation) - définit la rotation du placable (en angles euler)
- getDirection() - renvoie la direction d'orientation du plaçable
- inventaire () - renvoie la direction d'orientation du placable
- isAlive(id) - fonction statique pour vérifier si un placable avec id existe toujours
- isBeingCarried() - renvoie 1 si actuellement transporté, sinon 0
- getData(key) - obtient les données enregistrées sur le placeable stocké sous key
- setData(key,value) - définit les données enregistrées sur le placeable stocké sous key comme valeur
- saveData() - enregistre les données stockées sur ce placeable dans un fichier (bientôt)
C'est tout ce que nous partageons aujourd'hui pour cela Fiction guide. Ce guide a été initialement créé et rédigé par amusements du nord. Si nous ne parvenons pas à mettre à jour ce guide, vous pouvez trouver la dernière mise à jour en suivant ce lien.