Preface¶

When handling Minecraft server plugin or mod tasks in DeepSeek Harness (DSH), the common challenge is not generating a single file, but dealing with simultaneous changes in versions, platforms, and build pipelines. The coding approaches for Paper, Spigot, Fabric, Forge, and NeoForge differ, and the dependencies and JDK requirements vary across Minecraft versions from 1.7.10 to 26.x.

Below, we introduce sikadi233-hub/minecraft-dev. It is a Minecraft development plugin for DSH, providing relevant skills, tools, sub-agents, and Agent presets to help agents better write Minecraft server plugins and mods.

What Is This¶

Plugin name: sikadi233-hub/minecraft-dev
Maintainer: sikadi233-hub
License: MIT
npm package name: minecraft-dev
Official installation command: dsh plugin --profile web add minecraft-dev

This plugin covers development knowledge for MC 1.7.10 ~ 26.x Paper/Spigot plugins and Fabric/Forge/NeoForge mods, offering the following components:

7 on-demand load skills
2 tools: mc_scaffold, mc_gradle
4 built-in sub-agents
1 minecraft Agent preset

Directory page:
https://www.skillhub.cn/plugins/sikadi233-hub/minecraft-dev

Source code:
https://github.com/sikadi233-hub/minecraft-dev

Core Features¶

On-Demand Load Skills¶

The plugin provides 7 skills:

minecraft-java-build
minecraft-paper-plugin
minecraft-fabric-mod
minecraft-forge-mod
minecraft-neoforge-mod
minecraft-spigot-legacy
minecraft-major-mods

When a Minecraft-related task is initiated, the model will automatically call the skill tool to load the corresponding skill. You can also manually inject it by sending directly in the input box, for example:

/minecraft-paper-plugin

Other skill names can be manually sent in the same way.

Tools¶

The plugin provides 2 tools.

mc_scaffold is used to create buildable projects for Paper/Fabric/Forge/NeoForge/Spigot. According to the plugin disclosure, mc_scaffold only writes files under the user-specified targetDir.

mc_gradle is used to run gradlew <task> in a project. According to the plugin disclosure, mc_gradle executes gradlew in the user-specified project directory. mc_gradle relies on the presence of taskkill on the target machine (win32), truncates output to inline markers at the start and end, and does not spill files.

Built-in Sub-Agents¶

The plugin provides 4 built-in sub-agents:

subagent_mc_plan
subagent_mc_skeleton
subagent_mc_content
subagent_mc_verify

Example conversation:

Help me create a Paper plugin my-plugin with package name com.example.myplugin for MC 1.21.8 using the four sub-agent team.

Minecraft Expert Preset¶

The plugin provides 1 Agent preset: minecraft.

Starting from v0.6.0, after installing the plugin and restarting dsh, it will automatically install to:

$DSH_HOME/.agent-presets/minecraft/

This automatic installation only writes and does not overwrite existing presets. To disable automatic installation, you can configure:

autoInstallPreset: false

Installation and Enabling¶

npm Installation¶

Recommended method:

dsh plugin --profile web add minecraft-dev

Domestic npm mirrors may not be synchronized. If you encounter:

ERR_PNPM_FETCH_404

You can add the official source:

dsh plugin --profile web add minecraft-dev --registry=https://registry.npmjs.org

Local Tarball and Direct Source Connection¶

The plugin supports npm installation, local tarball offline/intranet installation, and direct source connection installation.

Running from dsh Source Code¶

If running from dsh source code, the command should use:

pnpm dsh

Instead of:

dsh

Restart After Installation¶

After installation, you must restart the dsh service. A running dsh will not automatically load newly installed plugins.

Typical Usage¶

Common examples are as follows:

Create a Paper plugin my-plugin with package name com.example.myplugin for MC 1.21.8
Create a Forge 1.12.2 mod mymod with package name com.example.mymod
Write a Botania 1.12.2 addon that registers a new flower
Run build on the current project using mc_gradle

You can also let the agent use the four sub-agent team:

Help me create a Paper plugin my-plugin with package name com.example.myplugin for MC 1.21.8 using the four sub-agent team.

Following the above steps, the plugin will load skills based on the current task and use mc_scaffold or mc_gradle to handle project creation and build tasks.

Use Cases and Notes¶

Suitable for these use cases:

Writing Paper/Spigot plugins in a DSH session
Writing Fabric/Forge/NeoForge mods in a DSH session
Handling legacy line projects like MC 1.7.10, 1.12.2, 1.16.5
Splitting Minecraft development tasks using sub-agents
DSH sessions requiring the minecraft expert preset

Usage notes:

The plugin runs with the current dsh process permissions. Before installation, you should check the source code, license, and disclosure information.
The plugin license is MIT.
package.json disclosure: cloud=false, network=[], offlineMode=true, apiKeys=[], retention=none.
Legacy line versions 1.7.10, 1.12.2, 1.16.5 require manually installing JDK 8 and setting JAVA_HOME.
For spigot 1.7.10 templates, before building, you need to place the spigot-api jar according to the libs/README.txt in the project.
User-local skills with the same name will override the bundled skills in this package, which is expected behavior. In case of conflicts, you need to delete the local directory with the same name.
API references are curated high-frequency signatures, not full Javadoc.
npm run check-links will verify links and curse.maven projectIds, and UNVERIFIABLE items require manual review.

Conclusion¶

The value of minecraft-dev lies in installing the skills, tools, sub-agents, and Agent presets required for Minecraft development into the DSH session, enabling agents to have clearly loadable knowledge and tools when handling Paper/Spigot plugins and Fabric/Forge/NeoForge mods.