roblox-teleport-matchmaking — скилл для Claude Code
Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService.
MIT 1 200 установок ★ 131 обновлён 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a claude-codeЧто делает roblox-teleport-matchmaking
Агент применяет этот скилл, когда разработчик добавляет в проект лобби, матчевые серверы, подземелья, системы очередей или кастомизирует выбор серверов. Внутри описаны шаблоны кода на Luau для безопасного вызова TeleportAsync, повторных попыток при сбоях и передачи параметров между местами. Также скилл объясняет настройку TeleportOptions, резервных серверов, VIP-серверов и кастомных сигналов матчмейкинга в Creator Hub.
Документация разбирает структуру вселенных, передачу данных через MemoryStore и проверку типа текущего сервера по game.PrivateServerId. В материалах учтены устаревшие методы, которые заменяет TeleportAsync, а также ограничения безопасности клиентских данных.
Перед запуском кода на Luau в Roblox Studio проверьте настройки доступа в Creator Dashboard — для безопасных переходов между подмирами требуется режим «Secure within universe only».
Какие задачи решает
- настроить безопасный переход игроков между подмирами и серверами Roblox
- реализовать повторные попытки при неудачных телепортациях в Luau
- передавать параметры матча через MemoryStore между игровыми локациями
- настроить кастомные сигналы и веса для матчмейкинга в Creator Hub
Примеры запросов агенту
- Напиши код на Luau для безопасной телепортации игроков в резервный сервер с повторными попытками
- Сконфигурируй передачу данных между лобби и матчевым сервером через MemoryStore
- Настрой кастомные атрибуты и веса сигналов для матчмейкинга в Roblox
Как установить roblox-teleport-matchmaking
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a claude-code2Вручную: положить файлы
~/.claude/skills/roblox-teleport-matchmaking/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/roblox-teleport-matchmaking/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a codex2Вручную: положить файлы
.agents/skills/roblox-teleport-matchmaking/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a cursor2Вручную: положить файлы
.cursor/skills/roblox-teleport-matchmaking/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-teleport-matchmaking2Вручную: положить файлы
.github/skills/roblox-teleport-matchmaking/SKILL.md1Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a gemini-cli2Командой платформы
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-teleport-matchmakingВручную: положить файлы
.devin/skills/roblox-teleport-matchmaking/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о roblox-teleport-matchmaking
Как установить roblox-teleport-matchmaking в Claude Code?
Выполните команду npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a claude-code, а затем обратитесь к файлу ~/.claude/skills/roblox-teleport-matchmaking/SKILL.md.
Что делает roblox-teleport-matchmaking?
Скилл помогает настраивать телепортацию игроков, резервные серверы, очереди и логику матчмейкинга в играх на платформе Roblox.
Что нужно для работы с серверами в Roblox?
Для работы с приватными и резервными серверами требуются права доступа в Creator Dashboard и актуальная среда Roblox Studio с поддержкой Luau.
Исходный текст
SKILL.md · MIT
---
name: roblox-teleport-matchmaking
description: Multi-place and multi-server games - universes and places, TeleportAsync with TeleportOptions (ReservedServerId, VipServerId, specific servers, teleport data), retrying failed teleports, secure access control, lobby-to-match flows, parties and queues, Roblox matchmaking with custom signals, server type detection, data handoff. Use when adding lobbies, match servers, dungeons, parties, server browsers, or customizing server selection.
---
# Teleports, places, and matchmaking
## Structure
- A **universe** (experience) contains a start place plus sub-places. All places share DataStores,
MemoryStores, MessagingService, developer products, and passes.
- Typical layouts: Lobby (start place) → Match place (reserved servers) → back to Lobby; or a hub with
separate world places. Keep shared code in packages or a shared Rojo tree.
- **Access Control for Places** (Creator Dashboard): `Fully open`, `Limited to same universe`, or
**`Secure within universe only`** (only server-initiated teleports into non-start places — recommended
for progression gates and test places). Clients can otherwise teleport themselves anywhere in the universe.
## Teleporting (server)
```luau
--!strict
local TeleportService = game:GetService("TeleportService")
local ATTEMPTS = 5
local RETRY_DELAY = 1
local FLOOD_DELAY = 15
local function safeTeleport(placeId: number, players: { Player }, options: TeleportOptions?): (boolean, any)
local ok: boolean, result: any = false, nil
for _ = 1, ATTEMPTS do
ok, result = pcall(function()
return TeleportService:TeleportAsync(placeId, players, options)
end)
if ok then
break
end
task.wait(RETRY_DELAY)
end
if not ok then
warn("Teleport failed:", result)
end
return ok, result
end
-- A teleport can still fail after TeleportAsync succeeds: retry transient failures.
TeleportService.TeleportInitFailed:Connect(function(player, teleportResult, errorMessage, placeId, options)
if teleportResult == Enum.TeleportResult.Flooded then
task.wait(FLOOD_DELAY)
elseif teleportResult == Enum.TeleportResult.Failure then
task.wait(RETRY_DELAY)
else
warn(`Invalid teleport [{teleportResult.Name}]: {errorMessage}`)
return
end
safeTeleport(placeId, { player }, options)
end)
return safeTeleport
```
`TeleportOptions` (set **at most one** of `ReservedServerId`, `VipServerId`, `ServerInstanceId`, or it errors):
- `ReservedServerId = HttpService:GenerateGUID(false)` → a **reserved server** (private, developer-created)
— ideal for matches, dungeons, and parties. The first teleport with a new GUID creates the server; reusing
the same GUID (store it in a DataStore/MemoryStore) sends more players to it. Generate GUIDs on the server.
On arrival, `game.PrivateServerId` equals that GUID.
- `VipServerId = id` → a player's **VIP server** (its `game.PrivateServerId`), usable with any place in the
experience. Carry the id in teleport data to keep a VIP group private across places (VIP → match → VIP);
handle `TeleportInitFailed` (server closed, full, or player not allowed).
- `ServerInstanceId = jobId` → a specific public server (e.g. "join friend's server").
- `SetTeleportData(table)` → non-secure data readable on arrival with `player:GetJoinData().TeleportData`
(server) or `TeleportService:GetLocalPlayerTeleportData()` (client). **Clients can tamper with it**:
never trust it for currency, items, or permissions — use DataStores/MemoryStores keyed by user ID
or by the reserved server's `PrivateServerId`.
Deprecated: `Teleport`, `TeleportToPlaceInstance`, `TeleportToPrivateServer`, `TeleportPartyAsync`,
`TeleportToSpawnByName` → `TeleportAsync` + `TeleportOptions`. `ReserveServer`/`ReserveServerAsync`,
`ShouldReserveServer`, and `ReservedServerAccessCode` → `ReservedServerId` (old access codes still work).
```luau
--!strict
local HttpService = game:GetService("HttpService")
local TeleportService = game:GetService("TeleportService")
-- New reserved match server; returns its id so more players can be sent later.
local function teleportToNewMatch(placeId: number, players: { Player }): string
local serverId = HttpService:GenerateGUID(false)
local options = Instance.new("TeleportOptions")
options.ReservedServerId = serverId
TeleportService:TeleportAsync(placeId, players, options)
return serverId
end
return teleportToNewMatch
```
## Data handoff between places
1. Save the player's data **before** teleporting (ProfileStore: end the session / wait for save).
2. The destination loads with session locking (ProfileStore retries while the old server releases).
3. For match parameters (mode, map, team assignments), write a MemoryStore/DataStore entry keyed by
the reserved server's id (the `ReservedServerId` GUID) before teleporting; the match server reads
`game.PrivateServerId` on start and loads its config.
4. On arrival, `TeleportService:SetTeleportGui(gui)` (client, before teleport) keeps a loading screen
up across the transition; use `ReplicatedFirst` loading screens on arrival.
## Detecting server type
| Server | `game.PrivateServerId` | `game.PrivateServerOwnerId` |
| --- | --- | --- |
| Public | `""` | `0` |
| Reserved (`ReservedServerId`) | non-empty (the GUID) | `0` |
| Private (VIP) server | non-empty | owner's user id |
## Lobby → match flow
1. Players queue in the lobby (party leader invites; party members stored server-side).
2. Queue in a **MemoryStoreQueue** / sorted map by mode and rating (see `roblox-data-stores`), or use
Roblox matchmaking to fill public servers.
3. When a match forms: generate a GUID, write match config to MemoryStore keyed by it, then `TeleportAsync`
all players with `ReservedServerId = guid` (the match server reads its config via `game.PrivateServerId`).
4. Match server: waits for expected players (timeout), runs the round, saves results, teleports everyone
back to the lobby place (a public server, or the party's lobby via `ServerInstanceId`).
## Roblox matchmaking (which server a joining player gets)
Default matchmaking scores eligible public servers by signals (friends, latency, language, age group,
occupancy...) and picks the highest weighted sum. You can customize it per place in Creator Hub:
- Adjust weights of Roblox signals, or add **custom signals** based on **custom attributes**:
- Player attributes: values stored in a **DataStore** (e.g. `PlayerElo`), configured in the matchmaking settings.
- Server attributes: set at runtime with `MatchmakingService:SetServerAttribute(name, value)` (e.g.
`GameMode`, `ServerLevel`); `InitializeServerAttributesForStudio` for testing.
- Preview scores against mock servers before applying, then apply the configuration to places.
Use it for skill-based public servers; use reserved servers when you need exact team composition.
## Server lifecycle
- `game:BindToClose` for shutdown saves; `game.JobId` identifies the server; soft shutdowns after updates
(Open Cloud `:restartServers` or "Restart servers for updates") teleport players to fresh servers.
- Server browsers: each server heartbeats `{ jobId, players, mode }` into a MemoryStore sorted map
(TTL) — see `roblox-data-stores`.
## Related skills
`roblox-data-stores` (session locking, MemoryStore queues), `roblox-security` (access control),
`roblox-game-systems` (round loops), `roblox-open-cloud` (server restarts).
© EL4CTEO · MIT · EL4CTEO/roblox-skills