[WeiDU] Liste des principales fonctions et macros pour modder

[Freddy_Gwendo]

SUJET EN COURS DE CONSTRUCTION

La plupart des discussions de modding comportent des références à des fonctions et à des macros de WeiDU qui permettent de nous simplifier la vie en automatisant certaines procédures.


En voici un récapitulatif succinct. Vous trouverez donc :

• Les fonctions concernant les objets ici.
• Les fonctions concernant les magasins ici.
• Les fonctions concernant les sorts ici.
• Les fonctions concernant les créatures ici.
• Les fonctions concernant les cartes ici.
• Les fonctions transversales ici.
• Les fonctions générales ici.

---

Petit rappel au cas où :

« Ability header » = en-tête d'une capacité d'un sort (généralement les renseignements sur la cible, le projectile utilisé, la distance, le temps d'incantation : un header par niveau) ou d'un objet (dégâts par type mêlée ou lancer, et/ou capacités spéciales de l'objet). Elles sont souvent aussi appelées « extended headers ».

---

[Freddy_Gwendo]

Fonctions WeiDU agissant sur les OBJETS

Fonction	Description
ADD_ITEM_EFFECT	Ajoute un effet à une ou plusieurs capacités d'un objet.
ALTER_ITEM_EFFECT	Modifie les effets globaux (d'équipement) et/ou les effets des capacités d'un objet.
DELETE_ITEM_EFFECT	Supprime tous les effets des capacités d'un objet correspondant au numéro d'opcode spécifié
ADD_ITEM_EQEFFECT	Ajoute un effet d'équipement à un objet.
DELETE_ITEM_EQEFFECT	Supprime tous les effets d'équipement d'un objet correspondant au numéro d'opcode spécifié.
ALTER_ITEM_HEADER	Modifie les ability headers d'un objet.
DELETE_ITEM_HEADER	Supprime les ability headers d'un objet.

---

Fonctions WeiDU agissant sur les MAGASINS

Fonction	Description
DELETE_STORE_ITEM	Supprime tous les objets spécifiés à un magasin.
REPLACE_STORE_ITEM	Remplace tous les objets spécifiés d'un magasin par un autre.

[Freddy_Gwendo]

Fonctions WeiDU agissant sur les SORTS

Fonction	Description
ADD_SPELL_EFFECT	Ajoute un effet à lancer par un sort.
ADD_SPELL_CFEFFECT	Ajoute un effet de « casting-feature » à un sort.
ALTER_SPELL_EFFECT	Modifie les effets d'un sort.
DELETE_SPELL_EFFECT	Supprime tous les effets lancés par un sort correspondant au numéro d'opcode spécifié.
ALTER_SPELL_HEADER	Modifie les ability headers d'un sort.
DELETE_SPELL_HEADER	Supprime les ability headers d'un sort.
RES_NUM_OF_SPELL_NAME	Convertit une référence du fichier spell.ids en nom (du sort).
RES_NAME_OF_SPELL_NUM	Convertit une référence du fichier spell.ids en numéro (du sort).

[Freddy_Gwendo]

Fonctions WeiDU agissant sur les CRÉATURES

Fonction	Description
FJ_CRE_VALIDITY	Vérifie la validité du format d'un fichier CRE, le répare si nécessaire, et retourne une valeur indiquant s'il est valide ou non.
ADD_CRE_EFFECT	Ajoute un effet à une créature.
DELETE_CRE_EFFECT	Supprime tous les effets d'une créature correspondant au numéro d'opcode spécifié
DELETE_CRE_ITEM	Supprime tous les objets spécifiés à une créature.
ADD_CRE_ITEM_FLAGS	Ajoute des drapeaux (flags) à tous les objets spécifiés possédés par une créature.
SET_CRE_ITEM_FLAGS	Attribue la même valeur aux drapeaux (flags) de tous les objets spécifiés possédés par une créature.
REMOVE_CRE_ITEM_FLAGS	Supprime des drapeaux (flags) à tous les objets spécifiés possédés par une créature.
ADD_CRE_SCRIPT	Assigne un script à une créature dans le premier emplacement disponible (de Override à Default).

[Freddy_Gwendo]

Fonctions WeiDU agissant sur les CARTES

Fonction	Description
ADD_AREA_ITEM	Ajoute un objet dans un conteneur d'une carte.
ADD_AREA_REGION_TRIGGER	Ajoute une région (area trigger) dans une carte.
ALTER_AREA_REGION	Modifie une région d'une carte
ALTER_AREA_ACTOR	Modifie une créature d'une carte.
ALTER_AREA_CONTAINER	Modifie un conteneur d'une carte (mais pas son contenu).
ALTER_AREA_DOOR	Modifie une porte d'une carte.
ALTER_AREA_ENTRANCE	Modifie les coordonnées et l'orientation d'un point d'entrée d'une carte.
DELETE_AREA_ITEM	Supprime tous les objets spécifiés d'une carte.
REPLACE_AREA_ITEM	Remplace tous les objets spécifiés d'une carte par un autre.
fj_are_structure	Ajoute un élément à un fichier ARE (créature, région, porte, conteneur, animation...).

---

Fonctions WeiDU agissant sur la CARTE du MONDE

Fonction	Description
sc#addWmpAre	Ajoute une carte à la carte du monde.
ADD_WORLDMAP_LINKS	Ajoute dans la carte du monde des liens d'une carte vers une autre.
DELETE_WORLDMAP_LINKS	Supprime dans la carte du monde tous les liens d'une carte vers une autre.

[Freddy_Gwendo]

Fonctions WeiDU transversales

Fonction	Description
ALTER_EFFECT	Modifie un effet d'une créature, d'un objet ou d'un sort.
CLONE_EFFECT	Clone un effet d'une créature, d'un objet ou d'un sort.
DELETE_EFFECT	Supprime un effet d'une créature, d'un objet ou d'un sort.
ITEM_EFFECT_TO_SPELL	Copie tous les effets d'un objet dans le premier extended header d'un sort.

[Freddy_Gwendo]

Fonctions WeiDU générales

Fonction	Description
SUBSTRING	Fonction permettant de sélectionner une chaîne de caractères à l'intérieur d'une autre.
READ_SOUNDSET	Lit le soundset d'un fichier CRE et le stocke dans une table.
WRITE_SOUNDSET	Écrit la table du soundset établie par la fonction précédente dans un fichier CRE.
HANDLE_AUDIO	Décompresse et installe automatiquement les fichiers compressés Ogg--Vorbis au format wav. Pour les versions Enhanced, la fonction ne les décompresse pas, mais les copie dans le répertoire override.
HANDLE_TILESETS	Décompresse et installe automatiquement les fichiers compressés tiz en fichiers tis avec l'utilitaire Tisunpack.
HANDLE_CHARSETS	Convertit des fichiers TRA au format UTF-8.

[Freddy_Gwendo]

AF : ajouter les fonctions générales manquantes.

Mise à jour du 13.04.2016 :

• Ajout de la fonction générale HANDLE_AUDIO.
• Ajout de la fonction générale HANDLE_TILESETS.

[To_an]

Je ne suis peut être pas autorisé à répondre à ce sujet mais je tenais à te remercier pour cette compilation. J'essaie de comprendre comment fonctionne WeiDU, et n'étant pas programmeur j'avoue avoir énormément de mal à maîtriser cet outil (il m'a fallut une journée pour découvrir comment déplacer vers le dossier 'override' du jeu l'ensemble des fichiers d'un dossier). De plus je me promène entre trois sites différents (et je consulte les fichiers des autres modifications dont certains sont particulièrement bien documentés) pour lire, voire et comprendre le bouzin mias c'est particulièrement fastidieux. Alors j'applaudis à deux mains ton initiative de regrouper dans un sujet unique tout cela.

Peut-on espérer que tu indiques sous chaque fonction un exemple de syntaxe ou de mise en oeuvre ?

[Freddy_Gwendo]

Si tu ne l'étais pas, tu n'aurais pas pu !


J'y ai songé, mais c'est très chronophage : ça suppose de donner la définition exhaustive de chaque fonction (avec toutes ses variables) et de l’illustrer par un ou plusieurs (le plus souvent plusieurs) exemples d'utilisation.

Alors, non ce n'est pas prévu dans l'immédiat.

Cependant, promis juré, j'y penserai à chaque fois que je validerai une procédure dans le tp2 de mon mod : je la noterai à part et j'illustrai les sections avec des exemples au coup par coup.

[To_an]

J'y ai songé, mais c'est très chronophage

Je comprends

Cependant, promis juré, j'y penserai à chaque fois que je validerai une procédure dans le tp2 de mon mod

Cochon qui s'en dédit comme on dit.

Alors bonne continuation à toi avec tous mes encouragements.

[Freddy_Gwendo]

Cochon qui s'en dédit comme on dit.

Pour commencer, quelques exemples d'utilisation des fonctions sur les cartes ici et là.

[To_an]

Pour commencer, quelques exemples d'utilisation des fonctions sur les cartes

Lu apprécié et resté sur le cul devant cette masse de travail réalisé. Encore bravo et merci.