LobbyGames [1.8.x-1.21.x] ✅ High Quality Minigames ✅ 100% Customizable ⭕ 10% OFF SALE icon

LobbyGames [1.8.x-1.21.x] ✅ High Quality Minigames ✅ 100% Customizable ⭕ 10% OFF SALE -----

Create Pool Tables, Soccer / Football, Connect 4, Snake, 2048, Minesweeper, Tic Tac Toe, and more!




- Added a simple afk timer that will kick a player from the lobby game (same as them doing /lg quit) after a certain number of seconds of no motion
- Players can now double-tap the space bar to get the boost jump on soccer (if the boost jump is enabled). This is the same as clicking the item.
- Players can now boost jump in soccer before the game starts

This update adds the following lines to the config:
Code (Text):
afk-kick-seconds: 90 #simple afk check if player does not move for too long. Set to -1 to disable
afk-kick-msg: "&cYou were kicked from %game% for being afk!"
----------, Dec 19, 2024

- Added 2 new placeholders for PAPI:
%lobbygames_<game>_<arenaId>_playercount% Gives the number of players in a particular game's arena
%lobbygames_<game>_playercount% Gives the number of players in any arena for a particular game
----------, Dec 9, 2024

- Fixed a bug in Connect 4 where particles caused an error in servers running any Minecraft version before 1.13 (legacy versions).
----------, Dec 4, 2024

- Adjusted the priority of particular LobbyGames events to allow for compatibility with plugins that check the player's inventory when they log out of the server. If they log out while playing a lobby game, the other plugins should see the player's normal inventory and not the inventory given from the lobby game.
----------, Nov 30, 2024

- Fixed a bug where particles in Connect4 could be created incorrectly depending on the rotation of the arena.
----------, Nov 28, 2024

- Added particles to Connect 4! These can optionally be disabled by setting connect4.particles-enabled: false in the config. For servers using Geyser where players can't see the armor stands, you can add connect4.increased-particles: true so that the particles are enough to fully substitute the armor stands.
- Fixed a bug where leaderboards may have failed for multiplayer games (such as pool, spleef, etc.) if merge-leaderboard-scores was set to false

This update adds the following lines to the config:
Code (Text):
connect4: #add the indented lines to the connect4 section
  particles-enabled: true
  increased-particles: false
----------, Nov 28, 2024

- Fixed a bug where in some conditions, the spleef.melting-snow-standing-delay config entry did nothing to change the delay between when a player walks over a block and when the block melts in Spleef. This entry can be added to the config if necessary, the units are seconds.
----------, Nov 15, 2024

- Added the option "spectators-enabled: true" to the spleef section of the config. If set to false, the old functionality will be used, where a player is teleported out of an arena if they are not in the game that is running.
- Changed the placeholders in the pool.pocketed-balls message to use %solids_pocketed% and %stripes_pocketed% to make it more clear. The old placeholders will still work as well, so no need to change your current config file.
----------, Nov 8, 2024

- Fixed a bug where players could fly in from the top of a soccer / football arena and be incorrectly placed into spectator mode when the game started
- Made it so that it is guaranteed that there will always be 1 solid ball and 1 striped ball on the back 2 corners of the triangle in 8-ball pool. All irl pool rules on ball placement should be satisfied now.
- Fixed a bug where the /connect4 command was not registered.
- Updated the ability to fully disable spectator mode in soccer by adding " spectators-enabled: false" to the soccer section of the config. This will allow for more fine-grained control to disable spectators without disabling soccer proximity joining.
- Added a protection to check that the world name is valid before loading a leaderboard in it.
----------, Oct 30, 2024

- You can now add carpets-enabled: false under the pool section of the config to disable the pool table hole armor stands if needed. This might be helpful if you are using a custom texture pack or map to emulate a pool table surface.
- Made it so that pool will work with barrier blocks (instead of the usual wool or other solid blocks) for the table, allowing for use of plugins such as Dexterity to make a more realistic table out of block displays.
----------, Oct 28, 2024

- Fixed a bug with 2048 where particular rotations of a rectangular arena (where width is not equal to height) were rotated 90 degrees when the bounds of the arena were processed by the game engine
- Added a validation step in setting up an arena. For games like 2048 or snake where it matters that the first location is the lower-left relative to the player (defining the edge of the "screen" of the game), it will now check that this is the case based on the spawnpoint's yaw. This should make it easier to set up an arena without needing intuition of the format.
----------, Oct 27, 2024

- Added protections for soccer / football to prevent obvious auto-clickers from affecting the game. There could still be autoclickers, but they will not have any significant advantage over normal players.
----------, Oct 19, 2024

- Fixed a bug in soccer / football where spectators were able to fly outside of the arena once the game ended.
----------, Oct 14, 2024

- The 6 holes around the pool table will now have particles appearing in them! If you'd like to disable this, add "particles-enabled: false" to the pool section of the config. This feature also enables geyser players to have an indication of where the holes are, since geyser does not support items in the armor stand's head slot.
----------, Oct 12, 2024

- Added a small optimization to multiplayer games that checks if the player is in the same world as the arena for most event listeners.
----------, Oct 8, 2024

- Fixed a small bug where upon exiting a spleef arena, if you could fly before it remained disabled. It will now reset the player's /fly ability to what it was before entering the arena.
----------, Oct 1, 2024

- Fixed a bug that was happening in spleef as of v1.7.0 where the first player to join the arena did not get their inventory back after the game.
----------, Sep 26, 2024

- Added the ability to disable spleef proximity joining. To disable, add "spleef.proximity-joining: false" to the config.
- Added the ability to change the timeout before the 2x2 blocks under a player's feet disappear when the snow is melting in spleef. To change it, add "spleef.melting-snow-standing-delay: 0.8" to the config. The units are in seconds, the default is 0.8. This update is only intended for compatibility with other plugins - when snow is melting, the idea is that players can not stop moving, so only change this if you are sure you want to change the game design.

This update adds the following to the config:
Code (Text):
spleef: #add this to the spleef section, don't create a duplicate section
  #<other spleef settings>
  proximity-joining: true
  melting-snow-standing-delay: 0.8
