Please refer to the 3D Static Object Asset for specific requirements of the Audio Meta Asset Framework before uploading an asset.
1. Find or Create the model file that you want to upload.
You can use any 3d modelling software and 3d model object file that is supported by Unity. For testing purposes, please you can find free 3d assets at Sketchfab.
A more complex model with high definition textures will be a larger file and will cost more to upload to Arweave. This also increases download time. Please check out https://prices.ardrive.io/ to determine Arweave upload costs per megabyte or gigabyte.
2. Create a Unity project and install the Rawrshak Tools SDK
Please refer to this tutorial on how to install the Rawrshak Tools SDK.
3. Move the asset into the Unity project
Move the folder containing the asset information including the model and necessary textures into the project
4. Select the model and drag into the scene. Click the model in the scene and make sure the Transform is set correctly.
Make sure that the Transform is set to the following at the start:
Position: (0,0,0)
Rotation: (0,0,0)
Scale: (1,1,1)
5. Correct the orientation
Make sure that the front of the asset is pointing towards the Z direction. The Z-direction is the Blue Arrow in the scene.
In this case, we flipped the Y axis 180 degrees.
Oriented the asset
6. Select the desired Bounding Box and place it in the scene.
Go to Assets\Rawrshak\Tools\Static3dObjectVerfier\Prefabs and select the desired bounding box. In this case, we're going to select Horizontal-Z shape bounding box. Drag that into the scene hierarchy to preserve the position.
Make sure to drag the prefab into the Hierarchy Tab, not the Scene tab. This preserves the position.
Make sure that the Position of the bounding box matches the initial Position of the prefab by selecting the prefab and comparing its position with the bounding box in the scene. In the example's case, it's position is at (0, 0.5, 0).
Drag Desired bounding box into the hierarchy, into the scene.
7. Add a Collider to the model
The box collider will be used by the bounding box to determine if the model is within the Asset Framework.
Select the largest mesh in the model hierarchy. Select 'Add Component' and search for a Collider component. In this case, we're using a simple box collider.
Add a Box Collider
7.B. You may need to adjust the Collider if it doesn't fit the mesh correctly.
Adjust the Box Collider if necessary
8. Select the Bounding Box object and set the Target Object to the object that has the box collider. Click "Load Target Object"
Set the Target Object in the Object Bounds script in the Horizontal Z bounding box object
9. Re-scale and re-position the object until the object fits into the bounding box (Bounding Box is white)
Model intersects with the bounding box.
Model is firmly inside the bounding box, the bounding box will turn green.
10. Create a new Empty Game Object to be the parent of the prefab
Create Empty object
Make sure the position of the new empty object is set to (0,0,0)
11. Move the model game object into the parent
Move the batmobile model into the Batmobile-parent object
12. Drag and drop the parent object into the Project Folder in order to create a prefab
Create a Prefab
13. Set the prefab's asset bundle name
Set Asset Bundle Name
14. Open the Asset Bundles Menu, select the Platform Targets, and click Generate Asset Bundles
Go to the menu and select: Rawrshak -> Asset Bundles
Select StandaloneWindows and WebGL, and click the Generate Asset Bundle
15. View the Asset Bundle Information
Click the asset bundle and view the information
16. Upload it to Arweave
Please check out this tutorial in order to upload to Arweave.
17. Connect to the Rawrshak Dapp and navigate your way to the Content Contract page
Create New Asset
18. Fill in the information about the Asset
Value
Description
Pinata API Key & Secret
This is needed for the metadata to be uploaded to IPFS. Please see the Pinata tutorial to set this up.
Name
Name of the meta asset
Description
Description of the meta asset
Image
Image src that will show up on Dapps and other front-ends
Tags
An array of tags categorizing the asset
Max Supply
The maximum instances for this asset that can ever be minted. If left at 0, it will automatically be converted to UINT256_MAX.
Royalty Receiver Address
The ethereum address that royalty fees will be sent to. If this is set to the Zero Address, the asset royalty will fall back to the default Content Contract royalty.
Royalty Rate
The percent royalty the developer will receive when this asset is traded in a marketplace that supports royalty fees.
Type
The Main type of meta asset. In this case, it should be set to Image
Subtype
The subtype of the meta asset. Please refer to the Image Assets page to get more info on which subtype to select. Defaults to square.
NSFW
Notifies game developers and users of explicit content. Please mark this correctly.
Static 3D Object Asset Data
Value
Description
Name
This 'name' is reserved for the name of the prefab that will be loaded by the game based on the Asset Names in the Asset bundle Menu.
Engine
Engine that this file is packaged for. Currently only supports Unity.
Platform
The platform refers to the operating system that the game will be running on. Values include android, ios, windows, and webgl.
Render Pipeline
Render Pipeline refers to the specific rendering pipeline that is set for a game engine. Values on this include brp (built-in render pipeline), urp (universal render pipeline), or hdrp (high-definition render pipeline). For now, we only support the built-in render pipeline so please set it to BRP.
Fidelity
Fidelity refers to the asset's quality, ease of download, and ease of loading. Values include low, medium, and high. Definition for Low, Medium, and High Fidelity is to be determined. For now, please set it to Low.
Shape
Shape refers to which type of default asset this object is expecting to replace.Values include small, medium, large, horizontalx, horizontaly, and horizontalz.
3d Static object file URI
Uri to the asset package stored in a decentralized database.
The Static 3D Object Meta Asset Framework has some requirements for each type and subtype. If your asset doesn't comply with the framework requirements, it may be unloadable by games.
Games expect the asset to follow the framework in order for them to load it.
To get the prefab name for Name section of the Static 3D Object Asset Data, you must open the Asset Bundle Menu, select the bundle name to view the information, and find the correct Asset name.
In this example, it's not "batmobile", instead it's "assets/batmobile-parent.prefab"
Use the Prefab name for the Name section
19. Fill in the Asset Information from the static 3d object information above.
Fill in 3D static object information
20. Click Create Asset and wait for the Metadata to propagate
Click Create Asset
Wait for Json to propagate
21. Wait for the transaction to process and Verify
Verify for the asset to show up in the contract
If you're running into problems or find any issues, please join our discord and reach out. We'll help answer questions and fix issues as fast as we can.
