VS Json File Generator

Resources Community Resources
1

VS Json String - Export Roblox Studio geometry to Vortex Studio

VSJsonLogo
VSJsonLogo500×500 40.8 KB

:link: Get it here: VS Json String on the Creator Store

What is this?

Vortex Studio doesn’t have a native way to pull geometry in from Roblox (yet) — there’s no importer, no bridge, nothing. If you build in Roblox Studio and want to bring that same layout into Vortex, you’d otherwise have to rebuild every part by hand.

VS Json String solves that. Select a Model or Folder in the Explorer, hit Get, and the plugin converts every valid part inside it into the JSON format Vortex expects — ready to paste straight into your project file.

image
image1237×837 72.3 KB

Features :sparkles:

  • One-click export — select anything in the Explorer, click Get, done.
  • Material mapping — Roblox materials are automatically mapped to the 5 materials Vortex currently supports (Plastic, Wood, Metal, Grass, Ice). Anything unsupported falls back to Plastic instead of breaking the import.
  • MeshPart detection — MeshParts can’t be represented in Vortex’s format yet, so instead of silently dropping them, they’re swapped for a bright purple placeholder box named NoTexture, in the same spot the mesh used to be. You’ll know exactly where you still need to fill in geometry by hand.
  • SpawnLocation support — spawns are exported as real parts (correct size/position), automatically colored green so they’re easy to spot.
  • PointLight support — PointLights get converted into large, transparent, colored parts approximating where the light source is and what color it casts. Not a real light, but a solid placeholder until Vortex supports actual lighting import.
  • Chunked export for big scenes — very large selections are automatically split into multiple chunks with Prev/Next navigation, so you’re not stuck copy-pasting one giant unreadable block of text.
  • English / Spanish auto-detected UI — the plugin reads Studio’s own locale setting and switches language automatically.
  • Safety warning on huge exports — if you select something with a very large number of parts, the plugin warns you before generating the text, since huge exports can take a moment.

image
image741×300 15.6 KB

How to use :open_book:

Quick Instructions
  1. Select the Model or Folder you want to export in the Explorer.
  2. Open the plugin and click Get.
  3. Click inside the text box, CTRL+A → CTRL+C (use Prev/Next first if your export was split into multiple chunks).
  4. Find your Vortex Studio project file: Documents → VortexStudio → (your place's .json file)
  5. Open it with a text/code editor (VS Code works great — Notepad will technically work but isn’t fun to use for JSON).
  6. Paste your copied chunk(s) inside the "parts": [ ... ] array.

This should be the result of the Json format.

image
image892×682 112 KB

Then assuming you have an empty place file, it should look like this:

{
  "project_id": "(don't touch this — it's assigned by Vortex)",
  "parts": [ -- HERE paste each chunk here, in order ],
  "lights": [
    {
      "name": "Light",
      "position": {
        "x": 50.0,
        "y": 80.0,
        "z": 30.0
      },
      "rotation": {
        "x": -0.39447272,
        "y": 0.43916786,
        "z": 0.22334667,
        "w": 0.775654
      },
      "color": {
        "r": 0.99999994,
        "g": 0.99999994,
        "b": 0.99999994,
        "a": 1.0
      },
      "illuminance": 10000.0,
      "shadows_enabled": true
    }
  ],
  "groups": []
}

:warning: Be careful not to break the commas the format already has between entries. If you’re pasting multiple chunks, make sure each one is separated by a comma before the next one starts.

You need an existing Vortex place already created in order to have a valid .json file to edit — the plugin doesn’t create new Vortex projects, it only fills in the parts array of one that already exists.

image
image1918×977 126 KB

Current limitations :warning:

Being upfront about what this plugin doesn’t do yet:

  • Unions and Negate parts (CSG) are skipped. Roblox doesn’t expose a scripting API to separate a UnionOperation/NegateOperation back into its original parts — the “Separate” button only exists as a manual Studio UI action, not something a plugin can call. If your build relies heavily on unions, you’ll need to separate them manually in Studio before exporting.
  • Wedges, corner wedges, spheres, and cylinders aren’t exported yet. Vortex’s current format only supports box geometry (position/rotation/scale), so there’s no way to represent these shapes without more fields on Vortex’s side.
  • Vortex only supports 5 materials right now (Plastic, Wood, Metal, Grass, Ice), so some visual fidelity is lost on more detailed builds.
  • Textures are not supported the plugin doesn’t translate any texture when formating into Json.
  • Models are not supported for now, trying to parent parts with groups, even changing the Id creates problems when trying to open the Project.

None of these are permanent — if Vortex’s format grows to support more shapes/materials, the plugin can grow with it.

Some Results

image
image1280×689 129 KB

image
image1235×802 40.5 KB

image
image1007×707 43.3 KB

image
image1280×715 54.8 KB

Feedback wanted

This is an early tool built out of a real need while working on my own project, and it’s already helped at least one other person get their build into Vortex without rebuilding from scratch. If you try it out, I’d love to hear:

  • What broke, if anything
  • What shapes/features you’d want supported next
  • Any workflow friction I can smooth out

Drop a reply or a review on the plugin page — thanks for reading! :heart: