Readme MCP

Mod Coder Pack 9.08 for Minecraft 1.7.
10
=======================================
MCP is (c) Copyright by the MCP Team
License and terms of use.
=========================
No warranties. If MCP does not work for you, or causes any damage, it's your pro
blem. Use it at own risk.
You are allowed to:
- Use MCP to decompile the Minecraft client and server jar files.
- Use the decompiled source code to create mods for Minecraft.
- Recompile modified versions of Minecraft.
- Reobfuscate the classes of your mod for Minecraft.
You are NOT allowed to:
- Use MCP to do anything that violated Mojangs terms of use for Minecraft.
- Release Minecraft versions or modifications that allow you to play without hav
ing bought Minecraft from Mojang.
- Release modified or unmodified versions of MCP anywhere.
- Use any of MCPs scripts, tools or data files without explicit written permissi
on.
- Make money with anything based on MCP (excluding Minecraft mods created by usi
ng MCP).
- Use MCP to create clients that are used for griefing or exploiting server bugs
.
- Release the decompiled source code of Minecraft in any way.
Prerequisites:
==============
1.) Install Java SDK Standard Edition (short JDK).
Link: http://www.oracle.com/technetwork/java/javase/downloads/
2.) Add the paths to your JDK and JRE bin folders to the Environment Variable PA
TH.
Description where to find the variable:
http://www.java.com/en/download/help/path.xml
Example for Windows users of what you have to add to the variable (entries a
re seperated by ";" )
C:\Program Files\Java\jdk1.6.0_24\bin;C:\Program Files\Java\jre6\bin
We wont provide any help setting it up - this _is_ a prerequesite.
Note: MCP versions 4.4 and higher should also work properly with JDK 1.7
How to use:
===========
1) Prepare the files:
- Copy the "minecraft_server.1.7.10.jar" file into the "jars" folder.
- Either copy the folders "assets", "libraries" and "versions" from "%APPDATA$\.
minecraft" folder into the "jars" folder or let the decompile scripts do it auto
matically for you.
- No need to copy the folders "bin" and "resources" from your "%APPDATA$\.minecr
aft" folder into the "jars" folder anymore - in fact, it does not work that way
anymore.
2) Decompilation and patching
- Start the "decompile.bat" script in this folder.

