eud-agent

Native AI authoring for StarCraft EUD maps: canonical epScript/DAT projects, reviewable agent edits, and direct euddraft builds.

한국어

eud-agent is a standalone Windows desktop application built with Tauri 2, Rust, React, and TypeScript. Describe a map behavior in natural language; the agent reads the real project and map, retrieves pinned references, edits epScript or DAT through typed tools, shows a reviewable changeset, and builds the output map through euddraft.

EUD Editor 3 is not a runtime dependency. Existing .e3s projects can be imported and exported through an independent MS-NRBF compatibility layer.

What it owns

• versioned project.eap manifest;
• confined src/**/*.eps and src/**/*.py source tree, ordered Python entrypoints, and exact EPS MainFile;
• sparse standard DAT, XDAT, TBL, requirement, and button JSON;
• deterministic EDS/plugin generation;
• direct bounded euddraft execution and structured diagnostics;
• semantic journal, accept/reject, rollback, and restart persistence;
• in-process BGE-M3 RAG and pinned epScript preflight;
• SCX/CHK map inspection and safe Map Agent mutations;
• multi-session Codex, Claude Code, Antigravity, OpenCode Go, and Ollama conversations, plans, ASK, and changeset review.

Requirements

Requirement	Notes
Windows 10/11 x64	MSVC Rust target; system WebView2 runtime
euddraft	Latest release downloads automatically during setup; an existing folder, euddraft.exe, or euddraft.py can also be selected
Source map	.scx or .scm
AI provider	Codex, Claude Code, Antigravity, OpenCode Go, or Ollama; configure at least one during setup
StarCraft data	Needed by terrain/rendering features; configure when auto-detection is insufficient

EUD Editor is optional and needed only if you choose to open an exported compatibility E3S.

Starting a project

Every ordinary launch shows the project launcher instead of automatically reopening the saved project.

• Up to 20 successfully opened projects appear newest-first, with name/path search and list-only removal. Removing a recent entry never deletes project files.
• Open an .eap file or select a Native project folder.
• Create from SCX/SCM or import a legacy E3S and its referenced map into an empty folder.
• The Windows installer associates .eap with a dedicated project icon. Double-click the .eap file to start directly in that project; if the app is already running, the request goes to its existing window. Other JSON file associations are unchanged.
• Use Switch project in the workspace header. Builds, active agent/review work, and open map-work windows block switching. Forwarded file requests remain pending and can be explicitly retried after the work finishes.

First-time environment setup

1. Select or create a project.
2. Let the app download the latest armoha/euddraft release, or select an existing euddraft folder/file. Downloads are SHA-256 verified and installed under %LOCALAPPDATA%/eud-agent/euddraft; an explicitly selected local path takes precedence.
3. Let the app verify/download checksummed RAG/model assets.
4. Select and connect an AI provider.

Already prepared environment settings are reused. Project open/create/import/export also remains available under Settings → Project.

Native project layout

my-project/
├── project.eap             # JSON manifest containing project settings directly
├── src/
│   ├── main.eps
│   └── bootstrap.py         # optional direct eudplib source
├── dat/
│   ├── standard.json
│   ├── xdat.json
│   ├── tbl.json
│   ├── requirements.json
│   └── buttons.json
├── maps/
│   └── source.scx
├── plugins/
├── build/
└── compat/
    └── editor-project.e3s   # imported projects only

The schema-v2 manifest, EPS/Python source tree, and sparse DAT JSON are canonical. EDS, generated build helpers/binaries, output SCX, and E3S are generated compatibility/build artifacts.

.eap means EUD Agent Project. It is the JSON manifest itself, containing the project name, map paths, MainFile, settings, plugins, ordered Python entrypoints, exact PyPI dependency declarations, their resolved wheel lock, and E3S compatibility metadata—not a pointer file. A project folder must contain exactly one .eap; renaming it preserves opening and subsequent saves. Sources, DAT, and maps remain separate files, so move the entire project folder together.

Open an old project.json or .eudproj through the legacy file-picker filter, or open its project folder, to migrate. After validation, the app atomically renames project.json to project.eap and removes the old descriptors. Coexisting old/new authorities or multiple .eap files are rejected rather than overwritten.

E3S compatibility

Import/export supports:

• CUI epScript tree and MainFile;
• source/output map references;
• standard DAT and XDAT;
• TBL, requirements, and button sets;
• supported main settings and ordered EDS plugins.

GUIEps, GUIPy, RawText, and ClassicTrigger-as-MainFile are rejected explicitly instead of being silently lost. Native EPS-only projects build normally and export to E3S on a bundled blank EUD Editor 3 project when they were never imported. A project containing any direct Python source, entrypoint, dependency, or lock is rejected for E3S export because Editor cannot represent it losslessly.

Direct eudplib Python

epScript remains the primary authoring language. Project-local src/**/*.py is first-class, fully trusted code: only manifest-selected entrypoints execute, in order, before the EPS MainFile in one frozen euddraft.exe process. All Python sources still participate in revision, snapshots, search, review, and rollback.

以上為 README 的開頭部分。其餘內容請閱讀原文。 檢視完整 README ↗