MeetupCore

The complete Meetup plugin. Automatic arenas, Kit Draft, ranked seasons, duels, parties and tournaments, on one jar from 1.7.10 to 26.3.

Why server owners choose MeetupCore

• 20 TPS, fully optimised. Arena builds, resets and database work run off the main thread or inside a strict time budget per tick.
• Every system is modular and fully configurable. Turn each part on or off in modules.yml. Every menu, hotbar, scoreboard, message, sound, timer and amount is in a file.
• Your colours, your placeholders. Hex colours and gradients (MiniMessage) in every text, PlaceholderAPI support, and 29 MeetupCore placeholders for your scoreboards, tab and holograms.
• Works with the plugins you already run. LuckPerms, Vault, PlaceholderAPI, TAB, LiteBans, AdvancedBan, EssentialsX, CMI, SuperVanish, Geyser, ViaVersion, Lunar Client, DiscordSRV, ItemsAdder, Oraxen, Nexo and more.
• Setup in five minutes. Stand in your lobby and type /meetup quickstart. The doctor checks the setup and tells you how to fix each problem.
• Developer API. Events, game data and custom scenarios, with a full example add-on.

One game, start to finish

Players join the queue and vote for the mode, the team size and the scenarios in one menu. Each player picks one of three kits in the Kit Draft. The plugin scatters the teams in a fresh arena, the border shrinks and the last team standing wins. The end screen shows the MVP, the top killers and the most damage, and one click starts the next game.

Several games run on one server at the same time, each in its own arena. New players join the waiting game with the most players.

Arenas that build themselves

MeetupCore generates a new arena for every game. You choose which map types players can vote for: Overworld, Caves, Nether, Waterless and End. Before an arena is built, MeetupCore samples several places in the new world and builds on the best one: flat ground, little water and few trees, away from oceans, rivers, mountains and swamps. A world with no good place gets a new seed, and seeds that passed are kept and reused, so a good arena is ready fast. The arena size follows the player count. Spawn points are always on safe ground, never on a tree, in water or in a wall. The next arena is built while the current game is still running.

The Caves map is not a vanilla cave system. The plugin removes the vanilla caves and carves its own cave network that joins every spawn point, under a bedrock roof. Pick the style: open caverns, tall ravines, timbered mineshafts or a classic network of rooms and tunnels.

The End map puts the fight on the main island while the ender dragon attacks. You set its health, its damage, whether it can be killed, the reward for the kill and how often it dives into the centre.

When the border shrinks, players outside it are teleported to a safe spot inside, corners included, so no one dies to a wall glitch. Prefer a moving border that hurts? Switch border.style to animated, or animated-teleport for both.

Prefer your own maps? Use a fixed world, or build an arena and mark it with the setup wand. The plugin copies it for each game and puts it back after the match.

Kits and the Kit Draft

Kits have Bronze, Silver, Gold and Legendary tiers with weighted items, so no two games are the same. In the Kit Draft, each player sees three rolled kits and picks one. Players can re-roll a set number of times each day and save their own hotbar layout. Kits can hold ItemsAdder, Oraxen and Nexo items, with a vanilla item as the fallback.

Moments that make a game

Sudden Death closes long games with a fast final border. Set scenarios that are always on (for example No Clean), with separate lists for ranked, duels and private games, and tune every scenario: TimeBomb's fuse, blast power, block damage and player damage are all options. A player on a kill streak gets a bounty, and the player who ends the streak takes the reward. After a death, the recap lists every hit, the weapon and the distance of each shot.

1.8 or modern combat

Pick a combat profile for the whole server or for each mode.

• 1.8 combat on every version: no attack cooldown, 1.8 knockback, a hit delay that you set, fishing rods and snowballs push players, no sword sweep damage, and sword blocking on 1.21.5 and newer.
• Modern combat: the normal combat of your server version.
• Custom: set each value yourself: hit delay, attack cooldown, sweeps, and every knockback value.

The server sends each push as a normal velocity change, so anticheats see vanilla movement.

Configurable team sizes

Solo, Duos, Trios and Squads. Players vote for the team size, or you fix it for each mode. Private games let a host choose the size, the mode and the scenarios for invited players.

