Sell items and blocks to your players using Item Frames!
Features
Note: This plugin does not support player shops, and will not in the near future. It is to be used by admins to create shops for server players.
Prices
Almost every item has a default price shipped with the plugin, but we suggest you still change most of these yourself. Some special items will not have defaults (excotic items like mob spawners)
I am not responsible for problems with the included default prices. It is the task of the server owner to fine tune prices, the ones I include are just suggestions. All craftable items will be automatically priced based on your defaults. The defaults included with the plugin are best effort guesses.
Required plugins
- Vault
- Permissions system (Bukkit default or plugin like LuckPerms)
- Economy plugin that is supported by Vault. (I use Essentials economy)
Make sure to see the manual for correct versions of these dependencies. https://wwx.be/itemframeshops/docs
Commands and permissions:
- /ifs setbuyprice [new buyprice] - Sets buy price for shop (click on item frame to apply, toggles)
Permission: ifs.command.buyprice
- /ifs help - Shows information about commands
Permission: ifs.command.help
- /ifs list - Lists all shops.
Permission: ifs.command.list
- /ifs materials - Saves a file containing all possible materials (blocks and items) in the game. Useful to customize default prices.
Permission: ifs.command.materials
- /ifs setmode [BUYING/SELLING/BOTH/DISABLED] - Set if shop is disabled or allowed to sell and/or buy items
Permission: ifs.command.mode
- /ifs setprice [new price] - Automatically sets sell price to 80% of buy for shop (click on item frame to apply, toggles)
Permission: ifs.command.price
- /ifs recalc - Recalculates buy/sell prices for shop (click on item frame to apply, toggles)
Permission: ifs.command.recalc
- /ifs reload - Reloads config files and data from disk
Permission: ifs.command.reload
- /ifs removeall - Removes all shops from the game.
Permission: ifs.command.removeall
- /ifs remove - Removes shop (click on item frame to apply, toggles)
Permission: ifs.command.remove
- /ifs save - Saves config files and data to disk
Permission: ifs.command.save
- /ifs setsellprice [new sellprice] - Sets sell price for shop (click on item frame to apply, toggles)
Permission: ifs.command.sellprice
- /ifs info - Shows statistics and information about a shop. (toggle on/off)
Permission: ifs.command.info
- /ifs worth - Shows the price and recipes ifs will use for the item in your hand.
Permission: ifs.command.worth
- /ifs debug - Contains a surprise every update (This is just a command I use to test certain things, I do not recommend that you use it)
Permission: ifs.command.debug
- /ifs create - Enables creating shops (click on item frame to create shop, toggles)
Permission: ifs.command.create
- /ifs shoplayout [amount of rows] - Allows you to change how a shop looks. You can reposition all "menu items" in a fake shop-like inventory. It is a work in progress and might be buggy!
Permission: ifs.command.shoplayout
- /ifs recalcall - Recalculates and loads all shop prices. This will remove any custom set pricing!
Permission: ifs.command.recalcall
- /ifs modifyallprices [multiplier] - Modifies all shop prices based on a multiplier. (does not calculate prices again!)
Permission: ifs.command.modifyallprices
- /ifs iteminfo - Used for debugging prices stuff. Shows item info.
Permission: ifs.command.iteminfo
- /ifs convertworth - Allows you to convert all prices from Essentials worth file to prices.properties. This might help to migrate prices from essentials.
Permission: ifs.command.convertworth
- /ifs groupwhitelist [group] - Adds or removes a group from the group whitelist. (list of groups that are allowed to use the shop) - This feature and command is in beta!
Permission: ifs.command.groupwhitelist
- /ifs setdefaultprice [new default price] - Allows changing the default price (in prices.properties) for the item in your hand. (does not work for custom items!)
Permission: ifs.command.setdefaultprice
- /ifs createshopsinselection - Turns every itemframe in your WorldEdit selection into a shop.
Permission: ifs.command.createshopsinselection
- /ifs removeshopsinselection - Removes every shop in your WorldEdit selection (but keeps items and frames).
Permission: ifs.command.removeshopsinselection
- /ifs recalcshopsinselection - Recalculates prices for every shop in your WorldEdit selection.
Permission: ifs.command.recalcshopsinselection
- /ifs sellall - Sells your entire inventory at IFS calculated prices.
Permission: ifs.command.sellall
- /ifs sellhand - Sells the item in your hand using a price calculated by IFS.
Permission: ifs.command.sellhand
Typical usage
1. Create shops by right clicking an item frame while crouching.
2. Optionally set the shop prices and/or modes by using the command.
3. Click the shop to view all available options.
The plugin will display an inventory GUI like this (the layout is cutomisable!):
4. Remove shops by left clicking a frame while crouching.
Important
Permissions
- ifs.admin.remove (allows removal of shops)
- ifs.admin.create (allows creation of shops)
- ifs.user.sell (allows selling to shops)
- ifs.user.buy (allows buying from shops)
In case you want to allow players to use /ifs sellall, you need to add the command permission AND ifs.command
Minecraft versions
IFS has a very extensive manual that will help you install the correct dependencies for the correct server versions. Please make sure you see the getting started guide here: https://wwx.be/itemframeshops/docs
Plugin Conflicts
This plugin should work fine with most plugins as ItemFrameShops does not depend on any special code.
Features
- Create shops, super fast and easy! Very easy to use
- Shops are automatically protected
- Advanced automatic price calculation: shop prices are based on a file with some default prices for uncraftable items, all other prices are calculated using their recipes (this includes in-world crafting). IFS will also take into account damaged items and price them according to the amount of damage. Does not include brewing at this time for technical reasons
- Nice completely customizable GUI menu to interact with a shop.
- Preview the item you're buying by seeing it as a preview in the shop menu inventory
- Use WorldEdit to create (or remove) a lot of shops at once.
- Offer discounts when people buy per stack (or don't, it's up to you!)
- Works with any custom item as long as it can be put in a item frame
- Beautifully presented - Item Frames
- Tested and working with CraftBukkit and Spigot 1.21 (older versions of minecraft starting with 1.14 can be used by downloading older versions of the plugin)
- All user-facing messages are customizable
Note: This plugin does not support player shops, and will not in the near future. It is to be used by admins to create shops for server players.
Prices
Almost every item has a default price shipped with the plugin, but we suggest you still change most of these yourself. Some special items will not have defaults (excotic items like mob spawners)
I am not responsible for problems with the included default prices. It is the task of the server owner to fine tune prices, the ones I include are just suggestions. All craftable items will be automatically priced based on your defaults. The defaults included with the plugin are best effort guesses.
Required plugins
- Vault
- Permissions system (Bukkit default or plugin like LuckPerms)
- Economy plugin that is supported by Vault. (I use Essentials economy)
Make sure to see the manual for correct versions of these dependencies. https://wwx.be/itemframeshops/docs
Commands and permissions:
- ifs.admin.remove
- ifs.admin.create
- ifs.user.sell
- ifs.user.buy
- ifs.user.discount32
- ifs.user.discount64
- ifs.user.useSellAll
- ifs.user.useBuyAll
- /ifs setbuyprice [new buyprice] - Sets buy price for shop (click on item frame to apply, toggles)
Permission: ifs.command.buyprice
- /ifs help - Shows information about commands
Permission: ifs.command.help
- /ifs list - Lists all shops.
Permission: ifs.command.list
- /ifs materials - Saves a file containing all possible materials (blocks and items) in the game. Useful to customize default prices.
Permission: ifs.command.materials
- /ifs setmode [BUYING/SELLING/BOTH/DISABLED] - Set if shop is disabled or allowed to sell and/or buy items
Permission: ifs.command.mode
- /ifs setprice [new price] - Automatically sets sell price to 80% of buy for shop (click on item frame to apply, toggles)
Permission: ifs.command.price
- /ifs recalc - Recalculates buy/sell prices for shop (click on item frame to apply, toggles)
Permission: ifs.command.recalc
- /ifs reload - Reloads config files and data from disk
Permission: ifs.command.reload
- /ifs removeall - Removes all shops from the game.
Permission: ifs.command.removeall
- /ifs remove - Removes shop (click on item frame to apply, toggles)
Permission: ifs.command.remove
- /ifs save - Saves config files and data to disk
Permission: ifs.command.save
- /ifs setsellprice [new sellprice] - Sets sell price for shop (click on item frame to apply, toggles)
Permission: ifs.command.sellprice
- /ifs info - Shows statistics and information about a shop. (toggle on/off)
Permission: ifs.command.info
- /ifs worth - Shows the price and recipes ifs will use for the item in your hand.
Permission: ifs.command.worth
- /ifs debug - Contains a surprise every update (This is just a command I use to test certain things, I do not recommend that you use it)
Permission: ifs.command.debug
- /ifs create - Enables creating shops (click on item frame to create shop, toggles)
Permission: ifs.command.create
- /ifs shoplayout [amount of rows] - Allows you to change how a shop looks. You can reposition all "menu items" in a fake shop-like inventory. It is a work in progress and might be buggy!
Permission: ifs.command.shoplayout
- /ifs recalcall - Recalculates and loads all shop prices. This will remove any custom set pricing!
Permission: ifs.command.recalcall
- /ifs modifyallprices [multiplier] - Modifies all shop prices based on a multiplier. (does not calculate prices again!)
Permission: ifs.command.modifyallprices
- /ifs iteminfo - Used for debugging prices stuff. Shows item info.
Permission: ifs.command.iteminfo
- /ifs convertworth - Allows you to convert all prices from Essentials worth file to prices.properties. This might help to migrate prices from essentials.
Permission: ifs.command.convertworth
- /ifs groupwhitelist [group] - Adds or removes a group from the group whitelist. (list of groups that are allowed to use the shop) - This feature and command is in beta!
Permission: ifs.command.groupwhitelist
- /ifs setdefaultprice [new default price] - Allows changing the default price (in prices.properties) for the item in your hand. (does not work for custom items!)
Permission: ifs.command.setdefaultprice
- /ifs createshopsinselection - Turns every itemframe in your WorldEdit selection into a shop.
Permission: ifs.command.createshopsinselection
- /ifs removeshopsinselection - Removes every shop in your WorldEdit selection (but keeps items and frames).
Permission: ifs.command.removeshopsinselection
- /ifs recalcshopsinselection - Recalculates prices for every shop in your WorldEdit selection.
Permission: ifs.command.recalcshopsinselection
- /ifs sellall - Sells your entire inventory at IFS calculated prices.
Permission: ifs.command.sellall
- /ifs sellhand - Sells the item in your hand using a price calculated by IFS.
Permission: ifs.command.sellhand
Typical usage
1. Create shops by right clicking an item frame while crouching.
2. Optionally set the shop prices and/or modes by using the command.
3. Click the shop to view all available options.
The plugin will display an inventory GUI like this (the layout is cutomisable!):
4. Remove shops by left clicking a frame while crouching.
Important
Permissions
- ifs.admin.remove (allows removal of shops)
- ifs.admin.create (allows creation of shops)
- ifs.user.sell (allows selling to shops)
- ifs.user.buy (allows buying from shops)
In case you want to allow players to use /ifs sellall, you need to add the command permission AND ifs.command
Minecraft versions
IFS has a very extensive manual that will help you install the correct dependencies for the correct server versions. Please make sure you see the getting started guide here: https://wwx.be/itemframeshops/docs
Plugin Conflicts
This plugin should work fine with most plugins as ItemFrameShops does not depend on any special code.