The Herobrine!

Remake of HiveMC's "The Herobrine!" v2 for Purpur 1.19.4, using MyWorlds for world management.

Current version: 1.5.8 (changelog).

Requirements

• Purpur 1.19.4
• ProtocolLib
• MyWorlds
• Redis/KeyDB (stores kit selections)
• MariaDB/MySQL (stores player statistics)

Quick Setup

1. Install the required plugins and configure your database connections in config.yml.
2. Drop map world folders into your maps/ directory (or whatever path is set as mapBase in config.yml).
3. Each map needs a mapdata.yaml file — use /hbsetspawn to place all required points and the wizard will generate it for you.
4. Create a maps/hub world folder to serve as each lobby's waiting area.
5. Create a lobby config file at maps/<config-id>.yaml listing which maps belong to it.
6. Run /hbcreatelobby <config-id> to bring a lobby online.

If anything is missing or misconfigured, the plugin will tell you exactly what needs to be fixed rather than starting in a broken state.

Lobby Config Format

Create a file at maps/<config-id>.yaml:

maps:
  - map1
  - map2
  - map3

Each map listed must have a folder in maps/ with a valid mapdata.yaml inside.

Map Data Format

mapdata.yaml is generated automatically by /hbsetspawn, but here is what it looks like:

name: Map 1
builder: Good Builder
shardMin: -100
shardMax: 1000
datapoints:
  - type: SURVIVOR_SPAWN
    x: -2
    y: 156
    z: 925
  - type: HEROBRINE_SPAWN
    x: 110
    y: 140
    z: 854
  - type: ALTER
    x: -6
    y: 157
    z: 925
  - type: SHARD_SPAWN
    x: 110
    y: 149
    z: 834

Join Signs

Admins can place physical signs that players right-click to join a game. The sign updates itself with the lobby name, current status, and player counts; right-clicking joins the best joinable lobby for that config.

To set one up:

1. Find the lobby config ID: the id: field of a file in plugins/TheHerobrine-OG/lobbies/ (the bundled lobbies/default.yaml on a fresh install).
2. Place a sign in a persistent world such as the server hub. The plugin warns if you place one in a managed lobby world, because those worlds are deleted on shutdown and take the sign with them.
3. Write [Herobrine] on the first line and the lobby config ID on the second line. Requires the theherobrine.signs.create permission.
4. The sign confirms registration and redraws with live data shortly after.

Breaking a registered sign requires theherobrine.signs.destroy and unregisters it; everyone else is blocked from breaking it.

Commands

/v and /vote are claimed for map voting before any other plugin sees them, for anyone who is in a lobby or standing in a lobby world, so VotingPlugin cannot take the /vote label away from map voting. Everywhere else /vote behaves normally.

Player Commands

Command	Description
/vote [map] or /v [map]	Vote for a map during the voting phase
/hbjoin <lobby>	Join or spectate a lobby by ID (HB1, or just 1)
/hub	Leave your current lobby and return to the main world

Admin Commands

Command	Permission	Description
/hbcreatelobby <config-id>	theherobrine.command.createlobby	Start a new lobby
/hbdeletelobby <lobby-id>	theherobrine.command.deletelobby	Stop and remove a lobby
/hbreloadconfigs	theherobrine.command.reloadconfigs	Reload all lobby config files
/hbsetherobrine <player>	theherobrine.command.setherobrine	Force a player to be Herobrine
/hbforcestart [time]	theherobrine.command.forcestart	Force the game to start
/hbpausetimer	theherobrine.command.pausetimer	Pause the start countdown
/hbdropshard	theherobrine.command.dropshard	Force the shard carrier to drop the shard
/hbspectate	theherobrine.command.spectate	Toggle spectator mode while in the lobby
/hbsetspawn <type> [index] [mapName]	theherobrine.command.setspawn	Place a map datapoint at your location

Permissions

Signs

Permission	Default	Description
theherobrine.signs.create	OP	Place [Herobrine] join signs
theherobrine.signs.destroy	OP	Break [Herobrine] join signs

Kits

Kit permissions can be required or left open in config.yml.

Kit	Permission
Archer	theherobrine.kit.classic.archer
Priest	theherobrine.kit.classic.priest
Scout	theherobrine.kit.classic.scout
Wizard	theherobrine.kit.classic.wizard
Mage	theherobrine.kit.unlockable.mage
Paladin	theherobrine.kit.unlockable.paladin
Sorcerer	theherobrine.kit.unlockable.sorcerer

Other

Permission	Description
theherobrine.overfill	Join a lobby that is already full