----------, Sep 24, 2024

- Added spectators to spleef! Similar to soccer, if a spleef game is running and a player walks into the arena, they will be made invisible and allowed to fly until they leave the arena.
- Fixed a bug in spleef where the remaining player count was off by 1
- By doing /lg join spleef, you will now be teleported to the center of the spleef arena rather than the spleef spawn.
----------, Sep 23, 2024

- Players can no longer attack other players or mobs while playing a lobbygame. They also cannot be attacked while in the game or otherwise lose health until they leave the game.
----------, Sep 16, 2024

- Changed the priority for pvp events, such as when players take damage to allow other plugins such as WorldGuard to un-cancel them if necessary.
----------, Sep 14, 2024

- Added a cooldown for the quit arrow item of approximately 1 second after joining. In the case that a player is using the 9th item slot and clicks an NPC to join, this will prevent them from immediately quitting.
- If the game is not yet started, API functions Game#getPlayTime() will now return "0m 0s" and Game#getDuration() will return the number of seconds since the game was first initialized. Nothing has changed for if the game is already active/started.
----------, Sep 12, 2024

- Fixed the plugin permissions list so that it will show all permissions in a LuckPerms editor for example.
- Added comments in the config.yml for soccer's game-max-time entry that explain how to use the %timer% placeholder, for example in the action bar entry.
----------, Sep 9, 2024

- Added an option in the config to let soccer win after a set period of time instead of after a certain number of goals are reached. To enable this option, the soccer.game-max-time must be set to a positive number of seconds, it will then ignore the soccer.point-win-threshold entry. You can use the new %timer% placeholder in the soccer messages, such as in the action bar.

This adds the following lines to the config:
Code (Text):
soccer: #add the following to the soccer section
  game-max-time: -1 #Units of seconds. If this is set, the game will end on the timer INSTEAD of when the point-win-threshold is reached.
----------, Sep 7, 2024

- Added an ability to change the action bar shown in soccer/football when the game is active
- Fixed a small bug where where after a player's armor was temporarily cleared when they clicked the arrow to quit but before they confirm

This update adds the following to the config:
Code (Text):
soccer: #add the indented line to the soccer section with indent
  action-bar: "%score%"
----------, Sep 3, 2024

- If you have plugin conflicts with CMI or otherwise are using PlaceholderAPI to create the leaderboard holograms, you can add the line 'disable-holograms: true' to the config to disable the ones created by LobbyGames
- The /lgjoinplayer command will now tab-complete the game name.
----------, Aug 25, 2024

- Added the config entry 'snake.action-bar' to allow a way to show the score during a snake game
- Changed the error-no-arenas-available config message to clarify that no arenas are open, not that none are set up.
- Made small changes to config comments to be more clarifying

This update adds the following line to the config:
Code (Text):
snake.action-bar: "&b%score% Apple(s)"
You can add the line to the 'snake' section of the config with indenting before the 'action-bar' text.
----------, Aug 22, 2024

- Added a way to specify a command to run per-player for the winning team in a soccer game. This way, the regular console-command-on-end config entry will run once (such as to broadcast), and the console-command-on-end-per-player will run per player (such as to award currency).
- Added the /lg leaderboard clearplayer <player> <game> command. This will clear a specific player's entries off of a specific game type's leaderboard.

The following lines were added to the config:
Code (Text):
soccer:
  console-command-on-end-per-player: "" #Runs once for each player on winning team. Example: "eco give %player% 25"
 
----------, Aug 13, 2024

- Fixed a bug that was causing eliminated spleef players to see messages twice
- Added a protection that, when loading an arena, checks that the world it is in is valid. If it is not valid, a warning will be shown in the console. This can happen if the world was renamed while the server was offline.
----------, Aug 10, 2024

- Added 'wager-cost' as an entry under each game in the config to set an amount that will be take from the player's balance upon joining. Recommended to only use this for wagering, where there is a custom reward that is greater than the cost if they win. This feature will require Vault.
- Added configurable messages for errors such as when a player tries to join an arena that does not exist or is in the wrong world.
- Fixed a bug where armor stands were cleared that weren't inside the defined arena space when a game resets

This version adds the following lines to the config:
Code (Text):
error-arena-not-exist: "&4Error: &cThis arena does not exist!"
error-wrong-world: "&4Error: &cYou cannot access this arena from this world!"
not-enough-balance: "&cThis game costs $%cost% to play!"

connect4:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
minesweeper:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
pool:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
soccer:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
spleef:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
sudoku:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
tictactoe:
    wager-cost: 0 #requires Vault, make sure to set an 'eco give' command in console-command-on-end for %winner%
 
Make sure to combine the wager-cost lines with their respective game sections!
----------, Aug 6, 2024

- Added a config setting 'return-to-game-spawn' that, when set to false, will teleport a player back to their previous location when the game ends or they quit.
- On spleef and soccer, players will no longer be teleported to the spawn when they walk out of the arena naturally.

The following line was added to the config:
Code (Text):
return-to-game-spawn: true #if false, player is teleported to where they were standing before starting the game
----------, Jul 30, 2024

- Added a PAPI placeholder for arena status. The placeholder is %lobbygames_<game>_<arenaId>_status%

The following line was added to the config:
Code (Text):
status-translate: "Open, Waiting, In Use" #Default (keep the commas): "Open, Waiting, In Use"
----------, Jul 22, 2024

- Fixed a plugin confliction where other plugins could un-cancel inventory events and allow players to modify their inventories while in a game.
----------, Jul 15, 2024

- Added a %time% placeholder to the clicker score (clicker.score-format) that shows the time the player has spent in the game
- Added a %remaining% placeholder to the clicker score to show how many blocks are remaining before the game ends.
----------, Jul 11, 2024

- Fixed an error that was causing problems with setting the item metadata in the armor stands that create the minesweeper flags on servers that don't use ViaVersion
- Fixed a console error that sometimes occurred when the plugin disabled.
----------, Jul 2, 2024

