Latest News Article

[ShaRose]

Hello! I'm ShaRose and I'm currently the primary maintainer for GuiAPI, taking over for lahwran who will still be contributing. GuiAPI is a powerful API for creating easy to create and use settings and menus in Minecraft, and uses TWL (http://twl.l33tlabs.org/).

For Users:

Current version is 0.14.2-1.2.5.

Download 0.14.2-1.2.5 here: Download

Old Versions:

Spoiler

Version 0.14.2-1.2.5 - http://bit.ly/Hl3tPT

If you are using Linux and minecraft 1.2.4 and lower you will need to update LWJGL to 2.6 or higher, due to a bug in the version that Minecraft is shipped with at the moment. Windows users do not need to do this. If you are using 1.2.5 and higher, same thing, you don't need to do this. You can download the latest version from the LWJGL website.

Version 0.14.1-1.2.4 - http://bit.ly/GWHfGs
Version 0.14.0-1.2.3 - http://bit.ly/AkwJgK
Version 0.13.1-1.1 - http://bit.ly/ABKmIF
Version 0.13.0-1.1 - http://bit.ly/yQc1SY - MAJOR BUG. DO NOT DOWNLOAD.
Version 0.12.0-1.0.0 - http://bit.ly/sbMwxP
Version 0.11.1-1.8.1 - http://bit.ly/p2GlJY
Version 0.11.0-1.7 - http://bit.ly/oKu2EQ
Version 0.10.4-1.7 - http://bit.ly/pnIXMR
Version 0.10.2-1.6.6 - http://bit.ly/q5ubhD
Version 0.9.8a-1.5_01 - http://bit.ly/ruWzE8
Version 0.9.8-1.4 - http://bit.ly/qkRT6C
Version 0.9.7-1.3_01 - http://bit.ly/ozk43J
Version 0.9.5a-1.2_01 - http://bit.ly/oPAz7L

This has to go in the minecraft jar.

If you don't know how to install mods, use this.

For Modders:

GuiAPI is now fully documented, has MCP source files, and includes a few examples.

You can view the source code on my Github, at https://github.com/ShaRose/GuiAPI/.

Javadocs are currently located on my Dropbox, located here. Be warned it may be out of date, as I don't always remember to update it after a release, and sometimes I do it by accident BEFORE a release. I tag all releases on github, so you can view the source at the time of at least the newer releases.

If you wish to code with GuiAPI, the easiest way is with MCP. Note that since GuiAPI uses generics, and most decompilers can't handle those well, it will not decompile cleanly. Currently, the best way is the following.

Copy the Developer Package into your minecraft.jar. This can be before or after you decompile, as it's just the files needed for GuiAPI to run (TWL and other libraries for it, as well as the theme and font), and as such none of it is decompiled by MCP.

After that, grab a copy of the source from Github. I have tagged the releases for you, so visit https://github.com/ShaRose/GuiAPI/tags and click the one you need. Inside that zip file, go to the folder named mcp. It shouldn't be hard to find.

Now, these files are GuiAPI's source code. Just copy all of these files into MCP's src\minecraft\net\minecraft\src folder. This will overwrite GuiOptions.java: If you have made any changes to that file, you can either do those over again OR you can view the information on Github for patching in GuiAPI's changes.

After this, just compile and you should be all set.

If you have modified GuiAPI by updating the theme, adding a new Widget, added functionality, or fixed a bug, please by all means contact me with details below or open a new issue on Github.

Contact me:

If you need help using GuiAPI (Adding GuiAPI to your mod), you can contact me on IRC, or you can email me using the option in my profile.

Anyone (install help OR modding help) can contact me on IRC on #Risucraft on Espernet if you have an IRC client, and if not you can use the EsperNet Webchat here.

[linkey11]

Cool beans, I hope you do as well with this project as lahwran did.

[Blueblade11]

Yep. Now, to figure out what you did...

[ShaRose]

Blueblade11, on 10 September 2011 - 04:42 AM, said:

Yep. Now, to figure out what you did...

If you mean the changes I made, a vast majority was code cleanup. Renaming fields and methods, commenting, etc. I made sure all methods and fields had a javadoc entry. I added GuiApiHelper, which includes a lot of helpers. I modified ModAction to allow some more functions. I updated ModSettings to include some 'basic' methods to get settings. I updated GuiModScreen to allow more control over the background rendered. WidgetClassicTwocolumn and WidgetSinglecolumn have an option to set a specific widget's height. That's just the stuff I remember off the top of my head, and the vast majority isn't used by most people.

[Blueblade11]

ShaRose, on 10 September 2011 - 04:58 AM, said:

If you mean the changes I made, a vast majority was code cleanup. Renaming fields and methods, commenting, etc. I made sure all methods and fields had a javadoc entry. I added GuiApiHelper, which includes a lot of helpers. I modified ModAction to allow some more functions. I updated ModSettings to include some 'basic' methods to get settings. I updated GuiModScreen to allow more control over the background rendered. WidgetClassicTwocolumn and WidgetSinglecolumn have an option to set a specific widget's height. That's just the stuff I remember off the top of my head, and the vast majority isn't used by most people.

infomation overload...

Anyways, going to sift through that javadoc later.

[ShaRose]

Blueblade11, on 10 September 2011 - 05:24 AM, said:

infomation overload...

Anyways, going to sift through that javadoc later.

It's easier to say most of the stuff people use is exactly the same, and if you want to see some of the new stuff to look at the two examples.

[honeybunch]

I assume you install it just like any other mod? You might want to provide at least a cursory explanation about installation in the OP. I've installed enough mods that I'm pretty sure I'm doing it right, but I imagine users who are new to Minecraft modding would appreciate some instruction.

Anyway, thanks for the API. I'm planning to install this and the Forge version of your ID Resolver and go crazy with Forge mods.

EDIT: Rereading it, the first paragraph might come off as kind of hostile or like I'm chastising you. Just want to say that that wasn't my intention. I was really just trying to make a suggestion that I figured would be helpful to new modders.

[Mathir_Girelad]

Can you make a patch for ModOptionsAPI? i want to make Nature overhaul with id resolver and i can't

[Timrath]

I, too, would love to see some instructions. Do you put the .zip into the mods folder, or do you unzip it and throw it into minecraft.rar?
Also: how can I tell whether the installation was successful? I don't even know what this mod does, but I need it for the ID Resolver. I've tried getting it to work numerous times, but it never worked, and I have no clue why. I don't even know if it's because of GUIAPI or ID Resolver itself.

[Mathir_Girelad]

Timrath, on 14 September 2011 - 10:56 PM, said:

I, too, would love to see some instructions. Do you put the .zip into the mods folder, or do you unzip it and throw it into minecraft.rar?
Also: how can I tell whether the installation was successful? I don't even know what this mod does, but I need it for the ID Resolver. I've tried getting it to work numerous times, but it never worked, and I have no clue why. I don't even know if it's because of GUIAPI or ID Resolver itself.

i made it work just install GuiAPI right after ModOptionsAPI. It worked for me

[Brofessional]

very nice <3

[Timrath]

Mathir_Girelad, on 14 September 2011 - 10:59 PM, said:

i made it work just install GuiAPI right after ModOptionsAPI. It worked for me

ModOptionsAPI? What is that?

I'm totally stumped. Even with a reinstalled Minecraft, it still gives me a black screen. I suspect GUIAPI just is incompatible with Minecraft 1.8.

[ShaRose]

GuiAPI is now updated to 1.8.1.

[Epicmidget]

No pics, no clicks.

[xSoul]

Good job!

[thegofa]

Epicmidget, on 18 September 2011 - 11:31 PM, said:

No pics, no clicks.

LOL your loss, Mo Creatures and anything else needing a gui wont run without this. Maybe read a bit, the 2nd post is Lahwran who did this GUI forever.

TG

[thegofa]

Hey ShaRose, not sure if its you I should ask this, or go to Dr.Zhark for Mo Creatures, let me know please if its not here and I will delete...

I have installed 1.8.1 latest, ModLoader latest, AudioMod latest and GUIAPI latest.

Run MC, all fine. Then add Mo Creatures latest (in mod folder) and I get this...

Spoiler

Sep 21, 2011 10:06:23 PM ModLoader readFromModFolder
FINER: Zip found.
Sep 21, 2011 10:06:23 PM ModLoader addMod
FINE: Failed to load mod from "mod_mocreatures.class"
Sep 21, 2011 10:06:23 PM ModLoader addMod
FINER: THROW
java.lang.VerifyError: (class: mod_mocreatures, method: AddRenderer signature: (Ljava/util/Map;)V) Incompatible argument to function
at java.lang.Class.getDeclaredFields0(Native Method)
at java.lang.Class.privateGetDeclaredFields(Unknown Source)
at java.lang.Class.privateGetPublicFields(Unknown Source)
at java.lang.Class.getFields(Unknown Source)
at ModLoader.setupProperties(ModLoader.java:1583)
at ModLoader.addMod(ModLoader.java:274)
at ModLoader.readFromModFolder(ModLoader.java:1179)
at ModLoader.init(ModLoader.java:824)
at ModLoader.AddAllRenderers(ModLoader.java:186)
at aam.<init>(aam.java:61)
at aam.<clinit>(aam.java:10)
at net.minecraft.client.Minecraft.a(SourceFile:259)
at net.minecraft.client.Minecraft.run(SourceFile:629)
at java.lang.Thread.run(Unknown Source)

Sep 21, 2011 10:06:33 PM ModLoader readFromModFolder
FINER: Adding mods from C:\Documents and Settings\User\Application Data\.minecraft\mods\rei_minimap

Never seen that "Incompatible argument to function" before so wondered if it was GUIAPI.

Many thanks for any help and if its Mos, sorry for posting here...

TG

[xTwilight3]

Cool!

[ULT1MATEGAMER]

teehee i always use this every update

[ShaRose]

thegofa, on 21 September 2011 - 10:21 AM, said:

Hey ShaRose, not sure if its you I should ask this, or go to Dr.Zhark for Mo Creatures, let me know please if its not here and I will delete...

I have installed 1.8.1 latest, ModLoader latest, AudioMod latest and GUIAPI latest.

Run MC, all fine. Then add Mo Creatures latest (in mod folder) and I get this...

Spoiler

Sep 21, 2011 10:06:23 PM ModLoader readFromModFolder
FINER: Zip found.
Sep 21, 2011 10:06:23 PM ModLoader addMod
FINE: Failed to load mod from "mod_mocreatures.class"
Sep 21, 2011 10:06:23 PM ModLoader addMod
FINER: THROW
java.lang.VerifyError: (class: mod_mocreatures, method: AddRenderer signature: (Ljava/util/Map;)V) Incompatible argument to function
at java.lang.Class.getDeclaredFields0(Native Method)
at java.lang.Class.privateGetDeclaredFields(Unknown Source)
at java.lang.Class.privateGetPublicFields(Unknown Source)
at java.lang.Class.getFields(Unknown Source)
at ModLoader.setupProperties(ModLoader.java:1583)
at ModLoader.addMod(ModLoader.java:274)
at ModLoader.readFromModFolder(ModLoader.java:1179)
at ModLoader.init(ModLoader.java:824)
at ModLoader.AddAllRenderers(ModLoader.java:186)
at aam.<init>(aam.java:61)
at aam.<clinit>(aam.java:10)
at net.minecraft.client.Minecraft.a(SourceFile:259)
at net.minecraft.client.Minecraft.run(SourceFile:629)
at java.lang.Thread.run(Unknown Source)

Sep 21, 2011 10:06:33 PM ModLoader readFromModFolder
FINER: Adding mods from C:\Documents and Settings\User\Application Data\.minecraft\mods\rei_minimap

Never seen that "Incompatible argument to function" before so wondered if it was GUIAPI.

Many thanks for any help and if its Mos, sorry for posting here...

TG

I'd say talk to Dr.Zhark about that one.