Introduction

Creating HTML5 mini-game prototypes typically involves selecting an engine, setting up the skeleton, implementing collision and input, and then adding responsiveness and performance optimization. If left to an AI agent, issues usually arise in two places: first, the technical selection and requirements for adaptation need to be re-stated for every conversation; second, patterns like collision detection and object pools are repeatedly written by hand, leading to unstable output quality.

The approach taken by dsh-minigame-plugin is to solidify these experiences into skill documents. DSH’s philosophy is “Everything is a Plugin”; capabilities are injected into conversations via plugins. After installing this plugin, you can describe the game you want to create directly in a DeepSeek Harness conversation. It will select the engine based on requirements, apply reference patterns, and output a single-file, zero-dependency page ready to play. The following sections introduce its features, installation method, and typical usage.

What is it

dsh-minigame-plugin is a DeepSeek Harness plugin authored by sasajun2345, current version 0.1.0, MIT licensed. One-sentence positioning: Let AI help you quickly create various HTML5 mini-games.

It does not restrict game types; both 2D and 3D are supported. The division of labor is simple: the user proposes requirements, and the plugin handles combining the engine and reference patterns to translate the requirements into a playable game file.

Key Features

  • Engine Support: Canvas 2D / Phaser.js / DOM + CSS / Three.js / Babylon.js, automatically selected based on requirements. The first three are for 2D scenarios, while Three.js and Babylon.js are for 3D scenarios.
  • Reference Docs: Built-in 17 reference documents covering reusable patterns such as collision detection, particle systems, physics engines, and grid algorithms.
  • Sound & Save: Supports procedural sound effects and high-score storage.
  • Internationalization: Multi-language support for Chinese/English/Japanese/Korean; automatically detects browser language and switches with one click.
  • Bundle & Performance: Object pooling, off-screen Canvas, InstancedMesh, device tiering, idle frame dropping; documented metrics are 2D < 40 KB, 3D < 128 MB.
  • UI Adaptation: Automatically adapts to PC, tablets, and phones; supports virtual joysticks, portrait/landscape switching, and notch-safe areas.
  • Game Narrative: Three-act structure, character design, multiple endings.
  • Advanced UI Design: Restrained composition, cardless design, dark theme, intentional motion effects.
  • Output Format: Single file, zero dependencies, ready to play upon opening.

Installation and Activation

Prerequisites: Node.js >= 20.19.0, DeepSeek Harness Developer Preview. The plugin depends on @deepseek-ai/dsh-skill-filesystem ^0.1.0-rc.6 and handles this automatically during installation.

Install to Web Configuration File

Execute the following command to add the plugin to the web configuration file:

npx @deepseek-ai/dsh plugin --profile web add github:sasajun2345/dsh-minigame-plugin

Verify Installation

Run the following command to check the configuration:

npx @deepseek-ai/dsh --profile web --dump-config

The output should include the dsh-minigame-plugin layer and the minigame-skill-filesystem line, indicating the plugin has been loaded correctly.

Local Development and Temporary Trial

If you are modifying this plugin locally, you can install it from the current directory:

npx @deepseek-ai/dsh plugin --profile web add .

Alternatively, you can use a patch method to try it out temporarily without committing it to the configuration:

npx @deepseek-ai/dsh web --patch ./cordis.patch.yml

Typical Usage

After installation, simply describe the game you want to make in a DeepSeek Harness conversation; the skill activates automatically. There is no restriction on game type; any type can be created. For example:

帮我做一个弹球消砖块游戏
做一个贪吃蛇，要有粒子特效
创建一个暗黑主题的射击游戏
做一个 2048 游戏，用粉嫩配色
做一个 3D 赛车游戏，有氮气加速
做一个 Roguelike 地牢探险游戏

From these examples, it can be seen that specifying the engine and implementation details in the description is not necessary—whether it’s 2D or 3D, whether effects are needed, and what color scheme to use, just clarifying the requirements is enough; the plugin handles engine selection and pattern reuse.

Use Cases and Notes

It is suitable for two types of users: developers who want to quickly produce playable HTML5 prototypes to save time from building from scratch, and those who want to equip their DSH agent with mini-game generation capabilities. After installation, it is ready to use in conversations.

A few points to note before use:

  1. The plugin runs with the permissions of the current dsh process. Before installing third-party plugins, it is recommended to read the source code in the GitHub repository to confirm behavior meets expectations before installing.
  2. The license is MIT; confirm it meets your authorization requirements before redistribution or secondary development.
  3. The bundle metrics provided in the README (2D < 40 KB, 3D < 128 MB) are optimization targets stated in the documentation; actual results depend on the specific game’s complexity.

Summary

dsh-minigame-plugin consolidates engine selection, common mechanisms, and adaptation optimization from mini-game development into skill documents, allowing DeepSeek Harness to generate an “open-and-play” HTML5 game from a single description. It is worth trying for scenarios that require rapid validation of gameplay prototypes.

  • Directory Page: https://www.skillhub.cn/plugins/sasajun2345/dsh-minigame-plugin
  • GitHub: https://github.com/sasajun2345/dsh-minigame-plugin