workshop-rs

workshop-rs is a Rust library and CLI for raw Overwatch Workshop text. It parses, validates, converts, queries, and emits Workshop code, and it is the canonical Workshop core shared by opy-rs, deltin-rs, and Wright.

Features

• Parse and emit raw Workshop with a shared Program model.
• Validate actions, values, events, enums, and settings against a built-in catalog.
• Convert between en-US and zh-CN, with strict checks for missing terms.
• Query hero abilities, weapon slots, and custom game modifiers.
• Verification tools for feature census, regression corpora, and client version drift.

Install

cargo add workshop-rs            # library
cargo install workshop-rs-cli    # CLI

Precompiled CLI archives are attached to GitHub Releases.

Quick start

workshop-rs-cli parse file.ws
workshop-rs-cli emit file.ws
workshop-rs-cli convert file.ws --from en-US --to zh-CN

Library usage and the full CLI reference are in docs/spec/usage.md.

Language support

The declared Workshop capability surface is listed in docs/language-support.md.

Documentation

See docs/README.md for architecture, data contracts, and release procedures.

Contributing

Read AGENTS.md first.

License

MIT. Dataset and fixture source attribution is in docs/source-attribution/README.md.