Skip to content

System Menu Plugins

LeonaMorro edited this page Nov 28, 2017 · 2 revisions

nPose contains some (menu)plugins that are already built in and can be called from within a NC with the command PLUGINMENU or via a custom script with linkMessages. These are:

Plugin name (to be used with PLUGINMENU)
npose_unsit
npose_changeseat
npose_pickseat
npose_offset Shows a menu with with buttons to be used to adjust your offset.
npose_menu Advanced: use this to inject buttons into another menu plugin

npose_unsit

Shows a menu with with buttons for the seats and unsits someone if you click the button.

PLUGINMENU|npose_unsit[|filter]

See filter

npose_changeseat

Shows a menu with with buttons for the seats and moves you to the seat if you click the button.

PLUGINMENU|npose_changeseat[|filter]

See filter

npose_pickseat

Is interaly used by npose_unsit and npose_changeseat. You may want to use it, if you need more options than npose_unsit or npose_changeseat offer.

PLUGINMENU|npose_pickseat[|menuParams[|actionParam]]

menuParams is a comma separated list with can contain multiple parameters

parameter number
0 filter
1 highlight: Can be a seat number or a avatar uuid. Surrounds the corresponding button with ⚫
2 text to show: Can be used to set the prompt of the dialog box.

actionParam can be:

  • the string changeseat to behave like npose_changeseat
  • the string unsit to behave like npose_unsit
  • an integer value to send a linkMessage with the given number, the string seatNumber|avatarUuid and the menuUserUuid as key

Filter

A filter is used to include or remove some buttons from the npose_unsit, npose_changeseat or npose_pickseat menu

OPERATORS (listed in order of their precedence)

Operator Description
! means a logical NOT
& means a logical AND
~ means a logical OR

Operators may be surrounded by spaces

KEYWORDS (case insensitive)

Keyword Description
owner matches the seat where the object owner is sitting
group matches the seats where avatars with the same active group as the object are sitting
occupied matches all occupied seats
ownseat matches the seat the menu user is sitting
any integer counts as a seatNumber
any string that begins with a "@" is a macro, which gets recursivly parsed
any other string counts as a permission registered by a plugin, see User Defined Permission