ScrollingMenuSign
Videos
Latest video:
- See the Videos page for full list of demonstration & tutorial videos.
Latest Version
Features
- Create scrollable command menus with one or more sign, map, multisign, inventory, hologram or spout views. Or trigger your menus with redstone signals or even from any held item.
- Scroll through views with right-click, execute the selected command with left-click (configurable)
- Sophisticated command parser/executor - permission elevation, command costs (items/durability/economy/food/health/xp), player/group/world restrictions, variable substitutions...
- Commands can have warm-ups and cooldowns
- Macros - run multiple commands or display large text blocks with one click
- Build a hierarchy of menus using Submenus
- Flexible Access Control gives you private menus and views, or limited to permission groups.
- External scripting language support allowing unlimited flexibility in what menu commands can do
- Sign & multisign views can produce Redstone Output when scrolled or executed
- Redstone Control Signs allow remote scrolling & execution via redstone signals for sign & multisign views
- Permissions support via Bukkit superperms
- Command Logging lets you keep an audit trail of who's executed what commands from SMS menus
- Multi-world support: menus can have views in any number of worlds
- Full coloured/bold/italic/underline/strikethrough text support on menu titles, items and messages
- Configure menus or menu items to have a limited number of uses, either per-player or globally
- Comprehensive tab completion for all commands
- Optional Spout support
Possible Applications
- A menu of station setting commands for Minecart Mania (this is what inspired me to write the plugin in the first place!)
- Newbie user guide menus
- Warp menus for your favourite teleportation plugin
- A basic shop menu - buy/sell/swap items & credits
- Controlled access to commands that users can't normally run
- Item reward menus with limited usage count
- Traps built from redstone views and/or scripts
- Super-convenient game mode (survival/creative) changer with map and/or spout views
Installation
Pretty simple:
- Copy ScrollingMenuSign.jar into your server's
bukkit/plugins
folder - Optional: install Vault for economy command costs and/or permission group support.
- Optional: install ProtocolLib to make active items glow.
- Restart or reload your server.
That's it. ScrollingMenuSign will automatically create a folder called bukkit/plugins/ScrollingMenuSign
when it first runs. All data related to the plugin is stored in here.
Documentation
- Quickstart Guide
- FAQ
- Command Reference
- Permissions support
- The Configuration File
- The Command Parser
- Submenus
- Warmups and Cooldowns
- Popup Messages
- View Types
- Redstone Output
- Macros
- Menu Item Tooltips
- User Variables
- Command Logging
- Setting usage limits on menus & menu items
- Redstone Control Signs
- Spout Support
- Using External Scripting Languages
- API: Managing ScrollingMenuSign menus from scripts or other plugins
Source
Development Versions
Development versions can be downloaded from this Jenkins build server. Notes:
- Development versions have not been approved by dev.bukkit.org staff
- Development versions may be buggy or fail to work completely. Only use development versions if you a) want to help with finding bugs, or b) have been asked to, to test a bugfix.
Changelog
Usage Statistics
Since SMS v1.3.0, fully anonymous usage statistics are collected using MCStats:
If you wish to opt out of MCStats metrics collection, edit plugins/PluginMetrics/config.yml
and change opt-out: false to true.
Donations
If you use and enjoy ScrollingMenuSign, you are welcome to make a donation by clicking the "Donate" button at the top right. However, donations are strictly optional, and don't confer any special benefits over non-donors.
hi desht thanks for keeping up the good work. I'm using some spout views and since your last update the title on top of the views is getting cut like the following image shows:
Do you know how to fix little issue?
Also, I'd like to mention that spout views are not working when in Fullscreen mode, the menus just do not show up, with no errors in console... however they work fine when you exit fullscreen mode. hope you can give me a hint on this little problems. your plugin is awesome anyways. will have to donate you some day :) thanks and sorry for my english
v1.3.0 has been released! See http://dev.bukkit.org/server-mods/scrollingmenusign/files/32-scrolling-menu-sign-v1-3-0/
@desht If you need any help testing let me know. Thanks!!
@DevonCWoodcomb
Very soon, I promise :) Coding for 1.3.0 is complete now, I'm just doing some testing & documenting. Plan to have it out on Monday, hopefully.
@desht
Hey, any idea when the next version will come out (with the fix for boseconomy). I am still setting up everything on my server, so I would love to wait for that before making signs with the workaround I came up with. Anyways, thanks for the plugin =D
@DevonCWoodcomb
Right now, no check is done, but I'm thinking for the next release I can drop any excess items at the player's feet and send him a message that his inventory is full. I suppose the only concern with that is griefing by flooding the area with floating item entities, but I'd hope any cost associated with the command would deter casual griefing... (and of course if other players are around they can always pick stuff up :) )
@desht
Awesome! That's great to hear.
Another question (yea, I'm full of them!).
Is there a way to make it check to make sure the user has room for the items in their inventory.
like if I do $1,-30 and their inventory is full, it will fail. If not that's no big deal. It'd just be nice to prevent it for stupid people.
@DevonCWoodcomb
Sorry the delay - problem confirmed. Partly due to the way Vault handles the BOSEconomy API, and partly my fault for not testing enough :) (The Vault withdrawPlayer() calls works fine with iConomy if you give a negative amount, but fails if you do that with BOSEconomy)
I'll get a fix for that into the next release, which should be fairly soon.
@DevonCWoodcomb
Hmm, should work. I'll do some tests.
Further testing reveals that I can't use a negative number with $e,
It passes the requirement of completing the transaction without paying any money. I was able to work around this using /#econ add <NAME> <amount>.
I don't know if that is a problem with this, Vault, or Boseconomy.
Well, it's official, I love you.
@DevonCWoodcomb
Well, if you wanted to sell, say, 10 cobblestone for 1 economy credit:
The CommandParser page has some more examples.
I am trying to make a shop with this plugin and so far it works great for buying, set up the macro once and just change the parameters for new entries, it's amazing. But I can't figure out how to let people sell things to the shop with it. I am willing to use an additional plugin if needed as well. Currently, I use Vault, PEX, and BOSEconomy that should impact the usage. Anyways, if anyone has any Ideas on how I can make the sign take an X amount of an item away, confirm that it worked and then pay the player that would be amazing. Thanks!
@RibShark
Yeah I'm actually planning to make the block id to erase maps that a configurable in the next release - default will be 0, meaning disabled.
Umm... is there any way of making it so hitting a glass block with a map not remove the map view. If not, consider adding one?
Put up a short demo of redstone output from signs: http://www.youtube.com/watch?v=p8lXUlC9R60
Awesome! I saw the new redstone output feature. I am going to test it soon! Ty desht :D
@1born2kill
Well... I can't really override LWC easily. But SMS does provide its own block protection, so removing the LWC protection should be a viable option.
If you set 'no_destroy_signs' to true (
/sms set no_destroy_signs true
) then all views will be unbreakable until you've removed them with the/sms break
command (for which you need the scrollingmenusign.commands.break permission - only give this to your admins :) )'no_destroy_signs' is actually true by default as of v1.2, and it also applies to blocks that are View Types / Redstone Views, despite the name of the setting.
Hi desht, I have a problem regarding your plugin and LWC. With LWC on, Locked Signs cannot be used by other users.
Is there a way to make it work? without removing the protection on the sign, or making it public?
Thanks!
Saaawwwweeeeetttttt Plugin now that it is working. Thanks desht, your plugin is freakin awesome once you get the commands figured out. Thanks for your quick responses and sorry for taking so long to get back to you about fixing it.