Is there a list somewhere of VO api lua functions with maybe a short description of what they do, argument descriptions and return values etc. or is it a case of just studying existing code and experimenting?

Apologies if I've posted this in the wrong place, please feel free to move it if I have.

Try here: http://www.vo-wiki.com/racecar/index.php?title=Main_Page

No idea if this has been kept up to date though.

For the most part. Most of what's missing are the actual arguments for some of the lesser used functions. Be careful though. There are still functions listed which are no longer working (e.g. GetCharacterIDByName which always returns nil) which are likely due to abuse. What we need to do is a complete inventory of the function list, weeding out that stuff which no longer works.

GetCharacterIDByName() name works fine, if you use it under the appropriate conditions.

Thanks, that's exactly what I was looking for. Appreciated!