Version mappings
In order to interact with Minecraft traffic, MCmdLogger requires a version mappings. Version mappings contains information about specific versions of Minecraft protocol and used to parse and generate packets.
By default, MCmdLogger comes with builtin mappings, by they can quickly become outdated. To avoid this, you can build version mappings by yourself.
PrismarineJS mappings
minecraft-data repo provided by PrismarineJS project is an awesome source of data about different versions of Minecraft protocol, items, crafting recipes, etc. It is actively maintained and its mappings are known to be pretty stable. You can find them in this repo: https://github.com/PrismarineJS/minecraft-data. MCmdLogger uses it for builtin mappings, and you can use it to acquire a fresh copy of mappings when builtin ones become outdated.
In order to build PrismarineJS mappings, launch MCmdLogger, enter any port and server IP, then run vermaps build prismarine command. This will download the latest mappings version from PrismarineJS repo and compile them into MCmdLogger mappings file (.mcmdlogger/vermaps.bin).
After build process is finished, you will need to restart MCmdLogger in order to apply new mappings.
Custom mappings
caution
Use of custom mappings can lead to instability and unexpected bugs. If you run into some issues with MCmdLogger while using custom mappings, try to remove them or switch to PrismarineJS mappings before contacting support.
From Git repo
In order to build mappings from Git repo, run vermaps build git <repo> [branch] command. Notice, that branch is optional, and if not specified, default repo branch will be used.
Git repo must have the same folder structure as PrismarineJS repo. MCmdLogger uses only data/pc folder, so other folders are not required.
From local folder
In order to build mappings from local folder, run vermaps build local <path> command. Path can be relative or absolute, and contents of the folder must have the same structure as data/pc folder from PrismarineJS repo.
Commands
There are commands related to version mappings management. These are console commands that need to be entered into the MCmdLogger console.
| Usage | Description |
|---|---|
vermaps info | Display info about currently used mappings |
vermaps remove | Remove local mappings (return to builtin) |
vermaps build prismarine | Build PrismarineJS mappings |
vermaps build git <url> [branch] | Build custom mappings from git repo |
vermaps build local <path> | Build custom mappings from local folder |