Tools for Atom (v0.1.1)

[Apjjm]

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
  

Installation (Current Version: V0.1.1)

Spoiler below!

1. Download and install Atom
   
2. Go to File->Settings->Install
   
3. Search for soma-mod-tools & Press enter.
   
4. Click Install on the soma-mod-tools package
   
5. 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).
   

You can see a change-log over on github

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
  

[Romulator]

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

[triadtimes]

If this would be anything like the Notepad++ support tool from HPL2 then yes, I'd be very interested. That thing saved me a ton of time back in HPL2.

[Apjjm]

Started work on the project:

https://github.com/Apjjm/soma-mod-tools

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.

[Apjjm]

I have updated this project to v0.1.1 and made an initial release.

Change-log

Spoiler below!

• Angelscript grammar & colouring
  
• Auto-detect the grammar for the various soma xml resource files
  
• Fork symbols-View to provide ctags support for angelscript on .hps files
  

Updated the OP with installation instructions & a quick usage guide.