Prop Converter

Atualizado em Nov 16, 2026 Abrir ferramenta

The Prop Converter at /app/prop (Props in the workspace) turns a 3D model into a static GTA V prop (.ydr) with its texture dictionary and archetype, ready to drop into a FiveM resource. The model is read and shown in the browser; pressing Convert saves it to the library and puts the job on the conversion queue, which a separate backend (WinAPI) works through. Conversions are counted per day, not paid for in credits.

What the Prop Converter makes

A conversion writes <name>.ydr, <name>.ytd when the model has at least one texture (its own or one put in a slot; a model with no textures gets no .ytd, and since 2026-11-15 the line under Convert says so), and <name>.ytyp unless YTYP is turned off under Advanced. The files land in the library as one folder. Under the finished model: Download all (each file), Download resource (a ZIP with <name>/stream/ holding the files and an fxmanifest.lua carrying data_file 'DLC_ITYP_REQUEST' 'stream/<name>.ytyp'), and the same line to copy when the files are added to an existing resource by hand. Weapons (/app/weapon) and Clothing (/app/clothing) are the same kind of tool with their own outputs; they are covered in the workspace doc.

Accepted model inputs

GLB only, up to 100 MB. Dropping or choosing an .obj, .fbx or any other model format shows "{name}: export as GLB" and nothing opens: export the model as binary glTF (.glb) from Blender or the program it was made in. A .ydr or .ydd dropped here opens in the Designer, which is where an existing game file's textures are edited; this tool makes a new prop from a model. A file named .glb that is empty, cut off or not a GLB inside shows "Could not read this model" with "Not a complete GLB · export it again as .glb"; one that uses Draco, Meshopt or KTX2 compression the tool cannot read shows "Compressed in a way this tool cannot read · export it without mesh or texture compression". Neither is kept as a project (until 2026-11-15 the raw parser message was shown and the unreadable file stayed in the Projects list).

Ways to get a model in, on the Steps card or the left column: Upload, Search (Sketchfab), Generate (AI, costs credits; see the Image to 3D doc), Library (models already saved) and Try a sample (Props only). A model is kept as a project on the device it was opened on, with its settings and its last conversion; the Projects list on the right brings it back.

Sketchfab search and import

Search (or Find a model) searches Sketchfab from inside the tool. Only downloadable models are listed, with their triangle count and licence. One click brings a model in; no Sketchfab account or token is needed (the site's own key does the download). A licence that limits use (non-commercial, no derivatives) asks before the model is used, and the author and licence stay on the library row.

Image to prop

Generate model makes a 3D model from a picture or from words first, then puts it on the stage like any other model. Generation is a separate paid step; see the Image to 3D doc for models, polycount and refunds. A model that came from a generation does not count against the day's conversions.

There is also a server-to-server path for FiveM resources using an API key with the props:create scope: POST /api/v1/fivem/props/stage-upload returns a 10 minute upload URL for a PNG or JPG ("Only PNG and JPG images are supported"), then POST /api/v1/fivem/props/from-image starts a Meshy task with propName (letters, digits and underscores, max 64), syncToken, optional scale (default 1.0, max 100) and createYtyp (default true). The server resource then polls /api/v1/fivem/props/task, triggers /api/v1/fivem/props/convert and downloads from /api/v1/fivem/props/request (signed URL valid 1 hour). Statuses are pending, converting, ready and failed. Tasks created this way are recorded with cost: 0 (verify whether that route is meant to be free). Since 2026-09-23 from-image answers a Meshy refusal with the reason in plain words ("That image was rejected by the 3D generator for content reasons. Try a different picture.") rather than "Failed to start 3D generation", and writes the run to the staff prop channel like any other generation; details in the API keys doc.

Size, turn and the other settings

The left column has Name (letters, digits and underscores), Scale and Longest side (the same size said two ways: the multiplier, and the longest side in metres), Rotation per axis with quarter-turn buttons, Stretch per axis, Reference (the 1.75 m person, or your own YDR), Collision (Exact mesh, Boxes, None), each material's textures and shader, and Advanced (LODs, draw distance, YTYP, texture size and compression, Legacy or Enhanced). A model over 50 units across gets a proposed scale when it is opened. Since 2026-11-15 every number field applies as it is typed (no Enter needed), a field that is emptied goes back to the model's value when it is left, the arrows of Scale nudge by about a hundredth to a tenth of the value whatever units the model was made in, the arrows of Longest side move one centimetre a press, and the arrows of Rotation move one degree (the quarter-turn buttons do 90).

Models over 150,000 faces cannot be converted: the column and, since 2026-11-15, the Steps card's Export step say "{faces} faces · over the 150,000 limit, remesh first", and Reduce the mesh (free, in the browser) brings it under.

Steps and the size handles in the workspace (2026-09-29)

In the workspace at /app/prop, the 3D stage opens with Steps, an optional walk-through (close it with the X; Steps at the top of the stage brings it back): Model (upload, search Sketchfab, generate, your library or a sample), Size (the longest side in metres and the person for scale), Textures (skipped when the model has its own on every material) and Export (name and Convert). Show in panel highlights the matching section of the left column. Weapons and Clothing have the same card with their own steps; see the workspace guide. Under the card (and under the empty stage's buttons when Steps is closed), Edit YDR textures opens the Designer, which is where the textures of an existing YDR are changed; this tool makes a new prop from a model.

Sizing is done with the handles on the model: drag a corner to resize evenly, a face ball to stretch one way. Since 2026-09-29 the handle stays under the pointer and a prop keeps standing on the ground while it is sized (the bottom holds, the sides grow evenly about the middle). The exact number can be typed in Longest side or Scale.

Your own YDR as the size reference (2026-09-30)

In the workspace at /app/prop, the panel's Reference field reads "Person" (the 1.75 m person that stands beside the model for scale). Add YDR takes one .ydr of your own, a game prop for example, and stands it beside the model in the same metres in place of the person, on the same ground line, so a new crate can be sized against the game's crate; Replace swaps it, the X goes back to the person, and the person button on the stage toolbar shows or hides whichever it is. The file is read by the converter (sign-in needed, up to 30 MB) and drawn in the person's quiet grey; it is only a reference and never goes into the conversion. A project keeps it. A wide reference stands off by its own width so it never covers the model.

What a conversion costs

Nothing in credits. A Free, Lite, Booster or Referrer account converts 3 models a day across Props, Weapons and Clothing, one at a time; Standard, Pro and Max are unlimited, two at a time. The footer shows what is left ("Conversion · Free · 2 of 3 today"), and when the day is used it becomes Unlimited on any plan with the time the next one frees up ("3 of 3 used today · next at 18:46 tomorrow"). A failed or cancelled conversion gives its place back. Converting the same model again with the same settings returns the files already made and does not count. Signed out, the page shows the sign-in card over the tool; nothing can be dropped until signed in.

Free re-export window and export history

The window ended on 2026-10-13 (the owner's call, api-security.md second pass): /convert/authorize no longer reads export_history, and validateExportFree with editor/export-validation.ts was deleted. Before that, every legacy export wrote an entry expiring after 24 hours and re-exporting the same unchanged source within it was free; nothing had written to the table since the legacy editor went on 2026-09-26, so no workspace re-export was ever free this way. The Converter's day and the paid plans' unlimited exports are what replace it.

The "Export History" panel belonged to the legacy Prop Converter editor, which was retired on 2026-09-26. Its routes (/api/v1/convert/history, /history/check and /history/upload) were removed on 2026-10-13. The workspace has no export history list.

Sharing a conversion

Sharing a conversion to Discord for credits no longer exists. The share dialog ("Shared! +10 credits earned!") belonged to the legacy Prop Converter editor, retired on 2026-09-26, and its route /api/v1/convert/share was removed on 2026-10-13. There is no share bonus now. If someone asks about the 10 credits for sharing, tell them the feature is gone.

Known limits

The tool works on a phone as well as on a desktop: under 1024px the three panels (Setup, Preview, Library) are one at a time on a bar at the bottom, and Convert is under Setup. It needs WebGL (hardware acceleration on).

While a conversion is queued or running the card under the model shows the step and a clock, with Cancel; the same job is in the Tasks pill at the top, so the tool can be left and the result arrives wherever you are. A page reload mid-conversion brings the model, its settings and the job back. Since 2026-11-15 a reload while the model was still being saved ("Saving 40%") starts the conversion again by itself when the project reopens within ten minutes (before, the press was lost without a word). A prop conversion that runs past six minutes is stopped with "The conversion took longer than 6 minutes and was stopped." Textures are capped by the Texture size setting and models at 150,000 faces.

Common questions

Which file types can I upload? GLB only (binary glTF, .glb), up to 100 MB. OBJ, FBX and the rest have to be exported as GLB first. A YDR or YDD dropped on Props opens in the Designer instead.

How much does a conversion cost? No credits. Free accounts get 3 conversions a day across Props, Weapons and Clothing; Standard, Pro and Max are unlimited.

The conversion failed. Did I lose anything? No. A failed or cancelled conversion does not count against the day, and the model is still on the stage: press Try again (or Try with Boxes collision when the reason names the collision mesh).

Do I need a Sketchfab account? No. Search and bring a model in with one click.

Does it work on my phone? Yes. Use the bar at the bottom to move between Setup, Preview and Library.

The handles on the model are gone. Props has only the size handles and they are always on. On Weapons and Clothing press G (Move), R (Turn) or S (Size), or one of the three buttons at the top right of the stage. Since 2026-11-15 Escape no longer turns them off and a newly opened model always has them.

Can I deploy straight to my server? Yes, with Pro or Max. The workspace's Deploy dialog sends a resource to a linked FiveM server. Details are in the FiveM servers doc.