[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


    Did you update it to the version of Minecraft right now?(Minecraft Beta 1.7.3) If not, can you pleeaase update it? I love this idea!
  3. Offline


    We're open to suggestions. I'd love to see your idea's on how this could be done differently. Post your ideas/suggestions/bugs to our Github Issues page.

    LocalShops 3.1.1 works fine with build 1000 but we don't have the new items yet as we're finalizing Version 4.0.0.

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

    General Gilliam

    hey, I'm having a problem getting this to work on my server. Whenever I run bukkit with this it messes with permissions and makes it so I can't use any of my plugins besides this one. If I take out the LocalShops.jar and then run the server everything runs fine. Here's my log, hope you can helps.

  5. Offline


    That doesn't help at all. We only consume Permissions, could you elaborate more on your configuration? Are you adding permission nodes for Localshops that might not be properly formatted for Permissions (the plugin)? That would be my guess. We definitely don't directly cause Permissions to have bad data.
  6. Offline

    General Gilliam

    Hmm, well, after doing a crap-load Google searching, I found a solution. By changing the name of "Permissions.jar" to "zPermissions.jar" everything works fine. I have no idea how this fixes the problem or what was causing it, but, it works, so screw it.
  7. Offline


    Will you update it so that users can import items into their own shop because i get errors when i use craftbukkit 1000
    so will you please update it
  8. Offline


    I have a question. Maybe I dont' understand how works this command
    /shop set minbalance [amount]
    I have set it to 100000 and currently I have money 20,000 and players still may sell items to my shop.
  9. fix: Reload -> shop breaks.
    restart: shop still stay? wtf
  10. Offline


    Seems odd, I haven't run into that problem before but that doesn't mean too much! Glad you got it working.

    LocalShops 3.1.1 works fine with Build 1000 (as I have said repeatedly on this thread). We haven't updated to contain the new items yet but that will come soon. We're working on it. (We really really are)

    Funky. I'll have to test this out. Owners and managers bypass the check since they just add the items to the shop so you might want to double check that when your testing you aren't an owner or manager of the shop.

    I'm not certain what this means. Could you elaborate what your trying to express in a different way so that I can attempt to help? The best way is to fully describe the problem, then describe how you were able to find the problem, and finally describe what you believe it should be doing instead.
  11. Offline


    I Have installed your Mod and I love it, best shop set up out there! I do have a slight issue with setting up permissions for my non admin players. I have followed all the instructions and everything works great for the admins. Here is what happens. You are able to see the search for an item commands etc, but when you are in a shop you are unable to use the /shop browse etc. Needless to say I am prob doing some noob mistake with adding them to my permissions list, was wondering if you could post an example? I am also using the BOSEconomy and everything seems to be working great, except this tiny permissions issue that I'm having. Thanks in advance for the help, and keep up the good work!
  12. Offline


    What Permissions plugin are you using and could you post the configuration of said plugin? It would help quite a bit.
  13. Offline


    I don't know if this has been mentioned already, but it may be worth looking into from a developer's angle:

    Go to a shop that can sell an unlimited number of an item. (e.g., a bow for 60 each.)
    Type "/shop buy bow all" while you have a mostly full inventory and a large amount of money on you.
    Watch all of your money disappear as you purchase a ton of bows you don't actually receive.

    Go to a shop that call buy an unlimited number of an item. (Again, e.g., a bow for 30 each.)
    Type "shop sell bow all" while you are still carrying the same things you had after buying (above).
    Watch as you sell a ton of bows (that you just bought) that you aren't actually carrying.

    This happened to me when I was new to the plugin and trying to figure out how to buy and sell on a server I was playing on. (The whole "shop browse sell" to see what a store buys confused the hell out of me for some time.)
  14. Offline


    Pretty sure we've squashed these fun bugs in our development tree, as far as the "shop browse sell", well really its confusing to about half the people either way we do it haha. If you have any idea's on how to solve it please let us know!
  15. Server restart or reload plugins will cause ur shop dissappear.
  16. Offline


    Restarting servers works fine, I'm sure your aren't the only one to restart a server. As far as reloading plugins, which one are you using and we may look at it. Most reloading plugins hurt plugins more than they help.
  17. well i dont know but im using permissions 2.7.4 and bukkit 1000+ with miencraft 1.7.3 and friend of mine said this is good pluging, we tried -> the shops wont stay :D they dissappear after reload or restart ^^
  18. Offline


    Please provide logs. Nobody else is having these issues with the same configuration.
  19. i dont have logs anymore and deleted the plugin already. I think its something to have with the permissions, friend has 3.x permissions and it works for him, same with 1 puplic server (fin server) which has newest permissions and this plugin it works.
  20. Offline


    Will this work with build 1000?
  21. Offline



    I have no idea.
  22. Offline


    hey u dont answer me :'(
    my question is on page .13 ;)
  23. Offline


    Your question on page 13 didn't make any sense. You should try replying with easier to understand information instead.

    Also, spamming the thread with replies because I didn't get to your post is pathetic. I'm not your personal support. I do this on my own time. The least you can do is be respectful of my time. Don't expect me to come running at your next post either.

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


    srry i use google translater:rolleyes:

    i want to change the config, that co-admins and builder use the shop too.
    because when i a builder or co-admin i cant use the shop .

    i hope this is better:)
  25. Offline


    Adding items has not been working thats why i asked
  26. Offline


    Would love to hear the specifics of your issues. There are many servers I know of that have shops working properly. Could you let me know the exact command you are using, the output from said command and finally you server logs from the time that you did this?
  27. Offline


    i used the command /shops add and it did not work i tried /shop add and that didn't as well but i renamed permissions and got it working thanks for your help though
  28. Offline


    What I have for my permissions plug-in is Yeti's Permission. I have also restored my user permissions back to default (where everything works for admin but no one else) With BOSEconomy I can set up brackets and place players in them for pay. I have set up a shop with items, however non admin have no way to use the /browse commands. I Followed all instructions to the letter with no luck.. So i will post what I have at the moment which is only admin to a few players in users and what i have so far in groups. Thanks again for the help and the speedy reply!!

    UPDATE: I figured out what the problem is. I was using an out of date version of The Yeti's Permissions plug-in. Overlooked that completely, Oops!. Thank You for the help that you were going to give ;p If anyone if having the issue that player cannot use the /shop browse commands while in the shop, update your Yeti Permissions,(If you are using it) older versions of Yeti's will not work with this plug-in. Hope this helps, and once again, Excellent work on this mod.. you all deserve some cake!

    Attached Files:

  29. Offline


    sorry I've offended you in some way or another, but you've answered the other, and I'm not so I thought you've forgotten my post.
    here a [diamond][diamond]
  30. Offline


    Hiya. Great mod, just convinced our admin to add it, I'm the mod in charge of it.

    We're on build 1000. Using 3.1.1. I don't have the other info except we're on iConomy, pretty sure.

    Using /shop find seems glitched. It ALWAYS returns "Showing 4 of 1 shops having _____"
    And it will only show either a buy or sell price. It won't show both if a shop is both buying an item and selling it.

    Edit: It's not always 4 of 1. It's 4 of <Number of shops selling it>

    So if two have the item, it's 4 of 2 shops selling it.

    and the first one won't list a sell price if it also has a buy price.
  31. Offline


    Hi, i have a question o.o its pretty much simple.
    My shop is for buying other people item only so i didn't add any price for sell so i was wondering, how do i remove item from my shop without removing the item cost from the shop ? (/shop remove)
    when i do /shop buy its say (shop not selling ** right now) the only way i found was /cremove .. but i don't want to add the price each time :Sand i'm the owner if that help ^^
Thread Status:
Not open for further replies.

Share This Page