Skip to content

Commit 9a73d85

Browse files
committed
Document configurable block models.
Closes #97
1 parent 39a217d commit 9a73d85

File tree

1 file changed

+14
-0
lines changed

1 file changed

+14
-0
lines changed

ChunkyDocs/docs/support/minecraft_compatibility.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -24,3 +24,17 @@ Below is a list of the Minecraft versions currently supported by Chunky and ever
2424
| Armor trims | Not supported | Planned | Planned | #1708 |
2525

2626
--8<-- "includes/abbreviations.md"
27+
28+
## Block models
29+
30+
Sometimes Minecraft changes the block models or textures (and texture mappings) of existing blocks. By default, Chunky uses the _latest_ block models of the Java Edition.
31+
32+
To keep compatible with old resource packs, there are flags to switch to older block models. These flags can be specified in the launcher as _Java options_, eg. `-Dchunky.oldModels.cocoa=pre-1.19` to switch to the old cocoa plant model.
33+
34+
| Block | Flag | Values | Note |
35+
| ----- | ------------------------ | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
36+
| cocoa | `chunky.oldModels.cocoa` | `1.19` (default), `pre-1.19` | Block model changed in 1.19, stage 2 cocoa plant is displayed incorrectly when the resource pack and block model don't match (see #1761) |
37+
38+
!!! info "Unsupported block models"
39+
40+
If you're missing an old block model or encounter issues with a block when using a resource pack that is made for an older Minecraft version, please [create an issue](https://github.com/chunky-dev/chunky/issues/new/choose). We will add support for all block models that are present in release versions of Minecraft (ie. block models that only appeared in snapshots will not be supported).

0 commit comments

Comments
 (0)