CreateYourOwnMenus

portals.png

As the name suggests, this plugin allows you to create your own menus. The menus are based on inventories, with each slot holding a clickable menu item. When a player clicks on a menu item, it performs all of the commands listed in the item's lore (the text underneath its name) in a similar manner to command blocks. You can design the menu in-game by selecting any item, naming it in an anvil, modifying its lore using a command, and using commands to create and open a menu for editing to place it anywhere in the inventory that you wish. You can modify your menus any time you want.

Thanks to TheMobCave for providing the video tutorial. Please like and subscribe!

The video tutorial was of CreateYourOwnMenus v0.2, so the latest version has even more features! One major change is that the /menu script command now has sub-commands. E.g. /menu script add [text] instead of /menu script [text]. As well as: insert, delete, replace, clear, show and hide.

See the Tutorial for detailed instructions.


Screenshots


See the gallery for screenshots.


User Reviews


"This looks amazing and would make my role playing server a lot easier for players so they don't have to remember a lot of commands." - Ccamm

"This looks amazing! I'm sure that we'll be able to use this in my new server project." - parrothead1337

"Awesome plugin." - Bobbinkin

"This plugin allow so much things :o" - TheNemesisA5


Features


  • Use commands to manage all of your menus
  • Use any in-game item as a menu item
  • Edit menus in-game using inventories
  • Open menus using commands, command blocks or other menus
  • Activate any menu item simply by clicking it in an open menu
  • Alternatively, activate menu items by holding in hand and right-clicking (can be used to open menus and more)
  • Modify the lore of any item using commands /menu script clear and /menu script [comment/command] commands
  • Add, remove, modify and share menus using their .yml files in the "plugins/CreateYourOwnMenus/menus" folder
  • Optionally run the command as the player instead of console by using the /sudo command E.g. /sudo @p kill
  • Show/hide menu script commands using the /menu script show and /menu script hide commands
  • Delay execute of commands in a script using the /delay [ticks] menu script command
  • Use {curly braces} to add dynamic arguments to commands (prompts the clicking player)
  • If you have Vault installed you can use /requirecurrency to check if a player has a given amount of currency

What it does not do


  • This is not intended to include a full-fledged scripting language. It simply executes commands in series and is interrupted on failure. For more complex actions, conditions and program flow you should be using a plugin like Skript to run scripts on menu item clicks.
  • It cannot run commands as a player with "elevated permissions". There is currently no safe way to do this within the Bukkit API without introducing errors, compatibility issues and/or require updates every build of Minecraft, CraftBukkit or even Bukkit. You can work around this by granting the permissions, performing the actions and then revoking them again, or by calling out to another plugin that supports this. I do not intend to add this feature until there is a safe way to achieve it.

Plugin Suggestions


This is a list of plugins that work well with CreateYourOwnMenus.

  • Use the MicroJump plugin for BungeeCord /server command support for BungeeCord users
  • Use the Skript plugin to open menus on player joining, or various other events, and create advanced scripts that you can run when clicking a menu item
  • Use the Vault plugin to provide currency support using the /requirecurrency menu script command

Commands and Permissions


A full list of commands and permissions is available on the Commands and Permissions page.

Detailed command help is available in-game by typing /menu


Sharing


Find and share pre-created menus on our forums!


Scripting


A basic scripting guide is available on the Basic Command Scripting thread.

Other tutorials and guides are available on the forum


Security Considerations


The menu scripts always run as console. By default, this is not a problem as only operators have the ability to create menu items and modify menus, however if you give other players permissions to do this, be aware that it will also give them the ability to effectively run any command they wish as console.


Development


Sources are available on GitHub: https://github.com/XHawk87/CreateYourOwnMenus

Ideas

  • Add internationalisation support
  • Add a "cyom.menu.edit.[menu id]" permission to allow editing of a specific menu only
  • Add "cyom.script.allow.all" permission to allow adding any command to a menu script, except those specifically denied (Default op)
  • Add "cyom.script.allow.[command name]" permission to allow adding specific commands to menu scripts (child of cyom.script.allow.all)
  • Add /menu script import [file] and /menu script export [file] for quickly importing or exporting the lore of a menu item to a simple text file
  • Add "cyom.slot.lock.#" to lock specific inventory slots in a player's inventory and treat it as a menu
  • Modify /menu grab command to place items into the same slots in a player's inventory where applicable, displacing other items, and otherwise finding any free slot
  • Trigger a menu item when it is used to attack or break blocks with
  • Add /use special command to allow the item to be used as a normal item (this cannot be used after a delay or prompt)
  • Organise menus into folders, and accessed in the form "folder.menu"
  • Store menu items in a format that is easier to edit manually, marking lines as hidden without the section symbols all over it
  • Provide a faux creative mode for non-op creative players so that server owners can grant creative abilities to non-op players without introducing security risks
  • Command support for tab-autocompletion

