diff --git a/README.MD b/README.MD index 89bf96934..13734c037 100644 --- a/README.MD +++ b/README.MD @@ -1,4 +1,71 @@ -Mixin -===== +![Mixin Logo](docs/logo.png?raw=true) -Mixin is a trait/mixin framework for Java using ASM. The main documentation can be found in the [Wiki](https://github.com/SpongePowered/Mixin/wiki) +**Mixin** is a trait/mixin framework for Java using [ASM](http://asm.ow2.org/) +and hooking into the runtime class-loading process via Mojang's +[LegacyLauncher](https://github.com/Mojang/LegacyLauncher) system. The main +documentation for **Mixin** can be found in the [Wiki](wiki). + +### Building Mixin +**Mixin** uses the [Gradle](http://gradle.org/) build automation system. To +perform a build simply execute + + gradle + +from within the project root directory. + +### Integration with Eclipse IDE + +The **Mixin** project can be integrated easily with Eclipse using the [Gradle +Plugin](http://marketplace.eclipse.org/content/gradle-integration-eclipse-44). +Simply choose `Import` -> `Gradle Project` and follow the prompts. + +When developing using **Mixin**, you can use the **Mixin Annotation Processor** +within Eclipse to provide context-sensitive errors and warnings to help you more +easily troubleshoot your mixins. To do so: + +1. Run the `gradle build` command to generate the mixin jar +2. Open the properties of your eclipse project and navigate to `Java Compiler` + -> `Annotation Processing` -> `Factory Path` +3. Check the `Enable project specific settings` checkbox +4. Click the `Add External JARs` button and select the generated mixin jar +5. Navigate up one level to `Java Compiler` -> `Annotation Processing` +6. Check the `Enable project specific settings` checkbox +7. Check the `Enable annotation processing` checkbox +8. Click the `New...` button next to the `Processor options` box + * Set `Key` to **reobfSrgFile** + * Set `Value` to the fully-qualified path to the `mcp-srg.srg` file +9. Click `OK` to apply the changes + +### Version History + +
Version | +Features / Changes | +Date | +
---|---|---|
0.1 | +
+
|
+ January 2015 | +
0.2 | +
+
|
+ March 2015 | +