Cloud spawning

This method is not supported by the developers of Resonite and may break at any time!

Cloud Spawning is part of the Things to Avoid list. It may break in the future without warning.

Cloud Spawning is the unofficial term used to describe the action of spawning an item from a user's Inventory programmatically. It is currently unsupported officially.

Methods

Although cloud spawning is not officially supported, several methods have been developed by the community to achieve it.

Copy & Paste

This method allows you to spawn an item by pressing a button, which will:

1. Copy text to the clipboard with a ButtonClipboardCopyText component.
2. Simulate keyboard inputs to paste with VirtualMultiKey component, which will spawn the item.

The benefit of this method is that it supports all links which may normally be spawned into Resonite, such as resrec, resdb and http.

This is at the disadvantage of only being triggerable by pressing a button. This means there is no way to use this method without user interaction.

RedX uses a similar method to spawn out items.

Setup

1. Attach both components to a slot which has a button component.
2. Configure the ButtonClipboardCopyText component to copy the link to the asset you want to cloud spawn.
3. Configure the VirtualMultiKey to "LeftControl" and "V".
4. Activate the button to spawn the asset.

Components and Method Proxies

This method allows for full control of how an item is spawned out from an inventory. This requires a mod to show sync delegates and to get the Method Proxy nodes which, once called, will spawn the item.

What You Need

• The mods Show Delegates from Arti & GetItemLink. For information on modding Resonite, see Mods.
• One Slot to hold components.
• Components StaticBinary & FileMetadata.
• The target item you want to spawn from the Inventory.

Item Setup

The get item link buttons (with the cheese button being active).

1. Open the Inventory tab on the Dash.
2. Navigate to the item you wish to cloud spawn.
3. Press the "cheese" button from the Get Item Link mod to copy the resdb link to the clipboard.

Slot Setup

An inspector showing the components needed to make cloud spawning work.

1. Create an empty slot using the Dev Tool.
2. Attach the StaticBinary component.
   1. For the URL, place your item's resdb link here.
3. Attach the FileMetadata component.
   1. For the Filename, you can use any name here, but it must have the .brson, .7zbson, or .lz4bson file extension at the end of the name. (Filling in MIME is not required.)
4. Add a button component onto the slot or parent slot, and trigger it to spawn the item.
5. (Alternatively) Open the FileMetadata Sync Methods using the Show Delegates mod, and with the ProtoFlux Tool, grab and hold the OnImportFile method. Then open the context menu while still holding it, select Proxy.

ProtoFlux Setup

An example of how to use ProtoFlux to cloud spawn.

1. With the method proxy, connect it to anything that can send a pulse to it (the example shows a Call node doing this).

Official Support

You can track the work on an official version of Cloud Spawning in this GitHub Issue.