3) Modding
- Modify the sourcecode in the "src\minecraft" folder or in the "src\minecraft_s
erver" folder.
4) Compile
- Start the "recompile.bat" script in this folder.
5) Testing
- To test the modified game, start the "startclient.bat" script
- To test the modified server, start the "startserver.bat" script
6) Obfuscation
- Decompile the code, modify and recompile.
- Start "reobfuscate.bat" to start the reobfuscation step, it will automatically
detect changed classes and reobfuscate them.
- Your obfuscated classes are now available in "reobf\minecraft" and "reobf\mine
craft_server", ready to be injected in MC.
- Make sure to delete the META-INF folder in minecraft.jar, otherwise the game w
ill just black-screen when you start it.
WARNINGS:
=========
- Make sure that you backup the modified sources before you run "decompile.bat"
again or all changes will be lost!
- The "cleanup.bat" file will delete most of the generated files and sources. Be
careful with this one :)
Notes:
======
* If you want to include external libraries (either as .jar or .class) to the cl
asspath during recompilation add them
to a folder called "lib" creating it first if required.
* Should mcp complain about "java.lang.NoClassDefFoundError: Start" when trying
to run startclient.bat or startserver.bat
try cleanup.bat (make backups of you sources!), decompile again and recompile
as the final step.
* Do not use this to release complete packages of minecraft jar, class or java f
iles. They are copyrighted
material by Notch and mods should only contain small changes to some classes,
never complete sets that
can be used by people who did not buy the game to play it.
* Make sure you use the original minecraft.jar and minecraft_server.jar files. I
f you have already modded them
they will NOT work with the patches in these scripts.
* The "startclient.bat" file uses the "Start.class" file to start the game. This
will make sure the game will not
use your "%APPDATA%\.minecraft" folder, but instead use the "jars" folder for
all saves. So any bugs in the modified
game will not corrupt your normal worlds.
* If you have any problems using this toolpack, put the "logs\*.log" files that
the scripts generated into a
zip-file and send it to us (post it in the minecraft forum):
http://www.minecraftforum.net/viewtopic.php?f=25&t=58464
* This version of the MCP uses a deobfuscator to change all field and method nam
es in the sources.
Look in the csv files in "conf", namely "conf\classes.csv", "conf\fields.csv"
and "conf\methods.csv" files for a complete mapping of the names.
* There are currently no known bugs in the recompiled game or server, except tho
se that were already in the original
game :)
* If your reobfuscated classes cause a black screen in Minecraft, make sure that
you've deleted the META-INF folder
in the minecraft.jar file.
* To add new resources to the game, for example png files, put them in the bin f
older tree, they will also get copied to the reob folder
automatically when you reobfuscate your changes.
Credits:
========
== Currently Active ==
Searge
* Creator of MCP
* Fixes all compile errors in the decompiled sourcecode
* Created the MCP mod system and API
* Created the Eclipse workspace for MCP 4.x
* Created the new RetroGuard deobfuscation module for MCP 3.0
* Created the new mod system
ProfMobius
* Creator of the renaming codes and re-obfuscation procedures
* Helped to port scripts to Linux
* Developer and maintainer of the MCP chan bot
* Is now bald after working too much with java constant pool and re-obfuscation
* Created the new workflow scripts and renamer for MCP 3.0
IngisKahn
* Creator of the bytecode compare tool that helps us to update the name mappings
quickly for new minecraft versions
* Contributed to the de-obfuscation spreadsheet
* Working hard on creating better internal tools for mapping updates and decompi
ling
Fesh0r
* php/sql code monkey
* Uses his magic to create mappings, patches, and general release work
* Has Searge's approval to make official MCP releases ;)
* Makes sure we get proper patches for the sourcecode that JAD generates
* Maintains our scripts and toolkits
* Optimized the Retroguard and Exceptor tools
R4WK
* Works on MCP updates and contributes to the new mod system
* Helps ZeuX with Techne improvements
ZeuX
* Helps out in the IRC channels - Head of HR
* Did server patches for the most recent versions - if you run into any (patch-r
elated) problems, it's his fault :P
* Created the famous Techne model editor for Minecraft
* Contributes features to the new mod system
LexManos
* Helped Fesh0r to update MCP for Minecraft 1.0.0/1.0.1
* Helped to update the scripts and mappings for the new structure introduced by
Minecraft 1.6.x
* Did a lot of the work required to update to Minecraft 1.7.10

CPW
* Helped to update the scripts and mappings for the new structure introduced by
Minecraft 1.6.x
* Did a lot of the work required to update to Minecraft 1.7.10
303
* Wiki contributor
* Tries to help out newbies in the IRC channels
* Makes sure modloader mods can be created with MCP
Mr_okushama
* Wiki contributor
* Public Support Manager
* IRC Operator
* Savior of the 2011 April fools prank
Cryect
* Contributed a lot of deobfuscation mappings
* Created the awesome AdventureCraft mod
Mysterio N
* Created the getmodsource scripts
== Former Contributors ==
Generic
* Works on improving IngisKahn's bytecode compare tool
* Added some important features to retroguard
Risugami
* The guy who created the first mods I (Searge) ever used in Minecraft
* The creator of modloader who gave us permission to include files from his syst
em in MCP
fotoply
* Helped to improve the batch files
Cadde
* Community manager and Wiki manager
* Works on the de-obfuscation spreadsheet
* Mod support (making old mods work with MCP)
* All round handyman
Vaprtek
* Works on the de-obfuscation spreadsheet
* Knows how to make pet creepers
gronk
* Script support
n00bish
* Linux script maintenance
Sage Pourpre
* His thread in the forums inspired me (Searge) to create this toolpack in the f
irst place
Tei
* Supported the MCP project since the first version was released
spec10
* The new linux scripts guy
Head
* Wiki contributor / Administrator
* Explains classes and their members on the Wiki
MissLil
* Various scripting stuff
* Lots of reverse engineering
* OpenGL constants annoting
ScottyDoesKnow
* obfuscathonCharmer, the obfuscathon GUI
Chase
* MCP Launcher Work
* External jar loading

