[INACTIVE][MECH/ECON] Showcase v0.8.1 - Create visual shops by spawning drops on slabs [1.1-R5]

Version 0.8.1

As supposed in this thread, I created a plugin that lets you put items into glass blocks (now steps, it's notchs fault) to showcase them. This is useable for shops, to show what's for sale there, or to make clear what type of farm you built.
Features

• Showcase all items in a half-step Block
• Block protection (you can't break the step block and the block below it to prevent that the item falls down)
• Multiworld
• Items in a showcase can't be picked up
• Only the player who created a showcase can remove it
• Prevents despawning of items (Normally, drops disappear after 5 minutes)
• You can setup finite and infinite shops
• DropChest support (disables DropChest for absorbing the showcased items)
• WorldGuard support (works out of the box)
• Localisation
• Can show custom item names through BukkitContrib
• Economy support:
  • iConomy 4 & 5
  • BOSEconomy
  • Essentials Economy

Download & Source-Code
Download Showcase.jar
Browse Source-Code on Github
You will need an economy system if you want shops.
This will install NarrowtuxLib automatically!
Please donate, if you really like this
Videos

When you have got issues, please read this:

1. Please, first check if you have got the most recent version of Showcase and the most recent recommended build of Bukkit.
2. Then, check if the bug is already listed in the "Known Bugs" section.
3. After doing step 1+2, report the bug with at least this information:
   • Version of Showcase
   • Version of Bukkit
   • If possible, a step-by-step explanation of the bug
   • If possible, console errors
   • When you think that this has got to do with another plugin, please list all your plugins like this:
     • PluginA, PluginB, PluginC ...

This will be incredible helpful for me to fix it faster.


You don't actually have to retype everything I typed here, but if you'd take it as a guideline which content you should include in your issue report, it's more helpful

Please, don't come here just to say "This doesn't work.". This says nothing.

Usage
Adding a showcase

1. Start sneaking!
2. Right-click a half-step block with the item in your hand you want to showcase
3. An assistant will ask you which type of Showcase you want to add. Type the text before the colon )
4. Depending on the type you chose, the assistant will ask some extra questions, follow the assistant to finish showcase creation.

Removing a showcase

1. Sneak
2. Right-click on a showcase. If this was a finite showcase or an exchange showcase, you will get your items back.

Permissions

Action	Permission-Node	Without Permissions
Create a basic Showcase.	showcase.basic	Player
Create a infinite shop Showcase.	showcase.infinite	Operator
Create a finite shop Showcase.	showcase.finite	Player
Create an exchange Showcase.	showcase.exchange	Player
Buy from a finite shop showcase.	showcase.buy.finite	Player
Buy from an infinite shop showcase.	showcase.buy.infinite	Player
Removing a showcase of other players.	showcase.admin	Operator

The column "Without Permissions" explains which user-type can use this permission when no Permissions system is installed.
What are shop showcases?
A shop showcase can be used to sell items to your players. There are 2 types of shops now:

1. Infinite shop. This one has an infinite amount of items. The money that the players give to buy an item will go to nirvana
2. Finite shop. This one has that number of items which the owner has set up. The owner will get the money from which the items were bought.

How can a Player buy items from a shop showcase?

1. Click on the Showcase. The price per item and the available amount will be displayed.
2. Type in the number of items you want and hit enter. A message will show you the success of the checkout.
   • Type 0 to abort checkout

How can you refill a finite shop showcase?

1. Click on it
2. Type in the amount of items to refill. Negative values will remove that amount from the showcase.
3. Walk away or type 0.

Commands

The showcase command handles manual saving and loading
/showcase save
Saves the items to showcases.csv
/showcase load
Loads the configuration, translation and items without saving (Use with caution)
/showcase reload
Saves and loads everything after that. Useful when some items aren't in place and you want to quick-fix that.

Configuration
The configuration file is auto-generated and is called showcase.cfg
Here are the configuration possibilities:

• basicmode : this decides if the plugin should operate like in version 0.2 or before (Just the basics)
• priceforbasic : this adds a price to the basic showcases
• priceforfinite : this adds a price to the finite showcases
• priceforexchange: this adds a price to the exchange showcases
• removewhenempty: when set to true, a finite showcase will be removed when it's amount hits 0
• showcaseprotection : turn this to false to be able to remove showcases from other players (griefers) (you should now use WorldGuard instead of this one )
• locale: standard is en-US. The german translation which is included in the jar-file is de-DE. If you type that in, it will copy the german file from the jar to your plugins folder
  • You can change the translation very easily by editing the existing locale.
  • Colors are supported, just add something like [GREEN] or [DARK_RED] to the text.
  • You can add newlines with \n
• autosaveinterval: the time between two auto-saves in seconds. Standard is 60 secs. Use -1 to disable autosave.

Translations

Currently available translations:

• English by @narrowtux - 0.6.7
• German by @narrowtux - 0.6.7
• Czech by @Jan Tojnar - 0.6.7 is included in jar in the next release

Changelog

Version 0.8.1

• Updated for CraftBukkit 1.1-R5
• Added plugin metrics http://metrics.griefcraft.com/plugin/Showcase

See the whole changelog

Todo

• Spawn multiple items in the same glass block (up to 4, would be aligned nicely)
• Verify that there is no free space below the glass block before adding a showcase
• Maybe let the showcase glow when you placed torches, glowstone or lava in it
• Custom messages (aka localisation)
• Sell-Showcases
• DropChest support (so the items inside the glass won't be absorbed by a Dropchest)
• Limit the amount of Showcases per player
• Add a price that the creator of a showcase has to pay (there would be an independent price for each basic, infinite and finite showcases)
• Linking infinite shops to banks (money spent for items goes there)
• Rent a showcase for money/day
• Autosave with configureable interval
• Commands for save, load and reload

Crossed items are already done!

Known bugs

• This plugin conflicts with some chat-altering plugins (i.e. bColoredChat) this is because the authors don't know how to correctly set up the priority of events.
• Normal players (the ones that aren't operators) can't use showcases that are in the spawn-protection area. Either disable the spawn protection or place the showcases to an other location (Disable spawnprotection by setting "spawn-protection-size=0" in the server.properties file)
• With the latest dev preview (not the recommended build), you're able to make slabs to double steps. I've got to investigate until they propose it as RB.
• ATM, Showcases won't save enchantments. So please just don't try to sell yours because that wouldn't work either.