- Fixed a bug where in some cases the plugin initialized legacy material support on non-legacy server versions. It will only use legacy materials if the server it is running on is a legacy Minecraft version.
----------, Jul 1, 2024

- Players will now automatically have flight disabled when entering a soccer/football or spleef arena. If your server has commands that allow them to turn it back on, make sure to add these to the blocked command list in the config so they can't be used in the game.
----------, Jun 24, 2024

- The pool ball menu GUI will now show the live-time information of what balls are sunk. It will automatically update if a player is looking at it while a ball is pocketed.
----------, Jun 23, 2024

- Added the ability for players to spectate a soccer game! All they have to do is step into the arena while a game is active.
- Added the SpectatorJoinLobbyGameEvent and SpectatorLeaveLobbyGameEvent classes to the API.
- Fixed a small bug in soccer where it would sometimes end too early when a player on a team of 2 quit the game.
----------, Jun 19, 2024

- Recompiled in java 8 for compatibility with older versions of spigot.
----------, Jun 11, 2024

- The PlaceholderAPI placeholders will now send a more helpful error message if there is a typo in the game parameter.
- Fixed a small console error that happens when the plugin is disabled after the jar file is altered on a running server.
----------, Jun 9, 2024

- Added a line in the config to change the material of the item that players click to exit a game.

This update adds the following line to the config:
Code (Text):
quit-item-material: "ARROW"
----------, Jun 1, 2024

- The plugin will now send an error message instead of the typical "-" string if a PAPI placeholder is called for a leader board that does not exist.
----------, May 27, 2024

- Fixed a bug where the default shot power/strength was used in practice mode instead of what the player selected.
- When exiting practice mode, the game will no longer reset a player's power selection to the default.
----------, May 26, 2024

- Added the static function LobbyGames.getInstance(). This is an easier and more beginner-friendly way of accessing the class that holds most of the API functions. More details about the API are on the wiki.
----------, May 23, 2024

- Fixed a bug that was occurring on servers running legacy Minecraft versions in which event listeners would fail to load.
----------, May 16, 2024

- Players will no longer be able to pick items up from the ground while joined in any lobby game.
----------, May 15, 2024

- Fixed a bug that was occurring on servers running legacy versions (<1.13) where the inventory was not updated after quitting a game.
----------, May 11, 2024

- Added the ability for armor stands to be rendered specifically for 1.8 clients. Since armor stands are rendered differently for players using these legacy versions, servers that expect all players to be on 1.8 can add "legacy-mode: true" to the config.
----------, May 10, 2024

- Fixed errors that were occurring in servers running 1.8 from the armor stand spawn update. The visual improvements are unfortunately not possible to implement in 1.8 because this feature does not exist in legacy versions.
- Altered the way that the 2048 score is displayed for legacy Minecraft versions (< 1.13) so that it does not cause spam for the player.
----------, May 1, 2024

- For Minecraft versions 1.13+, the plugin will now process part of the armor stand metadata spawning before it is shown to the player. This greatly improves the visual quality of all of the games that use armor stands.
----------, Apr 30, 2024

- Added a small update to allow use of the /lg reload command through the console.
----------, Apr 29, 2024

- Fixed a bug that was causing a confliction with inventory management systems when a player joined an arena from a different world.
- Increased the priority of lobbygames inventory management events to minimize the chances of conflictions with alternative/untested inventory management plugins
----------, Apr 26, 2024

- If a player enters a spleef arena, any passenger players who are sitting on them will be dismounted.
----------, Apr 16, 2024

- The /lg command will now auto-complete the list of games after typing in "/lg leaderboard <create|clear|delete>"
----------, Apr 13, 2024

- Removed the "using-per-world-inventory" option from the configuration file because it is no longer needed. The LobbyGames inventory management now works the same whether or not you are using Multiverse Inventories.
----------, Apr 8, 2024

- Changed the mechanics for how the soccer / football ball works, it no longer uses an invisible armor stand.
- Soccer will now remove any slime entities from the arena when the game starts, if there are any.
----------, Apr 6, 2024

- Added a feature that forces the player to have their original inventory returned if they are teleported to a different world while playing a game. This should fix the confliction that may arise with recent versions of Multiverse-Inventories.
----------, Mar 31, 2024

- Fixed a bug that was ending a spleef game when there were still 2 players left in cases in which the game started with 3 or more players.
- Players will now have flames extinguished when they are eliminated from spleef.
----------, Mar 31, 2024

- Fixed a small bug that occasionally allowed the boost jump in soccer/football to be used with a left click when the player otherwise intended to hit the ball.
----------, Mar 30, 2024

- Fixed a formatting bug where particular admin messages and colored join sign lines were not rendered correctly.
----------, Mar 26, 2024

- Made a small UX improvement to have the plugin work with signs that say [JOIN] even if the join-sign-text entry in the config is set to something different.
----------, Mar 26, 2024

- Fixed a bug in which a team did not win in soccer when the last player in the opposing team left the game.
- Added offset to the soccer ball to prevent it from sinking into the ground when rendered by particular minecraft clients.
----------, Mar 24, 2024

- The plugin will now return "[Unknown Placeholder]" if parsing a LobbyGames PlaceholderAPI placeholder that is not on the list.
----------, Mar 12, 2024

- Fixed a small bug that was making the soccer ball hover slightly above the ground when not in motion.
- Fixed a small bug that allowed players to modify the 2048 tile armor stands if a world protection plugin is not present
- Fixed a small bug that was removing the soccer ball twice when a goal is made.
----------, Mar 10, 2024

- If a player is waiting for an opponent in pool but has the quit confirmation menu open, when the 2nd player joins and the game starts, the menu will now close automatically.
- Fixed a small bug where the pool quit confirmation menu's red block would be interpreted as the hit strength selector.
----------, Mar 8, 2024

- Fixed a bug that was causing global leaderboards for multiplayer games to not display the most updated information unless the plugin was reloaded.
----------, Mar 6, 2024

- Updated the /lg help command to show details about /lg leaderboard and /lg reload commands.
----------, Mar 4, 2024

- Extended the radius in which the plugin will play the particle effects while an administrator is creating an arena. The limit exists to prevent lag.
----------, Feb 27, 2024

- If MySQL is enabled and the data has not been imported before, the data from player_stats.yml will now be automatically inserted into the database. It will then use MySQL instead of player_stats.yml as long as it is enabled.
----------, Feb 26, 2024

- Added a way to hook LobbyGames into MySQL! The plugin will create and manage a table named "lobbygames_stats" to keep track of the same information that was previously kept in player_stats.yml.
If MySQL is enabled, the plugin will not use the player_stats.yml file at all. If MySQL is disabled (default), the plugin will save player stats in the same way that it did before.
- Reading and writing operations regarding player statistics will now be done asynchronously whenever possible. The data is cached in the same way.

This update adds the following lines to the config.yml:
Code (Text):
mysql:
  enabled: false
  username: "username"
  password: "password"
  host: "localhost:3306"
  name: "database"
The MySQL user will need permissions to Create, Select, Insert, and Update on the "lobbygames_stats" table.
----------, Feb 25, 2024

- Changed the default value for the boost jump item in soccer / football to make it more clear that it needs to be right-clicked (instead of left-clicked).
----------, Feb 19, 2024

- Added a new feature in which players can select the team they want to join for soccer/football. When the game starts, undecided players will be assigned to whichever team has less players. If the teams are still unbalanced, it will randomly switch some players to the smaller team.
- Fixed a bug where the soccer ball was not removed, leaving behind a raw slime for when the plugin is reloaded while a soccer game is active.
- Fixed a bug in which the soccer ball becomes a raw slime if the game start countdown is cancelled.
- Fixed a minor console error that sometimes occurred when a soccer game finishes.

This update adds 2 lines to the config.yml:
Code (Text):
soccer:
    team1-join-title: "&bJoin blue team &7(Right-click)"
    team2-join-title: "&cJoin red team &7(Right-click)"
 
----------, Feb 18, 2024

- Added a new feature in which players can select the team they want to join for soccer/football. When the game starts, undecided players will be assigned to whichever team has less players. If the teams are still unbalanced, it will randomly switch some players to the smaller team.
- Fixed a bug where the soccer ball was not removed, leaving behind a raw slime for when the plugin is reloaded while a soccer game is active.
- Fixed a minor console error that sometimes occurred when a soccer game finishes.
----------, Feb 18, 2024

- Added a check in the /lg leaderboard create functionality to ensure that a leaderboard does not already exist in the location where a new leaderboard is being created.
----------, Feb 14, 2024

- When using /lg leaderboard create, the new leaderboard will now be created with the same entries on it as all of the other global leaderboards for the game type.
----------, Feb 12, 2024

- Added the PlaceholderAPI placeholder %lobbygames_<game>_<arenaId>_score%. If the game keeps track of a numerical score, this can be used to display it, and is specific to an arena id instead of a player. For example %lobbygames_soccer_2_score% would show the score of the 2nd soccer/football arena if there is an active game.
- The soccer/football jump boost feather will no longer activate on left click, just right-click while holding it. This is so that players do not have to constantly switch item slots while playing the game.
- Added a function Game#getScore() to the API. Unlike the previous function Game#getScore(Player), this is not specific to any player. The old function will not be deprecated because a player argument is still needed in games like Pool, but the 2 functions will return the same thing for all other scored games.
----------, Feb 10, 2024

- Fixed a bug in which players could fly over an active soccer (football) arena and be added to the game as a player. This should fix related inventory management interference.
----------, Feb 4, 2024

- Fixed a small bug in which [JOIN] signs were case-sensitive when they shouldn't be. The configurable game alias can be used on the join signs.
----------, Feb 1, 2024

- Fixed a bug relating to colored text on clickable join signs in which the color character is different on some servers or with ProtocolLib.
----------, Jan 30, 2024

- The player's gamemode will now be set to Survival while they are in a Sudoku arena. Just like their inventory, their gamemode will be set back to what it was prior when they leave the arena.
- Added the config entry minesweeper.wand-title, to allow for translation of the blaze rod item in minesweeper.
Code (Text):
minesweeper:
  wand-title: "&c&lSet Flag"
----------, Jan 28, 2024

- Added retro-compatibility with an old version of the config in which the "yes-text" entry used to be named as "yes," and same for the "no-text" entry in the current config.
----------, Jan 28, 2024

- The clickable [JOIN] signs now support color codes! Note that the plugin does not facilitate the creation of these signs, it is only for compatibility with other plugins that add colors to signs, such as Essentials.
- Fixed a small bug that made admins join the game when breaking a join sign.
----------, Jan 22, 2024

- All multiplayer games (Pool, Spleef, Soccer/Football, TicTacToe, Connect 4) now have global leaderboard support! It will track the number of wins for each player. Local leaderboards for these games will be released shortly in another update. You can create a global leaderboard with "/lg leaderboard create <game>"

- Fixed a critical bug in Spleef that prevented the game from ending in some cases.
----------, Jan 17, 2024

- Added comments in the config.yml to explain what the game-alias line does. The game alias is an alternative or translatable name for a game, which the plugin can use in /lg join, clickable signs, etc.
----------, Jan 16, 2024

- The plugin will now remove global leaderboards upon being disabled (such as when the server stops or a plugin manager disables the plugin). This should also fix a bug where duplicate holograms were occasionally seen.
----------, Jan 13, 2024

- Increased the radius at which armor stands are removed by the plugin when it refreshes a leaderboard, in case old leaderboards exist from a server crash.
Scoreboard Leader board champion ranking holograms automatic
----------, Jan 10, 2024

- Added a new item to the Pool menu that allows players to select how much strength to hit the cue ball with. There are 4 speed levels, the "High Power" level matches the old cue ball strength.
This item will also change into wool or terracotta when the ball sides are assigned in 2-player pool.

This update adds the following line to the config:
Code (Text):
pool:
  translatable-power-words: "&aLow Power, &eMedium Power, &6High Power, &cHighest Power"
 
Game Strength Customize Potion Server
----------, Jan 8, 2024

