There have been some questions about this lately so I'm putting together a post that describes this in detail along with where it's headed. This post can then be updated as the feature is updated.
As of the June 2012 release of Mythruna, here is how plug-ins can be installed:
Below when I describe a directory, it is relative to where Mythruna is installed and is not created by default. So when I talk about a "mods" directory, I'm talking about a yet-to-be-created sub-directory underneath where you installed Mythruna.
So, if you have:
C:\SomePath\MythrunaThat has the Mythruna.exe in it then I mean:
C:\SomePath\Mythruna\modsAlso note, unless otherwise specified, the script/plugin search is recursive. So if you install a plugin script under mods/scripts/foo/bar the script manager will still find it. This is a nice way to keep plug-ins isolated if they have lots of scripts and data files... plug-in authors should consider this when packaging their plugins. Unzipping a zip into the mods/scripts directory may be all that's needed.
Client-side pluginsRight now there are three different kinds of scripts that go in three different places (this will change someday).
UI Scripts:
These are scripts that are run on the client for either single player or multiplayer. They can be used to tweak key mappings or add console commands like the /trees and /flora commands.
They go in:
Dialog scripts:
These are dialog related scripts (like the help file but can be used for any interactive clickable conversation) used by other scripts.
They go in:
Plug-in scripts:
These are the general purpose scripts that are run during single player games. They can add commands, tools, game-mode objects, etc.. This is really the heart of the plug-in system as of this version.
They go in:
Server-side pluginsThe server only has dialog and regular plug-in scripts. They are essentially the same as for the client/single player versions except that are used by the server during multi-player games. They can still add tools, commands, game-mode objects, etc..
Dialog scripts go in:
dialogPlugin scripts go in:
scriptsSo if you have your stand-alone mythruna server installed in:
C:\MyGames\Mythruna-serverYou would make:
C:\MyGames\Mythruna-server\scripts...if you wanted to have a place to put multiplayer plugins.
Additional LibrariesIt is possible for a plug-in script to use additional libraries and that plugin may then require that an additional library directory is added. In this case, there will be an additional "lib" subdirectory relative to the plug-in script that contains .jar files that the plugin requires.
The FutureSoon, users will not need to involve themselves in any of this. They will at worst have to put a plugin file in the already-created plugins directory and then "install" it through the mythruna game interface... either client or server. These would be packaged as .jar files and include everything that the plug-in needs along with dependency information if it needed some other plug-in installed first.
So from a users perspective, all of the hard parts would be taken care of and the plugin (along with author, version, etc.) will just appear in a list in the in-game Plugin Manager screen. When they create new worlds they can choose to use the plugins or not.
...but today, we still have to hand create directories and copy script files.
