Current documentation + mysql functions

[Szaman]

Hi,

I would like to write some script's for Soldat server, but I have some problems with finding current documentation of script engine. Or maybe, just a list of functions with parameteres.

Can you, please, help me ?
I was reading the http://devs.soldat.pl/index.php/Main_Page page but I think it has not all of available functions (for example for MySQL).

Maybe I could help in creating documentation in some way ?

Also - the new script engine provides structures, like TActivePlayer (http://devs.soldat.pl/index.php/TActivePlayer). How does this match to the "good old" GetPlayerStat (http://devs.soldat.pl/index.php/GetPlayerStat) and so on ?

Thank you in advance for help and response

Best regards,
Peter.

[JotEmI]

Documentation for old ScriptCore 2.0 can be found here http://devs.soldat.pl/index.php/Server_Scripting.
The structure TActivePlayer that you refer to is a part of the new ScriptCore 3.0 which isn't documented yet, Falcon is working on that.

Both ScriptCores 2.0 and 3.0 don't support MySQL at this moment (afaik, Falcon didn't mention anything about MySQL in 3.0 so I assume it isn't supported). Some time ago EnEsCe added it to the server but those changes were reverted.

You can wait for Falcon to fully document 3.0 and use old ScriptCore 2.0 for now.

[Falcon`]

TActivePlayer properties named by GetPlayerStats stat "ID" are mostly matching each other. Except of fact that they're returned in target type, not some idiotic Variant.

[Szaman]

Thank you both for your replies.

@FalconPL: Yes, I've noticed that they are quite similiar, but is there any example how to use that TActivePlayer instead of GetPlayerStat() ? Or it will be attached in newly created documentation ? Could you, please, estimate somehow, when we (community) can expect (maybe just partly) finished documentation ? A week ? Month ? Can I help you in any way with that ?

@JotEmI: Yeah, I've read that page. It is very useful But - as you said - it is about SC 2.0.
Oh, I am nearly sure, that somewhere I've read about those functions (some changelog or sth). Maybe it was EnEsCe post about adding those features. Can I ask, why did you removed those functions ? How can I perform such operations now ? Can I attach for example some DLL ?

I've read somewhere that multi-threading is now disabled. What is an equivalent for that now ?

[JotEmI]

[...]Can I attach for example some DLL ?

I've read somewhere that multi-threading is now disabled. What is an equivalent for that now ?

Yes, you can use external DLLs. There you can have MySQL support, multi-threading, whatever you like. Check http://www.chmlib.com/ISetup/topic_scriptdll.htm for syntax.

[Falcon`]

@FalconPL: Yes, I've noticed that they are quite similiar, but is there any example how to use that TActivePlayer instead of GetPlayerStat() ? Or it will be attached in newly created documentation ? Could you, please, estimate somehow, when we (community) can expect (maybe just partly) finished documentation ? A week ? Month ? Can I help you in any way with that ?

Documentation is already almost complete. It misses some parts of File API and config file documentation + maybe some introduction page. I'll work on these next week.

@JotEmI: Yeah, I've read that page. It is very useful But - as you said - it is about SC 2.0.
Oh, I am nearly sure, that somewhere I've read about those functions (some changelog or sth). Maybe it was EnEsCe post about adding those features. Can I ask, why did you removed those functions ? How can I perform such operations now ? Can I attach for example some DLL ?

EnEsCe made his 2.7.3 and then left without a word more or less. Code he wrote never reached us, the new dev team. So, as a result, features he added are gone.

I've read somewhere that multi-threading is now disabled. What is an equivalent for that now ?

Multi-threading newer was a part of scriptcore. ThreadFunc() was just some really bad joke, the only thing it was doing properly was crashing the server. Scriptcore just isn't threadsafe, i don't know when i'll be working on this, if at all.

[Szaman]

Yes, you can use external DLLs. There you can have MySQL support, multi-threading, whatever you like. Check http://www.chmlib.com/ISetup/topic_scriptdll.htm for syntax.

Thanku you But how could I call a function originated in script-core, for example change team of player from the DLL function ? How do I reference it from DLL ?

@FalconPL: Oh, nice Thank you for this info and generally - for your work on that documentation
That's very bad that EnEsCe haven't shared this code Hmm... in my opinion, the multi-threading feature is very useful but if it's hard to develop then we must accept ScriptCore as is

[JotEmI]

Yes, you can use external DLLs. There you can have MySQL support, multi-threading, whatever you like. Check http://www.chmlib.com/ISetup/topic_scriptdll.htm for syntax.

Thanku you But how could I call a function originated in script-core, for example change team of player from the DLL function ? How do I reference it from DLL ?

I guess you can't, you can only reference DLL from your script and pass whatever info is needed to it, then check the result and act accordingly.

[Szaman]

Yes, you can use external DLLs. There you can have MySQL support, multi-threading, whatever you like. Check http://www.chmlib.com/ISetup/topic_scriptdll.htm for syntax.

Thanku you But how could I call a function originated in script-core, for example change team of player from the DLL function ? How do I reference it from DLL ?

I guess you can't, you can only reference DLL from your script and pass whatever info is needed to it, then check the result and act accordingly.

That's what I thought Thanks for that idea with acting depending on DLL function result.

[Falcon`]

If you're looking for mysql library then there are some already out there.

[Szaman]

Yeah, I've spotted that libdb. Thanks for SoldatSOCI I will try them

Are there, in ScriptCore 3, some network functions (sockets, etc.) but with non-blocking receiving (due to no multi-threading) ?

[Falcon`]

No

[Szaman]

Ok. Thank you very much for help
For now, I don't have any more questions

[Szaman]

@FalconPL: Falcon, maybe you had a chance to finish that new documentation recently ? I would be very grateful if there would be full documentation of SC3 available.

Best regards,
Peter.

[Falcon`]

http://devs.soldat.pl/index.php/Script_Core_3

[Szaman]

Thanks But I am looking for some more complex examples how to properly use those objects. Are those old functions like "OnJoinGame" are still recommended to use or shoud I search for an equivalent somewhere in those classes (like TGame)? Is mixing of those classes and "old" functions is possible ? What is the sequence of executing those handlers (old functions and class methods) - which one is executed as first one ? Does changes provided by "old" functions are immediately visible by this "classes" interface ?

Best regards,
Peter.

[Falcon`]

Are those old functions like "OnJoinGame" are still recommended to use or shoud I search for an equivalent somewhere in those classes (like TGame)?

You should search for equivalent.

Is mixing of those classes and "old" functions is possible ?

Yes, if you turn on legacy mode (see config file page)

What is the sequence of executing those handlers (old functions and class methods) - which one is executed as first one ?

First legacy handlers are executed, then new ones.

Does changes provided by "old" functions are immediately visible by this "classes" interface ?

Yes.

[Szaman]

Ok. Thank you very much for your response