- Modified the GameEndEvent event so that its getPlayers() function shows all of the players in the game (instead of just the winner) in the case of multiplayer games. Previously the plugin was designed for PlayerQuitLobbyGameEvent to be used, but it is more intuitive to use GameEndEvent in some cases.
Keywords: Roleplay RP Lobby Game API Player
----------, Jan 6, 2024

- Added the placeholder %lobbygames_<game>_leaderboard_line<number>_rawscore% that returns the raw (integer) score from a line. For example, "1m 22s" on minesweeper would return "82" seconds.
----------, Jan 4, 2024

- Added the following PlaceholderAPI placeholders:
%lobbygames_<game>_leaderboard_line<number>_player%
%lobbygames_<game>_leaderboard_line<number>_score%

It is now possible to get raw data from the leaderboard lines with PAPI. Like all other leaderboard placeholders, there must be at least 1 global leaderboard set up for this data to be tracked by the plugin.
----------, Jan 2, 2024

- Added a small fix that prevents the Pool ball collision calculation from producing a negative direction.
----------, Dec 29, 2023

- Fixed a bug that was preventing player inventories from being returned when the plugin is disabled or reloaded.
----------, Dec 26, 2023

- Added an option in the config "pool.cue-blaze-rod" that, when set to true, will set the pool cue as a blaze rod (instead of a stick). This creates an alternative if there are conflicting plugins.
----------, Dec 22, 2023

- To set an arena location while creating a lobby, you can now left-click a block with a blaze rod to set a location. Previously it would set the location any time you click any block, but this does not allow for small changes to the map to be able to reach the needed block.
----------, Dec 21, 2023

- Added the clarification that /lg set leaderboard sets a local scoreboard that is specific to the arena. (Use /lg leaderboard create <game> to make a global leaderboard).
----------, Dec 19, 2023

- Fixed a bug that was causing the billiard balls to be incorrectly placed for 4 block wide pool tables oriented on the x axis.
----------, Dec 13, 2023

- Changed an aspect of how the jar file is compiled to allow for servers running Java 8 and up to use the plugin.
----------, Dec 12, 2023

- Added the ability for admins to left click a block to set an arena coordinate instead of using /lg set when creating a new arena. This makes it easier to select corners of arenas in confined spaces without first removing blocks.
----------, Dec 11, 2023


- When creating a new arena, if it is the first arena in the game (arena id = 1), the message will no longer show the arena id in the command to admins.
----------, Nov 27, 2023

- Fixed a bug that made the pool cue ball occasionally disappear when placed anywhere on the pool table.
----------, Nov 26, 2023

- Added placeholder parsing to the configurable console commands, allowing admins to use math placeholders.
- Fixed a console error that would fire when an arena is deleted that had an incorrect configuration.
----------, Nov 23, 2023

- Added the alias /minigames to the /lobbygames command. This alias can be overridden by other plugins if already in use.
----------, Nov 22, 2023

- Fixed a bug that was causing the quit arrow item in Minesweeper to not work when clicked.
----------, Nov 21, 2023

- Added the entry "pool.redo-break" for when a player doesn't get enough balls to hit the sides of the pool table on the first round.
----------, Nov 17, 2023

- Fixed a bug that was preventing the 2nd player in TicTacToe from getting the quit option in their hotbar.
- Changed the minimum number of balls to be pocketed in pool from 7 to 5 for the game to award a player a win in their statistics.
----------, Nov 13, 2023

- Fixed a small error that occasionally appeared in the console while playing Pool.
----------, Nov 9, 2023

- Changed the default value for the "merge-leaderboard-scores" to false, as this is more intuitive for how leaderboards function.
----------, Nov 6, 2023

- Fixed a bug that was making it impossible for 2 players to join pool
- Fixed a bug that was sending the wrong player in PlayerJoinLobbyGameEvent and PlayerQuitLobbyGameEvent in the API.
- Soccer's GameWinEvent will now send the team's score in the API
----------, Nov 5, 2023

- Added getDuration() to the Game class to show the number of seconds since start.
- Added getDuration() to the custom event classes
----------, Nov 3, 2023

Made the following changes to the backend:
- Moved the custom events classes to the package me.c7dev.lobbygames.api.events. You must update your class paths if you were previously using these events. No future package changes are planned.
- Added simplified functions to LobbyGames class (getGame, joinPlayer)
- LobbyGames#joinPlayer functions will now return the initiated Game object or null.
- Added functions to the custom event classes that simplify the Game class interface.

These changes do not affect the gameplay, only the API.
----------, Nov 2, 2023

- Fixed a bug that allowed admins to create a cube-shaped arena rather than a planar arena.
----------, Oct 30, 2023

- Fixed a small bug that would sometimes cause a player to join the lowest arena id instead of the arena that has waiting players when using /lg join for multiplayer games.
----------, Oct 26, 2023

- Modified the arena creation process to make it more clear that the /lg set leaderboard command sets a local leaderboard for the arena, rather than a global one.
----------, Oct 25, 2023

- Added an option to the config named "use-display-names" that when set to false, will use only the raw player names in a leaderboard entry.
----------, Oct 23, 2023

- Fixed a bug that would join a player into soccer or spleef if they were in the wrong world but in mirrored coordinates to an arena in a different world.
----------, Oct 22, 2023

- Added a config option "using-per-world-inventory" that, when set to true, passes control to per-world inventory management plugins when the player leaves a game by teleporting out of the world.
----------, Oct 22, 2023

- Fixed a small console error in Tic Tac Toe that was caused when a player is waiting for a 2nd player to join.
----------, Oct 17, 2023

- Made it so that when setting up a spleef arena, server admins no longer need to go 1 block below ground (the arena is set up under their feet).
----------, Oct 16, 2023

- Fixed a bug that was making a player damage effect when their max health is above 10 hearts.
----------, Oct 9, 2023

- Added a patch that makes the player's gamemode be changed before items are given. This allows for compatability with other plugins that create different inventories given a player's game mode.
----------, Oct 7, 2023

- Added "soccer.proximity-joining" as an option in the configuration file (Default is set to true).
- Fixed a bug that was preventing moving the cue ball in the first draw of a Pool game.
----------, Sep 29, 2023

