opencage / cathodelib

A C# library supporting a wide range of conventions and file formats for Alien: Isolation.

CathodeLib - Alien: Isolation C# Library

CathodeLib is an open source library providing functionality to handle formats from the Cathode game engine, for modding Alien: Isolation. Used to power OpenCAGE!

Available as a NuGet package, or alternatively just include this repo as a submodule in your project!

---

All parsers inherit from a base CathodeFile class which provides:

• A static Implementation flag, defining if the parser supports CREATE, LOAD, and/or SAVE functionality for the file. Parsers which support all three have the ability to generate files from scratch.
• A Loaded bool, which is true if the parser has populated its values from a pre-existing file that it has loaded. If false, the parser is creating a new file on save.
• A Filepath string, which is the filepath that the parser is using to either load or save the file.
• A Save function, which will save the file out if the parser has the SAVE flag. This function can optionally be given a new filepath to save the file to. Returns false if saving fails.
• Events for OnLoadBegin, OnLoadSuccess, OnSaveBegin, OnSaveSuccess which fire at load/save start and successful completion respectively, with the appropriate filepath as an arg.

Most parsers provide access to the file's content via an Entries parameter, however this can vary per implementation.

Note: in debug mode the parsers will all fail hard, however in release mode all load/save calls are wrapped in try/catch statements.

Parsers currently available in CathodeLib...

For scripting:

• CATHODE.Commands handles COMMANDS.PAK files
  • The file consists of Composite scripts which hold various Entity types for logic
    • FunctionEntity = functions which execute functionality, with parameters and links to child Entity objects
    • VariableEntity = variables which can be used externally as parameters on an instanced Composite via a FunctionEntity
    • ProxyEntity = a proxy of a FunctionEntity within another Composite, useful for acting on events in another composite
    • OverrideEntity = an override of a parameter value on an entity within an instanced Composite in this Composite

Check out a full overview of the Commands structure on the Wiki, and follow this handy guide to create your first script!

For assets:

• CATHODE.PAK2 handles UI.PAK and ANIMATIONS.PAK files
• CATHODE.Models handles LEVEL_MODELS.PAK files, paired with a MODELS_LEVEL.BIN
• CATHODE.Textures handles LEVEL_TEXTURES.ALL.PAK files, paired with a LEVEL_TEXTURE_HEADERS.ALL.BIN
• CATHODE.LEGACY.Assets.Shaders handles various SHADERS PAK files (WIP)

For level data and mappings:

• CATHODE.Movers handles MODELS.MVR files
• CATHODE.RenderableElements handles REDS.BIN files
• CATHODE.Resources handles RESOURCES.BIN files
• CATHODE.Materials handles MODELS.MTL files
• CATHODE.MaterialMappings handles MATERIAL_MAPPINGS.PAK files
• CATHODE.EnvironmentMaps handles ENVIRONMENTMAP.BIN files
• CATHODE.EnvironmentAnimations handles ENVIRONMENT_ANIMATION.DAT files
• CATHODE.PathBarrierResources handles PATH_BARRIER_RESOURCES files
• CATHODE.PhysicsMaps handles PHYSICS.MAP files
• CATHODE.Lights handles LIGHTS.BIN files
• CATHODE.Collisions handles COLLISION.BIN files
• CATHODE.CollisionMaps handles COLLISION.MAP files
• CATHODE.AnimationStrings handles ANIM_STRING_DB.BIN and ANIM_STRING_DB_DEBUG.BIN files
• CATHODE.EXPERIMENTAL.NavigationMesh handles NAV_MESH files (experimental)
• CATHODE.SoundNodeNetwork handles SNDNODENETWORK.DAT files
• CATHODE.SoundLoadZones handles SOUNDLOADZONES.DAT files
• CATHODE.SoundFlashModels handles SOUNDFLASHMODELS.DAT files
• CATHODE.SoundEventData handles SOUNDEVENTDATA.DAT files
• CATHODE.SoundEnvironmentData handles SOUNDENVIRONMENTDATA.DAT files
• CATHODE.SoundDialogueLookups handles SOUNDDIALOGUELOOKUPS.DAT files
• CATHODE.SoundBankData handles SOUNDBANKDATA.DAT files
• CATHODE.CharacterAccessorySets handles CHARACTERACCESSORYSETS.BIN files
• CATHODE.CustomCharacterInfo handles CUSTOMCHARACTERINFO.BIN files
• CATHODE.CustomCharacterConstrainedComponents handles CUSTOMCHARACTERCONSTRAINEDCOMPONENTS.BIN files
• CATHODE.Strings handles *.TXT files

For configurations:

• CATHODE.BML handles any .BML files
  • Get/set content as an XmlDocument via BML.Content

For saves:

• CATHODE.ProgressionSave handles PROGRESSION.AIS files
• CATHODE.EXPERIMENTAL.MissionSave handles *.AIS files (experimental)

---

CathodeLib is in no way related to (or endorsed by) Creative Assembly or SEGA.