Splegg-OG is a Splegg plugin originally made by MrLuangamer, updated for Worldedit 7.2 and Spigot 1.16.4 by Hraponssi, then updated for Purpur 1.19.4 for use at TrueOG Network by NotAlexNoyle.

Runtime dependencies: WorldEdit, DiamondBank-OG, Utilities-OG, and MyWorlds. Chat-OG and Scoreboard-OG are optional and integrated when present.

Current feature state:

Matches run in per-game MyWorlds copies of the configured template world, so multiple games can use the same map without sharing arena blocks, scoreboards, or player state. The template copied is the world the map's terrain is in, taken from its spawns and then its floors; a match lobby saved in some other world never decides it.
Splegg creates isolated MyWorlds inventory groups for configured lobby and in-game worlds. It does not manage the vanilla main-world inventory group.
Players can join by lobby id with /spjoin, by map with /splegg join, by random queue, or through registered lobby signs, then vote for the map while waiting in the lobby.
Players can leave with /splegg leave, /hub, or the lobby slimeball.
Players who leave, relog, or reconnect inside a Splegg world are returned to where they were before they entered it. Return locations are kept on disk in plugins/Splegg-OG/prejoin-locations.yaml and expire after Options.PreJoinLocationExpiryDays days; the protected main-world spawn is the fallback.

Protected vanilla worlds: Splegg will never read, write, or configure the vanilla overworld dimensions (world, world_nether, world_the_end). This guard is hard-coded -- listing those names under Worlds.Lobby or Worlds.InGame in config.yml is rejected with startup warnings, and /splegg create, /splegg setspawn, /splegg setlobby, and /splegg addfloor all refuse to run while you are standing in one of them. Run Splegg only inside dedicated worlds that you create yourself.

Step-by-Step Setup Guide

Follow these steps in order to get your first map running.

1. Choose Your Map Source

Decide how you want to create your arena:

Option 1A (Manual): Create a fresh void world and build your map from scratch.
Option 1B (Import): Use a pre-built world folder (e.g., from PlanetMinecraft).

1A. Create Base Worlds (Manual Path)

Splegg requires dedicated worlds for lobbies and games.

Install MyWorlds.
Create a lobby world: /mw create splegg_lobby void
Create an in-game world: /mw create splegg_ingame void
Load them: /mw load splegg_lobby and /mw load splegg_ingame

1B. Import Pre-built Maps (Import Path)

If you have a downloaded world folder:

In config.yml, set Worlds.MapBase to maps.
Drop your world folder (e.g., MyAwesomeMap) into the /maps/ directory at your server root.
Add MyAwesomeMap to the Worlds.InGame list in config.yml.
Restart the server. Splegg will automatically deploy the map.

2. Configure the Plugin

Open plugins/Splegg-OG/config.yml.
Ensure splegg_lobby is under Worlds.Lobby and your in-game world (e.g., splegg_ingame or MyAwesomeMap) is under Worlds.InGame.
Restart your server or run /reload confirm.

3. Initialize the Splegg Map

Teleport to your in-game world (/mw tp <world_name>) and run:

/splegg create <map-name> (e.g., /splegg create my-first-map)

4. Define the Arena

While standing in the map:

