Introduction

The new BCDC++ startup.lua v3 creates a totally new Lua interface, which means the old scripts are incompatible with the new API (but those which come with the compiled client are converted). This new interface makes scripting much more easier, because you can use parametrized functions, and you can forget the old setListener calls. In this version, the core calls has been binded to the Lua API, so their names are the same as in C++, and works in object-oriented way.
Every value and function is binded as the field of the dcpp table (namespace). It regards for enumerations as well: they are directly in the dcpp table, not in the corresponding manager's subtable. Every loaded script gets a new, individual namespace, so global variables won't cause name clashes, but it's recommended to use local variables, because they are faster.
Some words about usercommands: dcpp.FavoriteManager.addUserCommand() registers a Lua usercommand, which - when selected - generates an OnOwnMessage(hub,message) event, where the hub is the client object of  the hub we clicked, and the message is the command passed to the call (see usage). You can use every parameter which is avaible on the client in the usual way: %[userNI], %[myTA] and %[hubURL] will work. The only restriction is %[line:] and %[kickline:] dialogs - they are unavaible and can't be used.
Currently just this kind of usercommand-handler implemented, but in the future (when OnPrivateMessageOut will be implemented), the corresponding function will be called (eg. if the command starts with $To: or BMSG ... PMXXXX then OnPrivateMessageOut will be called.) If you want to register a usercommand, put it outside from every function.
When you save a script, please select a human-readable name, and use just latin letters and numbers (thus, [a-zA-Z0-9]), and just one point, before the extension. It's important, else usercommands won't work (Now the extensionless filename identifies the script's namespace, so points are disallowed, because it has special meaning in Lua). 

Avaible commands
/lualist	Lists the currently loaded scripts
/luaload <scriptname.lua>	Loads the given script from the scripts subdirectory. If script is already loaded, then reloads it.
/luaunload <scriptname.lua>	Unloads the given script, but keeps it in the list
/luaremove <scriptname.lua>	Unloads & removes the given script from the list.
/meminfo	Shows some information about Lua interface's memory usage.