Chapter #1: what’s inside the pack
Once you receive your purchased copy of MD Gacha Machine Script for Events and unpack it, you will find:
- MD Gacha Machine Script, with copy-only permissions (for hoster)
- MD Gacha Machine Online Services HUD (for hoster)
- MD Gacha Machine Script [for participants], with transf & copy permissions (for participants)
The first script, called MD Gacha Machine Script, is meant to be used by event’s hosters whom wants to participate to their own events or just have a standalone gacha machine. While the MD Gacha Machine Script is the script itself for gachas, the Online Services HUD is necessary to register and login the MD Labs Online Services website which will be used to create and manage the hosted events.
A complete user manual which covers details about standalone gacha machine’s script and basic usage of Online Services HUD can be found here
Chapter #2: Participant’s script
The MD Gacha Machine Script for participants comes will transf & copy permissions because it’s designed to be the one sent and used by event’s participants.
The MD Gacha Machine Online Services HUD is not included but can be retrieved by any participants through the ‘Get HUD’ button present inside the gacha’s menu. The usage of the HUD is optional for event’s participants: having an account at MD Labs Online Services website will allow them to view all the stats of their gachas and events they are participating, as well as manage some aspects of their machines.
Event’s hoster should provide (by sending or selling) the MD Gacha Machine Script [for participants] to all event’s participants, but before doing so a permission’s change is requested: in order to work, infact, the MD Gacha Machine Script’s next owner permission MUST be changed to copy-only.
If an event’s participant receives the script with a different permission set other than copy-only, the script will send out an alert message and will not work.
Once the participants receive/purchase the MD Gacha Machine Script (configured with the right permissions), they can drop the script into the machines and perform the setup. At this point, an hosted event must be created.
Chapter #3: Creating an hosted event
In order for the partecipants to be able to use their copy of MD Gacha Machine Script, a valid event must be created by the hoster through the Online Services website. Hoster should log in the Online Services website and select “MD Gacha Machine” from the drop down list on called ‘Products’. At this point the page will load, composed by two main tabs:
- ‘My Gachas’ tab, containing all the data regarding gacha machines owned by the hoster.
- ‘My Events’ tab, containing all the event created and hosted.
Clicking on the ‘My Events’ tab will present the list of all hosted events, with name, region, start/end date, profit and status; also in this page it’s possible to find a link to create a new hosted event.
In order to create a valid hosted event, there are some rules and constraints that need to be satisfied:
- A specific event can occur only at one region
- A region can run only one event during a specific period
- An event must have a valid start and end date
- An event duration must be between 1 to 60 days
This means only one event per time can be created and run in a specific region, during a specific period. Clicking on the ‘Create Hosted Event’ link will start the wizard, where some data will have to be provided:
- Event’s name: the name that will be used for the hosted event;
- Event’s region: the region where the event will occur;
- Event start date/time (SLT): the date & time when the event’s participants will be able to setup their machines, in Second Life Time (SLT). All the transactions made from this moment and before the event effective start date/time will be considered as test transaction and not counted on the event’s total sales. Here some additional constraints are applied:
- It’s not possible to set a start date in the past from the moment the event is being created;
- It’s not possible to set a start date more than 30 days in advance from the moment the event is being created;
- Event effective start date/time (SLT): the date & time when the event will effectively start, in Second Life Time (SLT). All the transactions made from this moment and before the event end date/time will be considered as valid transaction and counted on the event’s total sales. Here some additional constraints are applied:
- It’s not possible to set a start date in the past from the event start date;
- Event end date/time (SLT): the date & time when the event will end, in Second Life Time (SLT). Here some additional constraints are applied:
- It’s not possible to set an end date more than 60 days after the start date;
When all data are provided correctly, the new event will be created and all the gacha machines present in the specified region and running the MD Gacha Machine Script for participants will be automatically associated to it.
Please note: the participant’s gacha machine will not work if:
- No hosted event exists on the region where the partecipant’s machines are rezzed;
- The hosted event’s start date/time is not reached yet;
- The hosted event’s end date/time is surpassed;
Chapter #4: Event’s statistics
Once the hosted event is successfully created, it will be listed into the ‘My Events’ tab along with all the past events occurred. For each event it’s possible to see some basic information:
- Event name: the name associated to the event;
- Region: the region where the event is run;
- Start date/time (SLT): the time when the event start, in SLT format;
- End date/time (SLT): the time when the event end, in SLT format;
- Total sales (L$): total profit made during the event by all partecipants through their gachas;
- Status: the event’s status (open/close);
Clicking on the event’s name will load the corresponding sales summary page; this page contains all the sales data regarding the event grouped by partecipants or gacha machines and also a graph to display the values in a more effective way.
Right below the graph, the sales data are presented into a table, reporting the store/owner, the profit made in L$ and the % of total sales represented by that profit.
Using this tool, the event’s hoster can check anytime during the event or once the event has ended which stores or gacha are selling the most, being able to get a detailed view of the event.
Please note: while the graph is always shown for the hoster to get an idea of the event’s trend, by default the detailed partecipants’s profit and % of total sales are hidden. This is made for a privacy reason, since not all partecipants may be willing to share their sales data; the partecipants will have to explicitly decide to share their data with the hoster of the event they are partecipating. When data is hidden and not shared, the values are replaced with a dash ( – ).
In order to share their data, partecipants will have to log in the MD Labs Online Services website and go to MD Gacha Machine page; selecting the ‘view by event‘ they will be able to see a complete list of all events – hosted or not – they are partecipating. By clicking the checkbox they will enable or disable the sales’s data sharing with the hoster for the corresponding event.
Chapter #5: End an hosted event
Once an event is running, the hoster can decide to close it before time. Inside the tab called ‘my events’, a button is displayed at the end of each running (open) event’s row: by clicking on it the hoster will be asked to confirm the event end.
Important: as an event is closed all the gacha machines (belonging to participants and/or to the hoster) associated to the event will stop working immediately.
Even after an event is closed all the statistics and sellings data will be preserved and the hoster will always be able to access them.