@captain1275/dsh-client-ui-skin-minecraft
v0.3.1
Published
Hot-pluggable Minecraft skin for the dsh web GUI: <edit me — one line pitch>
Readme
@captain1275/dsh-client-ui-skin-minecraft
A voxel take on the dsh web GUI, styled after the Minecraft main menu: a procedurally drawn pixel-art panorama skybox (blocky hills, pixel clouds, block trees, grass blocks) drifts slowly behind the app inside a CSS 3-D cube — the same panorama motion as the game's title screen, drawn from scratch rather than shipping Mojang's copyrighted textures. Buttons wear the classic MC widget sprite (gray slab, black outline, yellow hover label, press-down on click), inputs become sign posts (wooden plank with corner nails), panels float as translucent slate, and the palette maps to lapis blue, grass green, stone gray and gold sand.
Hot-pluggable as a client plugin in the official standalone bundle shape:
apply() sets the data-dsh-minecraft body attribute (the scope of the whole
stylesheet), renders the chrome, and pins the document title; its effect
disposer retracts every write. The stylesheet rides the bundle's CSS-modules
auto-inject, so the loader removes it with the entry.
The skin is presentation-only: no services are injected, no cordis events are emitted, and nothing reaches a model request.
Installing (official bundle)
Prefer the family aggregate package @captain1275/dsh-skins — every skin at once; for this skin alone, install with link::
# All skins (recommended)
dsh plugin --profile web add @captain1275/dsh-skins
# Or just this skin
dsh plugin --profile web add @captain1275/dsh-client-ui-skin-minecraft
# Activate: dsh-skin use minecraft
# From the repo (dev): dsh plugin --profile web add link:$(pwd)/packages/skins/minecraft$(pwd) is your clone of the dsh-web-ui monorepo.
A local link: install needs built artifacts first — lib/ is git-ignored and not committed, so run pnpm install && pnpm -r build in the monorepo before linking. Git installs (dsh plugin --profile web add github:<org>/dsh-web-ui#<sha>) build lib/ themselves via the prepare script; pnpm ≥10 blocks that until you copy the printed package key into the profile's pnpm-workspace.yaml allowBuilds list and re-run.
Activate or switch with dsh-skin use minecraft (helper script scripts/dsh-skin in the monorepo); only one skin is active at a time.
Building and testing
pnpm build # tsdown: lib/index.js + lib/client.js (self-contained preset)
pnpm test # vitest: apply/dispose contract specPublishing to the skin center
node scripts/skin-center-bundles # re-embed this skin into skin-center's registry
pnpm --filter @captain1275/dsh-client-ui-skin-center build
node scripts/gallery-build # refresh the gallery manifest/bundles
node scripts/capture-previews # re-shoot preview/light.png + preview/dark.pngThen commit everything (lib/, preview/, regenerated registry/gallery) and open a PR.
