GUI Creator


Anyone who has been active on the main forums in the last few days must surely have already heard the news.

I'm not going to comment on why and how, but the short version is that Bukkit is almost certainly not getting passed this.

Consequently, the future of BukkitDev is very uncertain. Even if the legal matters were resolved tomorrow there isn't really anybody left to deal with file submissions anyway. There's no indication about how long the site will stay up and what will happen to the files.

Anyway, while I will continue updating and developing my plugins you will need to look for updates somewhere else, namely the wiki. I will be updating this wiki in the next few days to facilitate better communication (forums, email, etc.) and adding any documentation that's missing.

I will also, of course, be looking into porting the plugins over to whichever API emerges from the ashes!

GUI Creator

This is the successor to Admin GUI, featuring a simpler config but offering more powerful customisation!

How it works

Each screen is divided into ten rows, each having four columns (by default). Controls can be placed into any of these cells, and can span multiple rows and columns. It's also possible to set the exact x, y, width, and height values if needed. See the tutorial for more information.

Video overview


Available controls

  • buttons
  • text boxes
  • checkboxes
  • radio buttons
  • textures (for images)
  • sliders
  • gradients
  • labels
  • spacers
  • link buttons


  • SpoutPlugin
  • Spoutcraft

Both of these can be downloaded here


set this to the id of a screen to have that screen automatically open when the GUI does
set this to no to stop the plugin creating skins when players join the server

The rest of the config is used to change the default colours of things. Each value must be a string in the format r,g,b or r,g,b,a. Note that you can override these colours on any particular control.


/reload_gui_creator or /rgc
this will refresh the layout files if they have been changed since the plugin was started. The new screens will be visible the next time the GUI is opened
/open_screen or /os
this is an alternative to pressing the C key
use on its own to open the GUI like normal
use with a screen id to open the GUI directly to that screen


  • gui_creator.can_open_gui - controls whether the user can access the GUI. Default is false.
  • gui_creator.can_reload_screens - controls whether the user can reload the screen files. Default is false.

Mac users

I've been informed that Macs have a very unfriendly behaviour of treating remote folders like local folders and creating hidden files on them. This has been causing the problems that I've seen come up a few times where the plugin is trying to read this hidden file.

I've fixed this from 1.6.7 but it you don't want to update, or you're seeing problems with other plugins, there are a couple of things you can do. One is to delete the file .DS_Store from any remote folders that are giving you trouble. Second is to follow the instructions here and stop the behaviour altogether.


  • there are a couple of controls that are hard-coded in Spout so resizing them won't work as intended (mainly check_box and radio_button)
  • this plugin is intended to be run full-screen, with GUI scale set to auto (see the previous point)

Like this and want to show appreciation? Send any unwanted TF2 items my way! id: coldandtired

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of coldandtired coldandtired Sep 07, 2014 at 11:12 UTC - 0 likes

    Updated the description. Please read.

    alt text

  • Avatar of MRVDOG MRVDOG Apr 16, 2014 at 23:15 UTC - 0 likes

    @coldandtired: Go ohhh awesome :), I should have tried it first hehe

    Last edited Apr 16, 2014 by MRVDOG
  • Avatar of coldandtired coldandtired Apr 09, 2014 at 06:42 UTC - 1 like

    @MRVDOG: Go It already works exactly like that (assuming 2 is the id of a screen) :)

  • Avatar of MRVDOG MRVDOG Apr 09, 2014 at 00:29 UTC - 0 likes

    could you possibly make it so you can use the command "/os 2", to open screen 2, bypassing the default, I am using Citizens2 & Denizen with this and it would be awesome to have GUI's for accepting quests etc..., i.e. could create a GUI confirmation prompt, and have a Denizen script call the "/os 2" command which would open the prompt, then have buttons in that that would say "/yes" or "/no"

  • Avatar of coldandtired coldandtired Mar 20, 2014 at 20:24 UTC - 0 likes

    @ReevoXF: Go Doesn't it work any more? As far as I know Spoutplugin hasn't changed the protocol for a while so everything should still work as it used to.

  • Avatar of ReevoXF ReevoXF Mar 20, 2014 at 18:41 UTC - 0 likes

    Please update! ;o3

  • Avatar of yurikoma yurikoma Oct 31, 2013 at 00:26 UTC - 0 likes

    @xH3LLRAIZ3Rx: Go

    spoutcraft client is now part of the technic client. also the spoutcraft plugin did a pretty good job allowing plugins like this do things that were previously impossible without modding

    @Eliijah: Go

    By the time that happens spoutserver will probably have been completed, and server owners will be able to add anything they want.

    custom gui, blocks, food, monsters, music (all without needing to mod, if your server has it your players can see/use/kill it) will really allow servers to be more unique.

    Last edited Nov 01, 2013 by yurikoma


  • Avatar of coldandtired coldandtired Oct 25, 2013 at 01:55 UTC - 0 likes

    @Eliijah: Go I'm not sure anyone's holding their breath for the Official API :)

    On top of that, almost all of the controls (drop down boxes, etc.) available are not found in Minecraft and were added by the Spout team.

  • Avatar of Eliijah Eliijah Oct 25, 2013 at 00:26 UTC - 0 likes

    The day that open Minecraft gui becomes available and we don't have to use spout or any another client is the day Minecraft takes a HUGE leap forward to a hole new ball game. ( please be soon! )

  • Avatar of xH3LLRAIZ3Rx xH3LLRAIZ3Rx Oct 24, 2013 at 23:19 UTC - 1 like

    the spout plugin, no offense is the worst API I have ever seen, but the spout client is ok


Date created
Dec 31, 2011
Last update
Oct 24, 2013
Development stage
  • enUS
All Rights Reserved
Curse link
GUI Creator
Recent files
  • R: 1.6.2 b1 for CB 1.6.2-R1.0 Oct 24, 2013
  • R: 1.5.2 b1 for CB 1.5.2-R0.1 Jun 03, 2013
  • R: 1.4.7 b3 for CB 1.4.7-R1.0 Feb 24, 2013
  • R: 1.4.7 b2 for CB 1.4.7-R1.0 Feb 19, 2013