next »

[Michael]

Mythruna Pre-Alpha API

This is a documented API I have created for the convenience of having it for everyone, until the new API Paul is working on comes out. This is practically to get everyone started with modding Mythruna, and will be continued until Paul releases his own.

Find the API examples on Github:
Java
Groovy

If you would like to help with the API, you can via Github!

[nh_99]

As a comment on you saying to leave that null on the command, that is FULL command description I think so you can set it to a map(String[] advancedHelp = new String[] { "Hello world!" };) that has that in it.

[Michael]

Hmm, this is a rough draft that a grabbed by looking at the first 2 tutorials that paul gave, and looking at some of his default scripts generated by the server, I am basing everything practically off of mods that people make and the examples Paul has gave. Thanks for the info!

[pspeed]

Yeah, the last argument is the "help" that gets printed when you do "help command" in the console.  It's a String[] basically.

This part of the API will definitely be tightened up soon.  I've learned a lot more about groovy integration since then.

[Michael]

Yeah, the last argument is the "help" that gets printed when you do "help command" in the console.  It's a String[] basically.

This part of the API will definitely be tightened up soon.  I've learned a lot more about groovy integration since then.

Oh, thank you for the help, and by the way, I pulled out 24 groovy scripts from your Mythruna-Core.jar because I remembered when I went looking onto that when I was completely lost about groovy, including when I looked into one of gara's mod and I saw an import I didn't recognize, or a method or something in his code I never saw posted before, and went diggin to all those scripts.

[pspeed]

Yeah, the last argument is the "help" that gets printed when you do "help command" in the console.  It's a String[] basically.

This part of the API will definitely be tightened up soon.  I've learned a lot more about groovy integration since then.

Oh, thank you for the help, and by the way, I pulled out 24 groovy scripts from your Mythruna-Core.jar because I remembered when I went looking onto that when I was completely lost about groovy, including when I looked into one of gara's mod and I saw an import I didn't recognize, or a method or something in his code I never saw posted before, and went diggin to all those scripts.

It's fine to look at these for learning... just remember, I don't always do things the best way in the heat of the moment.

I know most of these scripts will get replaced so sometimes I don't bother to clean them up properly.  As APIs evolved, some scripts still do things the old ways.  Still can be useful in lieu of docs, though.

[Michael]

Ahah, I went to look up how to make javadocs, and then I figured it out! I sat down for a couple seconds like "umm.. wait.., I don't have the source code.." do I need the actual source code of Mythruna to make actual JavaDocs?

[pspeed]

Ahah, I went to look up how to make javadocs, and then I figured it out! I sat down for a couple seconds like "umm.. wait.., I don't have the source code.." do I need the actual source code of Mythruna to make actual JavaDocs?

Pretty much.  Using the javap command you can find out what methods certain classes have but really the farther you stray from what is already called by my scripts the worse off you will be.  Those scripts are already going to change significantly but the Java code is nearly 100% different.

[Michael]

I have started a repository on GitHub for tutorials, ect about this API I got going
https://github.com/Shzylo/Mythruna-Pre-Alpha-API/

Now its midnight, I need to go to bed (but I don't wanna!).

[nh_99]

You need to change the helpInfo thing to String[] helpinfo. String arrays and Strings are 2 different things. Sorry to be a stickler about it, I just want people who are looking at this API stuff to have the right info.

[Michael]

You need to change the helpInfo thing to String[] helpinfo. String arrays and Strings are 2 different things. Sorry to be a stickler about it, I just want people who are looking at this API stuff to have the right info.

I did that, but I found that it bugged for me, I even went too groovy codehaus to make sure I was doing it right. I went and looked into one of Paul's groovy files and this is basically how he had it:

Code:

def help = """\
        This is the help info
        Here is more help info
        """

addShellCommand(shell, "Hello", "Justa test", help) {
    console.echo("Hello World!");
}

I will be doing some other testing after 7, because my grandma has OG&E smart hours, and between hours 2pm - 7pm, its called peak hour in which electricity consumption costs more (today its $0.05 per Kilowatt).

[Sean]

Nice job on the API!

[Michael]

Updated with a fix to one of the examples on github and added correct imports for the methods.

[pspeed]

Now that I think about it, I think the help is just a string and then I split it up on newlines.  The API is defined in one of the groovy files embedded in the game jar so it would be easy to confirm the exact signature of the method.

[Endimmion]

With this API, would it possible to add a sort of "query answer" plugin? You query the server with a certain command/string and the plugin return you the number of players connected, the version of the server....

It could be very usefull for my list (http://mythruna-servers.com/).