Bugs

  • Items in locked slots are still dropped on death instead of remaining in their slots
  • Items with the /consume command will only be removed if the stack size is 1

Deprecated Features

  • To reduce the number of special menu item commands, the /GiveChest, /TakeChest and /CountChest commands will be removed and less complex and easier to understand Skript alternatives will be provided in their place

Donations


If you like my work, please consider donating using the Donate button in the top-right corner of the screen. As a freelance professional, I rely on donations and payments to support my work. Anything you can contribute to support my work will allow me to spend more time making plugins for Bukkit and supporting the plugins I publish. Thank you.

Everything I create here will be 100% free to download and use as you please, just keep the license attached and give me credit for the original work if you decide to redistribute.

Donate


Help


This plugin uses Java 7

If you get the followed error on starting up the server with this plugin installed "Unsupported major.minor version 51.0". This means you are using an out of date version of Java. If you don't know how to upgrade, please contact your server hosting provider and ask them for help in upgrading to Java 7, or contact Oracle customer support. Mac OS X users require JDK 7 instead of JRE 7.

Very wide text boxes on menu items

Due to a Minecraft client formatting error, the invisible characters on the first line can cause the lore text box width to be increased despite taking up no space when there is visible text on the same line. This can be mitigated when hidden by keeping the first line empty using /menu script insert 0 &a. When commands are shown, it may become difficult to read them.

Non-op Creative Players spawning menu items without permission

Warning: A new security loop-hole has been discovered in the Minecraft server. It is possible for players with certain modified clients to create items for themselves that contain any lore that they want so long as they are in Creative Mode. This does not require operator status or permissions, only Creative Mode. If you have Non-operator creative players on your server be advised that if they use a modified client, it is possible for them to create any menu item that they want without needing permissions.

You can alleviate this somewhat by adding commands to the "blacklist-commands:" section in the config.yml. This will stop anyone but operators from using menu items with those commands on them. E.g.

blacklist-commands:
  - op
  - stop
  - kick
  - grantperms etc etc

Another option is to keep those players in Survival mode, but use other plugins to give them creative-like powers such as infinite resources, fast breaking and flight.

Ghost items appearing on clicking a menu item

If you are experiencing ghost items in 1.7.2 using this plugin, it is due to the client-side Minecraft bug (https://mojang.atlassian.net/browse/MC-41165). This only affects 1.7.2 and is fixed in 1.7.4. The bug is not dangerous as it is not a real item. Any attempts to move the item out of the inventory, place it, or fill the same slot will result in it disappearing. Since this is a client-side only bug, it is recommended that players be urged to update from 1.7.2 to 1.7.4 as soon as possible. Note: it is possible to play on CB 1.7.2 R0.1 beta using a Minecraft 1.7.4 client.

After restart, my menus all have weird characters wherever there were hidden commands or colours

This is a text-encoding issue caused by the some CraftBukkit servers attempting to read menu files in the wrong text encoding by default. You can fix this by telling Java to use UTF-8 by default for CraftBukkit.

For users of McMyAdmin, MultiCraft and other server launchers, there should be an option to specify text-encoding in your settings and switch to UTF-8. If not, you should have a way to add optional command line arguments, and follow the advice below for a startup script.

If you are using a startup script you will have something along the lines of:

java -Xmx1024m -jar CraftBukkit.jar

You need to add the following option somewhere after java and before -jar. E.g.

java -Xmx1024m -Dfile.encoding=UTF8 -jar CraftBukkit.jar

After updating CraftBukkit (build #3009+), my Skript custom commands aren't working from menu items

Changes in CraftBukkit build #3009 (1.7.2-R0.3-SNAPSHOT) have updated the Bukkit plugin command system that broke Skripts custom command handler. This prevented Skript from receiving commands that had been directly dispatched by other plugins. This issue was fixed in Skript 2.1.1+, so downloading the latest version of Skript should correct the problem.

It says @a or @w instead of the player's name

If a @a or @w target selector is the last character in a command, it is not currently replaced correctly. This will be fixed in the next dev build. In the meantime, attempt to ensure there is a non-whitespace character after the last target selector.

Every time I click an item in my inventory it activates it like it was a menu item

You may have inadvertently locked all of your inventory slots by misuse of the '*' permission node. This will grant you all permissions, including 'cyom.slot.lock.*' which is used for locking inventory slots so that they can be used as menus. The best solution for this is to stop using the '*' node and instead only grant yourself the specific extra permissions that you need. However if you insist on using the '*' node you will need to grant yourself the negative permission '-cyom.slot.lock.*' in order to prevent your slots from getting locked.

Every time I restart my server, all changes I made to my menus are undone

There is a time-related bug with previous builds of CYOM that prevent file saving. To fix this you must update to the latest dev build: http://dev.bukkit.org/bukkit-plugins/createyourownmenus/files/18-create-your-own-menus-v0-5-8-dev/

Support Channel

If you need help you can leave a comment below and I will get back to you as soon as I can. You can also join my IRC chatroom using the following link, but please read the tutorial first. http://webchat.esper.net/?channels=XHawk87&prompt=1

I am happy to give support, but repeatedly answering the same question that is explained in bold red on the plugin page is highly tedious. Don't be lazy, read first, then ask questions. It's the polite thing to do

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

  • Avatar of XHawk87 XHawk87 Nov 02, 2014 at 14:45 UTC - 0 likes

    @ThomasDrolo: Go

    Commands are run as the console. You must specify which player to warp.

    You will need to find out the syntax of the /warp command in that plugin's documentation, and see where the player's name needs to be inserted. You can then use @p in place of the player's name in the menu item E.g. /mycommand @p other_parameter. This will be automatically replaced with the clicking player's name when it is run. I.e. /mycommand ThomasDrolo other_parameter.

    If the command is not supported by the console then you can use /sudo [player] [command]. This will run the command as if the player typed it, including checking if they have permission for the command.

    I am currently working on: Security

  • Avatar of ThomasDrolo ThomasDrolo Nov 02, 2014 at 08:08 UTC - 0 likes

    I suppose, however, the command / warp sg then when I click on the menu is just the list of warps

  • Avatar of XHawk87 XHawk87 Oct 25, 2014 at 16:05 UTC - 0 likes

    @SaintGearz: Go

    Unfortunately Bungee commands aren't available for plugins to use without special support. Try the MicroJump plugin, it attempts to make the /server command available for use in command blocks and command scripting plugins.

  • Avatar of SaintGearz SaintGearz Oct 25, 2014 at 15:45 UTC - 0 likes

    I'm trying to add this command '/menu script add /server opprison' it's saying "Error in menu script line (unknown command): /server opprison

    SaintGearz = Love/Lyfe

  • Avatar of boss4atp boss4atp Oct 14, 2014 at 20:53 UTC - 0 likes

    @XHawk87: Go

    Ok thank you very much

  • Avatar of XHawk87 XHawk87 Oct 14, 2014 at 12:08 UTC - 0 likes

    @boss4atp: Go

    As you can place multiple commands on an item you can:

    • /op @p
    • /the_command_you_want_to_run_as_op
    • /deop @p

    If you have a permissions managing plugin installed, you can grant only that specific permission:

    • /grant_permission_command @p the.permission.for.this.command
    • /the_command_you_want_to_run_with_perms
    • /revoke_permission_command @p the.permission.for.this.command

    The best permissions plugins will even let you run the command silently, with no console spam. Check your plugin documentation to see if they have this feature. If not, try GroupPermsLite. Any command with -s at the end will be handled silently unless there is an error.

    Last edited Oct 14, 2014 by XHawk87
  • Avatar of boss4atp boss4atp Oct 14, 2014 at 00:07 UTC - 0 likes

    Is it possible that you can make the command as a op not from console. Thx

  • Avatar of Jaiden_09 Jaiden_09 Sep 20, 2014 at 18:10 UTC - 0 likes

    @XHawk87: Go

    Wow,thanks!obviously I did not know what "Append" meant ^_^ '

    I was so frustrated repeating exactly 3:05 on the video reference.

    I'm so glad you made a quick response,thank you again.

  • Avatar of XHawk87 XHawk87 Sep 20, 2014 at 17:54 UTC - 0 likes

    @Jaiden_09: Go

    You should do what it is telling you. "/menu script append /say hello world"

  • Avatar of Jaiden_09 Jaiden_09 Sep 20, 2014 at 17:23 UTC - 0 likes

    Hello,

    I've just recently changed by Bukkit(1.7.2) server to Spigot(1.7.10(supports 1.7.x and 1.8.x)) and using BungeeCord.i'm using this plugin in my lobby world.I found out that I cannot make commands for my items (R: CreateYourOwnMenus v0.5.9 (dev))

    (ex./menu script /say hello world!)After,It tells me /menu script ([player]) [clear|show|hide|append|insert|replace|delete] [parameters...]

    /menu

    the plugin no longer shows how to apply a command to the held object

    http://gyazo.com/4f8c160374d74d7ebc64925c1b923f93 (Temporary link)

    If you have a solution or planning on working on this possible bug,please reply.I love your plugin

Facts

Date created
Jun 17, 2013
Category
Last update
Aug 11, 2014
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
CreateYourOwnMenus
Downloads
19,109
Recent files

Authors