← Developer & Artist Docs
👩‍💻 Developers · mk_ key

Push from Blender / your pipeline

The mk_ Modeler lane is for outside tools — a Blender add-on, an export script, a build pipeline — to push 3D models, props, and avatar pieces into EveVolved automatically. It’s the programmatic version of the GLB upload: scoped to assets only (least privilege), no AI in the loop.

Connect a build-tools key

In the Creator Console → Connect, “Connect an outside tool” mints a private mk_ key. Name it for the tool it’s for (e.g. “My Blender”). Tick what it’s allowed to make, or leave all unticked for anything. The key authenticates the Modeler MCP (and the HTTP upload endpoint).

The pipeline

For a model with its own geometry, it’s upload-then-publish:

  1. get_asset_types — confirm the kind + size cap for what you’re pushing.
  2. Upload the GLB — request an upload intent at /sdk/model/upload-intent, then HTTP PUT the raw .glb bytes to the returned URL. You get back a glbKey.
  3. push_object — create the object/avatar piece with that glbKey (or a meshId from list_my_meshes), its category, and optional mount / stats.
  4. publish_object — go live. Avatar pieces appear in the Avatar assembler for everyone to wear + remix.

Prep the .glb the same way as a manual upload — meters, Y-up, origin at the base/grip, transforms applied, textures embedded. See the GLB guide for the details.

The tools

get_asset_types
The asset types you can make — mesh, texture, structure, object — with their content types + size caps. Call it first.
list_assets
List your own assets across all types (id, type, name, status) — to find an id to update or publish.
list_my_meshes
List your published meshes (id + name). An avatar piece references one of these by meshId.
push_object
Create or update an object — a weapon/prop/wearable or an avatar piece (hair/top/bottom/shoes/hands/cape/accessory). Give it a shape (meshId / glbKey / builtin) + category, plus optional mount + stats.
publish_object
Publish an object you own so it goes live in the catalog — avatar pieces land in the Avatar assembler. Requires a shape.
Which key?
mk_ for outside build tools (here). eve_ to let an AI build for you. evk_ to call EveVolved from your own server at runtime. Separate on purpose — least privilege.