docs: present Shacraft Core and its documentation in English

docs/COMPATIBILITY.md

@@ -1,30 +1,30 @@
-# Совместимость с Minecraft Java 26.2
+# Minecraft Java 26.2 compatibility
 
-Проверено 14 сентября 2026 года. Реализованы полный каталог целевой версии и двусторонний конвертер с явно определённым профилем точности. Подробные контракты и команды: [CONTENT](CONTENT.md), [interop](interop.md), [SERVER](SERVER.md).
+Verified on September 14, 2026. A complete catalog for the target version and a bidirectional converter are implemented, with an explicitly defined fidelity profile. Detailed contracts and commands: [CONTENT](CONTENT.md), [interop](interop.md), [SERVER](SERVER.md).
 
-## Источник
+## Source
 
-Mojang выпустила [Java 26.2](https://www.minecraft.net/en-us/article/minecraft-java-edition-26-2) 16 июня 2026 года. [Официальный launcher manifest](https://piston-meta.mojang.com/mc/game/version_manifest_v2.json) указал точные [метаданные версии](https://piston-meta.mojang.com/v1/packages/bc42e43dfe43d65a2f6c2c1dbb322c75134e51fe/26.2.json):
+Mojang released [Java 26.2](https://www.minecraft.net/en-us/article/minecraft-java-edition-26-2) on June 16, 2026. The [official launcher manifest](https://piston-meta.mojang.com/mc/game/version_manifest_v2.json) identified the exact [version metadata](https://piston-meta.mojang.com/v1/packages/bc42e43dfe43d65a2f6c2c1dbb322c75134e51fe/26.2.json):
 
-- Server JAR: `823e2250d24b3ddac457a60c92a6a941943fcd6a`, 60 894 273 байта; Java major 25.
-- DataVersion, извлечённый из целевой версии: **4903**.
-- Отчёты и публичный API подтвердили **1 196 блоков**, **32 366 состояний**, **158 сущностей**.
-- Все состояния сопоставляются по канонической строке и множеству свойств, не только по общему количеству.
+- Server JAR: `823e2250d24b3ddac457a60c92a6a941943fcd6a`, 60,894,273 bytes; Java major version 25.
+- DataVersion extracted from the target version: **4903**.
+- Reports and the public API confirmed **1,196 blocks**, **32,366 states**, and **158 entities**.
+- Every state is compared by canonical string and property set, not just by total count.
 
-`scripts/catalog_generate.py` проверяет артефакт, извлекает отчёты и измеряет коллизии. Повторное извлечение дало побайтно одинаковые сжатые каталоги. JAR остаётся в игнорируемом кэше; исходный код, текстуры, модели и звуки Minecraft в дистрибутив не включаются.
+`scripts/catalog_generate.py` verifies the artifact, extracts reports, and measures collisions. Repeating the extraction produced byte-identical compressed catalogs. The JAR remains in an ignored cache; Minecraft source code, textures, models, and sounds are not included in the distribution.
 
-## Что означает поддержка
+## Scope of support
 
-`identity`, `render`, `collision` и `behavior` — отдельные поля. Все ванильные состояния известны; 179 контекстных состояний явно помечены `approximate-context`. Остальные коллизии измерены при воздушных соседях и пустом контексте сущности. Это не обещает контекстную эквивалентность во всех ситуациях. Визуальные модели авторские процедурные, а не ванильные. Невидимые служебные блоки намеренно не получают видимую геометрию.
+`identity`, `render`, `collision`, and `behavior` are separate fields. All vanilla states are known; 179 context-dependent states are explicitly marked `approximate-context`. Other collisions were measured with air neighbors and an empty entity context. This does not promise contextual equivalence in every situation. Visual models use original procedural geometry rather than vanilla assets. Invisible technical blocks intentionally receive no visible geometry.
 
-158 типов сущностей имеют измеренные размеры, сохраняемые экземпляры и собственные формы. Полноценная AI, redstone, инвентари, генератор и симуляция жидкостей не реализованы. Неизвестные импортированные состояния сохраняются в реестре и видимы как отмеченная заглушка; они не подменяются воздухом в данных.
+The 158 entity types have measured dimensions, persistent instances, and original geometry. Full AI, redstone, inventories, terrain generation, and fluid simulation are not implemented. Unknown imported states remain in the registry and appear as a marked placeholder; the stored data does not replace them with air.
 
-Числовой runtime BlockId Shacraft не равен Minecraft state ID. Конвертер сопоставляет канонические строки; одинаковые названия в независимых WorldStore могут иметь разные внутренние номера.
+Shacraft's numeric runtime BlockId is not a Minecraft state ID. The converter matches canonical strings; identical names in independent WorldStore instances can have different internal numbers.
 
-## Проверенный обмен
+## Verified interchange
 
-Anvil импортируется по одному chunk с типизированным NBT, включая измерения и непрозрачные дополнительные данные. Неизменённый `exact` возвращает сохранённый оригинал после проверки хешей. После правок `exact` консервативно отказывает. `best-effort` переносит изменения блоков и поддержанных свойств сущностей, инвалидирует зависимые данные и сохраняет неподдержанные данные с отчётом и исходником.
+Anvil imports one chunk at a time using typed NBT, including dimensions and opaque extra data. An unchanged `exact` export returns the preserved original after checking its hashes. After edits, `exact` conservatively refuses to export. `best-effort` transfers block changes and supported entity properties, invalidates dependent data, and preserves unsupported data with a report and the original source.
 
-Sponge `.schem` v3 поддерживается в обе стороны. Обмен между разными форматами не обещает преобразования всей семантики биомов/block entities: неперенесённые данные архивируются и отмечаются в отчёте. Старые версии, legacy `.schematic`, structure `.nbt` и полная миграция произвольных DataVersion не объявляются поддержанными.
+Sponge `.schem` v3 is supported in both directions. Conversion between formats does not promise to translate all biome/block entity semantics: data that is not transferred is archived and identified in the report. Older versions, legacy `.schematic`, structure `.nbt`, and complete migration of arbitrary DataVersion values are not claimed as supported.
 
-Новый, неизменённый и отредактированный экспорт прочитаны официальными Java 26.2 `NbtIo`, `RegionFile`, `SerializableChunkData`, `PrimaryLevelData`, `WorldGenSettings` и читателем сущностей. Независимый nbtlib проверил Sponge и типы NBT. Это проверка официальных codecs без запуска игрового сервера и принятия EULA; игровой плейтест в Minecraft не заявляется.
+New, unchanged, and edited exports were read by the official Java 26.2 `NbtIo`, `RegionFile`, `SerializableChunkData`, `PrimaryLevelData`, `WorldGenSettings`, and entity reader. Independent nbtlib checks verified Sponge and NBT types. These checks used official codecs without launching the Minecraft game/server or accepting its server startup prompt; no in-game Minecraft playtest is claimed.