Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion AGENTS.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ Rules for coding agents (Codex reads this file; Claude Code imports it through `

## Scope

- Windows 11 x64 WPF editor for RECOIL source projects (`data/` + `gamegen/`), reconstructed once from the original game files and exported back to ZBD files. C# 14, .NET 10, WPF Fluent, Direct3D 11 (Vortice.Windows); the format library (`zStudio.Core`) stays independent of UI and rendering.
- Windows 11 x64 WPF editor for RECOIL source projects (`data/` + `gamegen/`), reconstructed once from the original game files and exported back to ZBD files. C# 15, .NET 11, WPF Fluent, Direct3D 11 (Vortice.Windows); the format library (`zStudio.Core`) stays independent of UI and rendering.
- Compiled game folders open only through MCP `open_root`, read-only: inspection, preview and export. Never add compiled-asset editing in code, GUI or MCP (owner decision). The July and August 1998 demos (version-13 worlds) are inspection only (the September 1998 demo reconstructs like a release). MechWarrior 3 supports the source pipeline, native in-app authoring and Blender round-trip for original 1.2; native mission selection replaces RECOIL-only difficulty/BFT/pickup/VTOL helpers ([MW3 sources](docs/mw3-source-project.md)).
- Python exists only in the Blender extension (`blender/zstudio_recoil`), the Blender round-trip driver (`tools/blender-roundtrip.py`) and the optional export checker (`tools/check_exports.py`). The app, builds and the plain test suite never need Python or Blender.

Expand Down
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,10 @@

Version numbers follow `MAJOR.MINOR.PATCH`; the 0.x series is under active development. Release tags and downloadable archives use the same version.

## 0.12.1 — Unreleased

- zStudio is built on .NET 11 (included in `zStudio.exe`; nothing to install).

## 0.12.0 — 2026-11-08

- Map diagnostics retain informational preview limitations and group unresolved animation calls by target, with call counts and bounded source details shared by Diagnostics and MCP.
Expand Down
2 changes: 1 addition & 1 deletion CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ dotnet run --project tools/zStudio.PreviewCheck -c Release --no-build -- --mcp-c
## Pull requests

1. Fork the repository (or use a branch if you have access), starting from current `main`.
2. Keep the change focused and follow `.editorconfig` and [AGENTS.md](https://github.com/Vorta/zStudio/blob/main/AGENTS.md): C# 14, nullable types, bounded little-endian reads, actionable diagnostics, format models independent of UI and rendering.
2. Keep the change focused and follow `.editorconfig` and [AGENTS.md](https://github.com/Vorta/zStudio/blob/main/AGENTS.md): C# 15, nullable types, bounded little-endian reads, actionable diagnostics, format models independent of UI and rendering.
3. Preserve source bytes, unknown fields, record identities and order; never infer identity from names. Add only must-have tests ([test policy](https://github.com/Vorta/zStudio/blob/main/docs/agents/testing.md#minimal-must-have-tests)). A successful parse does not establish game compatibility.
4. Every user-facing feature also works over MCP through the shared command and editing services, with the same validation, identities, undo and save protections. Update the typed tool schemas, [the capability inventory](https://github.com/Vorta/zStudio/blob/main/docs/mcp-capabilities.json), [the MCP guide](docs/mcp.md) and a protocol check that exercises the new path. CI checks XAML action handlers against the inventory; reviews also cover bound and dynamically created controls. MCP returns explicit draft and conflict errors instead of opening a dialog or discarding input.
5. Document visible behaviour and limits in the relevant guide and add an entry under the Unreleased section of `CHANGELOG.md`.
Expand Down
4 changes: 2 additions & 2 deletions Directory.Build.props
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
<Project>
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<LangVersion>14.0</LangVersion>
<TargetFramework>net11.0</TargetFramework>
<LangVersion>15.0</LangVersion>
<Nullable>enable</Nullable>
<ImplicitUsings>enable</ImplicitUsings>
<Deterministic>true</Deterministic>
Expand Down
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ Game files are not included; use your own copy of the game.
- Some edits are available only through MCP, such as adding a model to a world or moving an object to another parent.
- Previews show each mission's starting scene; they don't simulate gameplay.
- `zStudio.exe` is unsigned.
- On the first start of each version, zStudio unpacks WPF's native files (about 8 MB) to `%TEMP%\.net\zStudio\`. Where a policy blocks programs in `%TEMP%`, set the environment variable `DOTNET_BUNDLE_EXTRACT_BASE_DIR` to another writable folder. Folders of older versions there can be deleted.
- On the first start of each version, zStudio unpacks WPF's native files (about 9 MB) to `%TEMP%\.net\zStudio\`. Where a policy blocks programs in `%TEMP%`, set the environment variable `DOTNET_BUNDLE_EXTRACT_BASE_DIR` to another writable folder. Folders of older versions there can be deleted.

## Contributing

Expand Down
Loading