MCLabs Staff Docs

    ⚔️ Registering GGRTP Spawn Locations

    Random teleports (GGRTP) inside the Gank & Goon Zone are populated from a list of registered coordinates. This walkthrough details how to add, manage, and test GGRTP coordinates for an Era.

    Plugins & Tools Used

    • Gank & Goon Random Teleport: Skript command /ggrtpadmin
    • Configuration File: /plugins/Skript/scripts/raid/config/ggrtp.yml

    Step 1: Finding a Spawn Point

    1. Teleport or fly to the Gank & Goon Zone.
    2. Stand on the exact block and face the direction you want players to land and look towards when they teleport.

    Step 2: Registering the Spawn Coordinate

    1. Run the command:
      /ggrtpadmin add [era]
      • Example: /ggrtpadmin add era2
      • Note: If you omit the [era] argument, it defaults to the current active era.
    2. The script will automatically:
      • Generate a random UUID to act as the coordinate's unique ID.
      • Save your current X, Y, Z, Pitch, Yaw, and World coordinates to the configuration.
      • Automatically reload the active GGRTP configuration if you added it to the current active era.

    Step 3: Verifying the Configuration File

    Confirm that the coordinates are saved in the YAML configuration:

    1. Open /plugins/Skript/scripts/raid/config/ggrtp.yml.
    2. Locate the era section (e.g. eras.era2.locations).
    3. Verify that the generated UUID entry contains the correct coordinates.

    Step 4: Listing Registered Spawn Points

    To see all registered teleport coordinates and their coordinates for an era:
    /ggrtpadmin list [era]

    • Example: /ggrtpadmin list era2
    • Output lists: Location IDs (UUIDs) and coordinates.

    Step 5: Testing the Random Teleport

    To verify that players can land on the new spawn point:

    1. Run the test command to teleport yourself (or a staff member):
      /ggrtpadmin rtp <player>
    2. Verify that you land at the newly configured spawn coordinates.

    Step 6: Removing coordinates

    If a spawn point is no longer safe or needed:

    • Remove a Single Coordinate:
      /ggrtpadmin remove [era] <id>
      • Example: /ggrtpadmin remove era2 a9f8e4c2-7b1d...
      • Note: You can omit the [era] argument if removing from the current active era.
    • Clear All Coordinates:
      /ggrtpadmin clear [era]
      • Example: /ggrtpadmin clear era2 (deletes all spawn locations for era2)

    [!WARNING]
    Teleporting players into walls or void zones will lead to player death and support issues. Always check coordinates, pitches, and yaws using /ggrtpadmin list and manually inspect the landing sites.