Progetto per realizzare un Hackathon che permetta di sviluppare plugin per Minecraft.
Questo progetto contiene il codice Java necessario per realizzare un plugin per Minecraft utilizzando la mod Minecraft chiamata Forge [https://files.minecraftforge.net/]. La documentazione sulla libreria Forge è navigabile qui: [http://mcforge.readthedocs.io/en/latest/]. Il progetto è stato sviluppato con Eclipse [http://www.eclipse.org/] ma è possibile utilizzare qualsiasi IDE per sviluppare il proprio plugin. Per realizzare un plugin, inoltre, è necessario installare il Java Development Kit (JDK) [http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html].
Il server Minecraft è già disponibile all'interno di questo progetto, insieme ad esso questo progetto contiene anche un plugin d'esempio che mostri le possibilità di implementazione offerte da CanaryMod e un progetto che idealmente dovrà essere utilizzato come base di partenza per lo sviluppo dell'hackathon.
Per preparare il workspace in modo che possa essere aperto da Eclipe, è necessario usare il comando:
gradlew setupDecompWorkspace eclipse
In questo modo verrà inizializzato l'ambiete Forge con le librerie di Minecraft e verrà inizializzato il workspace per l'apertura con Eclipse.
Questa cartella contiene il server Minecraft realizzato da Forge. Per startare Minecraft, è possibile usare il comando:
gradlew startClient
Se si utilizza Eclipse, è possibile lanciare il server anche richiamando la configurazione di lancio Minecraft Server.
Questa cartella contiene i files necessari a definire un plugin di esempio che mostra alcune funzionalità di Forge. In particolare il plugin implementa diverse funzionalità richiamabili con un comando dalla chat del gioco. Inoltre il plugin crea un task asincrono che viene eseguito automaticamente dal server e registra un listener in grado di percepire la presenza di evento nel gioco per effettuare delle operazioni quando si verificano determinati eventi.
Il plugin implementa diverse funzionalità d'esempio, di seguito elencate:
- con il comando
/creacasaverrà creata una casa (5x5) di legno attorno al giocatore; - con il comando
/skytutti gli esseri viventi presenti nel mondo, ad esclusione dei giocatori, verranno portati in cielo di 50 blocchi e lasciati cadere; - con il comando
/rigenerail giocatore otterrà il massimo dei punti energia e dei punti cibo; - con il comando
/mandria ##verrà creata una mandria di N mucche (con N uguale al secondo parametro numerico passato al comando) attorno al giocatore; - facendo click col tasto destro quando si ha selezionato il materiale pelle, verrà "sparata" una mucca infuocata che, al contatto col terreno, esploderà
Il progetto può essere compilato come un semplice programma java, si consiglia l'utilizo di un IDE, come Eclipse, in grado di gestire automaticamente i progetti gradle.
This code follows the Minecraft Forge installation methodology. It will apply some small patches to the vanilla MCP source code, giving you and it access to some of the data and functions you need to build a successful mod.
Note also that the patches are built against "unrenamed" MCP source code (aka srgnames) - this means that you will not be able to read them directly against normal code.
Source pack installation information:
Step 1: Open your command-line and browse to the folder where you extracted the zip file.
Step 2: Once you have a command window up in the folder that the downloaded material was placed, type:
Windows: "gradlew setupDecompWorkspace" Linux/Mac OS: "./gradlew setupDecompWorkspace"
Step 3: After all that finished, you're left with a choice. For eclipse, run "gradlew eclipse" (./gradlew eclipse if you are on Mac/Linux)
If you preffer to use IntelliJ, steps are a little different.
- Open IDEA, and import project.
- Select your build.gradle file and have it import.
- Once it's finished you must close IntelliJ and run the following command:
"gradlew genIntellijRuns" (./gradlew genIntellijRuns if you are on Mac/Linux)
Step 4: The final step is to open Eclipse and switch your workspace to /eclipse/ (if you use IDEA, it should automatically start on your project)
If at any point you are missing libraries in your IDE, or you've run into problems you can run "gradlew --refresh-dependencies" to refresh the local cache. "gradlew clean" to reset everything {this does not effect your code} and then start the processs again.
Should it still not work, Refer to #ForgeGradle on EsperNet for more information about the gradle environment.
Tip: If you do not care about seeing Minecraft's source code you can replace "setupDecompWorkspace" with one of the following: "setupDevWorkspace": Will patch, deobfusicated, and gather required assets to run minecraft, but will not generated human readable source code. "setupCIWorkspace": Same as Dev but will not download any assets. This is useful in build servers as it is the fastest because it does the least work.
Tip: When using Decomp workspace, the Minecraft source code is NOT added to your workspace in a editable way. Minecraft is treated like a normal Library. Sources are there for documentation and research purposes and usually can be accessed under the 'referenced libraries' section of your IDE.
MinecraftForge ships with this code and installs it as part of the forge installation process, no further action is required on your part.
https://www.youtube.com/watch?v=8VEdtQLuLO0&feature=youtu.be
For more details update more often refer to the Forge Forums: http://www.minecraftforge.net/forum/index.php/topic,14048.0.html