mirror of
https://github.com/MCCTeam/Minecraft-Console-Client
synced 2026-08-15 13:04:36 +00:00
7609832976
Add tools/ directory with Python scripts for comparing Minecraft version registries and generating MCC palette files: - diff_registries.py: Compare Items/EntityTypes/Blocks/DataComponents/ EntityDataSerializers between two decompiled MC versions, reporting which palettes need updating with ID shift analysis. - gen_item_palette.py: Generate ItemPaletteXXX.cs from Items.java field declaration order, with name validation against ItemType.cs. - gen_entity_metadata_palette.py: Generate EntityMetadataPaletteXXX.cs from EntityDataSerializers.java registration order. - README.md: Usage documentation for all scripts. Made-with: Cursor
47 lines
1.8 KiB
Markdown
47 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.
|