mirror of https://github.com/MCCTeam/Minecraft-Console-Client synced 2026-08-15 13:04:36 +00:00

BruceChen 7609832976 chore: add reusable version adaptation scripts

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

2026-03-20 01:51:56 +08:00

1.8 KiB

Raw Blame History

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

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.

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.

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.

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.

1.8 KiB Raw Blame History