crusader-sdk 0.1.0a1__tar.gz

crusader_sdk-0.1.0a1/.dockerignore

@@ -0,0 +1,19 @@
+*
+!pyproject.toml
+!uv.lock
+!README.md
+!src/
+!src/**
+!ucp3/
+!ucp3/crusader-bridge-0.1.0/
+!ucp3/crusader-bridge-0.1.0/**
+!docker/
+!docker/run.sh
+!docker/ucp-config.yml
+!scripts/
+!scripts/check-game-files.sh
+**/__pycache__/
+**/*.pyc
+**/*.exe
+**/*.dll
+**/*.sav

crusader_sdk-0.1.0a1/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,36 @@
+name: Bug report
+description: Something in the SDK, bridge or Docker setup doesn't work as documented.
+labels: [bug]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Please don't post game files, save files or access tokens. Security problems go through
+        [private vulnerability reporting](../security/advisories/new), not issues.
+  - type: textarea
+    id: what-happened
+    attributes:
+      label: What happened
+      description: The command or code you ran, what you expected, and what happened instead.
+    validations:
+      required: true
+  - type: textarea
+    id: error
+    attributes:
+      label: Error or bridge output
+      description: The CrusaderError message, bridge log lines, or a stack trace.
+      render: text
+  - type: input
+    id: version
+    attributes:
+      label: crusader-sdk version
+      placeholder: "0.1.0a1"
+    validations:
+      required: true
+  - type: dropdown
+    id: setup
+    attributes:
+      label: How you run the bridge
+      options: [Docker image from this repo, Own Wine setup, Other]
+    validations:
+      required: true

crusader_sdk-0.1.0a1/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Report a security problem
+    url: https://github.com/smwitkowski/crusader-sdk/security/advisories/new
+    about: Please report vulnerabilities privately.

crusader_sdk-0.1.0a1/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,16 @@
+name: Feature request
+description: A game action, observation or tool you'd like the SDK to support.
+labels: [enhancement]
+body:
+  - type: textarea
+    id: what
+    attributes:
+      label: What you want to do
+      description: The in-game action or information, and how a human player does or sees it in the game.
+    validations:
+      required: true
+  - type: textarea
+    id: why
+    attributes:
+      label: Why
+      description: What it would let you or your agent do.

crusader_sdk-0.1.0a1/.github/dependabot.yml

@@ -0,0 +1,14 @@
+version: 2
+updates:
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly
+  - package-ecosystem: docker
+    directory: /docker
+    schedule:
+      interval: weekly
+  - package-ecosystem: uv
+    directory: /
+    schedule:
+      interval: weekly

crusader_sdk-0.1.0a1/.github/release.yml

@@ -0,0 +1,15 @@
+changelog:
+  exclude:
+    authors:
+      - dependabot
+  categories:
+    - title: Breaking changes
+      labels: [breaking]
+    - title: New commands and features
+      labels: [enhancement]
+    - title: Fixes
+      labels: [bug]
+    - title: Documentation
+      labels: [documentation]
+    - title: Other changes
+      labels: ["*"]

crusader_sdk-0.1.0a1/.github/workflows/ci.yml

