Contents

Support Managers

Aerielle Kiyori
English
offline
Anomelli Mellow
English
offline
show offline managers  
English, Hindi, Russian  

SSTI_SERV_EVENT_BOX_CUSTOM_BUTTON (SSTI API Event)

Tenant has clicked on custom menu button in box pop-up menu.

Variables

The following table shows input values (you send them with the API call) and returned output values.

Variable Required Description
link_message parameters:
num SSTI_SERV_EVENT_CLOUD
str button text
id avatar UUID

Comments

The custom menu button appears here:

SSTI box with menu.png

The button text can be set by using SSTI_API_BOX_CUSTOM_BUTTON command.

Important: the custom button will be removed on every SSTI server restart. Thus, you need to hook to SSTI_SERV_EVENT_INITIALIZED event to set the menu button properly (see the example).

Example

This code sets the custom button:

// Server API
// Commands:
integer SSTI_SERV_API_CUSTOM_BUTTON=-45050001;
integer SSTI_SERV_API_GET_GROUP=-45050002;
integer SSTI_SERV_API_GET_CLOUD=-45050003;
integer SSTI_SERV_API_BOX_CUSTOM_BUTTON=-45050004;
integer SSTI_SERV_API_GET_PARAM=-45050005;
integer SSTI_SERV_API_CUSTOM_HTTP_BUTTONS=-45050006;
integer SSTI_SERV_API_HTTP_REPLY=-45050007;
 
// Events:
integer SSTI_SERV_EVENT_INITIALIZED=-45060001;
integer SSTI_SERV_EVENT_CUSTOM_BUTTON=-45060002;
integer SSTI_SERV_EVENT_GROUP=-45060003;
integer SSTI_SERV_EVENT_CLOUD=-45060004;
integer SSTI_SERV_EVENT_BOX_CUSTOM_BUTTON=-45060005;
integer SSTI_SERV_EVENT_PARAM=-45060006;
integer SSTI_SERV_EVENT_RESET=-45060007;
integer SSTI_SERV_EVENT_LOCALURL=-45060008;
integer SSTI_SERV_EVENT_HTTPBUTTON=-45060009;
integer SSTI_SERV_EVENT_TENANT=-45060010;
integer SSTI_SERV_EVENT_NEW_GUESTPARTNER=-45060011;
integer SSTI_SERV_EVENT_GUESTPARTNER_REMOVED=-45060012;
//
// Set the menu button
setSSTIButton() {
    llMessageLinked(LINK_SET, SSTI_SERV_API_BOX_CUSTOM_BUTTON, "Custom!", NULL_KEY);
    llOwnerSay("SSTI button set");
}
 
default {
    state_entry() {
        // Set the menu button when this script restarts
        setSSTIButton();
    }
 
    link_message(integer sender, integer cmd, string str, key id) {
        if(cmd == SSTI_SERV_EVENT_INITIALIZED) {
            // Also catch the server initialization and re-set the menu
            setSSTIButton();
        }
 
        if(cmd == SSTI_SERV_EVENT_BOX_CUSTOM_BUTTON) {
            llOwnerSay("Tenant " + (string)id + 
                " has pressed the menu button: " + str);
        }
    }
}

The resulting menu:

SSTI box with menu.png


<< return back to SSTI API reference