Hexdoc

Added

* The internal hexdoc CI now automatically generates and deploys JSON Schema definitions for several Patchouli file types. See the [documentation](https://hexdoc.hexxy.media/docs/guides/standalone/patchouli-schemas) for more details.

Changed

* The `hexdoc.toml` field `textures.missing` can now be set to `missing = "*"`, allowing all textures to be missing. No other string values are currently supported.
* The command `hexdoc merge` now creates an empty `.nojekyll` file in the site root to disable Jekyll on GitHub Pages (since it's not necessary for hexdoc). Fixes [68](https://github.com/hexdoc-dev/hexdoc/issues/68).
* Tentatively reenable Typer's [pretty exceptions](https://typer.tiangolo.com/tutorial/exceptions/). Please open an issue if you notice any weird behaviour.
* Change the JSON Schema output path from `/schema/hexdoc` to `/schema`.
* Several documentation improvements/fixes.

Fixed

* The command `hexdoc render-models` was accidentally configured to take a list of models as an option instead of an argument.

Added

* Path resource dirs now support reading `.jar` and `.zip` files.
* Note: The resource folders (eg. `assets/`) currently must be at the root of the archive.
* New glob resource dir type: `{ glob="mods/*.jar", exclude=["**/some_broken_mod.jar"] }`
* New texture config to print some errors instead of failing the build: `textures.strict`
* New command: `hexdoc render-models`
* Placeholders in `hexdoc.toml` may now start with `$` to reference the root table (eg. `{$modid}` and `{$.modid}` are both valid).

Changed

* In `hexdoc.toml`, `default_lang` and `default_branch` are now optional, defaulting to `en_us` and `main` respectively.
* Update minimum Pydantic version to `2.7.1`.
* Update Pyright version to `1.1.361`.

Fixed

* Add missing default values for some fields in `*.png.mcmeta`.

Added

* The internal hexdoc CI now automatically generates and deploys a JSON Schema definition for `hexdoc.toml`. See the [documentation](https://hexdoc.hexxy.media/docs/guides/configuration/) for more details.

Changed

* `hexdoc serve` will now fail immediately instead of retrying the build in non-release mode if an error occurs.
* Update minimum Typer version to `0.12`.

Fixed

* Fix incorrect texture array size calculation when non-square images are used for block textures.

Changed

* Print stdout and stderr when shell commands fail (fixes [63](https://github.com/hexdoc-dev/hexdoc/issues/63)).
* Improve the error message when GitHub Pages is not enabled.
* Support `.json5` files in places other than I18n. Note that `.flatten.json5` is still only supported for I18n.

Added

* New block rendering system, implemented entirely in Python! This replaces [minecraft-render-py](https://github.com/hexdoc-dev/minecraft-render-py) and removes hexdoc's Node.js dependency. Block renders should now be much closer to how items look in inventories ingame.
* Note: Animated models currently only render the first frame of the animation.
* Note: `minecraft-render` is still included as a dependency for backwards compatibility reasons. This will be removed in a future release.
* New command: `hexdoc render-model`
* New dependencies: `frozendict`, `moderngl[headless]`, `moderngl-window`
* New `hexdoc.toml` field `lang.{lang}` for per-language configuration. Currently supported options include `quiet` and `ignore_errors`.

Changed

* Update `zh_cn` translations, by ChuijkYahus in [69](https://github.com/hexdoc-dev/hexdoc/pull/69).
* Blockstates are no longer taken into account when selecting block models to render.
* Deprecated the `--quiet-lang` CLI option.
* Errors will now always be raised for all languages unless explicitly disabled in `hexdoc.toml`. Previously, errors when rendering non-default languages would only fail the overall command in release mode.

Removed

* ⚠️ BREAKING: Removed `HexdocPythonResourceLoader`, as it was only needed for the old rendering system.
* ⚠️ BREAKING: Removed `HexdocAssetLoader.load_blockstates` and `HexdocAssetLoader.renderer_loader`. Several argument/return types have been changed from `IRenderClass` to `BlockRenderer`.
* Removed `hexdoc render-block` subcommands.

Added

* hexdoc now uses a custom `sys.excepthook` to hide unnecessary traceback frames, except in verbose mode.
* New reusable workflow input `site-url` to help support non-Pages deployments.

Changed

* Adding spoilers to individual pages with the `advancement` field is now supported.
* Use [`uv`](https://github.com/astral-sh/uv) instead of `pip` for all reusable workflows.
* `hexdoc ci build` now attempts to read the site url from `HEXDOC_SITE_URL` and `GITHUB_PAGES_URL` environment variables before querying the GitHub API.
* "No translation in {lang} for key {key}" warnings are now only printed once per key for each language to reduce log spam.