* Scrollable mod list.
titegtnodI
* Wiki contributor
* IRC Operator
== Superspecial thanks to ==
Stiver - for allowing us to include the fernflower decompiler in MCP releases
== Special thanks to ==
UltraMoogleMan
Yamachi
and of course:
- Everybody who contributed to the google spreadsheet and MCPBot or who created
some mods with MCP.
- NOTCH and JEB for creating a game that is just awesome, I hope they do not fee
l offended by our decompiling efforts.
Please, Notch, support our ambitions to mod your game. I know people who
bought it just because of
some great mods.
History:
========
9.08 - Updated to support Minecraft 1.7.2 and MinecraftServer 1.7.10
7.42 - Updated to support Minecraft 1.5 and MinecraftServer 1.5
7.39 - Updated to support Minecraft 13w09c and MinecraftServer 13w09c (snapshot)
7.34 - Updated to support Minecraft 13w05b and MinecraftServer 13w05b (snapshot)
7.30 - Updated to support Minecraft 13w02b and MinecraftServer 13w02b (snapshot)
7.22 - Updated to support Minecraft 1.4.5 pre1 and MinecraftServer 1.4.5 pre1
7.18 - Updated to support Minecraft 1.4.1 and MinecraftServer 1.4.1 (pre-release
)
7.17 - Updated to support Minecraft 1.4 and MinecraftServer 1.4 (pre-relrease)
7.0a - Added fernflower decompiler
4.5 - Updated to support Minecraft 1.9 pre 5 and MinecraftServer 1.9 pre 5
4.1 - Added an Eclipse workspace and included a reobfuscation bugfix
4.0 - Added improved decompile scripts with new Exceptor tool

