Javascript API documentation

[aubergine]

I previously grumbled about the game objects being static snapshots of game data - with the work I'm doing on my Vault script, I've gained a new understanding and appreciation for why the decision was made to have game objects copy game data rather than expose it live to scripts.

So, just wanted to take back my earlier comments and say 'well done!' on an erudite decision with regards to the game objects exposed via JS API.

[NoQ]

I wasn't really reading much last week ... did i miss anything?

I'm still looking for a way of making AI 1. chat and drop and receive beacons, 2. make use of gateways drawn on the map, and 3. know where his units are currently going (expose .orderx and .ordery properties?) ... also, challenge trouble not fixed yet in v3.1beta1 (:

[NoQ]

By the way, how exactly do we produce cyborg engineers?

Code: Select all

buildDroid(struct, "Truck", "Cyb-Bod-ComEng", "CyborgLegs", "", DROID_CONSTRUCT, "CyborgSpade");

didn't work, says

Code: Select all

[js_buildDroid] Invalid template Truck for factory A0CyborgFactory

[aubergine]

No idea, but watching this will cheer you up: https://www.destroyallsoftware.com/talks/wat

[Emdek]

aubergine, funny, but if you think about those examples, at least some of them are logical.
Also there are far "worse" examples, more similar to languages like one here, censored by forum...

[Per]

By the way, how exactly do we produce cyborg engineers?

Code: Select all

buildDroid(struct, "Truck", "Cyb-Bod-ComEng", "CyborgLegs", "", DROID_CONSTRUCT, "CyborgSpade");

didn't work, says

Code: Select all

[js_buildDroid] Invalid template Truck for factory A0CyborgFactory

That should work. Can you open a bug ticket for it?

[NoQ]

Done: #3133 (:

[NoQ]

What are the return values of functions like orderDroidBuild or buildDroid?

Cause i just noticed that i intuitively rely on them to return true if the order was successful and false if it's impossible to comply, which sometimes seems to be wrong (?)

[aubergine]

I'd also like to better understand the return values of the various functions. I was trying to work out what they'd be from the .cpp files, but I don't know C++ well enough to work out what's going on.

[Per]

I'm currently a bit too busy with apartment renovation to do much with the source, and my dev box is down, but in general, if you look in the c++ source, anything that has 'return QScriptValue();' returns nothing, and anything with 'return QScriptValue(true);' or 'return QScriptValue(false);' returns a boolean result value.

If you find such things missing in the documentation, I'd be happy to take patches to improve it.

[aubergine]

Ah, cool - it was the QScriptValue() that I wasn't sure about and your post above explains how that works so I can work out the rest.

[Emdek]

Information on what script returns (especially if those are objects / arrays) is "must have" in documentation (only other useful things are examples, but those should wait for completion of current scripting redo phase - initial porting to JS).

[Goth Zagog-Thou]

Looks like the time has come to convert Cam 4 to the new scripting engine.

Are there any unimplemented functions that might hinder this process yet?

[Emdek]

AFAIK campaign related functions are not done yet.

[Per]

Many campaign related functions have been ported already, but few of them tested - at all. If you want to help out, testing these functions would be of good help to getting the campaign side of things moving along. Then of course there are many campaign functions that are not yet ported, such as no function yet for adding a message, playing a video, etc..