RealStore
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
- Setup a coffer on a chest using /rs coffer add, which is where the currency will be deposited from store purchases
- Setup a store on a chest using /rs store add, which is where players will purchase items from you
- 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
- 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.
- Place any items you want to sell in your store
Purchasing From a Store
- Open the store by opening the chest
- Click on an item in the store to check the price
- Take a single currency item from your inventory and click on the item you wish to purchase
- The currency will be deducted from your inventory and deposited in the store owner's coffer
- 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
is it possible that you update it to 1.2.5 R4.0
pritty pleas!!! :D
All,
I apologize but all of my Bukkit development has been put on hold. The requirements of real life have demanded my attention. I do intend on eventually picking this back up, but until then, I am sorry.
Would u be able to make it so it will generate a coffers.yml and stores.yml file when the server starts? i can't get mine back
@ArchmageInc
Yeah the craftbukkit1.2.5 R1 build. Thats the one im supposed to use, right?
@ShadowKilla1111
What version of CraftBukkit are you using? I will look into this as soon as possible, but it may be a few days.
@ShadowKilla1111
heres the log...
18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The coffer file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified! 18:49:59 [WARNING] [RealStore] [RealStore 0.1.3]: The store file has been improperly modified!
@ShadowKilla1111
Ok update, whenever the server is restarted all of the coffers and stores are deleted.
Ok, has anyone had the problem of your stores randomly deleting? I just went back onto my server and had to reset everything
@catbox01
The idea of selling more than one item at a time is being addressed in the next release. It is being setup as you described. (There were a lot of people requesting this)
As for the bugs, please record them on github. I have had no reports of it kicking the item back into their inventory. Please indicate what version of CraftBukkit you are running, along with what other plugins are installed. I will try to address these issues.
After setting it up on our server, it's become kind of obvious that it's a bit glitchy. You cannot add stock to your merchandise chest without it kicking it back into your inventory. The plugin sometimes refuses to recognize coffers or stores, especially after there has been a player crash, or after kicking items back into your inventory. I have had to re-set several stores for unknown causes. I like this idea, but as a server maintainer, I also need reliable. I'll keep an eye on this to see how it develops.
Okay, I have some suggestions:
1) The plugin limits the purchases to a single item. It takes forever to buy a stack of cobblestone. Is there a way to allow stacked items to be purchased? 2) When you punch the chest with a multiple item in your hand, it should set the price you assigned to that multiple of objects. So if you set the price at 9 nuggets and punch the chest with 12 arrows, it would assign the value of 9 nuggets per dozen arrows. If you punched the chest with a single arrow, it should assign a 9 nugget value to a single arrow.
@Rustynunu
I haven't really considered the option to sell a store as a whole. With all of the other aspirations I have for the plugin currently, I don't see this as being a priority. If this is something you would like, put an enhancement request on github and I'll see if I can work it in.
Will you be adding the option to sell to a store anytime soon?
@ShadowKilla1111
Yes, a player may make as many stores as they like.
would you be able to make multiple stores?
Oh, one more quick suggestion. Some other plugins (in particular Grief Prevention) use the "punch a chest" action to do something. May I suggest also allowing a player to just point at the target chest when using the slash commands, instead of requiring the punch? If the player isn't pointing at a chest when he uses the slash command, a quick message can come up to tell him to punch the chest he wants, or use the slash command while looking at it.
Thanks!
Hi Archmage, I really like the idea of this plugin. Paired with anti-xray, it has great potential for my server. The only thing stopping me from using it is that there doesn't seem to be an option to create a server shop. I want to designate one or more chests to have unlimited inventory. I'd be placing them in the spawn, and giving brand new players just a little currency to pick and choose which starting gear they want. Once they're out in the world, they can't return to the shop (I'll take care of that part), so instead have to rely on player-owned shops from there.
So the only piece missing is the unlimited inventory chests. Can you help me out? :)
@Hoangbui
The master branch currently has currency configuration included. It is not yet ready for testing, but allows the admin to change what items are used as currency and what the conversion ratios are.
Also can you add a way for us to set default currency? Instead of gold, we can set it as diamond instead, removing the rest of the system? Thank you. I've been looking for something like this for a very long time.
Afterward, can you allow one to buy Permission through the same system :D ? I doubt it tho because the Source Code doesn't seem like it will work that way, well that is another interesting idea for you to work on in the future XD
It would make more sense to me if you used Lapiz instead of diamond since Lapiz has little purpose and Diamond is the most sought after commodity in the game. I wan't people to be able to buy diamonds and that wouldn't really work if it is a currency item. If you really want to please everyone you should make a config file to change the items of the economy.