! IMPORTANT: The following user manual applies to:
- MD Gacha Machine Script version 3.2.0
- MD Gacha Machine version 3.2.0
- MD Gacha Machine (MESH) version 3.2.0
- MD Gacha Machine (MESH #2) version 3.2.0
When some of the features are available only for a specific version, will be clearly stated.
Chapter #1: initial setup
Depending on the version, the owner will have to either drag the MD Gacha Machine Script in any object or just rez the MD Gacha Machine. Then, a simple click will prompt the debit permission request. This step is mandatory for the gacha machine setup and it’s required to activate several of the script’s features. Clicking on “next” and granting the permission will complete this step.
Once granted the debit permission, the gacha machine is not already setup for working and some other steps are necessary. If a normal user – different from the owner – clicks on the machine at this point, will get a message saying the machine is not yet ready for work. When the owner clicks on the machine a dialog menu will appear: this dialog is called “owner menu” and it is visible only by the owner; through this menu it’s possible to access all the gacha machine’s settings.
The basic setup for the gacha machine is now done, but to make it working a couple of more additional steps are required.
Chapter #1.1: why script needs debit permission
To complete the gacha machine’s setup the owner has to grant the script the debit permission; this allows the script to take moneys directly from the owner’s account. Even though this may sound somehow dangerous this permission is necessary to enable some advanced script’s features; at the same time there are only a few limited occurrences when this permission will be used.
Here are listed all the reasons why the script could use the debit permission:
- Split L$: when the feature is enable, then a money transfer is required from the owner’s account to the splitter’s one.
- Blacklist: if the avatar is blacklisted, then the transaction is canceled and the player avatar is refunded by the amount paid.
- SL issue/hack: when for some issue the amount paid do not match with the price set by the owner, then a refund of the amount paid is performed.
- Event: when the machine is associated to an event having a specific start and/or end time and the player pays the machine outside the working period, then a refund of the amount paid is performed.
- Machine already in use (busy): when the machine is communicating with the server to finalize the current transaction and a player (same or different) pays the machine again, then a refund of the amount paid is performed.
These are the only occurrences when the debit permission will be used, and money will be automatically taken from the owner’s account.
Chapter #2: owner menu
When the owner clicks the gacha machine, the configuration menu is displayed. This particular menu – accessible by the owner only – contains all the settings and options of the gacha machine and allow the owner to setup a machine in a quick and flexible way.
This menu is divided in many sections, some of them leading into other sub menus:
- Set price: set the gacha machine’s play price in L$; the allowed value are ‘0’ (zero) for a free play cost, or any integer value.
- Rares: this button will lead the owner to the rares sub menu, where items contained into the gacha machine can be flagged with a rare category (uncommon, rare, ultra rare) and extraction chance can be picked for any of the listed category. This menu is used also to unflag the items from the assigned rare category.
- Options: this sub menu groups together some advanced features such as profit split, direct pay and special prize. The detail of each features will be explained in the options chapter.
- Appearance: this sub menu interact with the appearance of the gacha machine, prodiving a resize and a color change module. These features will be described in details in the appearance section of this user guide. Please note: the appearance menu is available only on the MD Gacha Machine and MD Gacha Machine (MESH) / (MESH #2) version of this product, no appearance menu is available in the script-only version.
- Online Services: opens the MD Labs Online Services website, where the owner can interact with all the gacha machines. Details about this feauture can be found in the corresponding chapter.
- Update: this button starts the update module, which will look online for a new update of the product and – if found – deliver it to the owner.
- Reset: this button will reset the gacha machine, wiping all the data, including options, price and all the rares.
- Archive: this button triggers a specific feature for machines which are not used anymore; by archiving, the gacha will be removed from in-world keeping all the it’s statistics and transactions accessible via the MD Labs Online Services web page. This will allow store owners to access and analyze the machine’s statistics, while helping them to keep their data sorted and organized.
Chapter #3: basic usage
The basic usage of the MD Gacha Machine is very simple: once rezzed and granted the debit permission, from the owner menu price must be set through the “set price” button, submitting an integer value greater or equal than zero. That will be the cost in L$ users will have to pay in order to use the gacha machine.
The second mandatory step is drop one or more items inside the gacha machine’s content. For this step are very important the owner permission’s on the items: owner must have at least copy permission on the items, that way user will be able to play and get a copy of the items they won. If owner has only transfer permission on one or more items these will be included as well, but a warning message is displayed reminding the owner the item will be removed from the machine if won. As one or more items with the right permissions are dropped inside the gacha and correctly detected, the machine will be ready for anyone to use.
Users will be able to right-click the machine and pay the price to start a game and win a random prize. By left-clicking on the gacha machines, users will receive a list of all items present inside the machine itself, grouped by rarity level.
Chapter #4: rares
The MD Gacha Machine can easily handle up to 3 different category of rare items. with specific extraction change for each category. The rares categories are:
- ultra rare;
In addition to this, the normal items are called “common” items.
Please note: common items does NOT need any additional tag in their name to be correctly detected; the name tags are used only for rare items.
The MD Gacha Machine provides two different ways to mark (or flag) a specific item as rare, assigning it to a specific rare category:
- Automatic flag;
- Manual flag;
The automatic detection of rares works by adding a special keyword (or tag) into the item’s name, so the script will scan for the keyword and automatically assign the item to the corresponding category. The rare category keyword can be added prior to drop the item inside the gacha machine’s content or after, since at any change a new scan will be performed. The keyword can be placed at any point of the item’s name and must exactly be like the following:
- UNCOMMON: mark an uncommon item;
- RARE: mark a rare item;
- ULTRARARE: mark an ultra rare item;
Please note: the keywords must be written exactly like reported above, in capital letters or the script won’t be able to detect them.
When the script is started and each time the content of the gacha machine changes a new scan is performed and the result is written as output in the chat, telling how many items are found for any category.
In addition to the automatic detection – based on items name – a manual one is present as well, accessible through the “Rares” button of the owner menu. The rares submenu lets the owner to:
- assign (flag) an item to a specific rare category;
- remove (unflag) an item from a specific rare category;
- pick an extraction change for each rare category;
- list all the items of a specific rare category;
To assign an item to a specific rare category the owner must hit the “Flag Item” button and will be asked to select which category will the item be assigned to. Once picked the desired category a list of all “available” items is shown for the owner. Items are considered “available” when they haven’t been assigned to any rare category yet, namely when they are “common” items. When the selection is made, the picked item will be assigned to the specified category and removed from the “available” list.
The workflow to remove an item from a specific rare category works very similarly to the one described above: first the owner must select the rare category to operate on, then a list of all item assigned to that category is shown. When the selection is made, the picked item is removed from the category and assigned to the “available” items, returning to be a common one.
The “Set Chance” button of the rares sub menu allow the owner to select – for each rare category – a specific extraction change, which is the chance for the users to win an item assigned to that specific category. By default all rares the extraction chance are set to 0%. The owner can edit each percentage by submitting any value between 1 and 99%.
Please note: by any logic, it’s a best practice to assign a lower extraction chance to a rarer item’s category. This means ultra rare chance should always be the smallest one, followed by rare and then uncommon.
There are still two very important considerations to be done on rare items and win chances:
- If a win chance for a category is set – i.e. 10% for rare items – but no items of the specific category are inside the machine, then the win chance for the category is automatically set to 0.
- The win chance is associated to the rare category and not to the single item; if the win chance for the rare category is set to 10%, then there is the 10% of chances that one rare item among all the ones inside the machine will be picked as prize:
- If the machine contains only 1 rare item, the chance to win the prize is 10%;
- if the machine contains 2 rare items, each rare has a 10/2 = 5% of chance to picked, while the chance to win a rare prize is still 10%.
- if the machine contains 3 rare items, each rare has a 10/3 = 3,33% of chance to be picked, while the chance to win a rare prize is still 10%.
Chapter #5: options
In the option sub menu is possible to find some additional features aimed to enrich the experience with the gacha machine.
- Split L$: this feature allows the owner to split the earnings from the gacha machine with up to two different avatars. Clicking the Split L$ button will prompt a dedicated sub-menu, where the owner will have to select which split to setup among first and second; after this first choice, the owner will be asked to type the name or UUID (avatar key) of the avatar whom is going to split the profit with, and pick a split percentage between 0% and 100%. If both steps are done correctly, each time a user pays the gacha machine to start a game, the profit is splitted with the avatar declared and the L$ immediately payed out. When this option is active a “check” sign will appear in the corresponding button of the menu and details will be listed in the menu’s header; hitting another time the ‘Split L$’ button will disable the feature for the chosen splitter.
- Direct Pay: this option set the machine in pay-only mode, allowing users to pay the machine directly by clicking on it. If this option is enabled, no prize list will be sent on touch, since the only users’s possible interaction with the machine is the payment.
- Special: this option enables the feature to gift a ‘special’ prize to users whom played with the gacha a certain number of times. By clicking the button the owner will be asked to submit the number of pulls after which the special prize will be gifted. Please note: only one special prize is allowed and the special prize must contain the keyword ‘SPECIAL’ (without quotes and in upper case) in its name, or the script will not be able to find it.
Chapter #6: appearance
This sub menu brings two important features aimed to change the gacha machine’s appearance.
Please note: the appearance sub menu is only present in the MD Gacha Machine and MD Gacha Machine (MESH) versions, and it is not present in the MD Gacha Machine Script version.
- Resize: let the owner resize the gacha machine.
- Set color: the owner can pick among 12 different color to apply to the gacha machine.
Chapter #7: MD Labs Online Services
MD Labs Online Services is a responsive website, accessible from any platform from mobile devices to desktop computers, which allow to interact with the products released by MD Labs. Here’s a quick overview of what the the MD Gacha Machine owner will be able to do:
- Get a quick overview of all the gacha machine, with locations where they are rezzed, total number of plays and total profit;
- Rename and reset a specific machine;
- Delete a specific machine or multiple machines at once, including all the transactions performed;
- See the transactions list for any gacha machine, including player name, play cost, item won, item’s category, play date-time;
- Create events and assign them to the machines;
- Create presets and assign them to the machines;
- Add one or more users as managers – with several permissions levels – allowing them to access the store’s data and interact with the machines;
Chapter #7.1: Register an account and activate the product
Before accessing the website for the first time, the owner must register an account and activate the service. In order to do so, an Online Services HUD is provided inside the MD Gacha Machine pack.
Once attached the HUD, there are 2 simple steps to follow:
- Click on the user icon of the HUD, and type a password for the Online Services login.
- Click on the check icon to activate the MD Gacha Machine for the Online Services.
At this point it’s possible to open the MD Labs Online Services website and simply log in.
Chapter #7.2: MD Gacha Machine homepage – a quick overview
Once logged in the MD Labs Online Services website, it is possible to access the MD Gacha Machine section from the ‘Products’ dropdown list on the top of the page. The page that will load is the MD Gacha Machine homepage and will look similar to this one:
As first thing to notice, the webpage is divided into 5 different tabs (right under the top bar), each one containing specific features:
- Gachas: it’s the main tab, from here is possible to access the store’s data as well as to a list of all rezzed machines and the detailed transactions list of each of them.
- Events: this second tab is dedicated to listing all the created events, showing the number of pulls, the profit made and also access the event’s transactions list. Hosted events – run by the store owner – are displayed here too and their specific data is accessible clicking on the detail page.
- PLEASE NOTE: to create and host gacha events MD Gacha Machine Script for Events is required.
- Presets: this tab contains all the created preset for the machines; from here it’s possible to create, edit and remove presets, as well as apply them to the gacha machines.
- Managers: this tab lists all the store’s managers, with detailed info about their permissions; from here it’s possible to add and remove managers, as well as change their permissions levels.
- Blacklist: in this tab are listed all the avatars who have been banned from the store. Once blacklisted, an avatar cannot play any gacha machine and receive any prize from it.
- Archived: this tab lists all the archived machines, the ones that are not used and/or not rezzed anymore in-world. Archiving the machines help keeping data sorted and consistent.
Chapter #7.3: Gachas tab
The Gachas tab is the first tab present inside the MD Gacha Machine homepage and it is probably the most important one; this tab lists all the rezzed machines showing an overview about their statistics, as well as giving several tools to analyze the store’s data and sales.
At the top of the page there is a Store panel listing the user’s store and eventually all the other stores where the user is manager. To switch from a store to another simply select a new store from the drop down list: the page will refresh and load with the selected store’s data.
Below the store panel there is the graph panel: the data represented here will vary based on the current view selected. The default view is “by gacha” and the graph will show a pie chart with all the machines and their profit. Further below, the tools panel and the gachas list give access to the main features of this tab.
The Tools panels groups together some useful tools to analyze and manipulate the machine’s data. The most important tool of this section is the ‘view‘ drop down list which allow to group, sort and view the data in several ways:
- by gacha: this is the default view, useful to analyze the number of pulls and profit made by each machine;
- by region: through this view is possible to analyze which regions generate the most profit;
- by day: this view is useful to analyze the daily profit made by the gacha machines;
- by month: this view is useful to analyze the monthly profit made by the gacha machines;
- by year: this view is useful to analyze the yearly profit made by the gacha machines;
- by player: through this view is possible to analyze the profit made from each player;
- by category: this view is useful to analyze the profit made through each item’s category;
- by prize: through this view is possible to analyze the profit made from each machine’s prize;
When switching from a view to another, the page will reload and update to show all the data (including graphs) accordingly to the selected view mode.
Other useful tools are the ‘delete selected‘ button, which allow the deletion of multiple machines at once, and the ‘export‘ button, which allow to export the data from the current view.
Below the Tools panels there is the last – and most important – section of the gachas tab: the gachas list. Here all rezzed machines are displayed, each one with several useful information and ways to interact with them:
- Machine Name: the name of the gacha in-world. Clicking on the name will load the details page for the corresponding machine, containing both the complete transactions list, play stats and settings.
- Machine Region: the region where the gacha is rezzed in world. Clicking on the region’s name will load the details page for the corresponding region, listing all the transactions occurred in the region by all machines rezzed there.
- Plays: the number of pull made on the corresponding gacha.
- Profit (L$): the amount in L$ made by the machine.
- Event/Fair: this info allows the owner to assign a machine to a specific event previously created. The event feature is a very handy and useful way to keep track of the income made by participating at SL events, allowing to see the most profitable ones at a glance. Clicking on the event’s name will load the details page for the corresponding event, listing all the transactions made by gachas which were assigned to it.
- Last Sync: the last time the machine contacted the MD Labs server to update its status.
- Machine’s settings: clicking on the cog icon will load the details page for the corresponding machine, containing both the complete transactions list, play statistics and settings. From here is possible to change the machine’s settings and they will be automatically applied in-world.
- Machine’s operations: clicking on the three-dots icon will open a secondary menu containing several additional operations to perform on the corresponding gacha. These operations include delete, rename, reset, merge and much more. More details about it in the the dedicated chapter.
Chapter #7.4: Additional operations
While the data view is set to ‘by gacha‘, is possible to perform some additional operations to the machines; all these features are accessible by clicking the 3-dot icon on the right of the machine’s list. A drop down window will appear with the following options:
- Rename: rename the corresponding machine in-world and on MD Labs Online Services;
- Reset: reset the corresponding machine in-world;
- Archive: archive the corresponding machine, removing it from in-world (if present);
- Merge: merge the corresponding machine with another one, associating all the transactions to the new machine and removing the old one from in-world and from MD Labs Online Services;
- Delete all transactions: delete all the machine’s transactions;
- Delete: delete the corresponding machine in-world and from MD Labs Online Services, removing also all the transactions and settings;
Chapter #7.6: Machine’s details: play list
Depending on the data view chosen (by gacha, by region, by date, etc) is possible to view and analyze different kind of data; the most important is the data view ‘by gacha‘, the default one. When this data view is selected, a list of all machines rezzed is presented along with the region, the total pulls and total profit made by each gacha. By clicking on the machine’s name the details page for that specific gacha will load, and will look like this one:
The page is divided into three tabs:
- play list: this tab contains the complete list of the machine’s transactions;
- play stats: this tab contains several statistics about how the machine is used, such has top players, most given prizes and so on;
- settings: this tab holds the machine’s settings;
IMPORTANT: keep in mind that the details page is contextual to the data view selected in the MD Gacha Machine Homepage. This means – for example – that if the data view is set to ‘by gacha’ clicking on the machine’s name will load the details page for the chosen gacha, containing all the transactions made by the machine itself. Differently if the data view is set to ‘by region’ clicking on the region’s name will load the details page for the chosen region, containing all the transactions made in the region, independently from the specific gacha which made it. Moreover, if the data view is set to ‘by day’ then clicking on the date will load the details page for the specific day chosen and containing all the transactions made on the day, independently from the specific machine or region where occurred.
The first part of the ‘play list‘ tab contains an useful graph showing the daily profit for the selected machine; below this graph two other panels are present, containing the tools and the play list.
The ‘tools‘ panels provides some useful instruments to filter, manage and analyze the machine’s data; it is possible in fact to filter and see only the transactions made during a specific period, show/hide the free plays, delete multiple transactions at the same time and export the play list.
The ‘transactions‘ panel is the main panel of this page and presents a complete list of all the transactions (or plays) made on the machine; for each transaction the following data is displayed:
- Player’s name;
- Machine’s region;
- Price paid for the play;
- Item won as prize;
- Rare category of the item won;
- Play’s date & time;
- Delete button: this feature allow the owner to completely remove the corresponding transaction, updating also the machine’s statistics (total plays and total profit);
Chapter #7.6: Machine’s details: play statistics
When the data view is set to ‘by gacha‘ a second tab is present inside the detail page, name ‘play stats‘. There are three main panels in this tab, each one presenting different statistics about the gacha’s usage; it is important to notice and keep in mind that the data presented in this tab is calculated from the machine’s utilization and not taken from the machine’s settings.
The first panel presents the top players for the corresponding gacha:
The second panel presents the prize distribution for the corresponding gacha, showing the percentage of extraction for each prize related to the overall pulls made:
The third panel shows the rares distribution for the corresponding gacha. For an high number of pulls, the value shown here – uncommon / rare / ultra rare win chance – should approach the ones defined in the machine’s settings.
Chapter #7.7: Machine’s details: settings
The third tab for the machine’s details contains the machine’s settings; from here is possible to configure and interact with the machine in-world, assigning and changing the settings directly from this panel.
Chapter #7.8: Events tab
Back on the MD Gacha Machine homepage the second tab is called ‘Events‘ and offers a view of the events created by the owner and for each shows some useful statistics.
The primary scope of MD Labs Online Services is to offer a valid tool to interact with the machines in-world and analyze the data generated; events are an important part of this data infrastructure.
You can think at events as virtual tags that can be assigned to one or more gacha machines; each event is composed by the following data:
- Event name: an unique name that identifies the event;
- Event start time: this data is optional and represent the moment when the event starts;
- Event end time: this data is optional and represent the moment when the event starts;
While an event can have an unlimited number of machines associated, each machine can be assigned to only one event at time. Why events are useful? The feature was created to meet the needs of organizing and managing gachas in an era where SL events are more and more often on everyone’s agenda. Often, a store owner participates to several events monthly and it is very important to understand which ones are the most profitable and which aren’t.
Specific data is generated for the event itself, such as total profit and total plays: this means that – if several machines are assigned to a single event – the event’s total profit generated will be the the sum of all the machine’s profit; the data management is greatly simplified and the owner has a more detailed view of the selling trends. Another important feature that comes with events is the start / end date-time: when creating a new event is possible to define a start time and/or an end time for the event. These times are in SLT (Second Lite Time) and will be used to define the operation’s period of the machines assigned to the event. This means:
- If the event has a start date-time defined: all the machines assigned to the event will work ONLY after the start time is reached;
- if the event has an end date-time defined: all the machines assigned to the event will work ONLY before the end time is reached;
- if the event has both a start and end time: all the machines assigned to the event will work ONLY during the period between start time and end time;
IMPORTANT: when a machine is associated to an event having a start and/or end date-time, every attempt to play outside the allowed period will be aborted and the player refunded.
There are two main type of events that can be created and managed using MD Gacha Machine: normal events and hosted events; the ‘Events’ tab works as container for both type of events. NOTE: To better understand what a hosted event is, please refer to the corresponding chapter.
The first step to perform is create an event that will be used to associate gachas to. To create a new event, simply click on the ‘Create Event’ link that can be found in the ‘Tips’ panel; this will load a wizard that will guide the owner in creating a new event.
The event creation wizard is composed by three main tabs, each of them containing specific settings:
- Main Settings: here the owner is asked to provide an unique name for the event. If the event corresponds to a SL event it is a good idea to pick a name which includes the SL event’s name and also the round (i.e. “Uber-2018-01”). PLEASE NOTE: the event’s name is the only mandatory data to provide in order to create an event; all further data is optional and will give access to several advanced features.
- Date Settings: this tab contains two optional values called ‘event start time’ and ‘event end time’. Often in fact the SL events have a specific duration composed by a start date-time and a end date-time:
- providing a start date-time for the event will force all the in-world machines associated to start working only from the moment specified;
- providing a end date-time for the event will force all the in-world machines associated to stop working when the specified moment is reached;
- This feature is really useful because allows store owners to setup their gachas in advance, without worrying that their products could be bought before the effective SL event’s start;
- Apply Settings: the last tab for the event creation wizard contains two optional settings aimed to speed up the application of the event just defined. The first one allows the owner to automatically assign the event to all machines in-world rezzed in a specific region. Doing this, the gachas will be associated to the newly created event and – if there is a start date-time or a end date-time – operate as scheduled. The second feature on this tab works together with the first one: when applying the event to all gachas rezzed at a specific region, the owner can decide if associate also the machine’s previous transactions to the newly created event in case those machine have already been used and it is important to keep track of every transaction.
Once the event is created it will appear listed in the ‘Events’ tab, as shown here:
For each event created, the table shows different data:
- Type: this value shows the event type among normal and hosted.
- Status: this icon is useful only for events which have a start date-time and/or a end date-time associated. The status icon is green for the events which are currently active (having at least one machine working within the event’s validity period defined) and red for the ones not active (having validity period expired).
- Event/Fair Name: the event’s unique name, useful to distinguish one event from the other. Clicking on the event’s name will open the corresponding event’s detail page, which will be discussed below in this chapter.
- Event/Fair Region: this value is used only for hosted events and shows the region where the event is taking place.
- Event/Fair Hoster: this value is used only for hosted events and shows the name of the avatar hosting the event.
- Start Date-Time (SLT): this value – optional – shows the start date-time for the event. If the value is present, all machines associated to the event will start working at that specific moment.
- End Date-Time (SLT): this value – optional – shows the end date-time for the event. If the value is present, all machines associated to the event will stop working at that specific moment.
- Profit (L$): this value is the total profit in L$ made by all machines associated to the event, whether they are in the same region or in different locations. If the event is associated to gachas participating to a SL event this number is the most important one to consider, as it gives the owner an idea of how much profitable the SL event is.
- Plays: this value represents the amount of pulls done on all machines associated to the event, whether they are in the same region or in different locations.
- Trash icon (): this last button allows the owner to remove the corresponding event. Since this action will affect also all machines associated to the event, the owner will have to choose among two different kind of deletion:
- Delete the event’s association from transactions: this deletion method keeps the transactions made while the gacha was assigned to the event, but remove the association.
- Delete transactions associated to this event: this deletion method removes permanently all the transactions made while the gacha was assigned to the event.
As the machine is associated, the event’s name will be listed under the ‘Event/Fair’ column:
Clicking on the event’s name will open the details page for the corresponding event, while the X icon removes the event association from the machine.
When clicking on a specific event/fair entry, the details page for the corresponding event will load, showing a daily graph with the selling trends and the complete transactions list for the event selected. Since the event can have more than one machine associated, for each transaction listed is reported which gacha performed it in addition to all other usual data.
Chapter #7.9: hosted events
Hosted events are special events where different store owners / designers participate with their gacha machines; the ‘Events‘ tab – located under the MD Gacha Machine homepage – allows the creation of hosted events in addition to normal ones.
However, in order to create and host a gacha event is mandatory to use the MD Gacha Machine Script for Events, available as a separate purchase.
More info about hosting a gacha event in the dedicated user manual here.
Chapter #7.10: Presets tab
The third tab present in the MD Gacha Machine homepage is called ‘Presets‘: from here is possible to create, manage and apply presets to the machines in-world.
A preset is basically a setup or a configuration that can be applied to one or many gacha machines; this configuration contains all the settings necessary for the machine to work correctly.
So, why presets can be useful? If multiple machines are configured in the same way (i.e. same price, same rare win chances, ..), then creating a preset with that configuration and apply it to to the corresponding machines will bring a considerable saving of time, as well reduce the chance to setup the machines with wrong settings. This because – generally speaking – there is a tendency to setup the machines always with the same parameters (price, rares, etc..), and in this case presets become very handy.
Presets can be created simply clicking on the “Create Preset” link that can be found into the ‘Tips’ panel; a wizard will appear and drive the user through the creation; the wizard itself is divided into two main tabs each one containing a different set of options useful to customize the preset generated. Below here is reported – for each tab of the wizard – which options are available, however no detailed explanation of those options will be given as they were already vastly discussed in the previous chapters.
The first tab present into the preset creation wizard is called ‘Main settings‘ and contains the following options:
- play price;
- event association;
- 1st split settings;
- 2nd split settings;
- direct pay mode;
PLEASE NOTE: it is not mandatory to fill all the fields, but only the ones corresponding to the features that will be used by the machines. If – for example – there is no need for the split feature, then the split fields will have to be left empty and ignored.
The second tab is called “Rares settings” and contains all the features regarding the rare items:
- uncommon items win chance;
- rare items win chance;
- ultra rare win chance;
- special item’s number of pull required;
Once all the required settings are provided, clicking the “Create” button will create the preset defined as specified in the wizard. All the presets are listed under the “Presets” tab, displaying all the settings characterizing each of them.
From the list each presets can be easily applied to a specific machine simply clicking on the paper plane icon (); the owner will be asked to pick the gacha to apply the preset to and upon confirm every setting connected to the preset will be applied to the chosen machine in-world. Using the trash bin icon () on the presets list is then possible to delete completely a preset.
Chapter #7.11: Managers tab
The fourth tab present in the MD Gacha Machine homepage is the ‘Managers‘ tab, from here is possible to add, manage and remove one or more store’s managers. A manager will be able to access the MD Gacha Machine homepage just like the store’s owner and – depending on the permissions granted – interact in several ways with the machines.
PLEASE NOTE: the managers will ONLY be able to interact with the machines through the Online Services website, and not directly from in-world.
Each manager will have a specific level of permissions that can vary from level 1 to level 3. Lower level (1) means less permissions, while higher level (3) means more permissions; also, some actions can be performed only by the owner. Below here there is a list of all the actions and who can perform them:
- Owner only actions:
- rename the store;
- create a hosted event;
- end a hosted event;
- as participant, share profit’s data with the hosted event’s owner;
- delete a hosted event;
- create a preset;
- add a manager;
- remove a manager;
- change manager’s level;
- export data from the website;
- import data to the website;
- Managers with permissions at level 1:
- view all the data but not perform any action; (view-only permissions)
- Managers with permissions at level 2:
- rename a machine;
- reset a machine;
- create an event and associate a machine to the event;
- remove an event from a machine;
- archive a machine;
- restore a machine;
- apply a preset to a machine;
- remove a preset from a machine;
- send the registration HUD to a new manager;
- Managers with permissions at level 3:
- all the actions from managers at level 2;
- delete a machine;
- delete multiple machines at once;
- delete all the machine’s transactions;
- delete an event;
- merge two machines;
- delete a preset;
- set / change the machine’s settings (price, rares, etc..)
- add users to blacklist;
- remove users from blacklist;
As listed above, some actions can be performed only by the owner, level 1 is the lowest level (view only) and doesn’t allow any actions to be performed, level 2 and 3 allow the managers to perform more and more actions.
Independently by the permissions level, there is another important setting that characterizes each manager: the share profit data. As said, this option does not depend by the permissions level, but the store owner has to declare it when adding a new manager, and can optionally change it anytime. The share profit data is a flag that can either be set to true or false:
- if true, the manager will be allowed to see the store’s total profit, and all the machines’s profit.
- if false, the manager will not be able to see the store’s total profit and all the machines’s profit.
This is made to protect the owner’s privacy, since not always a store owner is willing to share the store’s profit data with the managers. The share profit data setting can be changed anytime by the owner only, and the changes will be applied immediately to the corresponding manager.
To add a new manager, click on the “Add Manager” link in the “Managers” tab; a wizard will appear and drive the owner through a few simple steps:
The first thing is provide the manager’s name or key (UUID); then select a permission level and whether share or not the store’s profit data. Once these info are provided, clicking on the “Add” button will add the selected user as store’s manager. The manager will be immediately listed under the “Managers” tab; from here it will be possible to change the manager’s level, toggle the share store’s profit and also remove the manager.
The ‘Managers’ panel – located into the Managers tab – contains the following data:
- Manager Name: the name of the manager.
- Permission Level: the permission’s level of the corresponding manager.
- Send HUD (): this button delivers a new copy of MD Gacha Machine registration HUD to the corresponding manager. More info further down on this page.
- Change Level (): this button opens a wizard that allows the owner to change the manager’s permission from one level to another.
- Share profit data ( / ): this button acts as a toggle, enabling and disabling the share of the store profit with the corresponding manager.
- Trash bin icon (): this button removes completely the manager from the store’s managers list, prohibiting the deleted manager to access the store’s page.
Is important to spend a few more words on the registration HUD for MD Labs Online Services. In order to login and access the store, the managers must be registered to MD Labs Online Services; if the user selected as manager already uses MD Gacha Machine then an account is already registered and the users will be able to use the same credentials to login to the store to manage. Conversely, if the user selected as manager doesn’t use MD Gacha Machine then the creation of an account is required and a registration HUD will be automatically sent to the user once added as manager. It is also possible to repeat the HUD dispatch in another moment through the corresponding option in the managers list.
Once added as manager, the user will be able to switch between stores through the “Store” panel present into the ‘Gachas‘ tab; from here, the drop down will present a list of all stores owned and managed by the user, and a click on them will start the switch process to the selected store.
Chapter #7.12: Blacklist tab
The ‘Blacklist‘ tab allows the owner to block one or more users, preventing them to interact with the store’s machines; this feature is designed to help store owners against impolite or rude users having an unfair attitude, like copybotters or cheaters. The tab is composed by two different panels called ‘Tips’ and ‘Blacklisted avatars’.
The ‘Tips‘ panel contains a link called ‘Add Blacklisted Avatar’ that will open a simple wizard to add a new blacklisted avatar; the only required data in this process is the name or key (UUID) of the avatar to blacklist.
IMPORTANT: as described in the initial chapters of this manual if a blacklisted avatars tries to play a gacha machine the transaction will be canceled, no prize will be delivered and the avatar will be refunded of the amount paid.
Once the avatar is added as blacklisted it will be listed into the ‘Blacklisted avatar’ panel:
This panel shows a few data about the blacklisted avatars:
- Avatar name: the name of the blacklisted avatar.
- Added: the date-time when the avatar was added into the blacklist.
- Trash bin icon (): a button that will remove the corresponding avatar from the blacklist, allowing it to interact with again with MD Gacha Machine.
Chapter #7.13: Archived tab
The last tab which composes the MD Gacha Machine homepage is called ‘Archived‘ and groups together all the machines which are not rezzed anymore and which have been archived by the owner. The archive feature has been designed to help store owners to keep their data consistent while reducing the amount of information displayed; by archiving a gacha– in fact – it will be removed from in-world and from the ‘Gachas’ tab on MD Labs Online Services, but all the machine’s data such as total profit, total item sold and the complete transaction list is kept.
This action brings several benefits to the store owner:
- There will be less machines displayed into the ‘Gachas’ tab, making it easier to find the gacha desired;
- Since all the machine’s data is kept there will still be statistics about the archived gachas;
The main panel present in this tab is called ‘Archived Gachas’ and lists all the machines which have been archived by the owner.
The data showed for each gacha is very similar to the one present in the ‘Gachas’ tab, except the additional operations which are accessible clicking on the 3-dot icon (). The first operation is called ‘Restore’ () and it allows the owner to restore an archived machine, moving it from the ‘Archived’ tab to the ‘Gachas’ one; while this action moves the machine’s data from one tab to another on MD Labs Online Services website, it will not restore the gacha in-world if it has been already deleted. The second option, ‘Delete’ (), removes completely the machine’s data; once done all the statistics will be lost including the transactions lists.