К основному содержанию
скилл CX Codex

roblox-teleport-matchmaking — скилл для Claude Code

Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-teleport-matchmaking -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/roblox-teleport-matchmaking/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-teleport-matchmaking/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
roblox-teleport nonlooped Скилл roblox-teleport переносит игроков Roblox между местами, серверами и зарезервированными серверами через TeleportAsync. Подскажет, как передать данные, обработать ошибки и настроить лобби. CX Codex +1 519установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-physics gamedev-skills Скилл roblox-physics для Claude Code настраивает физику и пространственные запросы в Roblox, включая сборки, ограничения и владение сетью. CX Codex +1 9 100установок roblox-building TabooHarmony Скилл roblox-building для сборки геометрии, карт и пропов в Roblox Studio через MCP или Luau. Помогает не угадывать координаты и доводить модель до проверяемого результата. CX Codex +1 4 200установок roblox-lighting TabooHarmony Скилл roblox-lighting для Claude Code и Codex. Настраивает освещение, атмосферу, цикл дня и ночи и пост-обработку в Roblox, решает проблемы с плоскими или пересвеченными сценами. CX Codex +1 3 900установок roblox-animation nonlooped Скилл roblox-animation для Claude Code и других агентов: треки, IK-позы, маркерные события и твины интерфейса для анимаций персонажей Roblox. Собирает локомоцию и эмоции без потери приоритетов. CX Codex +1 992установок

Из того же набора22

Весь набор →
roblox-text-chat Скилл roblox-text-chat для Claude Code и Cursor, который настраивает TextChatService, фильтрацию текста и чат в Roblox. Включается при добавлении чата, команд или табличек с текстом игроков. CX Codex +1 1 200установок roblox-monetization Скилл roblox-monetization для Claude Code помогает настраивать монетизацию в Roblox и разбирать сбои покупок. Подключается при работе с магазинами, пропусками, подписками, рекламой и платными случайными предметами. CX Codex +1 1 200установок roblox-physics Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок roblox-input Скилл roblox-input для Claude Code настраивает ввод игрока и камеры в Roblox. Он подключается к задачам с клавишами, способностями, транспортом, сенсорными кнопками или собственной камерой. CX Codex +1 1 200установок roblox-analytics-liveops Скилл roblox-analytics-liveops для Claude Code настраивает игровую аналитику, воронки, экономику и live-ops на Lua. Включается при добавлении событий, A/B-тестов или начислении наград. CX Codex +1 1 200установок roblox-audio Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится. CX Codex +1 1 200установок roblox-networking Скилл roblox-networking для Claude Code управляет сетевым взаимодействием клиента и сервера на Roblox, помогая настраивать RemoteEvent, RemoteFunction и оптимизировать трафик. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой