Session 132octavus — Découverte des docs Team17 dans original/DOCS

Constat

Le dossier original/DOCS/ contient 33 fichiers HOW2* (~118 KB de texte ASCII).
Ce sont des notes utilisateur Team17 expliquant comment se servir de leur outil interne
GAMELINKER (qui édite le TEST.LNK).

Lecture partielle effectuée (7 docs sur 33)

Docs lues :
– HOW2ChangeLevelNames, HOW2DefinePlayerAppearance, HOW2IncSoundEffects,
HOW2DefineFloorDamage, HOW2DefineAliens, HOW2DefineBullets, HOW2DefineObjects.

Confirmations techniques utiles pour le port

Ces docs confirment et complètent des choses qu’on avait reverse-engineerées :

• Format CSFX (samples) : 8000 Hz, multiples de 200 bytes, demi-volume, format RAW.
  -> matche le magic CSFX vu dans samples/*.fib après décompression.
• Floor damage : damage par tile + sound effect. -> matche les champs
  floorNoise / upperFloorNoise qu’on a dans notre ZoneRecord.
• Aliens : 21 paramètres par alien (graphic type BITMAP/VECTOR/LIGHTSOURCED,
  behaviour CHARGE/CHARGE_TO_SIDE/ATTACK_WITH_GUN, hit points, height, torch
  brightness, projectiles ejected upon death, auxiliary objects pour muzzle flashes…).
• Bullets : 14 paramètres (damage, visible/instant, gravity, bounce walls/floors,
  lifetime, explosive force, movement speed 0-7 en puissances de 2, impact noise,
  animation, graphic type BITMAP/GLARE/ADDITIVE).
• Objects : 4 types principaux (Collectable / Activatable / Destructable /
  Decoration), graphic types BITMAP/POLYGON/GLARE, 14 paramètres (hit points,
  explosive potential, collision cylinder, position vs floor/ceiling, lock to wall,
  sound FX…).
• Player appearance : confirme « joueur = un alien choisi » -> cohérent avec
  ObjT.typeId qu’on avait suspecté.

Reste à lire (26 docs)

ChangeGlobalPalette, ChangeHeights, ConvertWallGraphics, ConvertFloorGraphics,
ConvertTextureGraphics, AddDoorsAndLifts, AddAliensToLevels, Add_Objects_To_Levels,
DefineAlienAnimations, DefineATeleport, DefinePlayerGuns, DrawFloorGraphics,
DrawTextureGraphics, IncFloorGraphics, IncObjectGraphics, IncTextureGraphics,
IncVectorObjects, IncWallGraphics, MakeaCleanSlate, PlaceControlPoints,
SaveALevelToDisk, setWallFloorCeilingGfx, StartNewLevel, UseAnimSelect,
CreateChallengingLevels, Change_Lighting.

Décision

Pas de synthèse ni de programme d’indexation pour l’instant. On consultera ces docs
en lecture ciblée quand on attaquera chaque sous-système (ex: lire
HOW2ConvertWallGraphics quand on fera l’extracteur de textures de murs).