LUA Plugins for Torque

torque.abigholeintheweb.com/public_system/useruploads/lua_plugin.zip

This code will allow you to easily add plugins/addons to your game similar to World of Warcraft. Users can drop scripts into their addon folder and they will automatically load.

This resource is designed allow users restricted access to your game functions. It is not intended to be a replacement for TorqueScript, but rather a sandbox environment. You must specify the game functions you want to expose to your players.

Installation
Place the LUA directory inside your engine/libs folder.

Add "../lib/lua" to C++/General/Additional Include Directories
Add "lua.lib" to Linker/Input/Additional Dependencies

Add luaManager.h and luaManager.cc to your project

Add lua.cs to your game's client directory. Add exex("./lua.cs") inside your initClient() function.

Add loadAddons() to the end of initClient().

Usage
Place LUA scripts inside the addon directory. You can change the default directory in lua.cs loadAddons().

You can expose new available functions to the plugins by adding them to the registerFunctions() C++ functions. Note: You must then implement the new function above it. See the print command as an example.

You can create new events from TorqueScript by using the lua_event function. Example:

lua_event("onDamageDone", %damageDone, %againstName, %playerName, %hitType, %damageType);

In this example, this code would be placed where your client processes the combat damage log it recieves from the server. The corresponding LUA code would look like:

function onDamageDone(damageDone, attackerName, defenderName, hitType, damageType)
    print("You did " .. damageDone .. " damage!");
end

You can create as many events in script as you want. LUA scripts that do not implement the corresponding functions are simply ignored.

If you want to call a function on only one specific script, you can use the luaFunction script function. The first parameter is the script number you wish to call. You can pass the script number to TorqueScript using:

int scriptNumber = LuaManager::getStateIndex(L);