Bukkit

RealStore

Overview

RealStore allows users to create stores in which to sell goods. Goods are purchased with item-backed currency such as gold nuggets, gold ingots, gold blocks, diamonds, and diamond blocks. Stores are created from chests and each item may have an individual price. This includes sub-items such as colored wool. The store may also have a default price for any item which does not have a specific price. Any purchases from the store are deposited in coffers that the store owner has defined.

Features

• Allow players to setup stores and set prices
• Anti-grief included on stores and coffers
• Customization of prices on items in stores

Commands

All RealStore interactions start with /RealStore or /rs

• /rs coffer add - The next chest a player hits will become a coffer
• /rs coffer remove - The next chest a player hits will be removed from their coffers
• /rs store add - The next chest a player hits will become a store
• /rs store remove - The next chest a player hits will be removed from their stores
• /rs price $$ (where $$ is a number representing the price of an item in gold nuggets) - The next store a player hits with an item will have the price set to $$ for that item in the store
• /rs price $$ default (where $$ is a number representing the default price for items in gold nuggets) - The next store a player hits will have the default price set to $$ for any item whose price has not been set.

Permissions

• RealStore.* - Allows players access to RealStore transactions. There are no sub-permissions as all features require one another.

Currency

In-game currency may be interchanged in any way. The important thing to remember is Diamonds will only be used as change if a player has diamonds in their inventory.

• Gold Nugget - The base currency for all items
• Gold Ingot - Equal in value to 9 Gold Nuggets
• Gold Block - Equal in value to 9 Gold Ingots or 81 Gold Nuggets
• Diamond - Equal in value to 1 Gold Block, or 9 Gold Ingots, or 81 Gold Nuggets
• Diamond Block - Equal in value to 9 Diamonds, or 9 Gold Blocks, or 81 Gold Ingots, or 729 Gold Nuggets

Configuration

None currently

Use

Setting Up a Store

1. Setup a coffer on a chest using /rs coffer add, which is where the currency will be deposited from store purchases
2. Setup a store on a chest using /rs store add, which is where players will purchase items from you
3. Set prices on your store using /rs price $$ (where $$ is the value in nuggets) then hit the store with an item to set the price of that item
4. Set the default price on your store using /rs price $$ default (where $$ is the value in nuggets) then hit the store to set the default price. (The price of any item that did not have it's price specifically set with /rs price). Without setting a default price, any item that did not have a specific price set will be 1 nugget.
5. Place any items you want to sell in your store

Purchasing From a Store

1. Open the store by opening the chest
2. Click on an item in the store to check the price
3. Take a single currency item from your inventory and click on the item you wish to purchase
4. The currency will be deducted from your inventory and deposited in the store owner's coffer
5. The purchased item will be deposited in your inventory

Special Notes

• The currency item on the cursor during a purchase will not count toward what you can spend, therefore it is recommended, that a stack of one (1) gold nugget be used to purchase an item
• Any currency in your inventory will be 'colored up'. For example, if you have a stack of 64 gold ingots, they will be turned into a value equivalent in gold blocks
• If, during a purchase, you have a diamond in your inventory it will 'color up' using diamonds. (This may soon change)
• Diamonds will not be deposited in coffers, only an equivalent amount of gold
• If all of a store owner's coffer's are full, it will send the items directly to the owning player if they are online. If they are not online, no deposit will take place and the money will be lost!
• A player may setup as many coffers as they wish, currency will be deposited in the first coffer and when it is full, it will try the next, and so on.
• Coffers and Stores may not be broken by normal means by any player.
• A player may not open another player's coffer, though there is a special way to rob a store or coffer! :)
• Tools and Weapons in stores are unique based on type and damage values. Therefore a used diamond sword is considered different than a new diamond sword.
• Enchantments are not considered when setting item prices. Therefore a diamond pickaxe with SilkTouch I would be considered the same as a diamond pickaxe of unbreaking I. To set different prices of these items, use the damage modifier mentioned above.

Bugs

Because of the vast nature of this plugin, please use the GitHub Issue tracking system to submit bugs, issues, and feature requests. GitHub Issue Tracking