Revision as of 19:43, 31 August 2014

MineTweaker3

Welcome to the MineTweaker 3 wiki! The aim of MineTweaker is to provide modpack creators, server administrators and map makers with the capability of customizing Minecraft without having to write a custom mod for it. All functionality is provided through an easy-to-use scripting language. (no prior knowledge or programming experience required!)

Using MineTweaker, you can...

• Add and remove any crafting recipe
• Add and remove mod machine recipes for supported mods
• Modify the ore dictionary

Additionally, all scripts are sent from server to client, and thus only need to be stored server-side. They can be altered and reloaded without having to restart anything.

Forge Mods can also execute scripts in MineTweaker. Mod Script Execution

Comparison with MineTweaker 2

• Comparison with MineTweaker 2

Tutorials (1.7.X)

• Lesson 1: Introduction
• Lesson 2: Basic Recipes
• Lesson 3: Ore Dictionary
• Lesson 4: Furnace
• Lesson 5: Advanced Recipes
• Lesson 6: Item Renaming
• Lesson 7: Tooltips
• Lesson 8: Loot and seeds
• Lesson 9: Loops

Tutorials (1.6.4)

• Lesson 1: Introduction
• Lesson 2: Basic Recipes
• Lesson 3: Ore Dictionary
• Lesson 4: Furnace
• Lesson 5: Advanced Recipes
• Lesson 6: Item Renaming
• Lesson 7: Tooltips
• Lesson 8: Loot and seeds

Guides

• Script Introduction
• Script Statements
• Script Expressions
• Script Functions

Mod Support

• NEI: NEI Support
• IC2: IC2 Support
• GregTech: GregTech Support
• MineFactory Reloaded: MFR Support

• Additional Support: ModTweaker

References

The following wiki pages provide useful references:

• NBT Tag formats

Downloads

• 1.6.4: MineTweaker 3.0.7 for 1.6.4
• 1.7.2: MineTweaker 3.0.7 for 1.7.2
• 1.7.10: MineTweaker 3.0.7 for 1.7.10

Extending MineTweaker

More than ever before, you can extend MineTweaker with your own functionality.

There are various things you can do:

• You can register global variables with minetweaker.MineTweakerAPI.registerGlobalSymbol(IZenSymbol). Use MineTweakerAPI.getJavaStaticGetterSymbol to get a static getter symbol or MineTweakerAPI.getJavaStaticFieldSymbol to get a static field symbol.
• You can register bracket handlers with minetweaker.MineTweakerAPI.registerBracketHandler(IBracketHandler). Bracket handlers can make it possible to create your own namespace for items/things in specific mods. See the minetweaker.mc17.brackets for example implementations.
• You can register custom classes with minetweaker.MineTweakerAPI.registerClass. Classes must have either a @ZenClass or @ZenExpansion annotation. Classes can be imported and called (handy for mod machines) and expansions can extend existing types (see minetweaker.data for examples, as well as minetweaker.item.IItemStack)
• In large projects, you can use the gradle RegisterZenClassesTask (see GitHub source in buildSrc) to generate a class containing a list of all registerable classes in your project. You can then submit the class name to MineTweakerAPI to make it register all those classes. All MineTweaker subproject use this system, so read those gradle build scripts to see how it's done. (or contact me)

Changelog & Planned Versions

Changelog

Planned Versions

Credits

Me (Stan Hebben) as mod creator.

All those who reported bugs on GitHub, for otherwise I'd not be able to fix them.

The beta testers: Ravin6666, Peach774, AnodeCathode, Dyonovan, Joshiejack