Skip to content

Conversation

@OrsellGit
Copy link
Contributor

@OrsellGit OrsellGit commented Jan 5, 2026

The current implementation of the AngelScript (AS) wiki dump parser parses the server and client dump files. However, since there is currently no real difference between the two, all functions, enums, and types are marked as "Server & Client". The only AS implementation difference in Strata Source is with Hammer, which includes various class types and enums that are NOT in the game. Ex. BoundBox, RenderMode

Right now, as of 1/4/26, the parser has an issue if a type or enum exists in BOTH the game and Hammer. An example is Material, where Material exists to a far greater extent than Hammer, with several functions in the class definition. However, for Hammer, it's an empty shell. The "mergeDump" function currently doesn't handle a type already being defined and instead overwrites what's already there with the next dump to be merged. It wasn't an issue with the client & server ones since they were currently the same, but not the Hammer one.

The goal of this PR is to rewrite/update the AS wiki parser to support the Hammer dump file. This PR might evolve into rewriting the entire dump parsing scene, so that all scripting languages can be parsed from using one parsing file and formatted into the same format for wiki-wide consistency.

TODO:

  • Get a nicer icon for Hammer-specific types. This should be able to help make some custom icons: https://github.com/Templarian/MaterialDesign-Font-Build
  • Rewrite/Update the current AngelScript parser to support both the game and Hammer dumps correctly.
  • Add a new page type, a folder that also acts as a article.

However, still has issues with some types or enums like "Material" where
it's a opaque class for Hammer, but for the game it has a lot more to
the class but the Hammer version completly overrides the game version.
@OrsellGit OrsellGit changed the title DRAFT AngelScript: Adding support for displaying Hammer objects in the reference API. AngelScript: Adding support for displaying Hammer objects in the reference API. Jan 5, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants