![Auctioneer [1.8-1.18] icon](https://images.polymart.org/product/1656/thumbnail.png?t=1&v=3)
Auctioneer [1.8-1.18] 1.2.2
A unique interactive auction event - Perfect for SkyBlock & Survival!
Auctioneer
Auctioneer is a plugin that creates an interactive auction event at certain configured times, selling a random amount of items that participants can then have bid wars over. Perfect plugin for SkyBlock & Survival!
How it works:
The auction will automatically start at times specified in the config.yml file or it can be forced to start with "/auctioneer admin start". Players can then join using "/auctioneer join" or by clicking the NPC.
Participants of the auction then may have bid wars over each of the items being sold at the auction. To place a bid, all you simply have to do is say 'bid' in chat when a new offer has been made or if you are using the menu bidding system, players just simply click the amount they would like to bid. For each bid placed, a new offer will be displayed in the chat and can be changed in the config.yml file. The last participant to place a bid will be deemed the winner and receive their reward.
The bidding menu is fully customizable in the config.yml and that includes the shape of the bid slots.
Addons:
Auctioneer has the ability to hook into both Citizens and HolographicDisplays. If you have citizens enabled, an NPC will spawn at every auction which players can right-click to join the auction and if you have HolographicDisplays enabled, editable holograms for each auction state will be displayed above the item being sold. You can configure the NPC's name and skin and also change everything displayed on the holograms in the config.yml file.
Items:
Auction items can be added using the "/auctioneer admin edit". Once you create an item, you will be able to change the item stack, add commands to the item, change whether the item stack should be given to the bid winner and change the items base cost. Items can also be modified/deleted after they have been saved.
If a player has won a bid, their item will be available to them after the auction is over by clicking it in the reward menu that pops up. The reward menu can also be opened at any time by doing "/auctioneer rewards".
Commands:
/auctioneer join - Join the current active auction
/auctioneer rewards - View/claim your auction rewards
/auctioneer admin start - Start the auction early
/auctioneer admin edit - Edit/add items sold at the auction
/auctioneer admin reload - Reload the config
/auctioneer admin end - Closes the auction early
/auctioneer admin forceStart - Forces the auction to start without having to wait for participants to join
/auctioneer admin setDisplayLocation - Set where the auctioned items should be displayed
/auctioneer admin setPlayerTeleportLocation - Set where the participants should be teleported to when joining the auction
/auctioneer admin setNPCSpawnLocation - Set where the NPC should initially spawn
/auctioneer admin setNPCTeleportLocation - Set where the NPC should teleport to once the auction starts
/auctioneer admin removeArmorStands - Remove any armor stands that you are standing on. Used in case of any buggy armor stands.
PERMISSIONS:
(these can be changed in config.yml)
/auctioneer admin - auctioneer.command.admin
/auctioneer - auctioneer.command.auctioneer
Placeholders:
Requires PlaceholderAPI to be installed on your server.
%Auctioneer_next_auction% - View the time before the next automatic auction starts
%Auctioneer_bid_item% - View the item currently being sold
%Auctioneer_starting_bid% - View the starting price of the item currently being sold
%Auctioneer_highest_bid% - View the highest bid placed on the item currently being sold
%Auctioneer_highest_bidder% - View the highest bidder for the item currently being sold
%Auctioneer_bid_end% - View how many seconds are remaining on the current item being sold
Requirements:
This plugin requires an economy plugin to work. If you want to use holograms and NPC's, please make sure that you have both Citizens and HolographicDisplays or CMI installed on your server.
Animations:
Disco Ball:
Firework Animation:
Files:
[SPOILER="config.yml"]
# Auctioneer - by RossRao
# Thanks for purchasing! <3
# What system should be used for players to place bids
# Available: MENU, CHAT
bidding-type: MENU
# What system should be used for joining the auction
# Available: MENU, COMMAND
joining-type: MENU
# Which hours of the day should the auction start
automatic-auctions-enabled: true
start-times:
- '02:00:00'
- '08:00:00'
- '14:00:00'
- '20:00:00'
# How long players have to join the auction (In minutes)
join-time: 1
no-auction: '&b[Auctioneer] &cNo auctions are running at the moment.'
# How many items should be sold at the auction?
max-items: 3
# How long players are able to bid on an item. (Resets to this time with every bid)
bid-end: 15
# Which words players can say in chat to place a bid on an item
bidding-words:
- 'bid'
- 'place bid'
- 'here'
# The % of the items base price that will be increased per bid
increment: 30
# Increase the increment as the price goes up
exponential-increment-enabled: false
default-exponential-increment: 30
# Format:
# increment: price to increase at
exponential-increments:
'50': 500000
'100': 1000000
'150': 15000000
# Distribute the total amount of money spent at the auction to the participants
distribute-enabled: false
# How much the server will take away from the total amount in %
distribute-fee: 30
distribute-message: '&3&lDISTRIBUTED! &bA total of &6%total% Auctioneer Coins &bwere distributed between %participants% Participants. You received &6%coins% Coins&b!'
# Players are reminded every x amount of minutes of when the next auction will start
reminder-enabled: true
reminder-minutes: 5
reminder: '&b[Auctioneer] &bThe next auction will start in &3%time%&b!'
admin-command-permission: 'auctioneer.command.admin'
admin-help:
- '&c&lAdmin Commands:'
- ' &c- /auctioneer admin start &7- Start the auction'
- ' &c- /auctioneer admin edit &7- Edit the items sold at the auction'
- ' &c- /auctioneer admin reload &7- Reload the config'
- ' &c- /auctioneer admin end &7- End the auction early'
- ' &c- /auctioneer admin forceStart &7- Start the auction without having to wait for other players'
- ' &c- /auctioneer admin setDisplayLocation &7- Set the location of the display item'
- ' &c- /auctioneer admin setNPCSpawnLocation &7- Set the location of where the NPC will spawn'
- ' &c- /auctioneer admin setNPCTeleportLocation &7- Set the location of where the NPC will teleport to'
- ' &c- /auctioneer admin setPlayerTeleportLocation &7- Set the location of where participants will teleport to'
- ' &c- /auctioneer admin removeArmorStands &7- Removes any armor stands where you are standing, used in case of bugged stands.'
- ''
auctioneer-command-permission: 'auctioneer.command.auctioneer'
auctioneer-help:
- '&f&lAuctioneer Commands:'
- ' &f- /auctioneer join &7- Join the current active auction'
- ' &f- /auctioneer rewards &7- View & claim your auction rewards'
- ''
# The maximum amount of players who can join the auction
max-players: 20
min-players: 1
min-players-message: '&b[Auctioneer] &cSadly there were not enough participants in order for the auction to start...'
max-players-message: '&b[Auctioneer] &cSorry, the auctions slots are currently full. Come back another time.'
# What music should be played when the auction starts?
music-enabled: true
music: 'MUSIC_DISC_STAL'
not-enough-money: '&b[Auctioneer] &cYou don''t have enough coins in order to place a bid...'
not-enough-money-sound-enabled: true
not-enough-money-sound: 'ENTITY_VILLAGER_NO'
# How much money players need in order to join the auction.
# Set to 0 to disable
join-money-requirement: 20000.00
not-enough-requirement-money: '&b[Auctioneer] &cYou don''t have enough coins in order to join the auction...'
not-enough-requirement-money-sound-enabled: true
not-enough-requirement-money-sound: 'ENTITY_VILLAGER_NO'
not-enough-inventory-space: '&b[Auctioneer] &cYou didn''t have enough inventory space to claim this item.'
auction-starting:
- '&b[Auctioneer] &bThe auction is starting right now!'
- '&b[Auctioneer] &bDo &3/auctioneer join &bto join.'
auction-starting-sound-enabled: true
auction-starting-sound: 'ENTITY_PLAYER_LEVELUP'
auction-welcome:
- '&b[Auctioneer] &bWelcome to the auction! Let''s get started.'
auction-welcome-sound-enabled: true
auction-welcome-sound: 'ENTITY_EXPERIENCE_ORB_PICKUP'
auction-instructions-enabled: false
auction-instructions:
- '&3How it works: &73 random items will be auctioned each for 15 seconds. Participants will have'
- '&7the ability to bid on all 3 of the items by saying "bid" in chat. After every bid the price'
- '&7will be increased by 40% of the items base cost and the bidding timer will be reset. The last'
- '&7person to place a bid will win the item. Now, let''s get started with the auction.'
joined-auction: '&3%player_display%&r &bhas joined the auction. &7(%participants%/%max_participants%)'
joined-sound-enabled: true
joined-sound: 'BLOCK_NOTE_BLOCK_BASS'
already-at-auction: '&b[Auctioneer] &cYou are already at the auction...'
participants-invisible: false
auction-ended: '&b[Auctioneer] &bThe auction is now over. Thanks for showing up!'
auction-ended-sound-enabled: true
auction-ended-sound: 'ENTITY_PLAYER_LEVELUP'
first-auction: '&b[Auctioneer] &bFirst up, we have a %item%&r &bfor sale. The bid will start at &6%coins% Coins&b.'
next-auction: '&b[Auctioneer] &bNext up, we have a %item%&r &bfor sale. The bid will start at &6%coins% Coins&b.'
new-auction-sound-enabled: true
new-auction-sound: 'BLOCK_NOTE_BLOCK_PLING'
auction-bid: '&e%player_display% &fplaced a bid of &6%coins% Coins &fon %item%&r.'
auction-bid-sound-enabled: true
auction-bid-sound: 'BLOCK_WOODEN_BUTTON_CLICK_ON'
no-time-left: '&b[Auctioneer] &cYou ran out of time to place a bid...'
someone-already-bid: '&b[Auctioneer] &cSomeone placed a bid before you... Wait for the next offer.'
# Toggle if players should be able to outbid themselves
outbidding-self-enabled: false
outbidding-self: '&b[Auctioneer] &cYou cannot outbid yourself.'
new-offer: '&b[Auctioneer] &bThe next offer is &6%coins% Coins&b. Who want''s it?'
new-offer-sound-enabled: true
new-offer-sound: 'ENTITY_EXPERIENCE_ORB_PICKUP'
no-offers: '&b[Auctioneer] &cNo offers have been made yet!'
countdown:
going-once: '&f&lGoing once...'
going-twice: '&f&lGoing twice...'
sound-enabled: true
sound: 'BLOCK_NOTE_BLOCK_SNARE'
no-bids: '&cNo one placed any bids on %item%...'
sold: '&f&lSold!&r %player_display%&r &bpurchased %item%&r &bfor &6%coins% Coins&b!'
sold-sound-enabled: true
sold-sound: 'ENTITY_PLAYER_LEVELUP'
# Requires HolographicDisplays to be installed on your server
holograms-enabled: true
started-hologram:
- '%item%'
- '&fStarting at: &6%starting_bid% Coins'
- ''
- '&fEnding in: &b%ending%'
- '&7(Click glass to view)'
bid-hologram:
- '%item%'
- '&fStarting at: &6%starting_bid% Coins'
- ''
- '&fHighest Bid: &6%highest_bid% Coins'
- '&fHighest Bidder: &b%highest_bidder%'
- ''
- '&fEnding in: &b%ending%'
- '&7(Click glass to view)'
no-bidders-hologram:
- '%item%'
- '&cNo one placed any bids...'
sold-hologram:
- '%item%'
- ''
- '&fWinner: &b%highest_bidder%'
- '&fCost: &6%highest_bid% Coins'
# All in seconds
# How long it takes for a new item to be sold after the previous item has been sold
new-item-time: 5
# How long it takes for a new offer to be made after a bid has been placed
new-offer-time: 3
# How long after the instructions have been sent should the auction start
auction-start-time: 5
# The permission players are required to have to join the auction
join-permission-enabled: false
join-permission: 'auctioneer.auction.join'
no-join-permission: '&b[Auctioneer] &cYou must have the &6MVP &crank in order to join the auction!'
no-permission-message: '&b[Auctioneer] &cYou do not have permission to do that!'
# Requires Citizens to be installed on your server
npc:
enabled: true
name: '&e&lAuctioneer'
skin: 'RossRao'
look-nearby: true
time-units:
days: 'd '
hours: 'h '
minutes: 'm '
seconds: 's'
soon: 'Soon...'
placeholders:
none: '&cN/A'
ended: '&cEnded!'
animations:
disco-ball-enabled: true
fireworks-enabled: true
display-menu-enabled: true
display-menu:
title: 'Auction'
rows: 4
background:
material: 'BLACK_STAINED_GLASS_PANE'
glowing: false
name: '&7'
lore: []
slots:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 11
- 12
- 14
- 15
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 23
- 24
- 25
- 26
- 27
- 28
- 29
- 30
- 32
- 33
- 34
- 35
close:
material: 'BARRIER'
glowing: false
name: '&cClose Menu'
lore: []
slot: 31
display-item:
slot: 13
reward-claimed: '&b[Auctioneer] &bYou claimed your %item%&r &breward!'
reward-menu:
title: 'Collect your rewards!'
rows: 6
background:
material: 'BLACK_STAINED_GLASS_PANE'
glowing: false
name: '&7'
lore: []
slots:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 17
- 18
- 26
- 27
- 35
- 36
- 44
- 45
- 46
- 47
- 50
- 51
- 52
- 53
close:
material: 'BARRIER'
glowing: false
name: '&cClose Menu'
lore: []
slot: 49
collect-item:
lore-addon:
- '&8-----------------'
- '&bClick to claim reward!'
claim-all:
material: 'CAULDRON'
glowing: false
name: '&3Claim all rewards!'
lore: []
slot: 48
bid-menu:
title: 'Auction'
rows: 6
bid-slots:
- 0
- 9
- 10
- 11
- 12
- 13
- 14
- 15
- 16
- 17
- 26
- 35
- 34
- 33
- 32
- 31
- 30
- 29
- 28
- 27
- 36
- 45
- 46
- 47
- 48
- 49
- 50
- 51
- 52
- 53
background:
material: 'BLACK_STAINED_GLASS_PANE'
glowing: false
name: '&7'
lore: []
slots:
- 1
- 2
- 3
- 6
- 7
- 8
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 37
- 38
- 39
- 40
- 41
- 42
- 43
- 44
place-bid:
material: 'GOLD_INGOT'
glowing: false
name: '&6Bid %amount% Coins'
lore:
- '&bClick to place bid!'
bid-placed:
material: 'PLAYER_HEAD'
use-bidders-head: true
glowing: false
name: '&6Bid Placed by %player_display%'
lore:
- '&b%player_display% &bplaced a'
- '&bbid of &6%amount% Coins&b!'
bid-skipped:
material: 'BARRIER'
glowing: false
name: '&cBid Skipped'
lore:
- '&cThis bid amount has been skipped.'
timer:
material: 'CLOCK'
glowing: false
name: '&f&lTime Remaining:&r &b%end%'
lore: []
slot: 5
display-item:
slot: 4
joining-menu:
title: 'Auctioneer'
rows: 4
join-item-slot: 15
background:
material: 'BLACK_STAINED_GLASS_PANE'
glowing: false
name: '&7'
lore: []
slots:
- 0
- 1
- 2
- 3
- 4
- 5
- 6
- 7
- 8
- 9
- 10
- 12
- 13
- 14
- 16
- 17
- 18
- 19
- 20
- 21
- 22
- 23
- 24
- 25
- 26
- 27
- 28
- 28
- 29
- 30
- 32
- 33
- 34
- 35
information:
material: 'BOOK'
glowing: false
name: '&f&lAuction Information'
lore:
- '&7Players can purchase exclusive items'
- '&7from the auction, however, they will'
- '&7only open every few hours.'
- ''
- '&fStarting in: &b%timer%'
- '&fEntry Cost: &6%entry_cost% Coins'
- ''
slot: 11
close:
material: 'BARRIER'
glowing: false
name: '&cClose Menu'
lore: []
slot: 31
no-active-auction:
material: 'BEDROCK'
glowing: false
name: '&c&lNo Active Auction'
lore:
- '&7The auction isn''t open at the moment,'
- '&7check back in &b%timer%&7!'
no-join-permission:
material: 'BARRIER'
glowing: false
name: '&c&lLocked'
lore:
- '&7You need the &6MVP Rank &7in order'
- '&7to join the auction!'
- ''
- '&fBuy &6MVP &f@ &bstore.example.com'
already-at-auction:
material: 'COAL'
glowing: false
name: '&c&lAlready at the Auction'
lore:
- '&7You are already at the auction!'
not-enough-money:
material: 'GOLD_NUGGET'
glowing: false
name: '&c&lNot Enough Coins'
lore:
- '&cYou don''t have enough coins in'
- '&corder to join the auction!'
- ''
- '&fRequired Coins: &6%entry_cost% Coins'
join-auction:
material: 'EMERALD'
glowing: true
name: '&bJoin Auction'
lore:
- '&bClick to join the auction!'
config-version: 1.7
[/SPOILER]
API:
Hook into this plugin and listen for certain Auction Events!
[SPOILER="API Guide"]
Events:
AuctionStartEvent
AuctionEndEvent
AuctionJoinEvent
Methods:
AuctioneerAPI.getAuctionItem(reward-id);
This will return a reward from the data file allowing you to get the item, get the commands, get the base cost, etc.
AuctioneerAPI.getNextAuctionTime();
Get the next time an Auction will start. (String)
AuctioneerAPI.forceStartAuction();
Skip having to wait for players in order for the Auction to start.
AuctioneerAPI.startAuction();
Open the Auction for players to join.
AuctioneerAPI.endActiveAuction();
End the current active auction
[/SPOILER]
Terms and Conditions:
By buying this resource you agree that you have read and accepted
the following terms and conditions:
RossRao holds all rights to the products.
Decompiling this plugin is not allowed.
You are not allowed to distribute this product in any way.
Illegal distribution can lead to legal action being taken.
Refunds are allowed only if both sides (RossRao & buyer) agree that the reason for the refund is good enough.
The price of this plugin can change for new buyers.
This can be either through sales or an increase in prices due to new features.
Hook into this plugin and listen for certain Auction Events!
[SPOILER="API Guide"]
Events:
AuctionStartEvent
AuctionEndEvent
AuctionJoinEvent
Methods:
AuctioneerAPI.getAuctionItem(reward-id);
This will return a reward from the data file allowing you to get the item, get the commands, get the base cost, etc.
AuctioneerAPI.getNextAuctionTime();
Get the next time an Auction will start. (String)
AuctioneerAPI.forceStartAuction();
Skip having to wait for players in order for the Auction to start.
AuctioneerAPI.startAuction();
Open the Auction for players to join.
AuctioneerAPI.endActiveAuction();
End the current active auction
[/SPOILER]
Terms and Conditions:
By buying this resource you agree that you have read and accepted
the following terms and conditions:
RossRao holds all rights to the products.
Decompiling this plugin is not allowed.
You are not allowed to distribute this product in any way.
Illegal distribution can lead to legal action being taken.
Refunds are allowed only if both sides (RossRao & buyer) agree that the reason for the refund is good enough.
The price of this plugin can change for new buyers.
This can be either through sales or an increase in prices due to new features.
If you enjoy this resource, please consider liking it or even dropping a rating, it'd be very appreciated. Thank you! ❤️