3.1 - Complete rewrite of the framework, works with Minecraft 1.5_01 and Minecr
aftServer 1.5_02
2.12 - Updated to support Minecraft 1.5_01 and MinecraftServer 1.5_02
2.9a - Added MCP Mod System for 1.3_01, added mod loader support, updated mappin
gs
2.9 - Updated to support Minecraft 1.3_01 and MinecraftServer 1.3
2.8 - Added the MCP mod system SDK and support for OSX
2.3 - Updated to support Minecraft 1.2.3_04 and MinecraftServer 0.2.5_02. Linux
support beta.
2.2a - Bugfix release to improve the re-obfuscation tools
2.2 - The reobfuscation beta test release. Still for Minecraft 1.2.2
2.1 - Updated to support Minecraft 1.2.2
2.0a - Bugfix release
2.0 - Major updates to MCP and support for post-Halloween versions of Minecraft
1.6 - All classes have meaningful names now, the class name mappings and the fi
eld name mappings are applied
1.5 - Extend the scripts to also support decompiling, recompiling and testing t
he minecraft_server.jar file
1.4 - Using a deobfuscator to rename all fields and methods and jadretro to fix
some decompile bugs
1.3 - Added upgrade scripts to decompile and recompile Minecraft.class, Minecra
ftApplet.class and MinecraftServer.class
1.2 - Redirect output of all tools to a logfile
1.1 - Fixed TNT bug
1.0 - First release
Roadmap:
========
9.09+ - New awesome features, improvements and updates :)
________________________________________________________________________________
_________________________________
________________________________________________________________________________
_________________________________
________,.--:=r=..______________________________________________________________
_________________,,...___________
_ -:'`
:^)-.!..[``P: _____________________________________________________
______ ,.=~r?`[:_i=.
`'~-._ _
_ .
:=)~.|:.| [j _____________________________________________________
______ l| [3 .:,[:.
! _
_ :
:.[ .|:.( [| ______________________________________________________
________[|=^): [_ | .
! _
__
:~)=.i..j [] _____________________________________________________
______ )|:') [ _|;.
! _
_ .
:.)..i._|;.)| _____________________________________________________
______ [!:=[` |: | .
! _
_ ) _
:.[ .! | .[| _____________________________________________________
______ )j:^[` (: | .
! _
_ :_
<=l:.____ . | _____________________________________________________
______ [!:`` :.|:.
. ! _
_ ._ _ __ __:..;.|,.) .[j _____________________________________________________
______ [!3`T``l:. .
` ! _
____ [,...-+=c=f7l`!-( _____.~~~~~~~~._____=~~~~~~~/_____,>====~<.y=.__y~~~~~~~~
~~=~.._ ```[j)=[=[.;,,_ _|'`` _
____ [ -~= ( '=r::::~( _____!<.
L____F
.=._ ,c ;>~~<. [_ F<. .>~
~<. ".__ (.......!.( .. | ____
____ [`) [ ! !^) !') ______ [ JL (___F Z. ( ___/ ./ ____ ". J___ L ? _
__J. J _ |-l ,.( !-| )-| ____
____ ) !`
( ```[ ( _____ :. [[ J__F /] .L___F .F _______"L L__J
[__
__/
/ _ | )~~~~ r- !~! | ____
____ [ . . [_) (___|_( _____ | :L! J.F / L J __[
| _________ _ [ =+~~
=l ;/ __ |'[^^^( [ :'. ::( ____
____ [..
(.;.i.) ( ______L ? :. * / J. [__ L
L______________:L ;...
=+=^` ____ (`["[ l [`` ! ! | ____
____ ).. .... !.. ( _____J. L_ L
/ _[ :L__ [
[_________,.__ | .L___
__________ ( .
! | ____
____ ).. --. --..!-( _____[ :.__| / _.L J ___"c ?.______,/.;F _L J.___
__________ [_[___ __
_| ____
____ )~)~r -)~r - ( ( __:tT ":LJ / r^`
")___ \. 7*==^`.;* r^`
"tL_
__________ ! ( ,,[ ._].|_____
___ _z;! : = ( ( : !=( __'^^^^^^" ^^ *^^^^^^^^`____ "*~~~~^` __"^^^^^^^^" _
__________ ;.) ( ( ..!.!.| ____
____F"*:P*si_(^^======._________________________________________________________
___________j.....[.( !,.ztSP\ ___
_ _!
7*.)
L L_________________________________________________________
__________: J
:?x>'`
l___
__[ ;~.! ; :=l .-<--~~[_________________________________________________________
__________|,J .__ !. :. _,_ . _
I :`~. `\[ (.J-=
[_________________________________________________________
__________|
._L_)~\./ ..==`.
-.;`'=._ .L!;)-+--=-=-l_________________________________________________________
__________|___;__[_;=[\
,>=`
_ =-: `` _ --:...-..._________________________________________________________
__________ :_: ._[ \=^ .-!
_ ` - L______-.- ..-_________________________________________________________
__________: !
._____ -' _ -' _
_____
_______________________________________________________________________
__________
______ ' _____
d8b db
888o 88
88V8o 88
88 V8o88
88 V888
VP V8P
db
db
`8b d8'
`8bd8'
88
88
YP
.d88b.
.8P Y8.
88
88
88
88
`8b d8'
`Y88P'
.d88b.
.8P Y8.
88
88
88
88
`8b d8'
`Y88P'
db d8b db
88 I8I 88
88 I8I 88
Y8 I8I 88
`8b d8'8b d8'
`8b8' `8d8'
db
db
88
88
88
88
88
88
88b d88
~Y8888P'
d8888b.
88 `8D
88oobY'
88`8b
88 `88.
88 YD
d888888b d888888b
`88' `~~88~~'
88
88
88
88
.88.
88
Y888888P
YP
.o88b.
d8P Y8
8P
8b
Y8b d8
`Y88P'
d8888b.
88 `8D
88oobY'
88`8b
88 `88.
88 YD
d888888b
`88'
88
88
.88.
Y888888P
.d8b.
d8' `8b
88ooo88
88~~~88
88 88
YP YP
.d8888.
88' YP
`8bo.
`Y8b.
db 8D
`8888Y'
d88888b d888888b
88'
`~~88~~'
88ooo
88
88~~~
88
88
88
YP
YP
================================================================================
======================================

Readme MCP

Uploaded by

Document Information

Original Title

Copyright

Available Formats

Share this document

Share or Embed Document

Sharing Options

Did you find this document useful?

Is this content inappropriate?

Copyright:

Available Formats

Readme MCP

Uploaded by

Copyright:

Available Formats

Mod Coder Pack 9.08 for Minecraft 1.7.

- Start the "decompile.bat" script in this folder.

* Did a lot of the work required to update to Minecraft 1.7.10

* External jar loading

3.4 - Updated to support Minecraft 1.6.6 and MinecraftServer 1.6.6

You might also like