dsh-game-studio README

README проекта с github.com/ZSeven-W/dsh-game-studio. Одним файлом markdown: README.md.

DSH Game Studio

DSH Game Studio

Describe a small game in one sentence — play it in the sidebar of a DeepSeek Harness conversation, swap in AI art, export one HTML file.
10 agent tools • live sidebar preview • 2D and 3D voxel templates • OpenAI or Codex art with a cost check first • self-playing playtests • version history • one-file export

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Français · Español · Deutsch · Português · Русский · हिन्दी · Türkçe · ไทย · Tiếng Việt · Bahasa Indonesia

Package: @zseven-w/dsh-game-studio · Current plugin release: 0.1.0-rc.5 · Tested with DSH 0.2.1-rc.5
🎮 Live Demo Game Wall (10 playable 2D & 3D games) · Subscribe in Online Sources: finiking/dsh-games


DSH Game Studio — one sentence, one playable game

A 3D game running in the Game Studio sidebar, with AI art candidates ready to apply

The game plays in the right sidebar while the agent works; numbered AI art candidates wait under it for you to pick

Why DSH Game Studio

Ask the agent for a game in plain words — "a 3D game: a red panda collects bamboo shoots in a forest and dodges wild boars" — and it builds one from a template, plays it to check it works, and shows it in a sidebar you can play right away. Characters start as code-drawn models; when you want real art, the agent generates candidates with OpenAI or your Codex sign-in, you pick one by number, and the game swaps it in. Every change is a version you can go back to, and the finished game exports as a single offline HTML file.

🎮 Playable from the first answer Two templates — a 2D top-down game and the same loop in a 3D voxel world (three.js) — that the agent reshapes into the game you described: characters, rules, levels, screens.
🖥️ Live sidebar preview The game runs in a sandboxed panel next to the conversation, rebuilds on every change, and lists the art slots, candidates and versions under it. Landscape games get a wide stage.
🎨 Your own art, with a cost check first game_studio_generate_asset makes numbered candidates per slot with the OpenAI image API or the local Codex CLI. Before anything is spent you get an approval card with the service, image count and expected cost. A picture you attach in chat can be the reference.
🤖 Self-playing playtests game_studio_playtest plays the latest code in a headless Chrome or Edge and reports phases, score, frame rate, script errors and screenshots. Games that are not steered with arrow keys (grids, cards, aiming, rhythm…) define window.__autoplay, so the playtest plays their real loop.
🕰️ Version history Every build that changed the game is saved; game_studio_restore_version brings back code, rules and art together.
📦 One-file export game_studio_export writes a self-contained HTML file with no network access — open it in any browser or put it on any static host.
📱 Try it on your phone game_studio_share opens a temporary read-only link on your local network — or a temporary public link via a Cloudflare Quick Tunnel (cloudflared) so friends on any network can play — with a QR code in the sidebar.
🌐 Publish to GitHub Pages game_studio_publish pushes the built HTML (or the whole game wall) to a public repository under your signed-in gh account and enables GitHub Pages for a permanent link that stays live after you close your computer.
🗂️ My games Open the sidebar's + and pick Game Studio · My games: every game in the workspace as a tile with its latest playtest picture, filtered by 2D/3D and sorted by recency, versions or name. Click one to play it — no agent, no tokens. You can also subscribe to online game sources (owner/repo, GitHub repository URL, or GitHub Pages URL) to browse and play published games alongside your own. Export wall packs your local games into one offline page to send to friends.

Games made with it

🎮 Try 10 test games live in your browser (desktop or mobile): finiking.github.io/dsh-games/wall — or enter finiking/dsh-games under Online sources in your local Game Wall to subscribe and play them in your sidebar.

Four games from our test runs. Each started from the one sentence under it, in a fresh session (prompts translated from Chinese); later requests in the same session tweaked some of them, as noted. Gameplay is recorded with each game's own autoplay.

Moonlit Fox: Lantern Isle — 3D voxel template, live gameplay

Moonlit Fox: Lantern Isle — 3D voxel template, live gameplay

