maniascript vscode extension update v1.3.2

[reaby]

Hi,

UPDATE
You can still use this extension if you wish but there's much much much newer avaible now at
vscode marketplace: search Maniascript-Support by reaby.
The updated one has all the features here + some cool new ones. Checkit out!

Notice: maniaLSP 0.5.0 will work fine with the extension, versions below may have colorization problems.

Setup
The extension can run without setup, but you will have very very old api in that case.

To get use the latest, extract the api from game to somewhere at your harddrive
example:

Code: Select all

trackmania.exe /generatescriptdoc=D:\trackmania\doc.h

(works same with maniaplanet, note the folder needs to exist) and add following lines to your vscode setttings.json (can be accessed from File->Preferences->Settings->Extensions->ManiaScript)
Remember to include the filename as well for doc.h, this is to have more versatile support, incase you wish to name it differently

For maniaplanet you should use something like this:

Code: Select all

{
    "maniascript.apidocPath": "D:\\dev\\doc.h",
    "maniascript.useManiaplanetApi": true,
}

For new Trackmania:

Code: Select all

{
    "maniascript.apidocPath": "D:\\trackmania\\doc.h",
    "maniascript.useManiaplanetApi": false,
}

Manialink autocomplete and validation
I finally figured out the most easiest possible way to get autocomplete and validation working for manialink xml.

I recently have opened as well a github repository for holding and updating the manialink xsd.
You can find it here https://github.com/reaby/manialink-xsd

just install XML extension for vscode and use this template:

Code: Select all

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<?xml-model href="https://raw.githubusercontent.com/reaby/manialink-xsd/main/manialink_v3.xsd" ?>
<manialink version="3">
	<-- your manialink content here -->
</manialink>

Parsing of external libraries
Just add folder to workspace to get libraries load relatively from those directories.
so if you have

Code: Select all

#Include "Mylib/external.Script.Txt" as MyLib

be sure that MyLib is folder inside workspace library.

as of 1.2.17 also external stucts are supported:

Code: Select all

#Struct externalLib::myStruct as structAlias

Auto complete from context
You can set autocomplete namespace root 2 ways:

1. Either having requirecontext at 1st line:

Code: Select all

#RequireContext CMlScriptIngame

2. or having custom context comment block:

Code: Select all

/** @context CMlScriptIngame */
as well as require context with normal comment
// #RequireContext CMlScriptIngame

Template Strings
I added background color change for template strings, so it's easier to spot where templates starts and ends.
As well as templatestrings are considered as xml for color tokenizer. There's as well rule to colorize <script><!-- blocks as well.

Code snipplets
here's a list of prefixes what you can expand with tab-key, most of them are quite obvious:


#Include
#Setting
#Const
#Command
#Struct

declare
for
foreach
switch
if
elif generate if/else blocks
while

fast access macros:

main generate main function with documentation block
fnc generate function declaration with documentation block
decontrol to fast declare CMlcontrol with Page.GetFirstChild
new generate new instance of struct
PageGet generate (Page.GetFirstChild("controltext") as CMlControl) block
ve2 generate vec2 notation <float,float>
ve3 generate vec3 notation <float, float, float>
in3 generate int3 notation <int,int,int>

[magnetik]

Hey maybe you can create a new "place" on the extension marketplace ? People tends to download the most installed, so in a few time it will not matter that the old one is still there.

It seems awesome

[reaby]

Hi,

@magnetik thinking about that, but for now keeping this simple.

Hi, here's new update!
http://reaby.kapsi.fi/maniaplanet/vscod ... .2.13.vsix

Changelog
Fixed comments to colorize correctly on structs.
Intellisense shows now variable types like this: myquad : CMlQuad
Intellisense now autocompletes hopefully better build-ins example:
CMlQuad::_ <-- will show only enums now (instead of methods and enums)
Added keywords: `metadata` and `in`.
External libraries are now refreshed on every active document change, no
more need to restart ide when working on libraries!

[Mickael]

Hello,

Thank you for the plugin it is quite nice , but I think I found a problem with it.
When you are typing curly brackets, visual completes an opening bracket with a closing bracket like usual but when you type 3 curly brackets, the extension spawns 2 extra closing curly brackets ontop of the ones visual made.
It is only the case if you type the curly brackets without a text inside though.

Example:
"{}" => "{{}}" => "{{{}}}}}" (problem)
"{hello}" => "{{hello}}" => "{{{hello}}}" (this works)

[reaby]

Hello,

Thank you for the plugin it is quite nice , but I think I found a problem with it.
When you are typing curly brackets, visual completes an opening bracket with a closing bracket like usual but when you type 3 curly brackets, the extension spawns 2 extra closing curly brackets ontop of the ones visual made.
It is only the case if you type the curly brackets without a text inside though.

Example:
"{}" => "{{}}" => "{{{}}}}}" (problem)
"{hello}" => "{{hello}}" => "{{{hello}}}" (this works)

Hi Mikael,

Thanks for noticing this.... and I found the reason for this as well...
Looks like I don't need a rule to autoclose triple brackets. It looks like single bracket rule is enough to do this.
but I don't yet update the extension, let's see if there's other issues or wishes as well, so it's worth doing more fixes at same time.

[reaby]

http://reaby.kapsi.fi/maniaplanet/vscod ... .2.14.vsix

1.2.14 Changelog
Fixed braces autoclose
added varible type resolving to foreach, hopefully i didn't break anything...

[reaby]

i noticed afterwards it had some problems resolving structs... it's now fixed though. i didn't update version number, so if you already installed the extension just uninstall and reinstall the new version

[Mickael]

No problem , I will post it here if I find anything

[reaby]

http://reaby.kapsi.fi/maniaplanet/vscod ... .2.15.vsix

Code snipplets
I added alot of code snipplets helpers for version 1.2.15:
here's a list of prefixes what you can expand with tab-key, most of them are quite obvious:

#Include
#Setting
#Const
#Command
#Struct

declare
for
foreach
switch
if
elif generate if and else blocks
while

fast access macros:

main generate main function with documentation block
fnc generate function declaration with documentation block
decontrol to fast declare CMlcontrol with Page.GetFirstChild
new generate new instance of struct
PageGet generate (Page.GetFirstChild("controltext") as CMlControl) block
ve2 generate vec2 notation <float,float>
ve3 generate vec3 notation <float, float, float>
in3 generate int3 notation <int,int,int>

[Nerpson]

Good work!
Very useful plugin.