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

"Inventory": {
    "MML": {
        "GrantStartingItemsOnlyForPeopleWithNoMML": true,
        "NumStartingObjects": 3,
        "StartingObject1": "Red Cube: wss://mmleditor.com/v0/api/documents/curved-green-monkey",
        "StartingObject2": "Yellow Cube: wss://mmleditor.com/v0/api/documents/sympathetic-emerald-gecko",
        "StartingObject3": "Blue Cube: wss://mmleditor.com/v0/api/documents/national-copper-damselfly",
        "NumStartingDevices": 1,
        "StartingDevice1": "Sound Cube: wss://mmleditor.com/v0/api/documents/northern-black-nightingale"
    }
}

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

• NumStarting[ItemType]s: The number of starting items of the given ItemType (Object or Device). This has to match the number of corresponding entries of the format Starting[ItemType][X], with X going from 1 to the value of NumStarting[ItemType]s.

  • “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.

• Starting[ItemType][Number]: Takes a string of the format [Name]: [Url], where 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!