Page 1 sur 1

[WeiDU] Liste des principales fonctions et macros pour modder

Posté : lun. 11 avr. 2016, 14:23
par 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 ».


[WeiDU] Liste des Fonctions et Macros modifiant les objets et les magasins

Posté : lun. 11 avr. 2016, 14:26
par 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.

Posté : lun. 11 avr. 2016, 14:28
par 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).

Posté : lun. 11 avr. 2016, 14:29
par 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).

Posté : lun. 11 avr. 2016, 14:30
par 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.

Posté : lun. 11 avr. 2016, 14:31
par 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.

Posté : lun. 11 avr. 2016, 14:32
par 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.

Posté : mer. 13 avr. 2016, 13:22
par 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.

Merci

Posté : mer. 13 avr. 2016, 14:27
par 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 ?

Posté : mer. 13 avr. 2016, 15:14
par 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. :whistle3:

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.

Posté : mer. 13 avr. 2016, 15:21
par 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.

Posté : jeu. 21 avr. 2016, 17:47
par Freddy_Gwendo
To_an a écrit :Cochon qui s'en dédit comme on dit.
Pour commencer, quelques exemples d'utilisation des fonctions sur les cartes ici et . ;)

Posté : ven. 22 avr. 2016, 09:15
par 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.