Skip to main content

dsh-ui-web/packages/skins/minecraft

34Stars2Forks0Issues0Watchers

A Minecraft-themed skin for DSH Web GUI, featuring procedurally-rendered pixelated panoramic skybox, block-style buttons, and sign-style input fields.

Categories▣ UI Enhancements◈ Themes & Skins
Evidence5/5methodologySourceInstallMaintenanceDSH versionSecurity scan
Machine-auditedInstall commandRepo verifieddsh-plugin topicLicenseREADMEAI wiki

ⓘ This plugin is a sub-package of the CAPTAIN1275/dsh-ui-web monorepo — stars and activity count the whole repository.

CAPTAIN1275CAPTAIN1275
·CAPTAIN1275/dsh-ui-web
Language
TypeScript
License
Apache-2.0
Branch
main
dsh-plugindsh-plugin-marketdsh-plugins

Install

cmdweb profile
$ dsh plugin --profile web add @captain1275/dsh-client-ui-skin-minecraft

Run the command above in your terminal to install this plugin via the dsh CLI. You can switch Profile in the top-right corner. New to dsh? Read the beginner tutorial

Install via your agent

Install the DeepSeek Harness plugin CAPTAIN1275/dsh-ui-web/packages/skins/minecraft for me: review the repository at https://github.com/CAPTAIN1275/dsh-ui-web first, then run the install command and verify the plugin loads successfully.

Paste this instruction to the DSH Web GUI assistant — it will install and verify for you.

One-Line Pitch

A skin plugin that gives the DeepSeek Harness (DSH) Web GUI a Minecraft main menu vibe: places a slowly rotating procedurally-drawn pixel panorama skybox behind the interface, turns buttons into gray stone slab blocks, turns input fields into wooden signs with nails, and anchors the overall color scheme to lapis lazuli blue, grass green, lime, and gold sand.

Core Features

  • Injects a 3D panorama skybox composed of 6 procedurally drawn SVG pixel scenes (village, lakeside, dense forest, snow peak + sky + grass block) behind the main interface, rotating 90 seconds per revolution around the Y axis to replicate the Minecraft main menu's visual feel
  • Renders buttons as MC-style gray stone slab blocks: black borders, bright top surface, dark bottom surface; hover text turns yellow, the entire block sinks 1 pixel when pressed
  • Renders input fields and text areas as wooden sign boards with corner iron nails: natural wood gradient + wood grain + dark borders; borders brighten and text turns white when focused
  • Transforms panels and sidebars into translucent dark stone slab backgrounds, allowing the rotating panorama skybox to show through panels with data transparency
  • Also rewrites the --dsw-static-* and --dsw-alias-* palettes, remapping the official dark blue palette to lapis lazuli blue and green to grass green, so components read tokens that also fall within the block world
  • Changes the browser tab's document title to Minecraft · DeepSeek Online, restoring the original title when the skin is uninstalled

Technical Implementation

  • Language: TypeScript
  • Key Dependencies: @deepseek-ai/cordis (effect lifecycle), lightningcss (CSS Modules compilation), tsdown (bundling)
  • Architecture Pattern: Pure client-side injection; all styles attached under body[data-dsh-minecraft] (dark variant adds [data-ds-dark-theme]), fully reclaimed via Cordis ctx.effect() disposer; no cordis services mounted, no events dispatched, no model requests triggered
  • Entry Files: src/index.ts (host-side empty shell apply) + src/client/index.ts (browser-side apply(ctx) containing DOM writing, panorama skybox assembly, SVG data URI generation)

Use Cases

Suitable for players or student users who want the DSH Web interface to look like it's running in Minecraft—wrapping the entire AI conversation tool workspace with pixel block skies and slab UIs. If you're already using another skin, you need to decide whether to switch to this one; skins cannot be stacked.

Prerequisites & Compatibility

DependencyMinimum VersionDescription
DSH WebRunning dsh web service (default http://127.0.0.1:3080)Only affects DSH Web GUI, other profiles unaffected
Node.js>= 18 (build time)Repository uses pnpm + tsdown; browser-only at runtime
pnpm>= 10Package management and build tool; install from source with pnpm install && pnpm -r build
PlatformCross-platform (macOS / Windows / Linux)Pure frontend injection, no native module dependencies

Installation

dsh plugin --profile web add github:CAPTAIN1275/dsh-ui-web/packages/skins/minecraft

Configuration

This plugin requires no additional configuration. Skin enablement is mutually exclusive; skin switching is managed by the repository root's dsh-skin tool:

  • dsh-skin use minecraft enables this skin
  • dsh-skin use official restores official default appearance
  • dsh-skin list views skins and current active item

After switching, the config watcher hot-reloads within seconds; refresh the page to take effect.

FAQ

Q: How do I switch back to the official default appearance after installing?

A: Run dsh-skin use official in the terminal; the config watcher hot-reloads within seconds. Refresh the page to restore the original look.

Q: Will this skin work together with other skins?

A: No. Skins are mutually exclusive and managed by the repository's dsh-skin; only one skin can be active at a time.

Q: Will page elements leave residues after uninstallation?

A: No. apply() fully reclaims everything it writes via the Cordis effect disposer, including the data-dsh-minecraft attribute on body, injected panorama skybox (6 faces of stage/skybox), masks, and document title.

Q: What if I get dizzy from all the motion?

A: When the browser has "Reduce Motion" enabled (prefers-reduced-motion), the skin automatically stops the panorama rotation and zeroes out all button and input field transition animations, returning the画面 to static.

Q: Are the panorama skybox assets official original textures?

A: No. Original Mojang panorama textures are copyrighted; all pixel scenes in the skin are procedurally drawn using SVG on 8px blocks (blocky mountains, pixel clouds, blocky trees, mushrooms, pumpkins, birds, flowers, etc.). Each face's assets are generated from seed-based pseudo-random scatter points, ensuring consistent visuals on every refresh.

Q: Will this skin affect DSH Web's functionality?

A: No. The skin only modifies body attributes, injects DOM elements, and rewrites document.title; it doesn't mount cordis services, dispatch events, or touch model requests. It interfaces via CSS variables without interfering with the right-side file panel (aionui), Git graph, or other features that have their own token systems.

Difficulty Level

Beginner — one installation command plus one dsh-skin use minecraft takes effect; panorama skybox, button styles, and color palette are all built-in, requiring no configuration or coding.

Known Issues & Limitations

  • The subpackage LICENSE file is BSD-3-Clause, but the license field in package.json is set to Apache-2.0; the two declarations are inconsistent. The LICENSE file's actual content (BSD-3-Clause) takes precedence; it is recommended to align both before redistributing
  • Mutual exclusive skin switching depends on the repository root's scripts/dsh-skin script; it only works when installed from the same repository link. When cloning this subdirectory separately, you need to manually maintain the managed section of ~/.dsh/cordis.patch.yml
  • The installation command in the original README gives link:<absolute path to this repository>; this wiki provides the GitHub installation form according to plugin market standards; both are equivalent
  • When installing from GitHub, pnpm >=10 will block the build script; you need to add the printed package key to the profile's pnpm-workspace.yaml allowBuilds list and retry
  • No other known issues currently

Read the usage guide →

Install steps, key points, FAQ and compatibility for this plugin — auto-derived from indexed fields.

Listing badge

Listed on deepseek-plugin.org
[![Listed on deepseek-plugin.org](https://img.shields.io/badge/listed_on-deepseek--plugin.org-007EC6)](https://deepseek-plugin.org/plugins/CAPTAIN1275/dsh-ui-web/packages/skins/minecraft)

Paste this markdown into your GitHub README to link back to this listing. The badge only states the listing — not a security endorsement.

← Back to plugin directory