Soma Mod Tools For Atom
A plugin for the Atom text editor which provides various tools and utilities to aid with mod creation for SOMA. You can follow the project, or contribute over at github.
Features
Angelscript syntax highlighting (.hps files)
Symbols support for .hps files using ctags
Detect lang, nodes, mat, cmb, ent, cfg, gui, ps, fnt, hpm, hpm_* files as xml
The package may notify you that it has disabled symbols-view. If this did not happen, go to the "packages" tab and search symbols-view and verify it is disabled (click disable if it isn't).
Note: If you already use atom and have installed atom-ctags please note that this package may conflict with it, as that package also replaces symbols-view.
Usage
Spoiler below!
Go to File->Add Project Folder and select your soma directory (the place with soma.exe in it).
You will see a list of folders and files down the left hand side of the screen.
You can open files from this list, or you can use ctrl+P to search for files.
Use ctrl+r when inside a .hps file bring up the symbols view. This will list all the functions / clases / interfaces inside the file you are currently working on, which you can search through.
If you wish to update to a later version of this package go to file->settings->Updates
You can find more detailed information on using atom here
Known issues
Spoiler below!
Parameters don't color correctly in constructors
Parameters with defaults (e.g. void function(type x=1)) don't color properly for non-built in types
Future Features & Wishlist
Spoiler below!
Detect hpsl as shader filers, and apply a similar shader grammar
Add menu options & keyboard short-cuts for opening up .ent, .hpm etc files using the appropriate editor
Option/shortcut for launching the game using a specific mod in develop mode
Have a look and see what other editor tools we can integrate with
Stop replacing symbols-view, when symbols-view provides a means of providing tags to it.
Snippets for the default soma angelscript api functions. Maybe even support special coloring for them.
Fix syntax highlighting issues on parameters in function calls
I would definitely love to have some tools to at least help get us started. HPL3 seems rather different to HPL2, so getting an application that can assist with that transition between the two would be very helpful :3
So far we have some basic code colouring (still need to highlight parameters for functions correctly) and ctags support for symbols browser.
For the moment I have just forked the symbols view until we have a way to provide symbols to it, as I don't really want to commit a patch for a game-specific file extension.
Going to move this thread over to the Development sub-forum.
![[Image: screenshot.png]](https://raw.githubusercontent.com/Apjjm/soma-mod-tools/master/resources/screenshot.png)