# GHub \u2014 Hub Utilities Plugin for Minecraft<\/p>\n
**Version:** 1.0
\n**Compatible with:** Paper 1.21.x<\/p>\n
“`
\nProtocolLib
\nPlaceholderAPI (Optional)
\n“`<\/p>\n
GHub is a minimalist yet powerful plugin for managing spawn points, hub items, and player teleportation on a Minecraft server. It allows you to easily set up spawn, give special items, and supports placeholders via PlaceholderAPI.<\/p>\n
—<\/p>\n
## \ud83c\udf1f Main Features<\/p>\n
### 1. Spawn Setup<\/p>\n
* Players are automatically teleported to spawn when joining the server.
\n* Supports spawn messages (`welcome-spawn`) with Minecraft colors.<\/p>\n
**Example command:**<\/p>\n
“`
\n\/ghub spawn
\n“`<\/p>\n
—<\/p>\n
### 2. Hub Item<\/p>\n
* A configurable item given to players on join.
\n* Supports:<\/p>\n
* Material (e.g., COMPASS)
\n * Name and lore
\n * Action on use (`console` or `bungee`)
\n* Players cannot drop the item.<\/p>\n
**Example `config.yml` setup:**<\/p>\n
“`yaml
\nitem:
\n material: COMPASS
\n slot: 4
\n name: “&6Server Selector”
\n lore:
\n – “&7Click to choose a server”
\n function: “[console] deluxemenus open selector %player_name%”
\n“`<\/p>\n
—<\/p>\n
### 3. Item Functions<\/p>\n
1. **Console Commands**<\/p>\n
* Executed as console commands.
\n * Supports placeholders (e.g., `%player_name%`).
\n * If run from console without a player \u2014 a warning is shown.<\/p>\n
2. **BungeeCord Teleport**<\/p>\n
* Teleports the player to another server via BungeeCord.
\n * Example: `[bungee] lobby`<\/p>\n
—<\/p>\n
### 4. Void Teleportation<\/p>\n
* Players who fall below a set height (`VOID_HEIGHT = -60`) are automatically teleported to spawn.
\n* Cooldown for repeated teleportation: 3 seconds.<\/p>\n
—<\/p>\n
### 5. PlaceholderAPI Support<\/p>\n
* All standard PlaceholderAPI placeholders work in player messages.<\/p>\n
**Example:**<\/p>\n
“`yaml
\nmessages:
\n welcome-spawn: “Welcome, %player_name%!”
\n“`<\/p>\n
* Console commands that rely on player placeholders are disabled to avoid errors.<\/p>\n
—<\/p>\n
### 6. Plugin Commands<\/p>\n
| Command | Description | Permission |
\n| ————– | ————————— | ————- |
\n| `\/ghub reload` | Reload plugin configuration | `ghub.reload` |
\n| `\/ghub spawn` | Set the spawn point | `ghub.spawn` |<\/p>\n
—<\/p>\n
### 7. Configuration<\/p>\n
* All settings are in `config.yml` and `spawn.yml`.
\n* Configurable options include:<\/p>\n
* Material, slot, and name of hub item
\n * Player messages
\n * Item functions<\/p>\n
**Example `config.yml`:**<\/p>\n
“`yaml
\nitem:
\n material: COMPASS
\n slot: 4
\n name: “&6Server Selector”
\n lore:
\n – “&7Click to choose a server”
\n function: “[console] deluxemenus open selector %player_name%”<\/p>\n
messages:
\n welcome-spawn: “Welcome, %player_name%!”
\n cannot-drop: “&cYou cannot drop this item!”
\n reload-success: “&aConfiguration reloaded successfully!”
\n no-permission: “&cYou do not have permission to use this command!”
\n usage: “&eUsage: \/ghub [reload|spawn]”
\n“`<\/p>\n
—<\/p>\n
### 8. Safety & Convenience<\/p>\n
* Hub item cannot be dropped or moved.
\n* Cooldowns prevent teleport spam when falling into the void.
\n* Messages and commands safely handle missing players in console.<\/p>\n
—<\/p>\n
### 9. Installation<\/p>\n
1. Download the latest `GHub.jar` plugin.
\n2. Place the file in your Paper server’s `plugins` folder.
\n3. Restart the server to generate `config.yml` and `spawn.yml`.
\n4. Configure `config.yml` and set the spawn point using `\/ghub spawn`.
\n5. Done! Players will now receive the hub item on join.<\/p>\n","protected":false},"excerpt":{"rendered":"
gHub – Spawn, Welcome message, special item and more in one plugin<\/p>\n","protected":false},"featured_media":75650,"template":"","meta":{"_minecraft_slug":"ghub","_minecraft_project_id":"Ad6DdPCG","_minecraft_author":"Gomania","_minecraft_license":"MIT","_minecraft_downloads":182,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ghub.zip","_minecraft_size_bytes":61281,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T12:55:42.154762Z","_minecraft_date_created":"2025-09-08T07:54:23.238936Z","_minecraft_date_modified":"2026-01-04T22:44:17.087451Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ghub","_minecraft_icon_attachment_id":75650,"_minecraft_imported_at":"2026-06-04T09:10:48+00:00","_minecraft_import_hash":"bea80d0de6567673f3e96af612eadfca","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,127,128,867,129],"mod_loader":[132,133,134],"minecraft_version":[118,119,120,46,47,48,49,50,51,52,53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-75649","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-16","minecraft_version-1-16-1","minecraft_version-1-16-2","minecraft_version-1-16-3","minecraft_version-1-16-4","minecraft_version-1-16-5","minecraft_version-1-17","minecraft_version-1-17-1","minecraft_version-1-18","minecraft_version-1-18-1","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n