MIT-licensed SMAPI mod plus DSH plugin that turns Stardew Valley into text for DeepSeek — 53 tools, a session preset, F7 takeover and a localhost MCP server, no vision model required.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-13
License
MIT
01What can it help you accomplish?
Let a DeepSeek Harness session play Stardew Valley without any screenshot or vision model
A text observation of the game (state, inventory, character map, object coordinates, crops, exits, dialogue and shop contents) that the model reasons over, with the mod executing the resulting tool calls
dsh users who want an agent to actually play a game with a text-only model
Hand day-to-day farm work to the agent through 53 tools
Tool calls for movement and cross-map routing, tilling/planting/watering/harvesting, fishing, animal care, town business, mining and combat, plus UI and time actions
Players who would rather supervise a farmhand than grind the early game
Drive the same game session from another MCP client when you do not want to spend DeepSeek tokens
An MCP endpoint on `http://127.0.0.1:18080/mcp` that WorkBuddy / Claude Code / Cursor can attach to, so the client's own model calls the mod's tools
People already running an MCP-capable client who want the game tools there
02How to install into DeepSeek Harness
Prerequisites
- SMAPI installed as the Stardew Valley mod loader — the README was developed against SMAPI 4.5.2 + game 1.6.15
- A DeepSeek API key, unless you only drive the mod from an MCP client
- .NET 6 or newer SDK only for building the mod from source
Installation steps
- 01
Install `dsh-stardew-blind-whale-farmer` from the DSH plugin market — the plugin ships the compiled mod and copies it into the game's `Mods` (wait until the game is closed); fill in the Stardew Valley directory in the plugin's config card if it cannot find the game
- 02
Alternative: download the archive from GitHub Releases and drop the `BlindWhaleFarmer` folder into the game's `Mods` folder, or build from source with `powershell -ExecutionPolicy Bypass -File build.ps1` then `install.ps1`
- 03
Put your DeepSeek key in `ApiKey` inside `Mods\BlindWhaleFarmer\config.json`, or set the `DEEPSEEK_API_KEY` environment variable instead
- 04
Start the game through SMAPI, load a save, and press F8 to start or stop the AI
- 05
For the DSH preset route: enable the “大肥鱼种白饭” session preset in the plugin's config page, then create a new session and select it — only that session gets the game tools
Verify the integration
- The top-left corner of the screen shows what the AI is thinking and which action it is executing
- `dsai_state` prints the text state sent to the AI without calling the API
- `dsai_tokens` reports the tokens consumed in the current run
03DSH integration and capability boundaries
DSH plugin plus a SMAPI mod: the plugin market install ships the compiled C# mod into the game's `Mods` and adds a session preset / entry tool plus a config card; the mod itself exposes a local MCP server
Text observation of the game
the running Stardew Valley save→text state: time, weather, money, stamina, inventory, a 29×19 character map, crop/object coordinates, exits, villager and animal info, dialogue and shop contents
nothing is captured as an image — no screenshot and no vision model is involved53 game tools
the model's tool calls→pathfinding movement, batch farm work, fishing, animal care, town/building actions, mining and combat, UI and time actions
every action runs through the game's own logic, so stamina, animation and drops match manual playDSH session preset and entry tool
a new dsh session (preset) or any session (entry tool)→a session that carries the game tools and instructions, or a single `stardew` entry tool for existing sessions
both are off by default and must be enabled in the plugin's config pagethe game tools and instructions only load into the session that opted inLocal MCP server
an MCP client such as WorkBuddy, Claude Code or Cursor→the mod's tools plus `get_state`, `get_guide`, `toggle_ai` and `load_save` over `http://127.0.0.1:18080/mcp`
the server listens on localhost onlygame time freezes while the client thinks and the game pauses after `McpIdleSeconds` (120 s by default)the built-in AI and an MCP client cannot drive the game at the same timeTakeover, notes and run logs
the F7 key, the `dsai_notes` command, the transcript files→immediate cancellation of the running action, an editable long-term note store, and a full action transcript per run
`Mods\BlindWhaleFarmer\logs\transcript-*.log` is written per runnotes are stored per save under `Mods\BlindWhaleFarmer\data\`
04Who is it for? When not to use it?
Good for
- dsh users who want an agent to actually play a game with a text-only model
- Players who would rather supervise a farmhand than grind the early game
- People already running an MCP-capable client who want the game tools there
Not for
- It is a SMAPI mod plus a DSH plugin: Stardew Valley with SMAPI installed (developed against SMAPI 4.5.2 + game 1.6.15), and a DeepSeek API key unless you only use an MCP client. Building from source additionally needs the .NET 6+ SDK.
- Each step sends roughly 10k–14k input tokens and the AI takes a step every 10–20 s, so an hour of play is roughly one to two million input tokens — this is paid DeepSeek API traffic, though any OpenAI-compatible `BaseUrl` works.
- The AI saves the game when it sleeps, so back up the save or start a dedicated save for the AI. For unattended runs you must also turn off Stardew Valley's “pause when window is inactive” option.
- The game tools must not leak into every session: enable the session preset (or the single entry tool) instead of mounting `@deepseek-ai/dsh-mcp-client` globally, existing sessions cannot switch presets, and desktop and web use separate profiles that each need their own install.
05Compatibility, maintenance and safety notes
- It is a SMAPI mod plus a DSH plugin: Stardew Valley with SMAPI installed (developed against SMAPI 4.5.2 + game 1.6.15), and a DeepSeek API key unless you only use an MCP client. Building from source additionally needs the .NET 6+ SDK.
- Each step sends roughly 10k–14k input tokens and the AI takes a step every 10–20 s, so an hour of play is roughly one to two million input tokens — this is paid DeepSeek API traffic, though any OpenAI-compatible `BaseUrl` works.
- The AI saves the game when it sleeps, so back up the save or start a dedicated save for the AI. For unattended runs you must also turn off Stardew Valley's “pause when window is inactive” option.
- The game tools must not leak into every session: enable the session preset (or the single entry tool) instead of mounting `@deepseek-ai/dsh-mcp-client` globally, existing sessions cannot switch presets, and desktop and web use separate profiles that each need their own install.
MIT · README evidence only · latest release v1.1.7 (2026-11-12) · safety not audited
06Frequently asked questions
How do I install it into DeepSeek Harness?
Install `dsh-stardew-blind-whale-farmer` from the DSH plugin market: the plugin bundles the compiled SMAPI mod and copies it into the game's `Mods` folder (wait until the game is closed), and “update” in the market updates both together. If it cannot find the game, fill the Stardew Valley directory into the plugin's config card. SMAPI itself must be installed first.
Why doesn't the AI see the game in my session?
The “大肥鱼种白饭” session preset is off by default. Enable it in the plugin's config page, then create a new session and select it — only that session connects to the game and gets the tools. Sessions that already have messages cannot switch presets (a DSH rule), and other sessions intentionally carry none of these tools.
Do I need a DeepSeek API key?
Only for the built-in AI. Put the key in `ApiKey` in `Mods\BlindWhaleFarmer\config.json` or set the `DEEPSEEK_API_KEY` environment variable. If you instead connect WorkBuddy, Claude Code or Cursor to the mod's MCP server, the client's own model plays the game and no DeepSeek key is needed.
What does it write, and where?
Each run writes a full action transcript to `Mods\BlindWhaleFarmer\logs\transcript-*.log`, and the AI's long-term notes live per save under `Mods\BlindWhaleFarmer\data\` — those notes appear at the top of `get_state`, so a new session can continue. Game settings such as play days or minutes are edited in the plugin's config page and pushed to the game without a restart.
How much does a session cost?
Each step sends about 10k–14k input tokens and the AI takes a step every 10–20 seconds, so roughly one to two million input tokens per hour. The system prompt plus 43 tool definitions (~7.5k) is stable and can hit DeepSeek's cache; `dsai_tokens` shows the actual consumption of the current run.
07Related DSH workflows
rea
by morluto
Reverse engineer anything with agents, from app behavior down to native binaries.
reactive-resume
by reactive-resume
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
next-ai-draw-io
by dayuanjiang
Draw and edit draw.io diagrams by chatting with an AI. Web app, desktop app, and an MCP server for Claude Code, Cursor, Codex and VS Code.
everos
by evermind-ai
One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, tools, and workflows.
08Data and sources
`dsh-stardew-blind-whale-farmer`:一个 SMAPI 星露谷模组,加一个 DeepSeek Harness(DSH)插件。
**用 DSH 的话最省事**:在 DSH 的插件市场装 dsh-stardew-blind-whale-farmer。插件自带编译好的模组,会自动装进游戏的 `Mods`(游戏开着时等关了再装);以后在插件市场点“更新”,插件和模组一起更…
提供一个 **“大肥鱼种白饭”会话预设**(默认关闭,在插件的配置页里打开):新建会话时选它,那个会话才连上游戏、拿到玩游戏的工具;其他会话里完全没有这些工具和说明,不占上下文;已经对话过的会话不能再换预设(DSH 的规定),要玩请新建会话
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-13. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
