Articraft for Pascal

An external Pascal Editor plugin for articulated 3D assets. It can browse a Pascal-hosted mirror of Articraft-10K, place URDF assets as custom Pascal nodes, pose their revolute/continuous/prismatic joints, and submit prompt or reference- image jobs to a credentialed mini-articraft worker that returns posable USDZ.

Placement previews use the same articulated URDF/USDZ hierarchy as committed nodes, with translucent non-interactive materials and live articulation. New placements keep that motion active after commit and after selection changes. The inspector can stop or restart motion without writing per-frame joint values into scene history or autosave. Automatic motion is paused when the operating system requests reduced motion.

This is a Pascal integration maintained by pascalorg. It is not an official hosted service from the Articraft researchers.

What the plugin contributes

• Plugin id pascal:articraft and node kind articraft:asset.
• A lazy Articraft sidebar with Browse and Generate views.
• A placement tool that persists the artifact identity, source attribution, normalized articulation graph, and current joint pose in the Pascal scene.
• URDF + OBJ rendering for the CC BY 4.0 Articraft-10K dataset.
• USDZ rendering for results produced by the Apache 2.0 mini-articraft SDK.
• Live position, rotation, scale, and joint controls in the Pascal inspector; radians stay radians in scene data and are displayed as degrees only for people.
• Persistent, selection-independent motion that smoothly sweeps every movable joint while keeping per-frame values transient.
• Native looping glTF animation clips for those articulated joints when a Pascal project is exported to GLB; the saved joint pose remains the file's rest pose.
• A registry-native 2D footprint that follows each asset's persisted position, yaw, scale, selection, and highlight state in floor-plan view.
• An optional reference studio backed by host-scoped Azure GPT Image 2 and Google Nano Banana 2 providers. Generated references are saved into Pascal Files before they are reused for articulated-asset generation.

The browser package never receives provider, worker, or Supabase service-role credentials. Hosts expose the same-origin broker described in HOST_INTEGRATION.md.

Data and service boundaries

• Browsing calls the Pascal host's same-origin catalog route, then downloads model files from the public catalog storage origin configured by that host. That storage provider receives ordinary request metadata such as IP address and user agent.
• Generation sends the prompt and optional reference image to the Pascal host, which applies its visible automatic provider/model choice before calling the configured mini-articraft worker. Provider handling is governed by that provider's terms and the host operator's account.
• The reference worker persists the prompt, job status, and generated source/run metadata on its private durable volume. It publishes a normalized manifest without the prompt plus the public USDZ artifact. A reference image is kept only for the job and deleted locally when it finishes, although the selected model provider may retain inputs under its own policy.
• A placed Pascal node persists the catalog or generated artifact URL and digest, title, source attribution, optional generation prompt, dimensions, part/joint graph, transform, current joint pose, and whether motion is enabled. It does not persist a provider key, worker bearer token, Supabase service-role key, or Pascal user identity.

The plugin has no OAuth scopes or external account session. Report security or support issues through the repository's GitHub issues.

Development

bun install
bun run build
bun run check-types
bun test

cd server
uv sync --extra test
uv run pytest

Read Create a plugin for Pascal's public Plugin API v1 contract.

Pascal currently consumes the reviewed Git commit and transpiles the raw TypeScript entrypoint, matching the Nature reference plugin. bun run build emits a code-split ESM review artifact under ignored dist/; no install-time script or network request is required.

Upstream and data attribution

• Articraft project
• mini-articraft, Apache 2.0
• Articraft-10K, CC BY 4.0, by the Articraft authors / Cambridge Visual Structure Learning Lab

Every mirrored catalog record keeps the upstream dataset revision, source archive, license, and attribution. Applications embedding this plugin must keep that attribution visible.

License

Plugin and reference-worker integration code is MIT licensed. mini-articraft and Articraft-10K retain their own licenses above; this repository does not relicense their code or dataset artifacts.