- In Pool, when a player has the cue ball in hand (allowing them to place it on the table), they can now click multiple times to move it.
----------, Sep 25, 2023

- Added the No Permission message to the /lgjoinplayer (/lgforcejoin) command
----------, Sep 14, 2023

- Added the ball hit noise to when a player hits the cue ball with the cue in Pool.
----------, Sep 4, 2023

- Improved how the arena loading handles errors or unloaded worlds.
----------, Aug 28, 2023

- Fixed a bug where players would keep the items in their inventory when rejoining a spleef arena.
----------, Aug 26, 2023

- Fixed an error in the console caused when a player tries to join an arena by proximity.
----------, Aug 23, 2023

- Fixed a bug where not all of the blocks were removed from a deleted clicker arena
- Fixed a bug where the floor blocks were removed, but not the trapdoors in a deleted pool arena
----------, Aug 22, 2023

- Added an item that a player can click in minesweeper to quit the game.
----------, Aug 19, 2023

- Confirmation will now be asked if a player clicks the arrow item to quit a game.
- Fixed a bug where the 'yes' and 'no' values could not be retrieved from the config, the entries are renamed to 'yes-text' and 'no-text.'
----------, Aug 18, 2023

- Added a placeholder: %lobbygames_<game>_play_time_seconds%. This placeholder returns the same as %lobbygames_<game>_play_time%, but the raw number of seconds rather than the formatted string.
----------, Aug 16, 2023

- Fixed a bug that allowed other players to occasionally place sudoku tiles in a game that they are not active in.
----------, Aug 15, 2023

- Fixed a bug where leaderboard ranks were not re-ordered if "merge-leaderboard-scores" is enabled in the config.
----------, Aug 14, 2023

- Added an item a player can right click to leave an in-progress clicker game.
----------, Aug 11, 2023

- Made the Pool minigame more compatible with WorldGuard to prevent the modification errors in chat.
- Expanded the scope of events that Pool will listen to, allowing for players to left-click the cue ball.
----------, Aug 10, 2023

- Added a new PlaceholderAPI placeholder: %lobbygames_<game>_games_won%
This placeholder will return the number of multiplayer games a player has won, applying to pool, tic tac toe, connect 4, soccer, and spleef.
- Fixed a bug in tic tac toe that was causing the line particles to appear in the wrong column for flat arenas
- The default /lg command cooldown has been set to 3 seconds.
----------, Aug 10, 2023

- Fixed a bug that was preventing Minesweeper and Connect 4 from correctly saving the player's old inventory upon starting the game.
----------, Aug 8, 2023

- Fixed a bug that prevented a player's old inventory from being saved in Spleef.
- Increased the priority of Pool Armor Stand events to override editing plugins.
----------, Aug 7, 2023

- All 10 games will now give the player their inventory items for the game after teleporting them to the spawn. This is to increase compatibility with some types of world inventory management plugins.
----------, Aug 6, 2023

- Added the config option "merge-leaderboard-scores" that when set to true, will make it so that a player's score on a scoreboard is only replaced by their higher scores. If set to false, a new entry will be added each time they score anything in the top 5.
----------, Aug 5, 2023

- Fixed a bug where the game wouldn't end when one player's designated balls are all pocketed, but the opponent pockets the 8 ball while still having unpocketed balls.
----------, Aug 1, 2023

- Added the command "/lgjoinplayer" to make a way for admins or the console to let a player join a game. NPC clicks can use this command instead of using /sudo.

Usage: /lgjoinplayer <player> <game> [arena id]
Permission: lobbygames.forcejoin or lobbygames.admin
----------, Aug 1, 2023

- Fixed a bug that allowed players to place a checker outside of the arena if they clicked a sign in Connect 4.
----------, Jul 29, 2023

- Fixed a bug in Connect 4 that would occasionally prevent the game from ending when 4 checkers are connected.
- Fixed a console error that would occasionally fire when placing a checker in Connect 4.
- In 2-player games, the "console-command-on-end" config entry will not be run if the players are quitting. It now runs if someone wins the game.
----------, Jul 28, 2023

Introducing the newest game to LobbyGames, Connect 4! In Connect 4, you add checkers to the top of the board and try to connect 4 of your color on any row, column, or diagonal.

The recommended size is 7 blocks wide by 6 blocks tall, but you may set your own board sizes!

[​IMG]
----------, Jul 28, 2023

The default leaderboard expiration config entry is now 3 days. A comment has been added that clarifies that you can set it to -1 for no leaderboard expiration.
----------, Jul 27, 2023

- Pool will now override other plugins to prevent items from being placed into the armor stand slots. This is only for the armor stands in an active pool game, and will most likely only need to override armor stand editing plugins.
----------, Jul 25, 2023

- You can now use "\n" instead of "[newline]" in the config to improve readability.
----------, Jul 25, 2023

- Extended a previous update on the Pool cue ball physics to the rest of the billiard balls. This allows for more accurate collisions at high velocities.
----------, Jul 23, 2023

- Fixed a small bug that would cause an error in the console in soccer whenever a slime is attacked at the same time the soccer ball is in the respawn countdown.
----------, Jul 23, 2023

- The configurable game alias will now be used everywhere if set, such as in leaderboard titles, command chat responses, etc. If you are updating from a past version, make sure to review the game aliases if you haven't changed them from the defaults.
----------, Jul 22, 2023

- Fixed a small error that would fire in the console in the time between scoring and the ball respawning.
----------, Jul 22, 2023

The /lg reload auto-complete option will no longer show up for players who don't have the lobbygames.admin permission.
----------, Jul 21, 2023

- Added /lg command auto complete options for players who don't have the lobbygames.command permission.
----------, Jul 19, 2023

- Changed the item to quit Pool pratice mode to a feather (previously a wool block).
- The /lg reload command now requires the lobbygames.admin permission.
----------, Jul 18, 2023

- Patched a small bug that prevented players from proximity-joining soccer arenas when there was at least 1 player already in.
----------, Jul 17, 2023