Make a small game: a little fox collects lanterns in a moonlit forest and dodges thorn monsters.
“Make a small game: a little fox collects lanterns in a moonlit forest and dodges thorn monsters.”
2D template; characters later swapped for picked AI art
Make a 3D game: a little fox collects lanterns on a voxel island and dodges thorn monsters.
“Make a 3D game: a little fox collects lanterns on a voxel island and dodges thorn monsters.”
3D voxel template; the lantern model was redone in a later request
Make a 3D game: a little penguin collects fish on an iceberg and dodges seals.
“Make a 3D game: a little penguin collects fish on an iceberg and dodges seals.”
3D; a later request added the red hat
Make a 3D game: a red panda collects bamboo shoots in a bamboo forest and dodges wild boars.
“Make a 3D game: a red panda collects bamboo shoots in a bamboo forest and dodges wild boars.”
3D; characters later swapped for AI art, the forest stays 3D

How well it works

Measured in a real DSH with DeepSeek-V4.1-Flash, each game made from one sentence in a fresh session, scored by an independent playtest (2026-11-04/05):

Tools

Tool What it does
game_studio_create Create a playable game from the collector (2D) or voxel (3D) template, build it and show it in the sidebar. Takes the title, an art style, orientation (portrait or landscape) and slots — the game's own art slots, named in the user's language.
game_studio_build Rebuild after editing game.json or game.js, refresh the preview and save a version with a short note.
game_studio_playtest Play the latest code headlessly (phone-shaped portrait or 960×540 landscape) and report phases, best score, hearts, fps, errors and screenshots; characters: true returns close-ups of the characters only.
game_studio_generate_asset Generate 1–4 candidate images for one slot with openai or codex, optionally following a reference picture. Asks for approval before spending. Codex runs in the background.
game_studio_apply_asset Put a candidate into the game by its number, rebuild and refresh.
game_studio_revert_asset Go back to a slot's previous art.
game_studio_versions List saved versions, newest first.
game_studio_restore_version Restore an earlier version of the whole game.
game_studio_export Export one self-contained, offline HTML file.
game_studio_share Open (or close) a temporary read-only link on the local network, or pass public: true for a temporary public link via cloudflared so anyone with the link can play.
game_studio_list List the games in the working directory with title, 2D/3D, build state and versions, so the agent finds "the penguin game" by name.
game_studio_export_wall Export the game wall: one offline HTML page with a tile per built game; click a tile to play it.
game_studio_publish Publish the built game (or wall: true for the game wall) to GitHub Pages via the local signed-in gh CLI, or pass remove: true to delete it. Asks for approval first and only writes to repositories carrying its .dsh-game-studio.json marker.

The sidebar's buttons (apply, revert, build, export, restore, share, publish) call the same operations through the /game-studio command.

Image services and spending

Service What it needs Cost Notes
OpenAI (GPT Image) An API key in DSH credentials or the environment (OPENAI_API_KEY by default) Billed per image to your key; the approval card shows an estimate About a minute per batch. openaiBaseUrl accepts an OpenAI-compatible gateway.
Codex CLI Codex installed and signed in (codex login) Counts against your Codex plan; no API key Several minutes per image, runs in the background and reports back when done.

imageProvider: auto (the default) uses OpenAI when its key is set and Codex otherwise. With confirmSpending on (the default) nothing is generated until you approve the card. Sprites are checked for a transparent background and framing and fitted to the slot before they are offered.

Security and privacy

Requirements

Install into DSH

Install from npm into a DSH profile:

dsh plugin --profile web add @zseven-w/dsh-game-studio@latest
dsh web

Quick start

Open a session in a workspace folder and ask, for example:

Then try:

Configuration

Set these under config in your profile's cordis.patch.yml:

