Hexdoc

Fixed

* Localize the "please don't sue us Microsoft" page footer (previously was hardcoded).
* Disable showing local variables in Typer pretty exceptions, since it produces a really absurd amount of output. Set a non-empty value for the environment variable `HEXDOC_TYPER_EXCEPTION_LOCALS` to reenable it if you really want to.

Contributions

* Update `zh_cn` translations, by ChuijkYahus in [74](https://github.com/hexdoc-dev/hexdoc/pull/74).

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.