For the complete documentation index, see llms.txt. This page is also available as Markdown.

Create Frame Assets

Frame assets are a special asset class used to display 2D NFTs, images, and video. There are a few specific requirements for making custom frame assets (e.g., they can not be animated).

What is a Frame Asset?

A frame asset is a special asset type that serves as a screen to display NFTs, images, and video in the game environment.

How to Create a Frame Asset

About

To create a frame asset, you will select a flat rectangular area to serve as the "screen" on the asset using the Frame tool in the VoxEdit Modeler's Modeler.

Uploading the asset to your Workspace maintains this special property and makes the asset available in your Game Maker library.

The following logic options can be applied to a frame asset in Game Maker:

You must place a frame asset in Game Maker for these options to appear.

To display a 2D NFT image in the rectangular display area of your frame asset, you must own an NFT in the same wallet that is connected to your account at The Sandbox, and it must exist on the Ethereum blockchain.

NFT Information

The NFT Details Display component is often used on frame assets to provide marketplace information about the displayed media:

Specific Requirements

Size & Ratio

There is no limit on size or specific restrictions about ratio, but we recommend 16:9 or 1:1. The logic to use the frame object will allow for resizing, stretching to fit, and repeating (tiling).

If your image appears to be poor quality, it may be from stretching too large or in a ratio that doesn't suit the image. Create a new frame object or choose a different image.

Dimensions: Even Values

The model with the frame area must have a volume with even dimensions.

Examples

  • 64x64x2

  • 120x40x6

Unanimated

Do NOT animate the asset. If motion is applied, the asset will not be saved as a frame asset.

Projection Note

Do NOT move or rotate the node linked to the model with the frame area. The projection is locked at the position on the model in relation to the [0, 0, 0] coordinate.

If you move or rotate the model, the projection area won't match in the game world.

Animator view
Game Maker / Game Client view (projection misplaced)
Video Guide

Techniques

Floating Image

There is no need for a Voxel surface underneath the frame area. It’s possible to draw the area and then delete the voxels, and the area will remain active. This will let you design displays in which the images seem to be floating in space.

Last updated

Was this helpful?