- You can now add non-snow blocks to spleef arenas that won't be cleared upon the reset, allowing you to add walls to the arena. These blocks cannot be broken by players in the game. You can add additional challenges with the shape of the walls or make a spleef labyrinth!
- The cue ball will have maximum velocity for the break (the first round) of pool.
- Fixed a small bug that prevented a 2nd player from proximity-joining pool if enabled in the config.
- Added a protection to prevent setting the soccer spawn inside the arena.
----------, Jul 16, 2023

- Fixed a small bug that was causing the billiard ball collision calculation to fire on two adjacent frames, improving the accuracy and performance of Pool.
----------, Jul 15, 2023

- Players who walk near a Pool Table or Soccer/Football Arena will now automatically join. For pool, this feature has to be enabled in the config ("pool.proximity-joining").
- Players will now get removed from a Soccer game if they leave the arena.
----------, Jul 14, 2023

- Improved the 8Ball Pool physics, particularily when the ball is in high velocity.
----------, Jul 13, 2023

- You can now configure an alias for the name of each game type. This alias can be used on Join signs and the /lg command, allowing the plugin to be fully translatable.
- Added a patch to prevent adding items to the off hand of a pool armor stand.
----------, Jul 12, 2023

- Added a patch for a small console error that was occuring when a player quit pool with only 1 player in the game.
----------, Jul 12, 2023

- Removed the /lgames command alias to declutter the auto tablist complete, as this alias is least likely to be used (/lg is the alias to the full command /lobbygames).
----------, Jul 11, 2023

The LobbyGames command now autocompletes the possible chat arguments, improving quality of life and making it easier to set up the plugin.
----------, Jul 10, 2023

- Added a config line to run a command any time a player leaves a Lobby Game. Previously there was only an option to run a command when the player wins the game. This command is compatible with PlaceholderAPI, but will also use the placeholders %player% and %score%.

- Spleef will now override most world protection plugins, such as WorldGuard, to allow players to break the snow blocks in the game, but will not let players break any other blocks. This means that you can use WorldGuard as normal to prevent breaking blocks around the arena and the game should still work.
----------, Jul 9, 2023

- Fixed a small bug in the join command. If a player types the plugin name in the command (such as "/lobbygames :pool"), this will now behave the same as if they typed only the name of the game (such as "/pool").
----------, Jul 8, 2023

- For the commands that run whenever a player wins a game, the %winner% placeholder is now added as an alias to the original %player% placeholder to improve usability.
----------, Jul 6, 2023

- The console can now run commands whenever a game ends! Added a config line called "console-commad-on-end" to each game. Depending on the game type, you can use placeholders such as %player%, %score%, %winner%, %loser%, %winning_player_list%, and %losing_player_list%.
----------, Jul 5, 2023

- Fixed a small bug where the "interworld-teleportation-enabled" conflig line was not working on some versions. This option prevents players from accessing arenas in worlds other than the one they're already in.
----------, Jul 4, 2023

- Fixed a small bug where some content from the config file was not being reloaded with the /lg reload command.
----------, Jul 3, 2023

Added a list of blocked commands to the configuration file. This applies only to players who are in a Lobby Game who don't have the lobbygames.command permission.

The plugin can also be configured so that by default, all commands are blocked except for the commands that are added to the list.
----------, Jul 2, 2023

- Fixed a small error that was appearing in the console while playing Soccer
- Fixed a small error that allowed Spleef blocks to melt for a fraction of a second after the game ends.
----------, Jul 1, 2023

- If a player sneaks or stops on the edge of a block in Spleef while the blocks are melting, it will now remove the 2x2 area of blocks underneath them.
----------, Jun 30, 2023

- Increased the maximum arena size to 50x50 blocks, the Spleef max has been increased to 60x60. This applies to general games that do not have a special size defined.
----------, Jun 29, 2023

- LobbyGames will now override plugins like WorldGuard in spawning the slime for the soccer ball. This only allows the ball to spawn, no other mob spawning is overridden from other plugins.
- The config entry "reset-on-end" has been added to 2048.
----------, Jun 28, 2023

- Fixed a bug that was causing adjacent arenas to clear the other's armor stands (holograms) on start/end of a game.
----------, Jun 27, 2023

- The spleef melting blocks countdown is now displayed on an action bar, rather than in chat.
----------, Jun 27, 2023

- Added the config entry seconds-in-air to clicker to allow admins to control the speed of the blocks in the game. The default is 2.5s.
----------, Jun 27, 2023

- Made a small change that prevents manually adding decimal coordinates to arena locations that are expected to have integer components. Locations such as spawnpoint are unaffected by this.
----------, Jun 26, 2023

- 8Ball Pool now has a practice mode feature! While a player waits for another to join, they can practice pocketing the balls.
- Added the config option "reset-on-end" to Minesweeper and Sudoku to have them return to solid block state & remove all armor stands.
- Added the aliases "Minesw" to allow for smaller [Join] signs.
----------, Jun 25, 2023

- The leaderboard line number placeholder will now display the line number in the string.
- If the leaderboard line format contains a "-" character, the plugin will not add more "-" characters in an empty line to improve cosmetics.
- Fixed a small bug that was preventing global leaderboards from reloading format when the reload command is used.
----------, Jun 24, 2023

- A "0" will be returned if a player has no defined high score, instead of a "-"
- If leaderboard-entry-expiration is set to -1 in the config, this will now disable expiration.
----------, Jun 24, 2023

- Added the following extensions for PlaceholderAPI:
%lobbygames_<game>_highscore%
%lobbygames_<game>_play_time%
%lobbygames_<game>_games_played%
%lobbygames_<game>_leaderboard_line<number>%

- The Snake arena background will no longer be reset to wool each time, it can now be any block (other than air).
- Added a config option for Pool to make each side (solid, striped) the same color to improve accessibility.
----------, Jun 24, 2023

PlaceholderAPI support has been introduced to LobbyGames!
No command is necessary to install the extensions as long as the plugin is installed.
%lobbygames_game%
%lobbygames_score%
%lobbygames_time_played%
%lobbygames_opponent_name%
%lobbygames_player1_name%
%lobbygames_player2_name%
%lobbygames_arena_id%
%lobbygames_<game>_leaderboard% -Replace <game>
----------, Jun 23, 2023

