[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


    as has been stated (or maybe it hasn't) LocalShops-dev (the github source) currently supports fully functioning shopsigns (in our own format)

    The design focus of LS is to provide a lot of configuration options, and then try to connect them to easily accessible methods of interaction. Signs are very good way to do this.
  3. Offline


    I am having an issue with item names in the store. For instance I am selling "Stone Slab" in my store. That is the name of the item when I do a browse.

    When I enter "/shop buy stone slab", it says this store is not selling any stone. I thinks I am trying to buy stone instead of stone slab.

    It is clear to me now that the display names of the items do not always match up with the name that needs to be entered.

    1. what is the proper name for stone slab?
    2. Is there a list I can provide my community of all item names as they need to be entered as opposed to how they are displayed?

  4. Offline


    Have you tried "/shop buy stoneslab" where there is no space between "stone" and "slab"?
  5. Offline


    yes. It says that the shop is not selling any stone right now.
  6. Offline


    This was actually idea for my server. Seeing that armor and weapons have a 20% difference between buy and sell

    Hey did anyone else notice the UUID's in the shop names are gone? I love having shops being called weapons.shop instead of 013904-24092-12902.shop but when the the update undo itself? Lol. Thanks again for making the document english again

    Also even though the updates confuse me (mostly from me wanting time to freeze in the moment it is lol) this is the one plugin I hope will always stay with bukkit. Worldguard, Worldedit, LWC, iConomy and Localshops. That is all I need to survive. I try to only choose plugins that are in it for the long haul and this one is a surefire winner in terms of awesomeness.

    you get 10/10 awesomness'es

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


    Can anyone help me?

    Anybody know the exact item names in minecraft. For instance Iron Door is - IRON_DOOR_BLOCK.
  8. Offline


    A list of items names usable with the plugin would be very handy.
    Could this not be found in the source (I don't have enough knowledge to find it myself)?

    Would this example be valid?

    Also, I noticed a lack of an example of how to use the commands in game.

    Would it be something like:

    "/shop buy 3" or "/shop buy dirt" to buy dirt
    "/shop buy 2256" or "/shop buy gold_music_disc" to buy a golden disc
    "/shop buy 44" or "/shop buy stone_slab" to buy a smooth stone slab
    "/shop buy 44:2" or "/shop buy wooden_slab" to buy a wood half-block

    Please correct me if I am wrong, or verify for me if I am correct.

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



    Is there a way to limit the amount of items a player can put in a shop depending on permission group?
  10. Offline


    @Magesblood - not right now.

    @X-Men - you don't need the exact item names, nor the item IDs there is a builtin search function to get names of items in localshops. just try /shop search (/lshop search)
  11. Offline


    SERIOUS BUG!!!!!

    I have the latest Bukkit plugin.

    Whenever anyone on my server deletes a shop that is still full of items, every item multiplies infinitely. If they pick up a single bow for example, their entire inventory is filled with bows. The minute the bow is used once it disappears. Can anyone help me with this one? I tried to post on the bug report, but was taken to a 404 page.

  12. Offline


    it's a MC bug with dropping items into the world improperly.
  13. Offline


    Users on my server have just discovered a way to duplicate items although as far as I can tell they did it without removing a shop first. Needless to say this is very serious as it started with apples and moved on to diamonds before I noticed and put a stop to it.

    I have the relevant logs from LocalShops if it would help the developers. I was going to open an issue about this but it appears the issue tracker is dead. It appears the dodgy items were bought or removed from a shop initially.

    My main worry is stopping it from happening again. What steps do I need to take?
  14. Offline


  15. Offline


    How can i make the shops sell illegal items? I want to sell Double Slabs and it bugs out when it loads the shop file, it's easier to build with those than with stacking the Slabs and I am admin

    EDIT: Thanks for the answer Sleaker, good to know (Post below)
  16. Offline


    @EZSPECIAL some of the 'hacky' blocks weren't in 3.1.1 they'll be in the next version. Unfortunately that means you can't sell them in shops atm.
  17. Offline


    I've have both of these things but I would rather not publish them publicly, since they both contain user information. I am happy to send them to one of you privately though.
  18. Offline


    download link isnt working:(
  19. Offline


  20. Offline


    should work like this.
  21. Offline


    is it working with 860?

    i think youre right.
    I usualy just use the IDs.

    Its always /shop buy ID or /shop buy Name
    actualy it'd be enought to write f.e. "/buy 3" to buy dirt.

    any chance for a german version? I'd like to translate it, but i cant find something like a language file.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 16, 2016
  22. Working with 860?
  23. Offline


    Languages aren't in 3.1 we are working on localization for the next Release, but it may only be partial localization.

    yes it works with 860. Not even sure why people have to ask.
  24. Offline


    Am i doing something wrong?
  25. Offline


    looks like you don't have a proper economy plugin.
  26. Offline


    How is the next version coming along?

    Will you be able to code in any work-arounds for the 1.6.6 bugs with items?
  27. I have a problem with this LocalShop

    • Version of Bukkit - 766
    • Version of LocalShops - 3.1.1
    • Version of Permissions - I think it's not a reason
    • Which Economic Plugin you are using (and version number) - Iconomy v4
    • Description of issue, error, or shenanigan : I was doing my shop (selectiong prices etc,) and after restart my server (i ussualy save-all before shutdown) there was no shop in this place!?
      I go to the /plugins/LocalShop/Shops and there was a file named 7d48d644-f8b9-48a0-8e3d-1069be342e17
      I opened it by .txt and copy my config. Then i tried to make another shop and copy config from the first shop, but after restart there was no shop again.( But the file was in /shops) I was trying and trying but i can't copy my config to another shop.
    • Log files (as much as you can provide the better) Here they are
  28. Offline


    I am eager for the release of the next version. About how much is done? Could you give a percentage?
  29. Offline


    This is a continuation of the problem that I mentioned here:

    With the discussion on the issue in these posts:

    So it looks like BetterShop updated it's aliases (at least that's what the changelog indicates), but a new error is coming up and I am not sure if it's the same shit just different message or something new. Tried them separately and they worked, but still not together.

    I get this error:

    09:41:41 [SEVERE] Error occurred while enabling LocalShops v3.1.1 (Is it up to date?): null
            at net.centerleft.localshops.LocalShops.onEnable(LocalShops.java:79)
            at org.bukkit.plugin.java.JavaPlugin.setEnabled(JavaPlugin.java:125)
            at org.bukkit.plugin.java.JavaPluginLoader.enablePlugin(JavaPluginLoader.java:799)
            at org.bukkit.plugin.SimplePluginManager.enablePlugin(SimplePluginManager.java:253)
            at org.bukkit.craftbukkit.CraftServer.loadPlugin(CraftServer.java:140)
            at org.bukkit.craftbukkit.CraftServer.loadPlugins(CraftServer.java:118)
            at net.minecraft.server.MinecraftServer.e(MinecraftServer.java:232)
            at net.minecraft.server.MinecraftServer.a(MinecraftServer.java:219)
            at net.minecraft.server.MinecraftServer.init(MinecraftServer.java:146)
            at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:283)
            at net.minecraft.server.ThreadServerApplication.run(SourceFile:422)
    And BetterShop's changelog would be here

    Bettershop isn't returning any errors, only LocalShop. And unlike before where LocalShop would take over the commands and no BetterShop commands would work, this time no LocalShop commands work.

    Any thoughts?
  30. Offline


    i have a really quick question about the economy system and localShops. My Problem is that i cant get my economy system to connect with local shops. it may be really easy but i cant seem to figure it out. can someone please help me?

    ok so aparently i did not provide enough information on my last post. So im making a new post. I am expiriencing some problems making the iconomy money system work with the shops i create. When i try to buy something with the iconomy money all it says is that i removed an item and i did not pay for it with my iconomy money. everything else on the localshops works fine it is just this little problem.

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


    So you own the shop? If so, you would be paying yourself and who does that? So instead of buying as the shop owner you remove. You can verify you are the shop owner buy using the /shop info command (it'll display the owner).

    Could you elaborate? I'm not seeing any issues.

    We do best effort matching on the name. Such that providing a list of valid names is nothing more than the legitimate item name from Minepedia ;) Spaces work by the way, no need to use underscores (but they shouldnt hurt either). So say you want to buy "Lapis Lazuli Ore" you simply type it /shop buy lapis lazuli ore, you can also be lazy and leave off some portions of a name depending on the item etc.

    So there is no official list, but it should match everything. If you find something it doesn't then please post that. You can test with /shop search the item name you want to test, then the provided output gives debugging info from the search algorithm.

    EDIT by Moderator: merged posts, please use the edit button instead of double posting.
    Last edited by a moderator: Jul 16, 2016
Thread Status:
Not open for further replies.

Share This Page