Option Default Meaning
imageProvider auto auto, openai or codex.
openaiModel gpt-image-2.5-flare OpenAI image model; pin it so results stay comparable.
openaiBaseUrl OpenAI OpenAI-compatible base URL, e.g. a company gateway.
openaiCredential OPENAI_API_KEY Name of the credential or environment variable holding the key.
codexPath found on PATH or through the login shell Codex CLI executable.
codexModel Codex's default Model for Codex image runs.
codexReasoningEffort low Reasoning effort for Codex image runs.
codexTimeoutMinutes 15 Give up on one Codex image after this long.
confirmSpending true Ask for approval before every generation.
cloudflaredPath found on PATH or Homebrew cloudflared executable for temporary public share links.
ghPath found on PATH or Homebrew GitHub CLI (gh) executable for publishing to GitHub Pages.
githubRepo dsh-games Public GitHub repository name (under your signed-in account) for GitHub Pages.

Game project format

Each game is a plain folder in your workspace:

Development

npm ci
npm run build   # lib/index.js, lib/client.js and the bundled three.js runtime
npm test        # node --test; playtest tests are skipped when no Chrome or Edge is found

Ecosystem

Credits & License

License: MIT

dsh-game-studio (ZSeven-W/dsh-game-studio)

Ищем в базе…

Что это такое?Это плагин для DeepSeek Harness, который превращает описание игры в одно предложение в небольшую игру, в которую можно играть. Играть можно в боковой панели чата, можно заменить графику на созданную ИИ, а игру можно экспортировать в один автономный файл HTML, который работает без интернета.
Это отдельный игровой движок или плагин для чего-то другого?Это плагин для DeepSeek Harness (DSH), поэтому пользоваться им можно прямо из диалога в чате, а не в отдельном редакторе игр. Пока агент работает, игра появляется в панели рядом с диалогом.
Как установить и запустить первую игру?Установите пакет npm @zseven-w/dsh-game-studio в профиль DSH. Затем откройте сессию в рабочей папке и опишите игру одним предложением, например: котёнок ворует сушёную рыбу на кухне.
Что нужно помимо DSH?DSH версии 0.2.1 или новее и Node.js версии 24.11 или новее. Для тестовых прогонов также нужны Chrome или Edge на этом же компьютере. Для графики через ИИ нужен либо ключ API от OpenAI, либо вход в Codex CLI; без них игры тоже работают, только персонажи рисуются кодом.
Сразу выходит игра, в которую можно играть?Игры на сбор предметов и уклонение с первой попытки были рабочими во всех 10 тестах, медианное время составило около 14 минут на игру. Другие жанры, например match-3 или платформеры, тоже получались рабочими во всех случаях, но медианное время составило около 26 минут. При этом выборка небольшая.
Экспортированные игры работают без интернета?Да. Экспорт создаёт один автономный файл HTML, который не делает сетевых запросов, поэтому его можно открыть в любом браузере или разместить на статическом хостинге.
Что уходит с моего компьютера?Только ваши запросы и любая прикреплённая опорная картинка отправляются в выбранный вами сервис генерации изображений. Игры работают во встроенном изолированном окне (iframe), которое блокирует доступ к сети, а экспортированные файлы не делают сетевых запросов.
Могу ли я оставить свою графику вместо созданной ИИ?Да. Можно нарисовать поверх файла слота напрямую, и студия запишет это как вашу правку. Картинка, прикреплённая в чате, также может служить опорным образцом для генерации через ИИ.
С каких игровых шаблонов он начинает?Есть двумерный шаблон сборщика с видом сверху и такой же игровой цикл в трёхмерном мире из вокселей, созданном на three.js. Агент переделывает любой из шаблонов в игру, которую вы описали, включая персонажей, правила, уровни и экраны.
Может ли он сам протестировать игру?Да. Инструмент gamestudioplaytest запускает последний код в Chrome или Edge в фоновом (headless) режиме и сообщает об этапах, лучшем счёте, частоте кадров, ошибках скриптов и скриншотах. Каждая сборка, которая меняет игру, также сохраняется как версия, к которой можно вернуться.
Автор
ZSeven-W
Размер
9 MB
Звёзды
575
Обновлён
КоммитNov 09
Возраст
13 д
Коммиты · 90 дней