Skip to main content
Glama

Stardew Sim — map simulator & pixel toolkit for AI modding

Web: https://waifuhtr.github.io/Stardew-valley-mcp/ (mobile friendly)

Every vanilla Stardew Valley map — 259 maps including all building interiors, mines, Ginger Island and festival variants — extracted into a compact format and made simulatable: collision, doors/warps between locations, pathfinding, an NPC walking through it, and consistency checks for new locations. Plus a pixel-art toolkit that lets an AI read/write sprites as text.

The goal: AI assistants making Stardew mods stop guessing coordinates and stop needing screenshots.

web/

Web app: map viewer + walkable NPC simulation (tap-to-walk, D-pad, enters buildings), TMX mod testing, pixel editor

cli/sdv.mjs

Map CLI: find info ascii tile path go route render sheet tmx check fit patch

cli/px.mjs

Pixel CLI: draw read ops palette preview spec check slice pack (PXT text sprites)

mcp/server.mjs

Zero-dependency MCP server: tools sdv and px (one args string each → tiny schema)

tools/extract.mjs

XNB (Android LZ4 / uncompressed) or unpacked TMX+PNG → web/data

examples/beach-cabin/

Example: enterable beach cabin drawn with px ops → installable CP mod in mods/ and shown on the web map

AGENTS.md

Token-efficient workflow guide for AI agents

Quick start

node cli/sdv.mjs find saloon
node cli/sdv.mjs ascii SeedShop
node cli/sdv.mjs go Farm 64 15 Saloon 10 20
node cli/sdv.mjs render Town --region 40,50,20,15 --actor 45,60,left --grid -o town.png
node cli/px.mjs read web/data/img/extra/sprites.png --frame 16,32,0
node tools/serve.mjs 8080        # web app locally
node tools/test.mjs              # smoke tests

MCP (Claude Code):

claude mcp add --scope user stardew-sim -- node /abs/path/Stardew-valley-mcp/mcp/server.mjs

No npm dependencies; Node ≥ 18.

Related MCP server: Aseprite MCP Server

Türkçe

Tüm Stardew haritası (bina içleri dahil) çıkarıldı ve simüle edilebilir: çarpışma, kapılar/warp'lar, yol bulma, NPC yürütme, yeni konum/bina eklerken tutarlılık kontrolü (check, fit, patch). Piksel aracı (px + web editör) sprite'ları metin (PXT) olarak okuyup yazmayı sağlar — yapay zeka için az token, kullanıcı için web'den önizleme. Web sürümü mobil uyumludur: dokun-yürü, D-pad, iki parmakla yakınlaştırma.

Game assets © ConcernedApe. This repository is an unofficial modding reference; it is not affiliated with or endorsed by ConcernedApe.

Related MCP Connectors

Related MCP Servers