@@ -0,0 +1,65 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+permissions:
+  contents: read
+
+concurrency:
+  group: ci-${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      - run: uv sync --locked --extra dev --extra bridge
+      - run: uv run --locked ruff check .
+      - run: uv run --locked ruff format --check .
+      - run: uv run --locked pyright
+
+  test:
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python: ["3.10", "3.11", "3.12", "3.13", "3.14"]
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+        with:
+          python-version: ${{ matrix.python }}
+      - run: uv sync --locked --extra dev --extra bridge
+      - if: matrix.python != '3.13'
+        run: uv run --locked pytest
+      - if: matrix.python == '3.13'
+        run: uv run --locked pytest --cov=crusader --cov-report=xml
+      - if: matrix.python == '3.13'
+        uses: codecov/codecov-action@303a32d7a59b442fa8d48b6a1cc6825c09c847a5 # v7.1.1
+        with:
+          files: coverage.xml
+          fail_ci_if_error: false  # tokenless upload needs the repo enabled on codecov.io
+          use_oidc: false
+          token: ${{ secrets.CODECOV_TOKEN }}
+
+  docs-security:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+        with:
+          fetch-depth: 0
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      - run: uv run --locked python tools/gen_docs.py --check
+      - run: sh scripts/leakcheck.sh
+      - name: Scan git history for secrets
+        run: |
+          go install github.com/zricethezav/gitleaks/v8@v8.28.0
+          "$(go env GOPATH)/bin/gitleaks" git --redact --no-banner
+      - name: Audit locked dependencies
+        run: |
+          uv export --locked --all-extras --no-emit-project --no-hashes -o /tmp/crusader-requirements.txt
+          uvx pip-audit -r /tmp/crusader-requirements.txt

crusader_sdk-0.1.0a1/.github/workflows/release.yml

@@ -0,0 +1,28 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+concurrency:
+  group: release-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/crusader-sdk
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1
+      - uses: astral-sh/setup-uv@68559e99cc807c1eb7e9238fd43a15bba460eec2 # v10.3.3
+      - run: uv build
+      - uses: pypa/gh-action-pypi-publish@7245906fb61fa33a13554f9d5fb856fe61758086 # v1.14.3

crusader_sdk-0.1.0a1/.gitignore

@@ -0,0 +1,19 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.pyright/
+.coverage
+htmlcov/
+dist/
+build/
+.venv/
+.env
+.env.*
+*.exe
+*.dll
+*.sav
+games/
+log.key
+scripts/leakcheck-denylist.txt

crusader_sdk-0.1.0a1/.pre-commit-config.yaml

@@ -0,0 +1,20 @@
+repos:
+  - repo: https://github.com/astral-sh/ruff-pre-commit
+    rev: v0.14.14
+    hooks:
+      - id: ruff-check
+      - id: ruff-format
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v6.0.0
+    hooks:
+      - id: end-of-file-fixer
+      - id: trailing-whitespace
+      - id: check-added-large-files
+        args: ["--maxkb=500"]
+  - repo: local
+    hooks:
+      - id: leakcheck
+        name: leakcheck
+        entry: sh scripts/leakcheck.sh
+        language: system
+        pass_filenames: false

crusader_sdk-0.1.0a1/ACKNOWLEDGEMENTS.md

@@ -0,0 +1,3 @@
+# Acknowledgements
+
+Thanks to the OpenSHC and UCP3 projects and to Wine and its contributors.

crusader_sdk-0.1.0a1/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project are listed here. The format follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and versions follow
+[Semantic Versioning](https://semver.org/). Before 1.0, minor versions may change the command set.
+
+## [Unreleased]
+
+## [0.1.0a1] - 2026-11-09
+
+First public pre-release.
+
+### Added
+- Python client (`crusader.Game`) with typed results, standard library only.
+- Bridge server (`crusader-bridge`) exposing every command over REST and MCP, bound to 127.0.0.1 by default, with an
+  optional bearer token, Host/Origin checks and request size limits.
+- Game driver for Stronghold Crusader HD 1.41 under Wine, with all memory access through a checked boundary
+  (exe hash, mapped regions, write allowlist).
+- UCP3 module `crusader-bridge` and a Docker setup that uses your own game files.
+- Command reference, concepts and protocol docs, plus `llms.txt` and `llms-full.txt`.
+
+### Known limitations
+- Tested offline only; the first live run against the game is pending.
+
+[Unreleased]: https://github.com/smwitkowski/crusader-sdk/compare/v0.1.0a1...HEAD
+[0.1.0a1]: https://github.com/smwitkowski/crusader-sdk/releases/tag/v0.1.0a1

crusader_sdk-0.1.0a1/CONTRIBUTING.md

@@ -0,0 +1,24 @@
+# Contributing
+
+Issues are welcome for bug reports, questions, and suggestions. Please include steps to reproduce bugs and relevant environment details. Do not post security vulnerabilities publicly; follow [SECURITY.md](SECURITY.md).
+
+Pull requests are by invitation. Please open an issue and discuss your proposed change before starting a pull request; wait for a maintainer to invite one.
+
+## Local checks
+
+From the repository root, install Python 3.10 or later and [uv](https://docs.astral.sh/uv/). Run these checks before submitting an invited pull request:
+
+```sh
+uv run ruff check
+uv run ruff format --check
+uv run pyright
+uv run pytest -q
+sh scripts/leakcheck.sh
+uv run python tools/gen_docs.py --check
+```
+
+Maintainers updating GitHub Actions pins should inspect each pinned revision’s `action.yml` and validate its inputs. With the GitHub CLI (`gh`) installed and authenticated, run `scripts/check-action-pins.sh` to verify that every remote workflow action pin resolves to a commit. This requires GitHub API access and does not verify release tags or attestations.
+
+If `actionlint` is installed, also run `actionlint`. Optionally, run `uv run pre-commit run --all-files` for the configured hooks.
+
+Do not include game files, credentials, or other material you cannot redistribute.

crusader_sdk-0.1.0a1/LEGAL.md

@@ -0,0 +1,5 @@
+# Legal notice
+
+This is an unofficial project and is not affiliated with or endorsed by Firefly Studios. It requires your own legal copy of Stronghold Crusader HD v1.41, not the Definitive Edition. No game files are distributed. The software reads and writes game memory and is intended for offline single-player use only.
+
+The screenshot in the README is from Stronghold Crusader, © Firefly Studios, captured from the author's own copy of the game while driven through this SDK. It is used for illustration only.

crusader_sdk-0.1.0a1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Stephen Witkowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

crusader_sdk-0.1.0a1/PKG-INFO

@@ -0,0 +1,93 @@
+Metadata-Version: 2.5
+Name: crusader-sdk
+Version: 0.1.0a1
+Summary: A Python SDK for Stronghold Crusader.
+Author: Stephen Witkowski
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.10
+Provides-Extra: bridge
+Requires-Dist: mcp==2.3.0; extra == 'bridge'
+Requires-Dist: starlette; extra == 'bridge'
+Requires-Dist: uvicorn; extra == 'bridge'
+Provides-Extra: dev
+Requires-Dist: httpx; extra == 'dev'
+Requires-Dist: pre-commit; extra == 'dev'
+Requires-Dist: pyright; extra == 'dev'
+Requires-Dist: pytest; extra == 'dev'
+Requires-Dist: pytest-cov; extra == 'dev'
+Requires-Dist: ruff; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# Crusader SDK
+
+![Stronghold Crusader gameplay: a catapult firing across an oasis during a siege, driven through the SDK](assets/hero.jpg)
+
+<sub>Gameplay screenshot from Stronghold Crusader, © Firefly Studios, captured from a game driven through this SDK.</sub>
+
+[![CI](https://github.com/smwitkowski/crusader-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/smwitkowski/crusader-sdk/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/smwitkowski/crusader-sdk)](LICENSE)
+[![Ruff](https://img.shields.io/badge/lint-ruff-blue)](https://docs.astral.sh/ruff/)
+[![Pyright](https://img.shields.io/badge/type%20checking-pyright-blue)](https://github.com/microsoft/pyright)
+[![PyPI](https://img.shields.io/pypi/v/crusader-sdk)](https://pypi.org/project/crusader-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/crusader-sdk)](https://pypi.org/project/crusader-sdk/)
+[![Codecov](https://codecov.io/gh/smwitkowski/crusader-sdk/graph/badge.svg)](https://codecov.io/gh/smwitkowski/crusader-sdk)
+
+A Python SDK for observing and controlling Stronghold Crusader through a local bridge. Read game state, inspect the map, and issue commands from Python.
+
+Unofficial; not affiliated with or endorsed by Firefly Studios. You must provide your own supported game files. See [LEGAL.md](LEGAL.md).
+
+## Client example
+
+With a bridge running (see [Get started](#get-started)), play a month of the game from Python:
+
+```python
+from crusader import CrusaderError, Game
+
+game = Game.connect()  # CRUSADER_URL and CRUSADER_TOKEN are read from the environment
+print(game.state()["gold"], "gold at tick", game.state()["tick"])
+
+site = game.find_sites("granary", limit=1)[0]  # the game's own placement check
+game.build("granary", site["x"], site["y"])
+game.set_tax(2)
+
+result = game.advance(800)  # one game month (800 ticks); the game is paused otherwise
+for event in result["events"]:
+    print(event["type"], event.get("message", ""))
+
+try:
+    game.set_tax(42)
+except CrusaderError as exc:  # refusals come back as errors, like the game's UI
+    print("refused:", exc)
+```
+
+## How it works
+
+```mermaid
+flowchart TB
+    A["Your code or agent"] -->|"Python SDK, REST or MCP"| B["Bridge server"]
+    B -->|"reads game memory"| G["Stronghold Crusader 1.41<br/>under Wine"]
+    B -->|"queues commands, controls ticks"| U["UCP3 module inside the game"]
+    U -->|"the game's own command queue"| G
+```
+
+Commands go through the same command queue the game's UI uses, so the game applies its own costs and rules. The game
+stays paused between calls; time moves only when you call `advance`. Details: [how it works](docs/how-it-works.md).
+The bridge and Docker setup have been tested offline; a live run against the game is still pending.
+
+## Get started
+
+1. Supply your own supported game files and [set up the bridge](docs/quickstart.md#run-the-bridge).
+2. [Install the client](docs/quickstart.md#install-the-client): `pip install --pre crusader-sdk` (pre-release for now).
+3. Connect to the running bridge and [try the client](docs/quickstart.md#install-the-client).
+
+See the [quickstart](docs/quickstart.md) for bridge setup, requirements, and the experimental Docker option.
+
+## Explore
+
+| | |
+| --- | --- |
+| [Documentation](docs/index.md) | [API reference](docs/api.md) |
+| [LLM guide](llms.txt) | [Protocol](docs/protocol.md) |
+| [How it works](docs/how-it-works.md) | [Contributing](CONTRIBUTING.md) |
+| [Security](SECURITY.md) | [Legal](LEGAL.md) |

crusader_sdk-0.1.0a1/README.md

@@ -0,0 +1,72 @@
+# Crusader SDK
+
+![Stronghold Crusader gameplay: a catapult firing across an oasis during a siege, driven through the SDK](assets/hero.jpg)
+
+<sub>Gameplay screenshot from Stronghold Crusader, © Firefly Studios, captured from a game driven through this SDK.</sub>
+
+[![CI](https://github.com/smwitkowski/crusader-sdk/actions/workflows/ci.yml/badge.svg)](https://github.com/smwitkowski/crusader-sdk/actions/workflows/ci.yml)
+[![License](https://img.shields.io/github/license/smwitkowski/crusader-sdk)](LICENSE)
+[![Ruff](https://img.shields.io/badge/lint-ruff-blue)](https://docs.astral.sh/ruff/)
+[![Pyright](https://img.shields.io/badge/type%20checking-pyright-blue)](https://github.com/microsoft/pyright)
+[![PyPI](https://img.shields.io/pypi/v/crusader-sdk)](https://pypi.org/project/crusader-sdk/)
+[![Python versions](https://img.shields.io/pypi/pyversions/crusader-sdk)](https://pypi.org/project/crusader-sdk/)
+[![Codecov](https://codecov.io/gh/smwitkowski/crusader-sdk/graph/badge.svg)](https://codecov.io/gh/smwitkowski/crusader-sdk)
+
+A Python SDK for observing and controlling Stronghold Crusader through a local bridge. Read game state, inspect the map, and issue commands from Python.
+
+Unofficial; not affiliated with or endorsed by Firefly Studios. You must provide your own supported game files. See [LEGAL.md](LEGAL.md).
+
+## Client example
+
+With a bridge running (see [Get started](#get-started)), play a month of the game from Python:
+
+```python
+from crusader import CrusaderError, Game
+
+game = Game.connect()  # CRUSADER_URL and CRUSADER_TOKEN are read from the environment
+print(game.state()["gold"], "gold at tick", game.state()["tick"])
+
+site = game.find_sites("granary", limit=1)[0]  # the game's own placement check
+game.build("granary", site["x"], site["y"])
+game.set_tax(2)
+
+result = game.advance(800)  # one game month (800 ticks); the game is paused otherwise
+for event in result["events"]:
+    print(event["type"], event.get("message", ""))
+
+try:
+    game.set_tax(42)
+except CrusaderError as exc:  # refusals come back as errors, like the game's UI
+    print("refused:", exc)
+```
+
+## How it works
+
+```mermaid
+flowchart TB
+    A["Your code or agent"] -->|"Python SDK, REST or MCP"| B["Bridge server"]
+    B -->|"reads game memory"| G["Stronghold Crusader 1.41<br/>under Wine"]
+    B -->|"queues commands, controls ticks"| U["UCP3 module inside the game"]
+    U -->|"the game's own command queue"| G
+```
+
+Commands go through the same command queue the game's UI uses, so the game applies its own costs and rules. The game
+stays paused between calls; time moves only when you call `advance`. Details: [how it works](docs/how-it-works.md).
+The bridge and Docker setup have been tested offline; a live run against the game is still pending.
+
+## Get started
+
+1. Supply your own supported game files and [set up the bridge](docs/quickstart.md#run-the-bridge).
+2. [Install the client](docs/quickstart.md#install-the-client): `pip install --pre crusader-sdk` (pre-release for now).
+3. Connect to the running bridge and [try the client](docs/quickstart.md#install-the-client).
+
+See the [quickstart](docs/quickstart.md) for bridge setup, requirements, and the experimental Docker option.
+
+## Explore
+
+| | |
+| --- | --- |
+| [Documentation](docs/index.md) | [API reference](docs/api.md) |
+| [LLM guide](llms.txt) | [Protocol](docs/protocol.md) |
+| [How it works](docs/how-it-works.md) | [Contributing](CONTRIBUTING.md) |
+| [Security](SECURITY.md) | [Legal](LEGAL.md) |

crusader_sdk-0.1.0a1/SECURITY.md

@@ -0,0 +1,7 @@
+# Security
+
+Please report vulnerabilities privately using GitHub private vulnerability reporting for this repository. Do not disclose security vulnerabilities in public issues.
+
+## Threat model
+
+The bridge is a local, single-user tool that reads and writes game process memory. Keep it on loopback, set `CRUSADER_TOKEN`, and do not expose it to untrusted networks. Host, Origin, and JSON content-type checks reduce browser-based attacks; they do not protect against a compromised local process.

crusader_sdk-0.1.0a1/docker/Dockerfile

@@ -0,0 +1,35 @@
+FROM ghcr.io/astral-sh/uv:0.13.7@sha256:96f40d3904aad8d0bd010539001d36c8e2188b981e1334471a90c4a1d93bb490 AS uv
+
+FROM debian:bookworm-slim@sha256:734a72b3d6142a71993b4bc580ca01d8ca687f77a2c422d96a961d3376b179bc
+
+# Wine and the game are 32-bit; build on the amd64 platform.
+# hadolint ignore=DL3008
+RUN dpkg --add-architecture i386 && apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates curl unzip wine wine32:i386 libgl1:i386 libgl1-mesa-dri:i386 \
+    libglx-mesa0:i386 xvfb xdotool x11-utils procps python3 python3-venv \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN curl -fsSL -o /tmp/ucp.zip \
+    https://github.com/UnofficialCrusaderPatch/UnofficialCrusaderPatch3/releases/download/v3.0.7/UCP3-3.0.7-77c6accf14.zip \
+    && printf "%s\n" "a979816e4475e054b46b2f2793ef6a2109cfd03bf650e58e2b2f764804a8c105  /tmp/ucp.zip" > /tmp/ucp.sha256 \
+    && sha256sum -c /tmp/ucp.sha256 && rm /tmp/ucp.sha256 \
+    && mkdir /opt/ucp && unzip -q /tmp/ucp.zip -d /opt/ucp && rm /tmp/ucp.zip
+
+WORKDIR /opt/sdk
+COPY --from=uv /uv /usr/local/bin/uv
+COPY pyproject.toml uv.lock README.md ./
+COPY src ./src
+RUN uv export --frozen --extra bridge --no-dev --no-emit-project -o /tmp/requirements.txt \
+    && python3 -m venv /opt/venv \
+    && /opt/venv/bin/pip install --no-cache-dir --no-deps --require-hashes -r /tmp/requirements.txt \
+    && /opt/venv/bin/pip install --no-cache-dir --no-deps . \
+    && rm /tmp/requirements.txt
+COPY ucp3/crusader-bridge-0.1.0 /opt/sdk/ucp3/crusader-bridge-0.1.0
+COPY docker/ucp-config.yml /opt/sdk/ucp-config.yml
+COPY scripts/check-game-files.sh /opt/sdk/check-game-files.sh
+COPY docker/run.sh /opt/sdk/run.sh
+RUN useradd --create-home --uid 1000 crusader && mkdir /opt/crusader && chown crusader:crusader /opt/crusader
+USER crusader
+ENV HOME=/home/crusader WINEPREFIX=/home/crusader/.wine WINEARCH=win32 WINEDEBUG=-all DISPLAY=:99
+ENV CRUSADER_GAME_DIR=/opt/crusader
+ENTRYPOINT ["/bin/sh", "/opt/sdk/run.sh"]

crusader_sdk-0.1.0a1/docker/run.sh

@@ -0,0 +1,36 @@
+#!/bin/sh
+set -eu
+
+# Verify the mounted source before copying and verify the copy before launch.
+sh /opt/sdk/check-game-files.sh /game
+cp -R /game/. /opt/crusader/
+chmod -R u+rwX /opt/crusader
+sh /opt/sdk/check-game-files.sh /opt/crusader
+mkdir -p "$HOME/Stronghold Crusader/Saves"
+if [ -d /game/Saves ]; then
+    cp -R /game/Saves/. "$HOME/Stronghold Crusader/Saves/"
+    chmod -R u+rwX "$HOME/Stronghold Crusader/Saves"
+fi
+cp -R /opt/ucp/. /opt/crusader/
+mv /opt/crusader/binkw32.dll /opt/crusader/binkw32_real.dll
+cp /opt/crusader/binkw32_ucp.dll /opt/crusader/binkw32.dll
+cp /opt/sdk/ucp-config.yml /opt/crusader/ucp-config.yml
+cp -R /opt/sdk/ucp3/crusader-bridge-0.1.0 /opt/crusader/ucp/modules/
+cd /opt/crusader
+Xvfb :99 -screen 0 1024x768x16 &
+xvfb_pid=$!
+attempt=0
+until xdpyinfo -display "$DISPLAY" >/dev/null 2>&1; do
+    if ! kill -0 "$xvfb_pid" 2>/dev/null || [ "$attempt" -ge 30 ]; then
+        echo "Xvfb failed to start" >&2
+        exit 1
+    fi
+    attempt=$((attempt + 1))
+    sleep 1
+done
+wineboot -i
+wineserver -w
+wine reg add 'HKCU\Software\Wine\Drivers' /v Audio /d '' /f
+wineserver -w
+wine 'Stronghold Crusader.exe' --ucp-no-security &
+exec /opt/venv/bin/crusader-bridge "$@"

crusader_sdk-0.1.0a1/docker/ucp-config.yml

@@ -0,0 +1,15 @@
+meta:
+  version: 1.0.0
+active: true
+config-full:
+  load-order:
+    - extension: crusader-bridge
+      version: 0.1.0
+  modules:
+    crusader-bridge:
+      config: {}
+  plugins: {}
+config-sparse:
+  load-order: []
+  modules: {}
+  plugins: {}