LocalShops 3.1.0 Source Updated

This project is abandoned and its default file will likely not work with the most recent version of Minecraft. Whether this project is out of date or its author has marked it as abandoned, this project is no longer maintained.

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.

Features:

    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!

Requirements:

    CraftBukkit Recommended Build 1317 (as not sure how it will run with 1240)

Permissions (optional)

    PermissionsEX

Economic (use one of the following)
    iConomy v5
    Essentials Economy v2.6.2
    BOSE_economy
    (attempt for Iconomy6 support)

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.

Permissions:
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!
http://forums.bukkit.org/threads/econ-localshops-v3-1-1-fifth-avenue-economy-based-player-shops-935.17131/#post-293182

Third Party Tools & Utilities:
|ShopEditor - The GUI for Editing Shops (Windows only :()
http://forums.bukkit.org/threads/config-shopeditor-the-gui-for-editing-shops-v6-1-item-names.17163/

Credits / LocalShops Team:
Please do not send support messages directly to any of These developers. These are the original coders of the plugin. HOWEVER, all I did was added all the new items from 1.8.1 into the shops and updated it. This way everything can be added into shops. Except maps for some odd reason...

    cereal
    MineralMC
    Sleaker
    Jonbas


Comments

  • To post a comment, please or register a new account.
Posts Quoted:
Reply
Clear All Quotes

About This Project

Categories

Members

Recent Files

No files uploaded yet.