Zugg Software :: View topic - Hmmm... is there a list of predefined zs.* for lua purposes?

Posted: Mon Oct 13, 2008 2:46 am

I'm curious... it'd make things a bit more interesting if I could use lua for some things, but don't know where to start with the zs.* bit at all... perhaps someone can point me in the right direction...

Charneus

Magician Joined: 25 Oct 2000 Posts: 461 Location: USA

As you can see from my other post, I'm clearly not the authority on LUA integration yet, but the help file you are looking for is 'zs Object'. For pretty much every object in cmud (aliases, triggers, functions, variables, etc) there is a corresponding LUA table of the form zs.<whatever> (zs.alias, zs.trigger, zs.func., zs.var) that lets you get at it.

Posted: Mon Oct 13, 2008 8:20 am

Full docs here, list of zs functions and objects here.

Beginner Joined: 19 Nov 2008 Posts: 14

I'm having some trouble enabling and disabling triggers via a lua script. I did some reading and searching. In this thread http://forums.zuggsoft.com/forums/viewtopic.php?t=27719 the syntax :

Posted: Wed Nov 26, 2008 7:05 am

Firstly, you need to use zs.gettrigger() and not zs.trigger(), because they do very different things.

Secondly, there's a bug in the current version where the zs.gettrigger() function where it doesn't return settings by name if they're disabled - so once you've disabled it, there's no way to enable it again by name. If you store the trigger object in a variable (as in the first code example above, like t=zs.gettrigger("something");t.enabled=0;t.enabled=1) or refer to it by its ID number, returned by the index property (so index=zs.gettrigger("something").index;zs.gettrigger(index).enabled=0;zs.gettrigger(index).enabled=1) then it should work properly.

Apprentice Joined: 18 Feb 2007 Posts: 190

its fixed mate, zs.get* functions work on disabled settings now

Posted: Wed Nov 26, 2008 12:54 pm

I stand corrected; it's just that you need to use gettrigger() instead of trigger()

Wizard Joined: 17 Jun 2006 Posts: 1201

zs.trigger("id").enabled = false works to disable an alarm.

I don't see anything in the help files regarding zs.trigger(). There is only zs.gettrigger() and zs.maketrigger() and zs.numtrigger(). Where is the information regarding zs.trigger()????

Posted: Mon Jan 12, 2009 12:20 pm

zs.trigger() is the %trigger function (or perhaps the #trigger command, I can't remember). When you try to use zs.xxx, CMUD first looks to see if there's a Lua-specific function with that name, like the getyyy, makeyyy, numyyy functions, or the aborted or isvalid properties (full list of those is in the docs). If there's no Lua-specific function for a particular string ("xxx" in this case) then CMUD will look for zScript commands with that name. If there's no command, then it'll try zScript functions.

I can't remember if that's the order the lookups are in, but I know it looks up both. I can't remember if it looks up variables as well, or if you have to return them with zs.getvar() - try it and see. You can force a command or function with a particular name with zs.cmd.xxx or zs.func.xxx.