Ranked, duels, parties and tournaments

Ranked Meetup uses Glicko-2 ratings with placement games, divisions from Coal to Netherite and a Champion top 50. Seasons reset on your schedule with rewards, rating decay and loss protection. Staff get flags for repeat opponents, win trading and players on the same address.

Duels of one round or best of three, with a rematch button. Parties get their own hotbar: invite, promote, kick, party chat, open party, party duels against another party, and party split for a free-for-all inside the party. Tournaments run single-elimination brackets for 2 to 64 players, on demand or on a schedule (for example Saturday 20:00 in your time zone), with chat reminders and /tournament next.

A lobby players stay in

A hotbar with Play, Ranked, Duels, Party, Cosmetics, Leaderboards, Settings and Profile. Mode NPCs show live player counts. Leaderboard holograms show all-time, monthly and weekly tops. Players unlock kill effects, arrow trails, win dances and titles, and complete daily and weekly quests and achievements. Each player picks their own settings and language.

Staff tools

Staff mode with vanish, and a staff sidebar that shows vanish, open reports and the player you watch. Players report with /report, and staff punish from the report menu through LiteBans, AdvancedBan or the built-in punishments. Every game has a match log, and solo games warn staff about teaming.

Made for server owners

Every menu, hotbar, scoreboard line, message, title, sound and timer is in a file. commands.yml lets you rename, alias or turn off any command. Seven languages are included (English, Spanish, German, French, Portuguese, Polish, Turkish), and each player can pick one. A wrong value never stops the plugin: the console names the file, the line and the allowed values.

Data is in SQLite with no setup. For a network, use MySQL, MariaDB, PostgreSQL or MongoDB, and move your data with one command. If the database stops, the game goes on, saves wait on disk and are written when the database is back.

Discord embeds post every game result (winner, kills, duration, mode, scenarios, top kills, replay link) and every tournament, each with its own webhook, colours, fields and text in discord.yml.

Bedrock players on Geyser and Floodgate get forms for every menu. Lunar Client players see team markers, waypoints and the border.

Performance

MeetupCore keeps your server at 20 TPS. Arena chunks load off the main thread. Arena builds, resets and terrain work share a strict time budget per tick, and builds wait in a queue so a busy server never builds too many at once.

Tested on every version

Before each release, bots play full games on PaperSpigot 1.7.10, Paper 1.8.8, Paper 1.21.11, Paper 26.3 and Folia 26.3.

Commands

Command	What it does	Permission
/play, /meetup join, /meetup leave	Play menu, join or leave the queue	everyone
/meetup vote, /meetup kit	Vote, see or re-roll the kit	everyone
/ranked, /duel, /party, /tournament	Ranked queue, duels, parties, tournaments	everyone
/stats, /profile, /meetup top	Stats, division, leaderboards	everyone
/cosmetics, /quests, /settings	Cosmetics, quests, personal settings	everyone
/meetup private	Private game for invited players	meetup.host.private
/meetup forcestart, end, games, staff	Game control and staff mode	meetup.staff.*
/meetup reports, logs	Reports with punishments, match logs	meetup.staff.*
/meetup quickstart, setup, doctor	One-command setup, checklist, doctor	meetup.admin.*
/meetup reload	Read the files again	meetup.admin.reload

The full list of commands, permissions and placeholders is in the documentation.

Questions

• Does it need a database? No. SQLite works out of the box. MySQL, MariaDB, PostgreSQL and MongoDB work for a network.
• Do I need to build arenas? No. The plugin generates a new arena for each game. You can also use your own maps.
• Does one jar work on 1.8 and on 26.3? Yes. One jar runs on PaperSpigot 1.7.10 and on Spigot, Paper, Purpur, Leaf and Folia from 1.8.8 to 26.3.
• Can I change the menus and messages? Yes. Everything is in files, with hex colours and PlaceholderAPI.
• Can I turn parts off? Yes. Every system is a module.
• Does it work for Bedrock players? Yes, with Geyser and Floodgate.
• How does the licence work? Your key arrives in a BuiltByBit message after purchase.

Support: [OWNER: Discord invite]