ByBlockParty 2.15.0
Party add-on that escapes, camouflages, and spawns traps!
ByBlockParty - Advanced Block Hunt Event
Are you looking for a dynamic, fully customizable event to add excitement to your server? ByBlockParty is a complete solution that takes the classic block hunt concept to the next level with traps, a point system, cosmetic effects, an admin GUI, and many more features. Create an event that will have your players eagerly waiting to log on!
Main Features
- Dynamic Event System:
- Auto-Start: Automatically start parties at set intervals (e.g., every hour) or at specific times of the day (e.g., 18:00, 22:00).
- Vote-to-Start: Thanks to the VotingPlugin integration, allow the party to start automatically when enough votes are collected.
- Manual Control: Instantly start or stop parties with commands or through the convenient admin GUI.
- Auto-Start: Automatically start parties at set intervals (e.g., every hour) or at specific times of the day (e.g., 18:00, 22:00).
- Advanced Party Mechanics:
- Block Movement & Escape: The block doesn't stay still! It keeps the hunt exciting by periodically escaping to a new location or "juking" away when a player gets too close.
- Disguise: The block can surprise players by disguising itself as a common, nearby block (like stone, dirt, etc.), making the hunt more challenging.
- Traps: Finding the block doesn't always mean victory! A trap can be triggered, flinging the player into the air, trapping them in a cage, scrambling their inventory, or applying dozens of other customizable effects.
- Block Movement & Escape: The block doesn't stay still! It keeps the hunt exciting by periodically escaping to a new location or "juking" away when a player gets too close.
- Points & Shop System:
- Vault Integration: Reward players with both points and in-game money.
- Comprehensive Point Shop (/bpshop): Create a shop where players can spend their hard-earned points. Sell single-use items (Teleportation Compass, Block Radar), permanent upgrades, or cosmetic effects!
- VIP Shop: Create a separate shop with exclusive items available only to VIP players.
- Vault Integration: Reward players with both points and in-game money.
- Customizable Cosmetics:
- Custom Win Effects: Dozens of spectacular victory effects that players can buy and select (Golden Throne, Dragon's Wrath, Cosmic Ascension, and more).
- Custom Win Messages: Allow players to announce their victory with their own unique and cool messages.
- Effect Selection Menu (/bpeffect): A modern GUI where players can view all the cosmetics they own and choose which one to activate.
- Custom Win Effects: Dozens of spectacular victory effects that players can buy and select (Golden Throne, Dragon's Wrath, Cosmic Ascension, and more).
- Full Control & Integrations:
- Admin GUI (/bpadmin): A powerful interface to manage the party, edit player points, move holograms, and more.
- DecentHolograms Support: Dynamically updated holograms for party status and leaderboards.
- PlaceholderAPI Support: Use plugin data (like %byblockparty_points%, etc.) in other plugins such as scoreboards.
- Discord Integration: Automatically send countdown, party start, and winner announcements to your Discord server.
- Admin GUI (/bpadmin): A powerful interface to manage the party, edit player points, move holograms, and more.
Installation
- Download the plugin's .jar file.
- Download the required dependencies: Vault, DecentHolograms, PlaceholderAPI. (Optional: VotingPlugin).
- Place all .jar files into your server's plugins folder.
- Start the server. The plugin will generate configuration files like config.yml, shops.yml, etc.
- Most Important Step: Log in to the game as an admin and define the party area.
- For a specific area: Use /bp zone to get the wand and select two corners.
- Or for a fixed central point: Use the /bp setlocation command.
- For a specific area: Use /bp zone to get the wand and select two corners.
- Edit config.yml and other files to your liking, then reload the settings with /bp reload. You're all set!
⌨️ Commands
Player Commands
Command Alias Description
/bptime /bpt, /partytime Shows the time until the next party.
/bpshop /bpmarket Opens the point shop.
/bp top - Lists the top-winning players.
/bp stats [player] - Shows your own or another player's stats.
/bp points - Shows your own points.
/bp points send <player> <amount> - Sends points to another player.
/bp toggle - Toggles party notifications on/off.
/bp visible - Toggles the visibility of your points in leaderboards.
/bpeffect /bpe Opens the menu to select your owned cosmetic effects.
Admin Commands
Command Description
/bpadmin Opens the main admin GUI for all management functions.
/bp start Manually starts a party.
/bp stop Instantly stops the active party.
/bp reload Reloads all configuration files.
/bp setlocation Sets a fixed central point for the party to start.
/bp zone Gives the selection wand to define the party area.
/bp points <give|take> <player> <amount> Adds or removes points from a player.
/bp tp [player] Teleports yourself or another player to the active party block.
/bpeffecttest Allows you to test your selected win effect.
⚙️ Configuration
The plugin comes with fully customizable configuration files to perfectly match your server:
- config.yml: Main plugin settings, party mechanics, traps, rewards, holograms, and all messages.
- shops.yml: Defines all items in the normal and VIP shops.
- effects.yml: Defines all cosmetic effects that appear in the /bpeffect menu.
- discord.yml: All settings for Discord webhook notifications.
► Placeholders
General & Status Placeholders
These are ideal for holograms and global announcements.
- %byblockparty_status%
- Displays: The internal status of the event (WAITING, COUNTDOWN, ACTIVE, COOLDOWN, SETUP_NEEDED). Useful for advanced integrations.
- %byblockparty_timer_formatted%
- Displays: A formatted timer that automatically changes based on the party status.
- WAITING: Shows time until the next automatic party (e.g., 25:10).
- COUNTDOWN: Shows remaining seconds (e.g., 45).
- ACTIVE: Shows time left in the party (e.g., 04:59).
- COOLDOWN: Shows time until a new party can start (e.g., 08:15).
- Displays: A formatted timer that automatically changes based on the party status.
- %byblockparty_party_name%
- Displays: The display-name of the party from config.yml.
- %byblockparty_block_name%
- Displays: The custom display-block-name of the target block from config.yml.
- %byblockparty_last_winner%
- Displays: The name of the player who won the last party.
Dynamic Hologram Line Placeholders
These "smart" placeholders make it easy to recreate the old hologram. They automatically pull the correct lines from the party.hologram.lines section of your config.yml based on the current party status.
- %byblockparty_line_1%
- %byblockparty_line_2%
- %byblockparty_line_3%
- ...and so on for each line in your config.
- Displays: The corresponding line of text for the current state (waiting, active, cooldown, etc.), with all internal placeholders like time already parsed.
Voting System Placeholders
These require VotingPlugin and for the feature to be enabled in config.yml.
- %byblockparty_current_votes%
- Displays: The current number of votes collected towards starting a party.
- %byblockparty_required_votes%
- Displays: The total number of votes required to start a party.
- %byblockparty_queued_parties%
- Displays: The number of parties waiting in the queue, triggered by vote goals being met while another party was already active.
Leaderboard Placeholders
Use these to create top player leaderboards.
The format is %byblockparty_top_[statistic]_[rank]_[info]%
- [statistic]: wins or points
- [rank]: A number from 1 to 10.
- [info]: name (player's name) or score (the value of the statistic).
- %byblockparty_top_wins_1_name% -> Name of the #1 player in wins.
- %byblockparty_top_wins_1_score% -> Score of the #1 player in wins.
- %byblockparty_top_points_3_name% -> Name of the #3 player in points.
- %byblockparty_top_points_3_score% -> Score of the #3 player in points.
Player-Specific Placeholders
Note: These placeholders will only work in plugins that can parse them for a specific player (e.g., scoreboards, player-specific menus, whispers). They will not work in a global hologram.
- %byblockparty_points%
- Displays: The viewing player's point balance. Shows "Hidden" if they've hidden their score.
- %byblockparty_wins%
- Displays: The viewing player's total number of wins.
- %byblockparty_score_visible%
- Displays: "Visible" or "Hidden", depending on the player's setting.
- %byblockparty_notifications%
- Displays: "Enabled" or "Disabled", depending on the player's notification setting.
