A feature-rich unofficial non-affiliated asset viewer for the cosmetic providers we previously developed patches for, such as Lunar Client and Essential Mod, plus Dawn Client.
%20)
- Browses ALL cosmetics, emotes and resources on Lunar Client's public asset CDN (6,500+ items), and every cosmetic on Dawn Client's asset CDN (860+ items, with animated textures).
- Shows Essential Mod cosmetics from your own installation: pick your
.minecraftfolder and the cosmetic dumps (written by the Prometheus patch) and Essential's cosmetic cache are read locally in your browser. Nothing of Essential is hosted here and nothing is uploaded. Glow layers, animated textures, colour variants, sides, skin masks, particle effects, and emotes with their sounds are all shown. - Previews every cosmetic in 3D: hats, cloaks, wings, pets, suits, auras and more, with their animations.
- Plays emotes on a player, including props and particle effects.
- Shows cosmetics on a player with any Minecraft skin (wide or slim arms), alone or as a full outfit in the outfit builder.
- Search, filter and sort on any field, with the view kept in the URL so it can be shared.
- Collections, side-by-side compare and ZIP export of the source files.
- Essential outfits follow Essential's own rules: items that can't be worn together, parts hidden by other cosmetics or by armor (drawn stand-in pieces, in any of Essential's three armor modes), and any Essential emote as the pose.
- Runs entirely in the browser; downloaded files are cached locally.
Requires Node.js 20.19+ or 22.12+ (Vite 8).
npm install
npm run dev # dev server
npm run build # type check + production build in dist/The build reads a PRIMEUI_LICENSE key from a .env file in the project root (never commit it).
Tests use Vitest in three projects:
- unit (
tests/unit, Node): parsers, catalog, geometry and other pure logic, run against a small fixture CDN.tests/unit/livechecks the real Lunar and Dawn CDNs (needs network, about a minute). - dom (
tests/dom, happy-dom): Vue components and the whole app on the fixture CDN, with WebGL faked. - browser (
tests/browser, Chromium through Playwright): real WebGL rendering, Cache Storage and live models. Runnpx playwright install chromiumonce before the first run.
npm test # all projects
npm run test:unit # or test:dom / test:browser for one project
npm run test:watch # rerun on change
npm run test:coverage # code coverage report in coverage/node scripts/coverage.mjs checks catalog coverage: it sorts every file in the CDN indexes into an item, a dependency of an item,
or a resource, and prints UNCLAIMED 0 (exit code 1 otherwise). Run it after changing src/providers/lunar/catalog.ts.
GitHub Actions (.github/workflows/test.yml) runs the type check and all tests with code coverage on every push to main and on pull requests,
and uploads the coverage report as a build artifact.
Hosted on Cloudflare Workers (static assets) at assetviewer.dreamys.studio, built from main by
Workers Builds (build command npm run build, then wrangler deploy with wrangler.jsonc; PRIMEUI_LICENSE set as a build secret).
The site is static except worker/, which proxies /dawn/* to Dawn's asset CDN (it sends no CORS headers); npm run dev does
the same through the Vite dev server.
This project is intended for educational purposes only. We are not responsible for any damage caused by this project.
Assets belong to their respective owners. This project is not affiliated with Lunar Client, Moonsworth, Dawn Client, Essential or ModCore.
This project was made almost entirely with Claude Opus 5.5 on Medium/High effort.
GPLv3 © Prometheus Reengineering