[INACTIVE][ECON] LocalShops v3.1.1 (Fifth Avenue) - Economy Based Player Shops [935]

Discussion in 'Inactive/Unsupported Plugins' started by cereal, May 13, 2011.

Thread Status:
Not open for further replies.
  1. Offline


    Economy Based Player Shops

    Version: 3.1.1 (Fifth Avenue)

    LocalShops allows players to create and manage physical shops - literal player-defined cuboids - in which they can directly participate in a server economy!

    Version 3 includes masses of bug fixes, tweaks and improvements, including a brand new item search engine, allowing players to use, manage and create shops with more ease that ever before.

    • Player owned and operated physical shops!
    • Shops can be managed by multiple players.
    • Create a Free Market in which the players directly control economic values of items!
    Download LocalShops (JAR)
    Source Code
    Issue Tracker (Bug Reports & Feature Requests)

    Got Issues or Problems?

    We're happy to help with any issues or problems you may have, but please help us as we make every effort to help you! If you're experiencing errors, or funkiness please do the following:
    1. Verify that your versions meet the requirements in the Requirements Section
    2. You can reproduce the bug
    3. Use kind words in your post!
    Awesome, now in the post please include the following information:

    • Version of Bukkit
    • Version of LocalShops
    • Version of Permissions
    • Which Economic Plugin you are using (and version number)
    • Description of issue, error, or shenanigan
    • Steps to reproduce issue, error, or shenanigan
    • Log files (as much as you can provide the better)
    Commands: [required] <optional>
    • /shop
      • Displays a list of player commands
    • /shop select
      • Select a cuboid area for a shop to occupy. Used in conjunction with both the create and move commands. Using the select command a second time will cancel the selection process.
    • /shop create [shop name]
      • Creates a shop of the default sized (specified in the configuration file) at your location.
      • If used after the select command - assuming the player didn’t cancel the selection process, possess enough money to create a shop (also specified in the configuration file) and the selection is smaller than the maximum allowed area (again, specified in the configuration file) - a shop will be created that fills the specified area.
      • Remember, shops are created in a 3D space - selecting two blocks on the floor will likely result in the creation of a shop that is a single block tall, which isn’t particularly useful to anyone.

        Any characters may be used for a shop name, including spaces and punctuation.
    • /shop info <id>
      • Used while standing in a shop, this command will return information about that specific shop. If a shop ID is added to the end, it will return information about another shop without the player needing to be physically in it.

        Use either this command or list to get shop IDs.
    • /shop browse <buy|sell>
      • Shows a list of items currently in the shop and if provided either buy or sell as an argument it will only show those for to buy or sell (from the players perspective).
    • /shop find [item name|id]
      • Finds nearby shops that either buy or sell the item sorted by distance with the cost per item.
    • /shop list
      • Lists all shops in the current world that the player owns, along with their unique IDs and names.
    • /shop move [id]
      • Moves the specified shop to a new location. The select command can be used prior to this command, allowing the shop to be moved to a new cuboid specified by the player.

        Both list and info will return shop IDs, in addition to other information.
    • /shop destroy
      • Destroys the shop the player is currently standing inside. The owner of the shop will receive anything that was left in stock, inventory space permitting.
    • /shop add <item name>
      • Used without an item name on the end, adds the stack of items that the player is currently holding.

        If an item name is specified, that item will be added to the shop, with a stock of 0.
    • /shop remove <item name>
      • Used without an item name, removes the item that the player is currently holding from the shop, and returns all remaining stock to the owner.

        If an item name is specified, it works in the same way, but for the specified item instead of the held item.

        In order to remove a certain amount of items from a shop (and not stop the shop from stocking the item), the player must use the buy command. Owners and managers of a shop are not charged for removing items in this manner.
    • /shop buy [item name] <amount>
      /buy [item name] <amount>
      • Purchases a specified item from a shop. If the player uses ‘all’ in place of an amount, the shop will attempt to fill the player’s inventory with the specified item, money (and item stock) permitting.
    • /shop sell <item name> <amount>
      /sell <item name> <amount>
      • Used without an item name and amount defined, sells the stack of items the player is currently holding.

        With an item name defined, a specific item (a single item) is sold to the shop. If the player uses ‘all’ in place of an amount, all instances of that item in his inventory will be sold.
    • /shop set
      • Help page - displays a list of set commands.
    • /shop set buy [item name] [price] <bundle size>
      • Used to set the price and bundle size of items that the shop will be able to buy or purchased from customers.

        Both this command and the set sell command below are set from the perspective of the shop, not the customer; in contrast the buy and sell commands are always from the perspective of the customer.
    • /shop set sell [item name] [price] <bundle size>
      • Sets the price and bundle size of items that can be sold to the customer.
    • /shop set manager +/-[player name]
      ex: /shop set manager -cerealk +Mineral
      • Adds or removes managers from the player’s shop. A manage is able to add/remove items, set prices and set maximum amounts. He cannot move the shop, destroy the shop, nor add/remove managers.
    • /shop set minbalance [amount]
      • Sets a shops minimum balance that must remain in the account at all times. Helps prevent players from selling to a shop and completely bankrupting the owner.
    • /shop set max [item name] [max amount]
      • Used to set a maximum stock limit for a specified item. Note that the owner of the shop will still be able to add items above the maximum stock level, but the shop will not buy items from players if the current stock level is higher than the maximum specified amount.
    • /shop set notification
      • Toggles if the shop owner is to receive periodic transaction notifications via chat.
    • /shop set owner [player name]
      • Changes the shop owner to another player.
    • /shop set unlimited money
      Requires a special permission node: localshops.admin
      • Sets the shop to have unlimited money - useful for a server shop buying items from players. The money from items sold to the shop while this is toggled on will go to whoever is set as the shop owner. If the owner is set to a player that doesn’t exist (ServerBank, for example) the creator of the shop won’t get the money from item sales.
    • /shop set unlimited stock
      Requires a special permission node: localshops.admin
      • Sets a shop to have an unlimited amount of all stocked items - keep in mind that items still need to be added to the shop for them to appear in the shop’s inventory.
    A word of caution with Permissions, Managers by default cannot use shops! Managers should have both the manager and user permissions, similar with Admins.
    • localshops.user.*
      • Users can buy and sell to shops but not make or manage them.
      • Sub nodes are:
        • localshops.user.buy
        • localshops.user.sell
        • localshops.user.browse
    • localshops.manager.*
      • Owners and Managers can create, move or destroy shops and manage shops (using the set commands)
      • Sub nodes are:
        • localshops.manager.add
        • localshops.manager.create
        • localshops.manager.destroy
        • localshops.manager.move
        • localshops.manager.remove
        • localshops.manager.select
        • localshops.manager.set
        • localshops.manager.set.owner
    • localshops.admin
      • Allows administrative access to override manager permissions.
    • localshops.free.create
      • Removes the cost associated with creating a shop.
    • localshops.free.move
      • Removes the cost associated with moving a shop.
    Configuration File:
    See this post for the configuration file!

    Example/Instruction Videos:
    See this post for the example & instruction videos!

    Third Party Tools & Utilities:
    ShopEditor - The GUI for Editing Shops (Windows only :()


    LocalShops reports minimal anonymous data to provide general usage tracking. No personal or server information is ever transmitted. The following data is provided:
    • Plugin Name (this will always be LocalShops)
    • Plugin Version
    • Bukkit Version (the full Bukkit version string)
    • Operating System
      • Name
      • Version
      • Architecture
    • Java Version
    This data helps us understand the environments in which LocalShops is used within, however you are more than welcome to disable it by setting "report-stats" in the configuration file to false.

    Internet Relay Chat:
    We idle on EsperNet! Come join us (along with pretty much the rest of the Bukkit crew).
    • Server: irc.esper.net
    • Port: 6667
    • Channel: #localshops
    Credits / LocalShops Team:
    Please do not send support messages directly to any of us. While we appreciate your desire to solve problems or get answers, it isn't appropriate and our answers could easily help others!

    Version 3.1.1
    • Fix detection of BOSEconomy
    • Fix "/shop buy all" not properly functioning
    Version 3.1.0
    • Out of Beta!
    • Features:
      • Permissions updated, is not mandatory
        • Will only restrict admin commands to ops without Permissions
      • Sorting of /shop browse and /shop list
      • New command: /shop find
        • Used to find nearby shops that sell an item
      • Transaction notification for shop owners
    • Bug Fixes:
      • Economy sanity checks
      • /shop select Message clarify usage (bare hands)
      • Sanity checks on corrupt shop files
      • /shop sell all now sells all items instead of a single stack
      • Refactored Commands (now each in their own class)
      • Remove players from memory on PLAYER_KICK and PLAYER_QUIT events
      • Notification for insufficient funds
      • Owner & creator information is now shown in /shop info for all situations
      • Match criteria updated
        • Wool, Cactus Green, Cactus, Glowstone Dust
    Version 3.0.3-Beta
    • Fixed money exploit
    • Fix typo on selling or buying 0 items
    • Redstone Dust match criteria updated
    • Soul Sand match criteria updated
    View all changes here!

    Configuration File:
    The configuration file for LocalShops is located at plugins/LocalShops/localshops.properties and can easily be modified. See the following information about each variable and its purpose and valid values.
    • uuid=Random
      • Used for reporting.
    • debug=false
      • Value can be true or false. If true, logs verbose debugging information to console.
    • shops-per-player=-1
      • Maximum number of shops each player can have, unlimited is -1.
    • report-stats=true
      • Value can be true or false. If true, anonymous information will be collected, see Reporting section.
    • log-transactions=true
      • Value can be true or false. If true, logs transactions.
    • max-damage=35
      • Maximum damage percentage an item can have to be added to a shop (it will be sold repaired). Default is 35 (or, 65% or more of the 'health' of the item is remaining).
    • charge-for-shop=true
      • Enables charging for creating & moving shops.
    • shop-cost=100
      • Cost of creating a shop.
    • move-cost=100
      • Cost of moving a shop.
    • shop-height=3
      • Default shop height.
    • shop-width=10
      • Default shop width.
    • max-height=10
      • Maximum shop height.
    • max-width=30
      • Maximum shop width.
    • shop-notification=true
      • If true, shop transaction notices will occur. Note: this is a global configuration!
    • shop-notification-timer=300
      • Number of seconds between transaction notifications, default is 5 minutes.
    • shop-transaction-max-size=100
      • Maximum number of transactions that a store will store for notification purposes. Limited to 100 by default to prevent infinite memory usage.
    • search-max-distance=150
      • Maximum number of meters away from a player to include in shop find results (should be renamed to find-max-distance and will likely happen in the near future).
    BOSEconomy Support:
    BOSEconomy does not provide support for major or minor values and ONLY supports whole numbers. The result is that all orders are rounded up to the next whole number to ensure that the Shop Owners obtain the proper monetary value. Here are some examples:
    • Stone selling for 1.30 each...
      • A player purchases 1 and the total price is 1.30 and is thus rounded to 2 (we goto the next whole number, there is NO rounding down)
      • A player purchases 100 and the total price is 130 and thus there is no rounding to do.
    How to enable Debugging & Obtain the Logs:
    1. Locate the LocalShops properties file, it is located in the folder "plugins/LocalShops/" and is named "localshops.properties".
    2. Find the line that starts with "debug=" and set the value (portion after the equals) to true.
      1. You should now have "debug=true"
    3. Remove your old server logs (we will want a fresh slate to start with). The server log is "server.log", either delete it or move/rename it.
    4. Start the Bukkit, and perform the actions to cause the error.
    5. Stop Bukkit.
    6. Locate "server.log" in the Bukkit main directory and attach it to your forum post!

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 16, 2016
    Thumbz, Mitsugaru, Stalker and 9 others like this.
  2. Offline


    ok so i cant buy stuff from my own shop. but other people can with money from i conomy?
  3. Offline


    No you cannot purchase something from yourself and have money change parties. Because of this, if you are the shop owner, you will remove an item from the shop instead of purchasing it. If you are not the owner, they will pay you (because you are the owner).

    I would highly recommended testing this as its much faster than asking questions. It's easy to ask a friend to buy some dirt for cheap after all!
  4. Offline


    By any chance, have the /buy and /sell functions changed in a recent update? Since updating from an older version of the plugin, using /buy and /sell don't actually sell any items, but simply return the message "[Shop] Mode set to buying/selling!"

    Using /shop buy and /shop sell work fine, but unfortunately i've set up a few other plugins to make use of the /buy and /sell commands directly and this causes some huge problems for me to fix.

    Is there something I'm doing wrong with this plugin? If this is working as intended, is there a way I can stop localshops from catching the /buy and /sell commands altogether (so that I can use an alias of my own instead)?
  5. Offline


    Sounds like you have another plugin intercepting the buy and sell commands. We also attempt to grab buy and sell, but we don't have that output you stated above. The best suggestion I have is to place whatever plugin you want to have buy and sell commands to belong to alphabetically first in your plugins folder, but this really isn't about LocalShops and more about Bukkit in general so I'd suggest you do some research and post in a more appropriate place if necessary.
  6. Offline


    Found a bug, i dont know how it happened, but if someone has a negative amoutn of items in the shop, you get payed for buying [Massive one] If you buy from a shop at times, its dropped unlimiteed times. please fix this!
  7. Offline


    We love this plugin, and have been using it since Jonbas started it. You've been awesome in keeping the plugin going.

    Would you be willing to add a command "/shop pull" or "/shop get" for managers to remove items from stock without affecting the shops ability to purchase that item? We run stores that buy only, and don't want to add a sell price (even at high prices).
  8. Offline


    I have the same problem. Command /shop set minbalance [amount] works ok, but players can still selling items under owner's minimal balance.

    I look in source code and probably in CommandShopSell.java is bug. Condition in method
    private boolean shopSell(Shop shop, ItemInfo item, int amount) {
    if (!pData.payPlayer(shop.getOwner(), player.getName(), totalCost)) {
    if (shopBalance <= shop.getMinBalance() || shopBalance < invItem.getSellPrice()) {

    Second condition is at wrong position, I think.
  9. Offline


    Has this been tested against

    Build 953 RB
    Iconomy 5.x
    Permissions 3.x
  10. Offline


    Worked Awesomely until 1.7,

    My " OP'ed,Debuging, permissions '*' " who even owns the shop can no longer touch it,
    [Shop] You don't have permission to use this command

    He used to be able to manage it with a breeze, there are no console errors on trying to manage the shop.
    Please take a look at this =(
  11. Offline


    can someone help me i've tried everything but when i try a create a shop it says you 'have reached your maximum number of shops or you don't have permission' but i haven't made any other and it my server also i downloaded permissions and looked at every video so can someone help me
  12. Offline


    Any chance of a /shop copy [Shopname] and /shop paste [Shopname]?
    ...or some sort of clone feature that will allow me to have the same "Global Exchange" in different areas so that prices only need to be updated in one area?

    Also, any chance of a fluctuating price for the "Global Exchange" that goes up in price the more things are purchased and goes down in price when things sell more?
  13. This is what I am looking for as well. I want to open multiple stores around the map and have them share a global inventory and price structure. This means that I wont have to run around updating all shops inventory levels. The other people helping work on our server code looked into trying to do this ourselves by making a shared item database, but it looks as if it would be a pain instead of just getting it hard coded into the main addon. Any possibility of having this added to the next release?

  14. Offline


    it still doesn't work can some one help me
  15. Offline


    how can I make it that each of the moderator or semi-admin (co-admin)
    So the shop /store buy stone 5 can use ?:(
    I use Iconomy5, BOSEconomy and Essentials but i cant find the file where you can change it.

    thx for help[diamond]
  16. Offline


    • LocalShop
    • 3.1.1 (and other versions)
    • 953
    • Linux
      • Ubuntu
      • 10.10
      • ?
    • Latest I guess

    A user is able to sell items to shop (and get money for it) but they are able to buy items but no money is extracted from their bank account. I think this started happening during the 1.7 update because I haven't heard of this happening prior.

    Thanks for any help that comes my way :)
  17. Offline


    LocalShops is working with iConomy 5, Permissions 3, and RB 953

    I did have a couple of questions...
    I use Residence (Kinda like WorldGuard) for region management; how do I keep people from creating shops in protected areas?

    Is it possible to make shop creation actually build a predefined block setup?
    Like if someone does "/shop create MyShop", it will create a predefined Shop Building that I setup as an admin for them on that plot and be protected from build/destroying on it, and if they "/shop move" or "/shop destroy" it, the building will be destroyed as well.
  18. Offline


    • Bukkit 953
    • LocalShops v3.1.1
    • Permissions 2.7.2
    • IConomy
    I'm having trouble adding shears to the inventory of a shop. I've tried to add shears to the shop using /shop add and /shop add all, but it says it could not find the item.
  19. Offline


    Caliver, please note that the command is for CraftBukkit b935, which is not a 1.7 CB build. Until it is updated for CraftBukkit b953 (or higher), shears won't be addable because shears are not present in the ID list for materials that is being used. I know I'm not the creator of this plugin, I just figured I would try and shed some light for you on why you can't sell shears in a shop as of right now.
  20. Offline


    I was wondering if you were planning on adding a command that sets the max amount of items for a specific store. For example, someone that rents a large lot can have more items in the stock than someone who rents a smaller shop.
    Niemand likes this.
  21. Offline


    Oh alright. I wasn't sure which was the 1.7 build but thanks for shedding light on that. :)
  22. Offline


    it would be nice to add ability to update shop config from server, after manual editing it. Without stopping server.
    Something like "/shop save" to save from memory to disk and "/shop reload" to update new conf to memory.
  23. Offline


    Are they planning on updating this plugin to 1.7.x?
  24. Offline


    Please fix.. permissions don't work.
    Permissions 3.x
    Minecraft latest version
  25. Offline


    how do you make a shop i know /shop create .... but i doesn't work
  26. Offline


    Its not working for me! Users have the permission nodes but but it says it doesn't!
    Please post yours :eek:
    Btw I've got the same stuff as you, except minecraft 1.7.4 or what ever it is
  27. Offline


    does this work with 1.7.3
  28. Offline


    '/shop search' does not work. That command requires an item name. Obviously that is what I am trying to find.

    What is the valid item name for stone slab? It is not 'stone slab' or 'stoneslab'.

    Found it ... I think it is 'slab'.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 16, 2016
  29. Offline


    That's what I'm trying to say... /shop search name - does a regexp on the item name and tries to match it with the exact name in the list. So you can try /shop search slab or /shop search sto step - to try and match the item.

    The item name detection in 3.1.1 is a bit outdated and has been updated to be better at catching names, so if you have issues finding an item just use the minecraftwiki and search for the item ID:subtype or use that for dealing with all of your commands, the wiki has all of the data values for all the items.
  30. Offline

    Phantom Index

    I did encounter a glitch. Say if someone named LocalMan created a Shop "LocalStuff". LocalMan adds TNT to his shop and set it to buy for 100 each.
    LocalMan only has 10k in-game money. Another person named DudeBroMan comes and sells 10 stacks of TNT. LocalMan is broke and instead of DudeBroMan receiving 64k money for the TNT, he gets 64Mil!

    This has happened 3 times already with the same method, but different items. I'm using build 953 and the latest LocalShops as of now 3.1.1

    It would be nice if you could look into this glitch. Otherwise economys will just explode.
  31. Offline


    i can't add pistons to my shops.
Thread Status:
Not open for further replies.

Share This Page