- Fixed a bug that was causing new arenas to not save on some servers.
----------, Jun 22, 2023

- Added global leaderboards! You can create multiple global score boards for a lobby game. Regardless of which arena a player joins, their score will be reflected on the global board. The local arena-level leaderboards are still supported.
Command: /lg leaderboard <create:clear:delete> <game>
- Fixed a small error that appeared in the console after quitting a 2048 game on some server versions.
----------, Jun 22, 2023

8-Ball Pool is the latest game to be added to LobbyGames! In 8-ball pool, you hit the cue ball to knock other balls into the pockets. The first player to pocket all of their designated balls and then pocket the 8-ball wins! Engange your players and make your lobby or roleplay map more engaging!
[​IMG]
----------, Jun 21, 2023

If the text in the config is empty, the message will not be shown - made this property apply to more messages where applicable across various games.
----------, Jun 19, 2023

Added a configurable action bar that is sent when a player tries to place an X or O when it is not their turn.
----------, Jun 18, 2023

Added the alias "ttt" for tic tac toe, which can be used as a join command ("/ttt") or in a clickable sign.
----------, Jun 16, 2023

This update creates a way to make clickable signs! Previously, players could join arenas by running a command, which could be done with a NPC click, for example. Hub & Roleplay servers now have another way for players to join that can be easily integrated with a map!
[​IMG]
----------, Jun 15, 2023

Vertical arena support has been added to Tic Tac Toe and Sudoku! Previously, only Snake had vertical arenas. This means that these types of arenas can be set up on a wall, rather than only on the floor.
----------, Jun 15, 2023

- Made some changes under the hood to how Tic Tac Toe ends ends a game
- Added another check to verify if the 2 locations used in the Arena creator are valid.
----------, Jun 14, 2023

Added particle effects to the Arena maker to visualize the outline of a new arena. This helps with determining the right size and the locations of spawn points.
----------, Jun 13, 2023

Games that don't use the leaderboard (Tic Tac Toe and Soccer) will no longer show the /lg set leaderboard message when creating a new arena.
----------, Jun 13, 2023

Added Tic Tac Toe to LobbyGames! In Tic Tac Toe, you compete with another player to fill either 3 X's or 3 O's in a row!
[​IMG]
----------, Jun 12, 2023

Fixed a small error that occured in the console if a player in a lobby game teleported to another world.
----------, Jun 11, 2023

Added shortcut commands to join a lobby game, such as /2048, /snake, /soccer, etc.
----------, Jun 10, 2023

- Added a configurable boost jump option for players in a soccer game. Players can use this to catch up with the ball or get to their net faster.
- Clarified goal setup when creating a soccer arena
----------, Jun 9, 2023

The snake in Snake games will no longer spawn partly outside of the arena, allowing for consistency between small and large snake arenas.
----------, Jun 8, 2023

- Lowered the probability of a 4 tile spawning in 2048 to be closer to most versions of the game.
----------, Jun 7, 2023

Added a configurable join cooldown for large servers to moderate how fast players can rejoin.
----------, Jun 7, 2023

Fixed a bug that was preventing the plugin from starting on some server versions due to an issue with spigot's legacy support.
----------, Jun 6, 2023

Fixed a small bug that caused the plugin to clash with ViaVersion on server versions
----------, Jun 4, 2023

Changed the less important messages broadcasted to spleef arenas into action bars
----------, Jun 4, 2023

Added an action bar to show the current score in 2048 games
----------, Jun 3, 2023

Fixed a bug where the plugin could not load arenas because it initialized before worlds on some implementations.
----------, Jun 2, 2023

Introducing 2048, the newest minigame added to LobbyGames! In 2048 you slide the tiles on the board to combine and merge them without running out of space!
[​IMG]
----------, Jun 2, 2023

- Added config entries for common error messages
- Fixed general bugs, such as where some messages were not displayed in 1.8 servers
- Fixed a bug where the arenas.yml file was cleared on startup
----------, May 31, 2023

Added an alias "football" to /lg join, as well as some common misspellings of other games.
----------, May 31, 2023

- Added a command ( /lg restart ) that allows a player to restart a Sudoku game. Currently no other games are affected by this command.
- Players can now fly in Sudoku (configurable)
----------, May 30, 2023

- Fixed a bug where the leaderboards would disappear at the start of some games
- Added a config line for the title of the wool in soccer
----------, May 29, 2023

- Added an item that players can right-click to leave a soccer/spleef arena when it is still filling with players.
- Removed legacy config entries that are not used
----------, May 28, 2023

v1.1.0 is here, introducing Sudoku and increased version compatibility!
Note: If you have already downloaded and are updating the existing file, make a backup of config.yml and arenas.yml!
[​IMG]
----------, May 27, 2023

- Players will now be teleported to the spawnpoint after a game ends. For soccer / football, since previously no spawnpoint was required, you will have to re-create the arena if you want this to apply.
- Fixed a typo in the default config
----------, May 25, 2023

A configurable action bar has been added to block Clicker to show the score during the game. This can be disabled by setting it to "" in the config file.
----------, May 24, 2023

- Added /lg reload to reload the config in-game.
- The nametags above the unclicked Clicker blocks can now be set with the config
----------, May 24, 2023

- Added more configurable options for the spleef countdowns
- Fixed a bug that prevented the clicker nametags from appearing in some versions
----------, May 22, 2023

- Added a countdown to the soccer ball after getting a goal - configurable
- Added configurable score into goal messages
- Improved compatability for legacy server versions
----------, May 21, 2023

Soccer arenas can now be made to any size above 7x7 blocks - this is an exception to the other games, which have a maximum size of 34x34 blocks to prevent lag.
----------, May 20, 2023

Resource Information
Author:
----------
Total Downloads: 374
First Release: May 19, 2023
Last Update: Dec 19, 2024
Category: ---------------
All-Time Rating:
22 ratings
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings