Studio-quality renders of Blockbench and low-poly models, right in your browser.
Open a model, pick a look, press Render. ModelShot keeps pixel-art textures crisp, handles transparent pixels, rounds edges softly and path-traces global illumination — all on your own GPU, nothing uploaded. Export images, turntables and animations, or embed a live viewer on your page.
Status: early development.
Requires Node 22.19 or later (22 LTS, see .nvmrc) and pnpm, pinned through corepack:
npm i -g corepack@latest
corepack enable
pnpm install
pnpm browsers
pnpm -r build
pnpm testpnpm browsers installs the pinned headless Chromium used by the browser tests once; see Testing.
Also: pnpm typecheck (tsc -b over the root tsconfig.json, which references every package, tools/harness and
tsconfig.config.json for the root config files; a new package adds its reference there), pnpm lint, pnpm format:check (pnpm format fixes formatting).
Packages (packages/*): formats, scene, renderer-rt, pathtracer, looks, export, app, embed, brand
(design tokens, fonts, logo) and site (the landing page). Test tooling lives in tools/harness; the wiki build in tools/wiki.
Docs: scene format (what every loader produces), Blockbench loader,
glTF / GLB loader and OBJ loader (supported features, limits, error codes),
player skins and posing (the player model from a skin, poses, held models),
realtime renderer (passes, pixel-art sampling, transparency, context loss),
path tracer (API, determinism, alpha, sides and order on every ray, lighting),
look presets (the shared look parameters both renderers read),
camera (the shared camera, frame-to-fit, controls),
export (PNG, APNG, GIF, WebP, WebM and MP4 from the path tracer: options, limits, fallback),
brand (tokens, contrast rules, fonts, logo and icons, licences),
landing page (layout, hosting at / and /app/, the local file handoff, motion, tests),
app (opening models, panels, shortcuts, render and export, local state, offline, limits),
hosting (GitHub Pages, layout and URLs, CSP, the deploy workflow; the app is at https://mrlarkyy.github.io/ModelShot/app/ after the first deploy),
embed (the <modelshot-viewer> element and iframe, parameters, CORS, limits, privacy),
testing (unit and browser layers, goldens, budgets, CI).
The wiki is generated from docs/ on every push to main (tools/wiki); edit the pages there.
ModelShot is released under the MIT licence. The ModelShot name, logo, icons, illustration and social preview, and the artwork their
generators draw, are not covered by it and stay all rights reserved (see packages/brand/assets/LICENSE); the bundled fonts keep their SIL Open Font License.