QuickSell
Description
QuickSell is a popular Shop Plugin, which is commonly used on Prison Servers.
It allows various Possibilities for your Players to sell Items to your Server
as well as a very lightweight Booster System which not only allows you to create
Sell Multipliers but also XP Boosters, mcMMO Boosters and much more!
IMPORTANT: I (mrCookieSlime/TheBusyBiscuit) have stopped working on this Plugin and now develop Video Games instead (more on my Youtube Channel). But this doesn't mean QuickSell is dead. This Plugin is available on GitHub, so if you are or know a talented Plugin Developer, consider contributing to it by making a Pull Request to keep this Project alive.
QuickSell v2.0 by mrCookieSlime [English]
QuickSell v1.10.10 by Koz4Christ [English]
Features
- Easy Shop Creation
- Easy Shop Management with the Ingame Editor
- Booster Creation and Management including Gem Boosters for PrisonGems or mcMMO Boosters!
- Old-Fashioned Sell-Signs with a lightweight GUI (Sell, Estimate, Cancel)
- Sell-All Signs and Command!
- Citizens Integration - Setup Merchants
- Nice Worth Overview
- and much, much more!
Sell (Basic)
The Sell-Utility can be accessed by doing /sell (Can be disabled in the Config)
or by using [Sell] Signs, this Utility opens up a GUI like this:
- Green Stained Glass: Confirms the Transaction and sells all Items inside that GUI
- Yellow Stained Glass: Gives you an estimated Worth of what you will be getting in return for these Items
- Red Stained Glass: Cancels the Transaction, you will be given back all Items
Just put all Items you want to sell into the GUI and you are done - simple as that!
Sell-All (Basic)
The Sell-All-Utility can be accessed by doing /sellall (Can be disabled in the Config)
or by using [Sell All] Signs, this Utility does not open any GUIs, instead it
scans your Inventory for any Items that could be sold to the Shop you are selling to
and sells those Items
If you are using PrisonUtils your Backpacks will also be scanned through!
Auto-Selling (Moderate)
Note that this Feature requires PrisonUtils to be installed!
The Auto-Selling-Utility can be toggled by doing /autosell
This Utility basically sells or at least attempts to sell all Blocks you mine!
You will not get a Message that this occured to prevent a spammed Chat Window.
However every X Blocks it will give you a little Summary of all recently sold Blocks.
Worth Info (Moderate)
You can access this Utility by doing /prices <Shop>
or by Left-Clicking
Sell-Signs,
Sell-All-Signs,
or NPC-Merchants
This Utility gives you a nice Overview of what Items can be sold to a certain Shop
and more importantly, for how much ;)
NPC-Merchants (Advanced)
Note that this Feature requires Citizens to be installed!
You can link any Citizens NPC to a Shop using
/quicksell linknpc <Shop> <sell/sellall>
This will make this NPC act like a Sell or a Sell-All Sign when you Right-Click him.
Addons and Extensions
- PrisonUtils by mrCookieSlime - Allows you to use Backpacks for SELL-ALL Signs and Command as well as the ability to sell as you mine
- PrisonGems by mrCookieSlime - Allows you to make Gem Boosters
- mcMMO by drtshock, t00thpick1, TfT_02 - Allows you to make mcMMO XP Boosters
- Citizens by fullwall - Allows you to setup NPC Merchants
- PickaxeSell by TOX1C - Allows you to sell all your Items upon Right-Clicking your Pickaxe
- QS Permission Boosters by MrEminent42 - Allows you to give a QuickSell Booster to Players based on their Permissions (Rank)
- QS Sell-Command Permissions by MrEminent42 - Adds a Permission to be required for /sell and /sellall
Commands/Permissions
Command | Description | Permission | ||||
/sell [Shopname] | Opens up the Inventory to sell Items | The Command itself has no permission but Shops do! Check the Config Section | ||||
/sellall [Shopname] | Allows you to sell all your Items in your Inventory to that Shop | The Command itself has no permission but Shops do! Check the Config Section | ||||
/booster <Type/all> <Name of the Player> <Multiplier> <Duration in Minutes> | Example: /booster mrCookieSlime 2 1 -> Now the whole Server has got a 2x Multiplier on every Transaction they make. You can hook it up to Buycraft in order to earn Money without violating the EULA! | QuickSell.booster | ||||
/pbooster <Type/all> <Name of the Player> <Multiplier> <Duration in Minutes> | Example: /booster mrCookieSlime 2 1 -> Now ONLY mrCookieSlime has got a 2x Multiplier on every Transaction. You can hook it up to Votifier or something.! | QuickSell.booster | ||||
/boosters | Lists all active Boosters | No Permission required. | ||||
/quicksell | Displays a Help Message | QuickSell.manage | ||||
/quicksell reload | Allows you to reload the Config | QuickSell.manage | ||||
/quicksell editor | Opens up the Ingame Shop Editor | QuickSell.manage | ||||
/quicksell stopboosters [Player] | Stops all global Boosters, add a Player argument to make it stop all private Boosters of the specified Player | quicksell.manage | ||||
/prices <Shopname> | Allows you to see which Items can be sold in the specified Shop | QuickSell.prices |
To create Signs you also need the Permission QuickSell.sign.create !
Signs
Note: All empty lines can be replaced with a text of your Choice. Example: "$32.5/ea" / "Click to open" / ...
This one will open up the Shop GUI as if you were doing /sell
This one will open the specified Shop.
This one will try to sell all your items to the specified Shop.
This one will sell all Items of the specified Type to the specified Shop.
If you have the config option "open-only-shop-with-permission" set to true, you can also just write Sell All on its own, no matter what is on the other lines. This will then open the highest Tier shop you have access to.
Configuration
options: auto-update: true ## Specify whether the Plugin should Auto-Update sell-gui-rows: 3 ## Specify how many rows the Sell-GUI has locked-item: STAINED_GLASS_PANE-14 ## The Item which will be used if the Shop is unaccessable. sign-prefix: '&7[&eSell&7]' ## The Prefix which Sell Signs will have. Changing it to e.g. "Sell Me" requires you to make the first line "Sell Me" as well in order to create a Sell Sign. sellall-sign-prefix: '&a&oSell All' ## Same rules apply for the Sell all Signs pregenerate-all-item-prices: false ## Turning this on will pregenerate all Item Values in the Config enable-menu-line: false ## Enabling the Menu line will add 3 nifty Buttons to the GUI: Sell, Estimate and Cancel enable-commands: true ## You can toggle whether /sell and /sellall can be used. boosters: extension-mode: false ## Enabling this means if you activate a 2x Booster while another 2x Booster is already active it will increase the active Booster's time instead of stacking it refresh-every: 10 ## The Interval in Seconds when it checks whether a Booster wore off commands-on-sell: ## Commands which will be executed on selling something. Supports the Variables {PLAYER} and {MONEY} - say {PLAYER} just sold something and got ${MONEY} - title {PLAYER} title {text:"+ ",color:green,bold:true,underlined:false,italic:false,strikethrough:false,obfuscated:false,extra:[{text:"${MONEY}",color:gold,bold:true,underlined:false,italic:false,strikethrough:false,obfuscated:false}]} sound: enabled: true ## Whether it should play a Sound when you sell something sound: ORB_PICKUP ## The Sound which will be played - Don't Mess with the stuff below, this is deprecated! Use /quicksell editor instead! list: - A ## Add all new Shops to this List, it will then generate a Section like the one below - '' ## Just add '' if you want to create an empty Space in the GUI to seperate your Shops shops: A: ## The Config Section of a Shop name: '&aA - Shop' ## The Name of a Shop itemtype: CHEST ## What Item will be displayed for the Shop amount: 64 ## All Prices in this Shop will be divided by this number. (Example: If you sell 1 Cobblestone for a price of $64, you will only get $1) lore: - '' - '&aYou can also add a little description to your Shop here' ## Color Codes supported! permission: QuickSell.shop.A ## The Permission required to use this Shop, set it to '' to make this shop no longer require a permission. price: ## The Prices for this Shop STONE: 0.0 ## 0.0 means its unsellable. GRASS: 10.2 ## You can specify the Amount of Money people will get per Item they sell if it has this Material STAINED_CLAY-2: 3.5 ## By attaching -{META-ID} you can set a price for items with a specific Meta-ID. DIAMOND_SWORD-&cSoulbound Sword: 100.32 ## You can also specify a Display Name with support for Color Codes C: ## Another Shop name: '&aC is awesome' ## Just some random Settings which have been explained above itemtype: SPONGE amount: 1 lore: [] permission: '' price: SPONGE: 10.0 inheritance: ## This will import all Prices from the below listed Shops. Note here: The priority of these Prices will decrease as this List goes down - A ## Has a lower priority than C - B ## Has a lower priority than A
Source Code
Check out QuickSell's Source Code, if you want to keep this Project alive, maybe even consider contributing to it by making a Pull Request!
Developer API
QuickSell allows a lightweight API for Developers to be used in order to create custom Addons for QuickSell.
QuickSell does offer a lot of Methods, however I am only going to explain some of them right here:
API Documentation
Plugin statistics
Auto-Updater and Metrics
All my Plugins are using an Auto-Updater to make sure, you're always
using the latest and hopefully most bug free version of my Plugin.
If you don't want this Plugin to be auto-updated, you can turn it off
in the config file at "options -> auto-update: true/false"
They also use a Metrics-System which collects the following Informations:
A unique identifier
The server's version of Java
Whether the server is in offline or online mode
The plugin's version
The server's version
The OS version/name and architecture
The core count for the CPU
The number of players online
The Metrics version
Opting out of this service can be done by editing
plugins/Plugin Metrics/config.yml and changing opt-out to true.
@Legend8972
... You cannot have more than 54 Shops if you are using the GUI System.
@kaublestown
It probably is something to do with vault then.
@Legend8972
Post your Config please.
@hdakhil
Work for me.
Yo Getting a bug report when i do /Sell yes CS-CORE and QuickSell are updated to their newest version http://pastebin.com/0fVueBjC
1.8 Blocks?
ok, ill see what is the error then.
edit: the plugin is still not working, I've even made a new private server to test it out without essentials and replaced it with iconomy. The results are still the same, my balanced isn't changed
@kaublestown
Well, something seems broken here though... It's not QuickSell at least.
@bry5318
Config...? If you changed the Prefix you obviously have to use the one you configured to be the header of the sign.
@TheBusyBiscuit
Signs don't work at all now. When i type sell all on the first line, the sign doesnt work. ive tried for like 45 minutes and ive tried everything
@mrCookieSlime:
Thx for replying so quickly :). Essentials and Vault are both up to date. All economy plugins work except quicksell. Plugins like simpleregionmarket and chestshop both work fine without any issues whatsoever. The signs for quicksell work, I earn $5000 selling the blocks, but my currency stays @ $0. Here is a link to the video I made.
https://www.youtube.com/watch?v=18Yy4nrc-pM&feature=youtu.be/
Here is a list of my plugins, all are updated to the latest except ezrankslite
TimTheEnchanter, AutoPickup, PlugMan, NoCheatPlus, WorldEdit, VoxelSniper, MotdManager, Buycraft, DeluxeTags, ChatColor, Vault, PlotMe, Multiverse-Core, Advanced_Item_Effects, HealthBar, PermissionsEx, MyCommand, BarAPI, CS-CoreLib, WorldGuard, CustomHelp, MineResetLite, SilkSpawners, QuickSell, CustomEnchantments, ImmortalCustom, RandomBox, ChestCommands, Lockette, Giveall, ClearLag, FirstJoinPlus, PrisonUtils, PlayerVaults, BypassSlots, HolographicDisplays, Votifier, GAListener, Essentials, SimpleRegionMarket, EssentialsProtect, ServerSigns, EssentialsSpawn, Multiverse-Portals, EZRanksLite, KitAdder, EssentialsAntiBuild, PrisonGems, EZPrestige, ChestShop, EssentialsChat
@kaublestown
Do you have Vault installed?
Maybe try updating Essentials and Vault.
So i created a sign for my mine. It works and all, selling will tell me I got how much money, but when i do /bal (for essentials), it says i have $0. How do i fix this? This is a wonderful plugin and I wish it would work perfectly.
Just wanted to tell you that EzRanksLite has got a huge recode so parts of this plugin won't work without some changes, thanks for reading :)
Cookie could you add my new plugin SellCommandPermissions to the list? It's a lightweight plugin to add permissions to /sell and /sellall.
@Nickolas211
Please use pastebin.com to show us your config. Copy and paste it into the large text box, then press submit, and give us the link your are led to. Please also do the same for the error you get.
@Mrbye
Did you use tab when you wrote the config? If so YML the config wont work. It has to be spaces even if it lines up with tab.
@mrCookieSlime hello is there a way i could send you my config file so you can check what wrong with it? I keep getting a error every time i try to sell and everything looks right
@Nickolas211
There is /quicksell reload ...
@TheBusyBiscuit
That would be great because I do not want to have to shut the prison server down each time I would like to create a new shop because we buy the items from players at 64 blocks or a stack.
@Nickolas211
Well, I was going to make the QuickSell Editor a GUI anyway, so there might be a Button for that then.
@mrCookieSlime:
Would it be something you would consider adding into the plugin?
@Nickolas211
No, you cannot edit it ingame. That has to be done in the config.