✅ How to Use the gbk_lobby Plugin
The gbk_lobby plugin is designed to manage a central lobby where players can be teleported easily. It allows server administrators to configure and remove the lobby, as well as teleport players with a countdown. Here's how to set it up and use it effectively.

1. Plugin Setup
After installing the gbk_lobby plugin on your server, follow these steps:

Install the Plugin

• Download the file: gbk_lobby.jar
  
• Place it in the /plugins directory of your server
  
• Restart your server or run /reload to activate the plugin

The plugin will automatically create a database file named gbkD.db and generate the necessary config files in its plugin folder.

2. ⚙️ Command Overview
/lobby – Teleport to the Lobby
Usage: /lobby
Description: Teleports the player to the lobby after a 5-second countdown.
Permissions: Default players can use this if the lobby is set.
Players must remain still and avoid damage during the countdown; otherwise, the teleport is canceled.

/gslobby – Set Lobby Location
Usage: /gslobby
Description: Sets the player’s current location as the lobby.
Permissions: Admins only.

/grlobby – Remove Lobby Location
Usage: /grlobby
Description: Deletes the saved lobby location from the database.
Permissions: Admins only.

/lobby (Admin Teleport) – Instant Teleport
Usage: /lobby
Description: Admins with the gbk_lobby.op permission can teleport instantly without countdown.

3. Setting the Lobby Location
Set Lobby

1. Stand at the desired lobby location in-game
   
2. Type /gslobby
   
3. The plugin will save your current position (world, coordinates, yaw, pitch) to the database and confirm success.

Remove Lobby
To clear the saved location, simply run /grlobby. Players will no longer be teleported until a new lobby is set.

4. ⏳ Teleport Mechanics
Countdown System
When a non-admin player runs /lobby, a 5-second countdown begins. During this time:

• Movement or damage cancels the teleport
  
• If uninterrupted, the player will be teleported when the countdown ends

Instant Teleport for Admins
Admins with the gbk_lobby.op permission bypass the countdown and are teleported immediately.

5. Player Join & Respawn Behavior
New Player Join
When a new player joins the server for the first time, they are automatically teleported to the lobby (if set).

Respawn Location
Upon death, players will respawn at the lobby location (if set), unless a personal spawn point exists.

6. Permissions
Permission Node Description
gbk_lobby.default Allows regular players to use /lobby
gbk_lobby.op Grants admin access to set/remove lobby and skip countdown
Tip: Use permission plugins like LuckPerms, PermissionsEx, or GroupManager to manage access.

7. ️ Database Configuration
The plugin uses an SQLite database ( gbkD.db) to store lobby data.

Database Fields:

• world → The name of the world
  
• x, y, z → Lobby coordinates
  
• yaw, pitch → Player orientation at teleport

⚠️ Manual editing is not required, unless troubleshooting or migrating.

8. Troubleshooting
Problem Solution
/lobby doesn't work or doesn't teleport Make sure the lobby is set using /gslobby
Players can move or take damage during countdown Check for conflicts with other plugins
Lobby location isn't saving/loading Check server logs for SQLite errors and ensure gbkD.db is writable
By following these steps, you can easily configure and use the gbk_lobby plugin to enhance your server’s lobby experience.
Need help or want custom features? Don’t hesitate to reach out!