MML Starting Items

Overview

Some live config has been added to allow players to be given some MML objects, even if they don’t have any in their collection, so they can play around with them.

NOTE: Public documentation for live config, inventory, collections and MML are still TO-DO

Integration

In your project’s live config, add a section along the lines of the following to your game.json

"UserCollection": {
    "StartingObjects": {
        "MML": {
            "GrantOnlyToPeopleWithNoMML": true,
            "NumDevices": 1,
            "NumObjects": 1,
            "MMLObject1": {
                "Name": "Red Cube",
                "Url": "wss://mmleditor.com/v0/api/documents/curved-green-monkey",
            },
            "MMLDevice1": {
                "Name": "Yellow Cube",
                "Url": "wss://mmleditor.com/v0/api/documents/sympathetic-emerald-gecko",
            }
        }
    }
}

• GrantOnlyToPeopleWithNoMML: If this is true, then any players that already have MML objects in their collection won’t be given these starting items. If this is false, the starting items will be given to all players.

• NumObjects: The number of starting MML objects to be given. This has to match the number of corresponding entries of the format MMLObjects[X], with X going from 1 to the value of NumObjects. You can only have up to three starting MML objects.

• NumDevices: The number of starting MML devices to be given. This has to match the number of corresponding entries of the format MMLDevice[X], with X going from 1 to the value of NumDevices. You can only have up to three starting MML devices.

  • “Objects” are MML items that you can place into the world.

    
• “Devices” are MML items that you equip to your person, and interact with through your device menu.

• MMLObject/MMLDevice[X]: Takes a an objet with child keys: Name and Urlwhere Name is the display name you want for your MML item, and Url is the URL of the MML document (This can be found in the MML Editor’s metadata tab).

Any questions on this, please reach out to Benjamin Naccarato!