import_file
Uploads a local file to your Roblox account and inserts it into the open place as a Model, Sound, or Decal; supports model, audio, and image files.
Instructions
Import a LOCAL file into Roblox: uploads it to the user's own account via the Open Cloud Assets API (needs TUFAN_OPENCLOUD_KEY), then inserts it into the open place. Supports .rbxm/.rbxmx/.fbx/.gltf/.glb (Model), .mp3/.ogg/.wav/.flac (Audio → Sound instance; wav/flac acceptance may vary), .png/.jpg/.bmp/.tga (Decal instance). NOT .obj — convert to .fbx/.glb first. Max 20 MB. Audio uploads are quota-limited (10/month, 100/month if ID-verified) and queue for moderation — they often outlive waitSeconds; when that happens the call returns an operationId, and re-calling with { operationId } resumes WITHOUT re-uploading or burning quota. Models typically finish in seconds. For an EXISTING marketplace asset by id, use insert_asset instead; to AI-generate a new mesh from a prompt/image, use generate_asset instead.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "import_file"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Display name on Roblox (default: file name) | |
| place | No | Target place (PlaceId or project name). Defaults to the bound/sole connected place. | |
| anchor | No | Anchor all parts after a Model insert (opt-in) | |
| insert | No | Insert into the place after upload (default true) | |
| filePath | No | Absolute path of the local file to upload | |
| onGround | No | Drop the inserted Model flush onto whatever is below it (opt-in) | |
| position | No | [x,y,z] world position for the inserted Model's pivot (opt-in) | |
| assetType | No | Override auto-detect — e.g. Animation for a KeyframeSequence .rbxm | |
| parentPath | No | Where to insert in the place (default Workspace) | |
| description | No | Description shown on the asset's Roblox page. Default empty. | |
| operationId | No | Resume a pending upload instead of uploading again | |
| waitSeconds | No | Max seconds to wait for Roblox-side processing after upload (default 45, max 240) | |
| collisionFidelity | No | Set on every MeshPart after a Model insert (opt-in; Hull = cheap static-prop choice) | |
| targetHeightStuds | No | Scale the inserted Model so its height equals this many studs (opt-in) |