Set Spawns: Run /splegg setspawn <map-name> at every player starting position. You need at least two. Use next or a number to modify them.
Set Lobby: Run /splegg setlobby <map-name> where players should wait before the game starts. You must be standing inside the map's own world -- the match lobby is rebased into every per-game copy, so coordinates surveyed anywhere else land in unrelated terrain. Splegg refuses the command from another world and tells you which one it wants. For a waiting area outside the map, use the global /splegg setlobby with no map name instead.
Define Floors:
- Use the WorldEdit wand (//wand) to select two parallel corners of a floor.
- Run /splegg addfloor <map-name>. Repeat for as many floors as needed.

5. Test Your Map

Run /splegg join <map-name> to ensure everything is working correctly.

Join Signs

Admins can place physical signs that players right-click to join a map. A repeating task redraws every sign each second with the map name, live status, and player counts, using the Sings.Format and Sings.Status templates in config.yml.

To set one up:

Make sure the map already exists (/splegg create <map-name>, see the setup guide above).
Place a sign in a persistent world such as the server hub — never inside a per-match world copy, which is deleted after each game.
Write [Splegg] on the first line and the map name on the second line. Requires the splegg.admin permission.
The sign reformats itself immediately; right-clicking it joins that map, creating a game if none is running.

Signs are registered by location, not by their text, so reformatting cannot orphan them. Breaking a registered sign requires splegg.admin and unregisters it; everyone else is blocked from breaking it.

Points, Ranks & Placeholders

Every block an egg destroys and every match win awards points (Points.BlockBroken and Points.Win in config.yml). Totals persist in plugins/Splegg-OG/stats.yml and map onto the Hive Java Splegg rank ladder:

Rank	Points
Farmer	0
Cook	5,000
Chef	10,000
Master	100,000
Humpty Dumpty	250,000
Ramsay	500,000
Hot'n'Spicy	1,000,000
Splegg Head	1,200,000
Bacon	1,500,000
Sunnyside	2,000,000
Delicious	3,000,000
Easter Bunny	4,000,000
Scrambled	5,000,000
Oliver	7,500,000
The Eggspert	Top player, once they also reach Oliver

Registered through Utilities-OG as MiniPlaceholders, resolved for the viewing player, and updated the moment the underlying value changes:

Placeholder	Value
`<sp_score>`	Total points
`<sp_rank>`	Colored rank name for that score

🛠 Command Reference

Management & Setup

/splegg create <map> - Initialize a new map.
/splegg setspawn <map> [next|#] - Define/modify player start points.
/splegg setlobby <map> - Set map-specific warm-up area. Must be run inside that map's world.
/splegg setlobby - Set the global fallback lobby. Any world.
/splegg addfloor <map> - Add selected WorldEdit region as a floor.
/splegg info <map> - Check setup status (spawns, floors, etc.).

Gameplay

/spjoin [lobby] - Join a lobby by id (SP1, or just 1). With no argument, joins the best open lobby.
/splegg join <map> - Join a specific map.
/splegg random - Join a random available map.
/vote [#] or /v [#] - View or cast votes for the current lobby's maps.
/splegg leave - Exit a lobby or match.
/hub - Return to the main world spawn.

Administration

/spforcestart [time] - Start the match ignoring Options.AutoStartPlayers.
/splegg start [map] - Start a match that already has enough players.
/splegg stop [map] - End a match immediately.
/splegg list - List all maps, their status, and player counts.
/splegg help - Full command reference.

Alias: /sp can be used instead of /splegg.

Map Voting:

When a player joins a Splegg lobby, the lobby picks up to Options.VotingMaps playable maps. The joined map is kept as one of the choices and the remaining slots are filled randomly. Players get the same chat voting flow as TheHerobrine-OG: /v #, clickable vote lines, one active vote per player, vote changes that move the count, and reminder messages every Options.VotingReminder seconds.

When the start countdown reaches Options.EndVotingAt, voting ends and the highest-voted map wins. If the winning map is different from the joined map, Splegg prepares a new per-game world copy for the winner, moves lobby players to that map's queue lobby, updates signs and scoreboards, and starts the match on the winning map.

/v and /vote are claimed inside Splegg territory before any other plugin sees them, so VotingPlugin cannot take the /vote label away from map voting. The claim covers a player who is in a Splegg game, and anyone standing in a configured lobby or in-game world or a per-match copy. Everywhere else /vote behaves normally: neither label is declared in plugin.yml, so Splegg never competes for them.

Force Starting:

/spforcestart [time] restarts the lobby countdown ignoring Options.AutoStartPlayers, so a match can begin below the configured minimum. The countdown floor is Options.EndVotingAt so map voting still resolves before the match starts, and [time] raises it. Requires splegg.admin.

Chat:

When Chat-OG is installed, Splegg registers a chat formatter for its Worlds.GamePrefix key (SP by default), which covers both the configured lobby worlds and every per-match copy. Lobby chat shows the player count, in-game chat shows blocks broken, and eliminated players are greyed out. Chat-OG's discord.games must contain a matching SP key for Splegg worlds to get their own chat; without it they stay in global chat and the formatter never runs.

Chat-OG only routes worlds named <letters><number>-<name>, so a lobby world named anything else stays in global chat while Splegg still treats it as its own. Splegg warns at startup naming any such lobby world. Worlds.InGame entries are deliberately not checked: they are match templates, nobody queues or plays in one, and each per-game copy is named <prefix><gameId>-<template> and routes whatever the template is called.

Scoreboard:

Queued players see a sidebar with the map, the players waiting and the countdown; during the match it shows the map, the players still alive, the player's own blocks broken and the time left. The labels are the Scoreboard.* keys in config.yml. With Scoreboard-OG 1.2.0 or newer installed, the sidebar is drawn through Scoreboard-OG's sidebar API, so the network board returns on its own when the player leaves and /togglescoreboard is honoured. Without it, a plain Bukkit sidebar is used and the main scoreboard is restored on leave.

Match Lobbies:

A map's match lobby is stored as bare coordinates and rebased into whichever per-game world copy the match runs in, so it only means anything when it was surveyed inside the map's own world. One saved elsewhere is ignored at runtime -- the queue falls through to the global lobby, then to spawn 1 -- and /splegg info <map> reports it as ignored with the command to re-run. Splegg logs this once per map on load rather than on every sign refresh.

If you are upgrading and a map's lobby was saved in a shared hub world, that map was previously copying the hub as its arena. Re-run /splegg setlobby <map> inside the map, or clear the entry and rely on the global lobby.

Lobby Signs:

Admins can create a join sign by placing a sign with these lines:

[splegg]

join

my-map

Splegg rewrites the sign using Sings.Format from config.yml. The default layout is header, map, status, then player count. Sign clicks resolve the map from the saved sign location in maps.yml, not from the visible line text, so operators can change the displayed format without breaking joins. Admins can break registered Splegg signs to remove them; non-admin players cannot break them.

Permissions:

splegg.join - Join Splegg games with /splegg join, /splegg random, or lobby signs.
splegg.joinfull - Join a full lobby.
splegg.admin - Manage maps, signs, and matches. Includes the join permissions.
splegg.use - Metadata permission that includes splegg.join.

Original Bukkit Page.

The current Gradle build target is Purpur 1.19.4 on GraalVM CE 17 / Java 17.

To Build:

./bootstrap.sh

export JAVA_HOME=/path/to/java-17

./gradlew build

Gradle must run on Java 17 or newer, and the git submodules under libs/ must be initialized before the build.

The resulting .jar file will be in build/libs/

Planned Features:

Database to remember shop purchases across sessions (currently in-memory only).
Functional lobby menu items: wire up the Guide book and Cosmetics menu. The shop item and leave slimeball are functional.
Power ups.
Spectator Mode (partial TODOs exist for spectator compass, spectator inventory, and join-in-progress).
Leaderboards.
PlaceholderAPI support.

Licensed under the GPLv3.