Preface

The plugin mechanism of DSH allows extending the web interface. If you want to transform the DSH interface into a Minecraft pixel style while retaining texture management and local music playback, here introduces the dsh-minecraft-theme maintained by SuperLS-X. First, it explains what it solves, then provides installation, usage, and important resource boundaries.

What is this

dsh-minecraft-theme is a Minecraft theme plugin for DeepSeek Harness (DSH). It provides block texture backgrounds, pixel fonts, MC-style buttons with click sound effects for the DSH web interface, and includes texture import/management and a music player. Maintained by SuperLS-X, licensed under MIT.

Core Features

Theme

  • Provides 21 official Minecraft block texture backgrounds, switchable with one click.
  • Texture size options: 64 / 96 / 128 / 192 / 256 px.
  • Pixel fonts use Chinese Zpix and English Silkscreen, applied across the entire interface.
  • Buttons are MC-style gray embossed buttons, playing the official Minecraft click.ogg sound effect on click.
  • Floating block particles are decorative elements, can be toggled on or off.

Texture Management

  • Built-in 21 blocks plus imported/custom textures in a unified list, applicable with one click.
  • Management operations include renaming, deletion (recoverable), and reordering (move up / move down).
  • Texture import supports pasting images (Ctrl+V), dragging images, or entering local image paths / data URI.
  • Custom textures, renaming, and sorting are saved locally, persisting after restart.

Music Player

  • Built-in 16 official Minecraft soundtracks.
  • Playback controls include play/pause, previous/next track, volume, draggable progress bar, and auto-play.
  • Supports selecting local music folders to import personal music in formats ogg / mp3 / wav / flac, unlimited quantity; played locally without uploading.
  • Default music and local music are displayed in separate groups.
  • Built-in music cache for up to 6 tracks (LRU), with streaming playback for local music.

Installation and Enabling

First, confirm the dependency environment. The peerDependencies declared in package.json are:

@deepseek-ai/cordis ^4.0.1

Then install as per the README instructions. Below is the installation command from the resources, to be sent directly to DSH:

安装https://github.com/SuperLS-X/dsh-minecraft-theme

After the above steps, follow the prompts to confirm.

Typical Usage

  1. Two buttons, “Textures” and “Music”, appear at the bottom of the sidebar.
  2. Click “Textures”: switch background textures, import/manage custom textures.
  3. Click “Music”: select tracks to play, import local music folders.
  4. Clicking any button plays the MC click sound; opening the texture panel allows adjusting texture size and toggling particles.

Resource and Interface Boundaries

This plugin is a DSH rc.7 static plugin. The host side mounts it via profile bundle in cordis.patch.yml, and the browser side is provided by /plugins/<id>/client.js. The host registers the /mc/rpc route on ctx.webServer for browser-side fetch calls.

Local resources (textures, fonts, sound effects, music) are all read within the host process without uploading. When online, it can be used fully without any local resources. Resource loading priority is as follows:

  1. Workspace:
<workspace>/mc-textures/
  1. Default resources bundled with the package.
  2. CDN fallback.

For offline optimization, place resources in the workspace:

<workspace>/mc-textures/zpix.ttf
<workspace>/mc-textures/music/*.ogg

Custom textures and settings are saved to:

<workspace>/mc-textures/custom-textures.json

Applicable Scenarios and Notes

Suitable for users who need a Minecraft-style theme, texture management, or local music playback in the DSH web interface.

Before installation, note:

  • The plugin runs with the current DSH process permissions; check the source code and license before installing.
  • This plugin is licensed under MIT.
  • Minecraft is a trademark of Mojang Studios; this plugin is not affiliated with Mojang.
  • Default music, sound effects, and textures come from InventivetalentDev/minecraft-assets (for non-commercial learning purposes), with related copyrights owned by their respective owners.
  • The fonts Silkscreen and DotGothic16 distributed with the package are under the SIL OFL 1.1 license; Zpix is copyrighted by its author and loaded on-demand via CDN only, not distributed with the package.

Conclusion

The value of dsh-minecraft-theme lies in transforming the DSH web interface into a switchable Minecraft style and integrating texture and music management into the sidebar; local resources are read within the host process without uploading. GitHub address:

https://github.com/SuperLS-X/dsh-minecraft-theme