mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2026-08-15 13:04:36 +00:00
48 lines
1.8 KiB
Markdown
48 lines
1.8 KiB
Markdown
|
# MCC Version Adaptation Tools
|
||
|
|
|
||
|
|
Scripts for analyzing Minecraft version differences and generating MCC palette files.
|
||
|
|
|
||
|
|
Requires: Python 3.10+, decompiled MC server source in `MinecraftOfficial/<version>-decompiled/`.
|
||
|
|
|
||
|
|
## Decompiling a new MC version
|
||
|
|
|
||
|
|
```bash
|
||
|
|
cd MinecraftOfficial
|
||
|
|
java -jar MinecraftDecompiler.jar --version 1.21.4 --side SERVER \
|
||
|
|
--decompile --output 1.21.4-remapped.jar --decompiled-output 1.21.4-decompiled
|
||
|
|
```
|
||
|
|
|
||
|
|
## diff_registries.py — Compare registries between versions
|
||
|
|
|
||
|
|
Compares Items, EntityTypes, Blocks, DataComponents, and EntityDataSerializers between two MC versions. Reports whether each palette needs updating, lists added/removed entries, and shows ID shift statistics.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
python3 tools/diff_registries.py 1.20.6 1.21.1
|
||
|
|
```
|
||
|
|
|
||
|
|
Output indicates for each registry:
|
||
|
|
- **IDENTICAL** → reuse existing palette
|
||
|
|
- **PALETTE UPDATE NEEDED** → create new palette file + update version routing
|
||
|
|
|
||
|
|
## gen_item_palette.py — Generate ItemPalette C# file
|
||
|
|
|
||
|
|
Reads `Items.java` field declaration order to generate a complete `ItemPaletteXXX.cs`.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
python3 tools/gen_item_palette.py 1.21.1 121
|
||
|
|
# → MinecraftClient/Inventory/ItemPalettes/ItemPalette121.cs
|
||
|
|
```
|
||
|
|
|
||
|
|
Also validates each item name against `ItemType.cs` and warns about missing enum values.
|
||
|
|
|
||
|
|
## gen_entity_metadata_palette.py — Generate EntityMetadataPalette C# file
|
||
|
|
|
||
|
|
Reads `EntityDataSerializers.java` static block registration order to generate `EntityMetadataPaletteXXX.cs`.
|
||
|
|
|
||
|
|
```bash
|
||
|
|
python3 tools/gen_entity_metadata_palette.py 1.20.6 1206
|
||
|
|
# → MinecraftClient/Mapping/EntityMetadataPalettes/EntityMetadataPalette1206.cs
|
||
|
|
```
|
||
|
|
|
||
|
|
The script maps Java field names to MCC's `EntityMetaDataType` enum. If a new serializer type appears that isn't in the mapping table, it will warn you to update both the script's `FIELD_TO_ENUM` dict and MCC's `EntityMetaDataType.cs` enum.
|