Obfuscation maps are Proguard mappings from old (original) names to new (obfuscated) names for classes and class members that have been renamed.[1] They have been exported in the client.json for every snapshot and release available in the Launcher since 19w36a, and the client.json for 1.14.4 has been updated slightly after 19w36a's release to include obfuscation maps as well.[2]
Usage
The obfuscation maps can be used to remap obfuscated stack traces (as in crash reports) to readable stack traces.[3]
Dinnerbone and Adrian Östergård have suggested that the obfuscation maps may make modding easier.[4][5] Searge has implied that the obfuscation maps can replace certain third-party programs such as the Mod Coder Pack.[6]
Third party usages
The obfuscation maps include enough information to deobfuscate Minecraft for decompilation. Third-party programs may exist for this purpose.
According to the License, such decompiled source code is restricted to internal and reference use.
License
Every obfuscation map file starts with a line indicating the license of the maps.
# (c) 2019 Microsoft Corporation. All rights reserved. This information is provided "as-is" and you bear the risk of using it. This information does not provide you with any legal rights to any intellectual property in any Microsoft product. You may copy and use this information for your internal, reference purposes. Microsoft makes no warranties, express or implied, with respect to the information provided here.
History
| September 3, 2019 | Dinnerbone mentions "a small surprise for modders!" for 19w36a. | ||||
|---|---|---|---|---|---|
| Java Edition | |||||
| 1.15 | 19w36a | Downloads to client and server obfuscation maps are now included in client.json. | |||
| September 4, 2019 | Dinnerbone releases obfuscation mappings for 1.14.4 as well. | ||||
Trivia
- Out of all Java Edition versions published after 19w36a (September 4th, 2019), Combat Test 3 is yet the only one published without any obfuscation map.
- Unlike previous Combat Tests, the version it forked against, 1.14.4, has obfuscation maps released.
- All consequent Combat Tests have obfuscation maps released, and are based off versions with obfuscation maps released.
- As of 20w06a, versions released in year 2020 still have
# (c) 2019 Microsoft Corporation.in the license notice in the obfuscation map files.
References
- ↑ "ProGuard manual | Usage" – Guardsquare
- ↑ “I've been pushing for this for a while, so I'm really happy that we were finally able to release the obfuscation mappings public. @SeargeDP had a great idea to release the 1.14.4 mappings as comparison, so those are going out right now.” – @Dinnerbone, September 4th, 2019
- ↑ "ProGuard manual | Retrace" – Guardsquare
- ↑ “Tomorrow's snapshot has a small surprise for modders! Should make one or two people happy :)” – @Dinnerbone, September 3rd, 2019
- ↑ “Happy modding!” – @adrian_ivl, September 4th, 2019
- ↑ “This should answer the questions of everyone who kept asking about MCP updates for newer versions of Minecraft. Spoiler: there won't be any, they are finally not necessary anymore.” – @SeargeDP, September 4th, 2019
| 버전 |
| ||||
|---|---|---|---|---|---|
| 개발 |
| ||||
| 기술적 |
| ||||
| 멀티플레이어 |
| ||||
| 게임 사용자지정 | |||||
