Teleport System setup
A teleport window: players press a place and arrive there. Only the places you list exist, and each can need a group rank.
You Need
- Roblox Studio, with your game open.
- Your Prova licence key, from your dashboard.
- To own the experience, or the group that owns it.
You Get
- A file from the Prova Discord server.
- Prova Core, free, one per experience.
- Your licence key, added as a secret.
What Goes Where
Your Explorer after installing. Don’t rename anything.
ReplicatedStorage
└─ PROVA | Teleport System Folder
├─ README Script
└─ Remotes Folder
├─ Result RemoteEvent
└─ Teleport RemoteEvent
ServerScriptService
└─ PROVA | Teleport System Folder
├─ TeleportConfig ModuleScript
├─ TeleportRules ModuleScript
├─ TeleportServer Script
└─ TeleportService ModuleScript
StarterGui
└─ PROVA | Teleport System ScreenGui
├─ OpenButton ImageButton
├─ Teleport Frame
└─ TeleportClient LocalScript
| Service | Object | What it holds |
|---|---|---|
| ReplicatedStorage | PROVA | Teleport System | The README and the remotes the window uses. |
| ServerScriptService | PROVA | Teleport System | The system and its settings. |
| StarterGui | PROVA | Teleport System | The teleport window and its open button. |
Installation
Follow the steps in order.
-
Join the Prova Group
You must be in the Prova group when you buy and when you sign in to your dashboard. Players in your game don’t need to join.
-
Buy the Game Pass
One payment in Robux, from the Teleport System page. The Game Pass is your proof of purchase.
Then open your dashboard and create your licence key. It is shown once, so copy it somewhere safe. One key covers every system you own, in up to six of your experiences.
-
Download the Teleport System File
The Teleport System arrives as one file, from the Prova Discord server. Save it somewhere you can find it.
-
Install Prova Core
Once per experience, however many Prova systems you own. Core is free. Open View → Explorer and click the arrow beside ReplicatedStorage. If PROVA | Core is already there, skip this step.
- Download Prova Core from the Prova Discord server.
- In Explorer, right-click Workspace and choose Insert from File. Pick the Prova Core file.
- Among what it adds are two folders named PROVA | Core.
- Drag the one holding Constants, Core, Ed25519 and Log into ReplicatedStorage.
- Drag the one holding CoreServer and LicenseProvider into ServerScriptService.
- Delete anything left over, such as an empty model.
ExplorerReplicatedStorage
└─ PROVA | Core
ServerScriptService
└─ PROVA | Core
Only one copy of Core. A second PROVA | Core stops every system with PC-002. -
Add the Teleport System Folders
In Explorer, right-click Workspace and choose Insert from File. Pick the Teleport System file. Among what it adds are three objects named PROVA | Teleport System. Drag each one into its service.
Add the Teleport System Folders Drag this Into The Folder holding README and Remotes ReplicatedStorage The Folder holding TeleportConfig ServerScriptService The ScreenGui holding Teleport and OpenButton StarterGui Remove any other teleport menu you had. Delete anything left over, such as an empty model. -
Place Your Destinations
Every button needs a part where players arrive. Players face the way the part faces. The parts can be inside any folder or model in Workspace.
- Home → Part. Put it on the floor where players should arrive.
- Turn it to face the way players should face.
- In Properties: Anchored ticked, CanCollide unticked, Transparency 1.
- Rename it exactly: LobbyTP, StageTP, ATP, BTP or CTP. One part per button.
-
Turn On Allow HTTP Requests
Turn on Allow HTTP Requests and click Save. Without it the licence can’t be checked and Core stops with PC-004. Already on if another Prova system works in this game.
File/Experience Settings/Security -
Add Your Licence Key as a Secret
Publish your game first: File → Publish to Roblox. Then, in a web browser, open create.roblox.com, click your experience, and in the left menu choose Secrets → Create Secret. Fill in all three fields exactly.
Already done for another Prova system? Skip this step. Lost your key? Rotate it on your dashboard and paste the new one here.
Creator Dashboard/Your Experience/Secrets/Create SecretAdd Your Licence Key as a Secret Field Type Name prova_licence Secret Your licence key Domain api.withprova.app -
Publish and Check the Output
Publish and join your game. Press F9 to open the Developer Console and choose the Server log. When the Teleport System works, you see these lines.
In the game, a square TP button appears on the left. Click it, press a place, and you arrive there.
Testing in Studio instead? Open View → Output. A normal Play can’t read the published secret, so add a Local Secret named prova_licence with your key under File → Experience Settings → Security, or use a Team Test.
Output[PROVA | Core] v0.2.0 starting.
[PROVA | Core] Teleport System v1.0.0 registered.
[PROVA | Teleport System] v1.0.0 ready. 5 destinations.
[PROVA | Core] Licence confirmed.
Buttons and Parts.
The standard destinations. The button is its name in the Teleport window; the part is in Workspace.
| Button | Shows | Part |
|---|---|---|
| Lobby | Lobby | LobbyTP |
| Stage | Stage | StageTP |
| GroupA | Group A | ATP |
| GroupB | Group B | BTP |
| GroupC | Group C | CTP |
Adding a Place.
Copy a button
In the Teleport window, right-click Stage → Duplicate. Rename it, e.g. Cafe, and change its TextLabel.
Add its part
Place a part the same way as above, named e.g. CafeTP.
List it
Add a line to Destinations: { Button = "Cafe", Part = "CafeTP" },
Settings
All settings are in one file. Change a value, then publish.
Who Can Teleport
| Setting | Standard | What it does |
|---|---|---|
| GroupId | 0 | Your group’s ID, the number in its web address. 0 means everyone has rank 0. |
| MinimumRank | 0 | Lowest rank that can use the window. 0 is everyone. |
Destinations
One line per button. Buttons not listed are hidden.
| Setting | Standard | What it does |
|---|---|---|
| Destinations | Lobby, Stage, GroupA, GroupB, GroupC | Each line is { Button = "Lobby", Part = "LobbyTP" }, with an optional MinimumRank = 40. |
Teleporting
| Setting | Standard | What it does |
|---|---|---|
| HeightAbove | 3 | Studs above the part players arrive at. |
| CooldownSeconds | 2 | Seconds a player waits between teleports. |
| CloseAfterTeleport | false | Close the window after teleporting. |
The Window
| Setting | Standard | What it does |
|---|---|---|
| ShowOpenButton | true | The TP button on the left, for players with MinimumRank. |
| OpenButtonText | "Teleport" | The label when hovering over it. |
| UseOpenKey | false | Open the window with a key. |
| OpenKey | Enum.KeyCode.T | That key. |
| BackgroundBlur | 12 | Blur behind the window. 0 is off. |
| PlaySounds | true | Click sounds. |
| VerboseLogging | false | Print every teleport and refusal. |
Troubleshooting
Open Output and look for lines starting with [PROVA |. All PC- codes are also on Error Codes.
| You see | It means | What to do |
|---|---|---|
| No part named "LobbyTP" exists in Workspace | A destination part is missing or misnamed. | Place Your Destinations. |
| No TP button | No licence yet, rank below MinimumRank, or ShowOpenButton is false. | Look for a PC- code, then check TeleportConfig. |
| A place button is missing | It isn’t in Destinations, or the rank is below its MinimumRank. | Check Destinations. |
| Nothing happens when pressing a place | Wait CooldownSeconds between teleports, or the part is missing. | Check Output. |
| isn’t valid / was skipped | A typing mistake in TeleportConfig. | The message names it. |
| PC-001 | Prova Core isn’t installed. | Install Prova Core. |
| PC-002 | Prova Core is installed twice. | Delete one PROVA | Core from each service. |
| PC-003 | No licence key found. | Add the secret. In a Studio Play, add a Local Secret or use a Team Test. |
| PC-004 | HTTP requests are off. | Turn On Allow HTTP Requests. |
| PC-005 | Prova couldn’t be reached. | Usually passes by itself. If not, check the secret’s Domain is api.withprova.app. |
| PC-006 | The key isn’t valid. | Copy it again, or rotate it on your dashboard. |
| PC-014 | You don’t own this experience. | Use it in an experience owned by you or your group. |
| PC-015 | Your licence doesn’t cover the Teleport System. | Buy its Game Pass, or remove it. |
