La respuesta corta
Construye la puerta como una Part o un Model, marca Anchored, mueve su pivote al borde de las bisagras (pestaña Model, Pivot) y añade el tag Door en la ventana Properties. Un solo Script en ServerScriptService encuentra todas las puertas con el tag mediante CollectionService, les añade un ProximityPrompt ("Open", mantener E) y, en Triggered, hace tween de un NumberValue de 0 a 1 mientras mueve la puerta con door:PivotTo(closedPivot:Lerp(openPivot, alpha)). Los atributos de cada puerta eligen si gira o se desliza, el ángulo, el tiempo, el cierre automático y la llave.
- No puedes hacer tween de la posición de un Model directamente: un Model no tiene propiedad CFrame ni Position, y su
WorldPivotsolo indica dónde está su pivote. Haz tween de un NumberValue y mueve la puerta conPivotTo, que Roblox describe como la forma principal de mover modelos desde un script. - Abre las puertas en el servidor. Una puerta abierta por un LocalScript se mueve solo en la pantalla de ese jugador.
- Comprueba la llave y la distancia en el servidor. La guía de seguridad de Roblox dice que los ProximityPrompts se pueden abusar igual que los RemoteEvents, y su propio ejemplo de una comprobación que debe hacer el servidor es si el jugador tiene la llave necesaria para abrir una puerta.
En esta página
Cómo funciona una puerta con script
Una puerta que funcione en un juego en vivo tiene que moverla el servidor. Si la mueve un LocalScript, la puerta se abre en la pantalla de ese jugador y sigue cerrada para todos los demás, porque un cambio que hace un cliente se queda en ese dispositivo (consulta qué se replica y qué no, en inglés). Por eso en esta guía el dispositivo del jugador solo muestra el prompt e informa de la pulsación de la tecla, y un Script del servidor hace todo lo demás. Un uso de la puerta va así:
- El jugador se acerca a menos de 8 studs de la puerta y aparece un prompt con la acción Open y el nombre del objeto Door, y la tecla E en un teclado. Roblox muestra el botón correspondiente en un mando o en una pantalla táctil.
- El jugador mantiene E durante 0.2 segundos. El evento
Triggereddel prompt se dispara en el servidor con ese jugador. - DoorService comprueba al jugador: que esté vivo, lo bastante cerca, que no esté haciendo spam del prompt y que lleve la llave si la puerta la necesita.
- Hace tween de un número de 0 (cerrada) a 1 (abierta). Cada vez que el número cambia, mueve la puerta esa fracción del camino entre su posición cerrada y la abierta con
PivotTo. - Cuatro segundos después de que la puerta esté abierta del todo, la cierra de la misma manera. Una pulsación mientras la puerta se mueve la hace dar la vuelta desde donde esté.
| Pieza | Dónde va | Qué hace |
|---|---|---|
Script DoorService | ServerScriptService | Encuentra todas las puertas, les añade el prompt, comprueba cada uso y mueve la puerta. Es el único script de esta guía. |
El tag Door | En cada Part o Model de puerta | Marca qué es una puerta. Los tags se añaden en la ventana Properties y se guardan con el place. |
Atributos como Style y KeyName | En cada puerta (opcional) | Ajustes de una puerta: girar o deslizar, el ángulo, la velocidad, el cierre automático y la llave. |
ProximityPrompt DoorPrompt | Dentro de la puerta (lo añade DoorService) | Muestra "Open" o "Close" y dispara Triggered cuando un jugador mantiene E. |
NumberValue DoorProgress | Dentro de la puerta (lo añade DoorService) | El número que el tween mueve entre 0 y 1. Cada cambio mueve la puerta. |
Tool RedKey (opcional) | StarterPack, para probar | La llave de una puerta cerrada. Sirve cualquier Tool si su nombre coincide con el KeyName de la puerta. |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
Paso 1: construye la puerta y coloca su bisagra
- En el Explorer, pasa el ratón sobre Workspace, haz clic en el botón + e inserta una Part. Llámala
FrontDoor, pon suSizeen unos4, 7, 0.5(4 studs de ancho, 7 de alto y medio stud de grosor) y muévela al hueco de tu puerta. Una puerta hecha de varias partes también sirve: selecciónalas y pulsa Ctrl+G para agruparlas en un Model. - Marca Anchored en todas las partes de la puerta y deja CanCollide activado. Las partes ancladas nunca se mueven por la gravedad ni por colisiones, pero un script sí puede moverlas, que es justo lo que hace DoorService.
- Coloca la bisagra. Selecciona la puerta, abre la pestaña Model y activa Pivot. Haz clic y mantén pulsada la flechita de la esquina del botón Pivot y marca Snap, para que el pivote se ajuste a los puntos de esquinas, bordes y centros. Arrastra el pivote al borde de la puerta donde irían las bisagras. Una puerta corrediza puede dejar el pivote en el centro.
- Añade el tag. Con la puerta seleccionada, baja en la ventana Properties hasta Tags, haz clic en + y escribe
Door, con D mayúscula. En una puerta que es un Model, pon el tag en el Model, no en las partes de dentro. - Construye una segunda puerta, para las secciones de puerta corrediza y de llave. Inserta dos Parts más en Workspace:
Panel, de unos4, 7, 0.5, yKnob, de unos0.5, 0.5, 0.5, pegada a una cara de Panel. Selecciona las dos, pulsa Ctrl+G y cambia el nombre del nuevo Model aVaultDoor. Ancla las dos partes, mueve el modelo a un segundo hueco y añade el tagDooral Model. Su pivote puede quedarse en el centro, porque esta puerta se va a deslizar.
El pivote importa porque una puerta batiente gira alrededor de él. Si se queda en el centro, la puerta gira sobre sí misma como una puerta giratoria. En una parte, el pivote que colocas se guarda como su PivotOffset, y GetPivot lo incluye, así que el script gira la puerta exactamente alrededor del punto que elegiste. Si un Model tiene PrimaryPart, el pivote del modelo es el pivote de esa parte, y DoorService también pone el prompt en esa parte. Sin PrimaryPart, el prompt va en la primera parte que encuentre dentro del modelo. Si vas a asignar un PrimaryPart, hazlo antes de mover el pivote: asignarlo mueve el pivote del modelo al pivote de esa parte, como indica la página de las herramientas Pivot de Roblox.
Ajustes de la puerta (atributos)
Todas las puertas funcionan con los valores por defecto de abajo. Para cambiar una puerta, selecciónala, baja en la ventana Properties hasta Attributes, haz clic en +, escribe el nombre, elige el tipo y haz clic en Save; luego pon el valor. DoorService lee los atributos una sola vez, cuando prepara la puerta, así que cámbialos con el juego detenido.
| Atributo | Tipo | Por defecto | Qué hace |
|---|---|---|---|
Style | string | Swing | Swing gira la puerta alrededor de su pivote. Slide la mueve de lado a lo largo de su ancho. |
OpenAngle | number | 90 | Grados que gira una puerta batiente. Un número negativo la hace girar hacia el otro lado. Mantenlo entre -179 y 179: la puerta siempre gira por el camino más corto, así que DoorService lo limita a ese rango. |
SlideDistance | number | su ancho | Studs que se mueve una puerta corrediza a lo largo de su ancho. Un número negativo la desliza hacia el otro lado. |
OpenSeconds | number | 0.6 | Cuánto tarda en abrirse o cerrarse del todo, entre 0.05 y 10. |
AutoCloseSeconds | number | 4 | Cuánto tiempo se queda abierta del todo antes de cerrarse sola. Con 0 se queda abierta hasta que alguien la cierre. |
KeyName | string | ninguno | El nombre de una Tool que el jugador debe tener para abrir la puerta, como RedKey. No lo pongas si cualquiera puede abrir la puerta. |
Paso 2: añade el script de la puerta
Pasa el ratón sobre ServerScriptService, inserta un Script llamado DoorService y pega el código de abajo. Maneja todas las puertas del place, sin importar cuántas tengan el tag. Los tres ajustes del principio se aplican a todas las puertas; los atributos del paso 1 cambian una sola.
-- Script en ServerScriptService llamado DoorService.
-- Abre y cierra cada Part o Model con el tag "Door" mediante un prompt de mantener E.
-- El servidor mueve la puerta, así que todos los jugadores ven la misma puerta, y el servidor
-- comprueba la distancia y la llave, así que nadie puede abrir de lejos una puerta cerrada con llave.
--
-- Atributos opcionales de cada puerta (ponlos en la ventana Properties):
-- Style string "Swing" (por defecto) o "Slide"
-- OpenAngle number grados que gira una puerta batiente alrededor de su pivote (por defecto 90, de -179 a 179)
-- SlideDistance number studs que se mueve una puerta corrediza a lo largo de su ancho (por defecto: su ancho)
-- OpenSeconds number cuánto tarda en abrirse (por defecto 0.6)
-- AutoCloseSeconds number se cierra sola después de este tiempo; 0 la deja abierta (por defecto 4)
-- KeyName string el nombre de una Tool que el jugador debe tener, como "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- studs
local MIN_SECONDS_BETWEEN_USES = 0.3 -- por puerta, contra el spam del prompt
local doorsSetUp: { [Instance]: boolean } = {}
local function attribute(door: Instance, name: string, default: any): any
local value = door:GetAttribute(name)
if value == nil or typeof(value) ~= typeof(default) then
return default
end
if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
return default -- NaN o infinito escrito en la ventana Properties
end
return value
end
local function hasKey(player: Player, keyName: string): boolean
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
local inBackpack = backpack and backpack:FindFirstChild(keyName)
local held = character and character:FindFirstChild(keyName)
return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end
local function setUpDoor(door: Instance)
if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
return -- ya es una puerta que funciona, o no es una parte ni un modelo
end
local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
if not (promptPart and promptPart:IsA("BasePart")) then
warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
return
end
doorsSetUp[door] = true
door.Destroying:Connect(function()
doorsSetUp[door] = nil
end)
-- Una copia de una puerta que funciona trae el prompt y el valor antiguos: quítalos
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- Calcula las posiciones cerrada y abierta una sola vez, desde donde está colocada la puerta ahora
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- Desliza a lo largo del lado plano más largo de la puerta, su ancho. Un Model se mide según los
-- lados de su pivote, una Part según su propio Size, así que no rotes el pivote de una Part corrediza
local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
local alongX = size.X >= size.Z
local width = if alongX then size.X else size.Z
local direction = if alongX then Vector3.xAxis else Vector3.zAxis
openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
else
-- Lerp siempre gira por el camino más corto, así que un ángulo mayor giraría hacia el lado equivocado
local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
end
local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
local keyName = attribute(door, "KeyName", "")
-- Hace tween de un número de 0 (cerrada) a 1 (abierta) y mueve la puerta para que coincida.
-- PivotTo mueve una sola parte o un modelo entero alrededor de su pivote.
local progress = Instance.new("NumberValue")
progress.Name = "DoorProgress"
progress.Parent = door
progress.Changed:Connect(function(alpha: number)
door:PivotTo(closedPivot:Lerp(openPivot, alpha))
end)
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "DoorPrompt"
prompt.ActionText = "Open"
prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
prompt.HoldDuration = 0.2
prompt.MaxActivationDistance = PROMPT_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = promptPart
local isOpen = false
local lastUse = 0
local moveCount = 0
local function move(open: boolean)
isOpen = open
moveCount += 1
door:SetAttribute("Open", open) -- otros scripts pueden leer esto
prompt.ActionText = if open then "Close" else "Open"
-- Un tween nuevo sobre el mismo valor cancela el anterior, así que una puerta puede dar la vuelta a medio camino.
-- Escala el tiempo según lo que le falta por recorrer.
local target = if open then 1 else 0
local seconds = openSeconds * math.abs(target - progress.Value)
TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()
if open and autoClose > 0 then
local thisMove = moveCount
task.delay(openSeconds + autoClose, function()
if moveCount == thisMove and isOpen then
move(false)
end
end)
end
end
prompt.Triggered:Connect(function(player: Player)
local now = os.clock()
if now - lastUse < MIN_SECONDS_BETWEEN_USES then
return
end
-- La guía de seguridad de Roblox dice que los prompts se pueden abusar como los remotes, así que comprueba otra vez aquí
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (humanoid and rootPart) or humanoid.Health <= 0 then
return
end
if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
return -- demasiado lejos para haber usado el prompt de forma honesta
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- cerrada con llave, y este jugador no tiene la llave
end
lastUse = now
move(not isOpen)
end)
end
-- Todas las puertas con el tag ahora, y las que lo reciban después (incluidas las que clonen otros scripts)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService añade DoorPrompt y DoorProgress a cada puerta por su cuenta cuando empieza el juego, así que no hay nada que insertar a mano. Deja una sola copia del script: ya se encarga de todas las puertas con el tag.
| Parte del script | Qué hace | Por qué |
|---|---|---|
attribute() | Lee un atributo y usa el valor por defecto cuando falta, es del tipo equivocado o no es un número real (NaN o infinito). | Un error al escribir en la ventana Properties da una puerta con los ajustes por defecto, no una puerta rota. |
doorsSetUp y el bucle de restos | Prepara cada puerta una sola vez, y antes quita cualquier DoorPrompt o DoorProgress copiado de otra puerta. | Si no, una copia de una puerta que funciona tendría dos prompts, uno de ellos muerto. |
closedPivot y openPivot | Se calculan una sola vez, desde donde está la puerta cuando se prepara. Una batiente gira el pivote alrededor de su propio eje vertical; una corrediza lo mueve a lo largo del lado más largo de la puerta. | Interpolar con Lerp del pivote cerrado al abierto mantiene el pivote en su sitio mientras la puerta gira, así que el borde de las bisagras no se mueve en todo el giro. |
DoorProgress y PivotTo | El tween cambia un número; cada cambio mueve la puerta a closedPivot:Lerp(openPivot, alpha). | TweenService puede hacer tween de un NumberValue, y PivotTo mueve una parte, o un modelo con todas sus partes, para que su pivote quede en ese CFrame. |
| El prompt | HoldDuration 0.2, MaxActivationDistance 8, RequiresLineOfSight desactivado. Una puerta con llave muestra "Needs RedKey". | Con la línea de visión activada, el prompt se oculta cuando algo tapa la vista de su parte; desactivarla evita que el marco o el resto de una puerta que es un modelo lo oculten. |
move() | Empieza un tween hacia 1 o 0, con el tiempo escalado según lo que le falta por recorrer a la puerta. | Un tween nuevo sobre el mismo valor cancela el anterior, así que una puerta que da la vuelta a medio camino retrocede con suavidad y tarda la mitad. |
| Cierre automático | Espera el tiempo de apertura más AutoCloseSeconds, y luego cierra la puerta solo si moveCount no ha cambiado. | Un temporizador viejo nunca cierra una puerta que alguien cerró y volvió a abrir mientras tanto. |
Las comprobaciones de Triggered | Un uso por puerta cada 0.3 segundos, un personaje vivo, a menos de 14 studs de la parte del prompt, y la llave, pero solo para abrir. | Todo lo que un cliente puede disparar se puede abusar, así que el servidor repite las comprobaciones. Los 14 studs son los 8 del prompt más 6 de margen para un jugador que se movió mientras mantenía E. |
El atributo Open | Se pone en la puerta en cada movimiento. | Los atributos puestos en el servidor se replican a todos los jugadores, así que otros scripts, incluidos los LocalScripts, pueden escuchar con GetAttributeChangedSignal("Open"). |
Poner un tag a cada puerta y manejarlas desde un solo script es el patrón que recomienda Roblox: su referencia de CollectionService dice que, si te ves añadiendo el mismo script a muchos objetos, puede ser mejor un script que use CollectionService. GetTagged devuelve las puertas que existen cuando empieza el script, y GetInstanceAddedSignal detecta las puertas que reciben el tag o se añaden después. La guía de scripts de cliente y servidor (en inglés) cubre esta forma de organizar un place.
Haz una puerta corrediza
Selecciona VaultDoor, añade un atributo string llamado Style y ponlo en Slide. Entonces la puerta se mueve de lado y no gira: lo que mide su propio ancho, o SlideDistance studs si lo defines. Para deslizarla hacia el otro lado, usa una distancia negativa, como -4 para una puerta de 4 studs. Cualquier otra puerta, incluida FrontDoor, se desliza igual en cuanto tiene este atributo.
DoorService mide los dos tamaños horizontales de la puerta, su ancho y su grosor, y la desliza a lo largo del más largo. En un Model mide con GetExtentsSize, cuya caja sigue la orientación del pivote del modelo, así que una puerta girada 90 grados después de agruparla se sigue deslizando a lo largo de su ancho y no de su grosor. En una Part mide el Size de la propia parte, así que no rotes el pivote de una parte corrediza. Moverlo no da problemas.
- Puertas dobles: dos mitades con el tag, una al lado de la otra, las dos con
StyleSlide, y una con unSlideDistancenegativo para que se separen por el medio. Para puertas dobles batientes, pon el pivote de cada mitad en su borde exterior y dale a una mitad unOpenAnglenegativo. Cada mitad tiene su propio prompt y se abre por separado. Si las mitades se mueven una contra la otra, pasa el signo menos a la otra mitad. - Un portón que sube: este script solo desliza a lo largo del ancho de la puerta. Para levantar las puertas, pon
directionen el script aVector3.yAxis(entonces todas las puertas corredizas suben) y dale a cada una unSlideDistanceigual a su altura. - Una puerta con física: el tutorial de objetos móviles de Roblox mueve partes a lo largo de un eje con un PrismaticConstraint. Igual que la puerta con bisagra, eso es física, sin prompt ni cerradura a menos que los programes.
Cierra una puerta con llave
Una puerta con llave se abre solo para un jugador que tiene una Tool con el nombre correcto. Crea la llave y luego dile a la puerta cómo se llama:
- Pasa el ratón sobre StarterPack, haz clic en + e inserta una Tool llamada
RedKey. Inserta dentro una Part llamadaHandle, la parte que sujeta el personaje, y asegúrate de que esa parte no esté anclada: una parte anclada dentro de una tool deja al personaje clavado en el sitio. Desmarca tambiénCanBeDroppeden la Tool si los jugadores no deben poder soltar la llave para otra persona: mientras está marcado, Retroceso suelta en Workspace la tool equipada. - Selecciona VaultDoor, añade un atributo string llamado
KeyNamey ponlo enRedKey. El nombre del objeto en el prompt ahora dice Needs RedKey.
DoorService busca la llave en dos lugares. Una Tool está en el Backpack del jugador hasta que la equipa, y al equiparla pasa a su personaje, así que la puerta se abre tanto si la llave está en la barra de herramientas como si está en la mano. La comprobación se hace en el servidor porque la guía de seguridad de Roblox nombra justo este caso, si el jugador tiene la llave necesaria para abrir una puerta, como un permiso que el servidor debe verificar. Solo abrir necesita la llave: cualquiera puede cerrar una puerta abierta, y se cierra sola después de AutoCloseSeconds.
StarterPack le da la llave a todos en cada reaparición, lo cual está bien para probar. En un juego real, entrégala de otra forma:
- Desde una tienda: la guía de la GUI de tienda da Tools de ServerStorage al Backpack y al StarterGear del comprador.
- Desde un personaje: la guía de diálogo con NPC da una Tool de
ServerStorage.DialogueItemscuando el jugador elige una opción con la acciónGiveItem. Pon una Tool llamada RedKey en esa carpeta y dale a una opción de DialogueDataaction = "GiveItem"eitem = "RedKey", y la llave sale de una conversación. - Como objeto de inventario: con el sistema de inventario, un objeto llave funciona en cuanto el jugador lo equipa, porque equiparlo pone una copia de su Tool en su Backpack y en su mano.
Una llave en el Backpack se pierde cuando el personaje muere, porque Roblox vuelve a llenar el Backpack desde StarterPack y StarterGear en cada reaparición. Para conservarla, pon también una copia en el StarterGear del jugador, como hace la guía de la tienda. Para que la llave se gaste al usarla, busca la Tool de la llave en el Backpack o en el personaje del jugador y destrúyela en el manejador de Triggered, justo después de que pase la comprobación de la llave.
En qué fallan los tutoriales de puertas antiguos
Si estás comparando esta guía con un video o una publicación de un foro, estos son los patrones que causan la mayoría de los hilos de "mi puerta no funciona", y lo que hace esta guía en su lugar.
| El tutorial | El problema | Esta guía |
|---|---|---|
Hace tween del CFrame de un Model de puerta | La referencia de Model no lista ninguna propiedad CFrame ni Position. Su WorldPivot solo indica dónde está el pivote del modelo, así que hacerle tween mueve el punto de pivote y deja las partes donde están. | Hace tween de un NumberValue y mueve el modelo entero con PivotTo. |
Mueve un modelo con SetPrimaryPartCFrame | Está reemplazado: Roblox dice que uses PivotTo en el trabajo nuevo. | Usa PivotTo, que Roblox describe como la función principal para mover Models desde scripts. |
| Suelda todas las partes a una parte bisagra y hace tween solo de la bisagra | Funciona cuando todos los welds están bien, pero cualquier parte sin soldar se queda atrás cuando la bisagra se mueve. | Mantiene todas las partes ancladas y sin welds. PivotTo mueve la puerta y todo lo que tiene dentro. |
| Copia el mismo script en cada puerta | Cada arreglo hay que repetirlo en todas las copias. Roblox sugiere poner tags a los objetos y manejarlos desde un solo script con CollectionService. | Un solo DoorService y un tag Door. |
| Abre la puerta en un LocalScript | La puerta se abre solo en la pantalla de ese jugador, y todos los demás la siguen viendo cerrada. | El servidor mueve la puerta, así que todos los jugadores ven la misma puerta. |
Abre la puerta desde Touched | Touched se dispara varias veces seguidas por un solo contacto (página de debounce de Roblox), y el dispositivo de un jugador puede controlar cuándo se dispara Touched para su propio personaje (documentación de seguridad de Roblox). | Un prompt que el servidor comprueba. |
Mueve la puerta paso a paso en un bucle con wait() | Roblox marca wait() como reemplazado por task.wait(), y un bucle no puede dar la vuelta a medio camino cuando alguien vuelve a pulsar. | Un tween por movimiento. Un tween nuevo sobre el mismo valor cancela el anterior, así que la puerta da la vuelta desde donde está. |
| Comprueba la llave en un LocalScript, o no la comprueba | Un tramposo controla todo en su propio dispositivo, así que una comprobación en el cliente no detiene a nadie. | El servidor busca la Tool en el Backpack y en el personaje del jugador. |
| Sin tiempo de espera en el prompt | La guía de seguridad de Roblox dice que los prompts se pueden abusar igual que los remotes, así que nada impide dispararlo una y otra vez. | Un uso por puerta cada 0.3 segundos. |
Qué puede y qué no puede hacer un tramposo
Da por hecho que un tramposo controla todo en su propio dispositivo, incluido su personaje. Esto es lo que significa para estas puertas.
| El tramposo intenta | Resultado | Por qué |
|---|---|---|
| Disparar el prompt desde el otro lado del mapa | Se ignora a menos que su personaje esté en la puerta | DoorService mide desde la parte raíz de su personaje hasta la parte del prompt e ignora todo lo que pase de 14 studs. Puede teletransportar antes su personaje junto a la puerta (mira la última fila), así que la comprobación de distancia impide el uso desde lejos, no el teletransporte. |
| Dispararlo muchas veces por segundo | Como máximo un uso por puerta cada 0.3 segundos | El servidor guarda la hora del último uso de cada puerta. |
| Abrir una puerta con llave sin la llave | Rechazado | El servidor busca la Tool en su Backpack y en su personaje, donde él los ve, no en la pantalla del jugador. |
| Usar la puerta con su personaje muerto | Se ignora | DoorService comprueba que haya un Humanoid con más de 0 de vida y una parte raíz. |
| Atravesar una puerta cerrada de todos modos | Posible | La documentación de seguridad de Roblox incluye saltarse obstáculos físicos y cambiar su propia colisión entre las cosas que un cliente puede hacer con su propio personaje. |
| Teletransportarse al otro lado de la puerta | Posible | La misma documentación incluye teletransportar su propio personaje a cualquier posición. |
Paso 3: pruébalo
- Pulsa Play (F5). Acércate a FrontDoor: a menos de 8 studs aparece un prompt con la acción Open y el nombre del objeto Door. Mantén E. Después de 0.2 segundos la puerta gira 90 grados alrededor del borde de las bisagras en 0.6 segundos, y el prompt ahora dice Close.
- Pasa y espera. Cuatro segundos después de terminar de abrirse, la puerta se cierra sola. Mantén E mientras se cierra: da la vuelta y se abre desde donde estaba.
- Prueba la cerradura. Si RedKey está en StarterPack, muévela a ServerStorage por ahora, pulsa Play y mantén E en VaultDoor: el prompt dice Needs RedKey y nada se mueve. Detén el juego, devuelve RedKey a StarterPack y juega otra vez: VaultDoor se abre, con la llave en tu barra de herramientas o en tu mano.
- Comprueba el deslizamiento. VaultDoor, un Model con
StyleSlide, se mueve de lado lo que mide su propio ancho cuando se abre. Detén el juego, selecciona VaultDoor, gírala 90 grados con la herramienta Rotate y juega otra vez: debe seguir deslizándose a lo largo de su ancho, no de su grosor. Vuelve a girarla cuando termines. - Elige Server & Clients en el desplegable del modo de prueba, pon 2 clientes y pulsa Play. Abre una puerta en la ventana de un cliente: también está abierta en la otra ventana, y se cierra en las dos.
- Detén el juego, selecciona una puerta y pulsa Ctrl+D para duplicarla; luego mueve la copia a otro hueco. Comprueba que la copia sigue mostrando Door en Tags y pulsa Play: la copia funciona sin ningún script extra.
Deja abierta la ventana Output (menú Window y luego Output). DoorService no imprime nada cuando funciona. Una advertencia de que una puerta "has no part to put the prompt on" significa que un Model con el tag no tiene partes dentro. Consulta Errores comunes para lo demás.
Cómo ampliarlo
Puertas automáticas
Para una puerta que se abre cuando alguien se acerca, llama a move(true) desde dentro de setUpDoor en vez de esperar al prompt. Al final de setUpDoor, empieza un bucle con task.spawn, porque un bucle normal ahí nunca termina y DoorService nunca pasaría de la primera puerta. Mantenlo en marcha solo mientras la puerta esté en el juego: task.spawn(function() while door.Parent do ... task.wait(0.5) end end). Dentro del bucle, comprueba con workspace:GetPartBoundsInBox si hay un personaje dentro de una caja alrededor del hueco de la puerta, y llama a move(true) cuando lo haya y la puerta esté cerrada. El cierre automático la cierra después como antes. Pon Enabled del prompt en false si la puerta solo debe abrirse sola.
Puertas VIP
La guía de game pass (en inglés) ya construye una puerta VIP que los dueños del pase atraviesan directamente, usando grupos de colisión. Para una puerta VIP que se abre con E, añade una comprobación más en el manejador de Triggered, junto a la de la llave: haz return a menos que player:GetAttribute("OwnsPass_VIP") == true, el atributo que pone el script del servidor de la guía de game pass. Léelo solo en el servidor.
Un teclado con código
Para una puerta que se abre con un código escrito, guarda el código en un Script del servidor o en ServerStorage, que los jugadores nunca reciben, y nunca en un LocalScript, donde un tramposo puede leerlo. El LocalScript del teclado envía solo los dígitos escritos a través de un RemoteEvent. En el servidor, comprueba que el jugador está cerca de la puerta, limita cada cuánto puede intentar adivinar, compara los dígitos y solo entonces llama a move(true). La guía de RemoteEvents muestra cómo comprobar lo que recibe un remote.
Sonidos
Pon un Sound dentro de la parte de la puerta, para que suene desde la posición de esa parte, y llama a su método Play al principio de move. O reprodúcelo desde un LocalScript que escuche el atributo Open de la puerta con GetAttributeChangedSignal("Open"), ya que el servidor pone ese atributo en cada movimiento.
Puertas añadidas mientras el juego está en marcha
Clona las puertas nuevas desde una plantilla cerrada en ServerStorage. DoorService lee la posición cerrada de una puerta cuando la puerta aparece, así que una copia de una puerta que estaba abierta en ese momento tomaría su posición abierta como cerrada. Mueve la copia a su hueco con PivotTo antes de poner su Parent en Workspace, para que DoorService registre ese punto como cerrado. Los prompts y valores viejos que vienen con una copia se quitan automáticamente. Para una puerta que lleva a los jugadores a otra zona o a otro place, consulta la guía del teletransportador.
Errores comunes y soluciones
Abre la ventana Output (menú Window y luego Output) antes de pulsar Play. La mayoría de los problemas con puertas vienen de un tag, un pivote o un atributo que no es exactamente lo que espera el script.
No aparece ningún prompt en la puerta
Comprueba esto en orden: DoorService es un Script, no un LocalScript, directamente en ServerScriptService; la puerta tiene el tag Door con D mayúscula, en el propio Model si la puerta es un Model; la puerta es una parte (una Part, MeshPart u otra BasePart) o un Model; y estás a menos de 8 studs de la parte donde va el prompt. Una advertencia en Output de que la puerta "has no part to put the prompt on" significa que el Model con el tag no tiene partes dentro.
La puerta se cae, se desplaza o la empujan cuando empieza el juego
Alguna de sus partes no está anclada. Selecciona todas las partes de la puerta y marca Anchored. Las partes ancladas nunca se mueven por la física, pero DoorService sí puede moverlas.
Cambié un atributo pero la puerta lo ignora
Comprueba tres cosas. El tipo: OpenAngle, SlideDistance, OpenSeconds y AutoCloseSeconds deben ser atributos number, y Style y KeyName deben ser atributos string; DoorService usa el valor por defecto cuando el tipo está mal. La escritura: los nombres se comparan de forma exacta, así que openAngle es otro atributo. Los valores también se comparan de forma exacta: Style debe ser Slide con S mayúscula y sin espacios. El momento: DoorService lee los atributos una sola vez, cuando prepara la puerta, así que un cambio hecho durante una prueba de juego no hace nada hasta que vuelves a jugar.
La puerta gira hacia el lado equivocado, o se vuelca de lado
Para que gire hacia el otro lado, pon OpenAngle en negativo, por ejemplo -90. Si gira alrededor de un eje horizontal y no de una bisagra vertical, es que el propio pivote está rotado: activa Pivot en la pestaña Model y rota el pivote hasta que quede vertical.
Una puerta corrediza se mete en la pared o se mueve muy poco
Dale un SlideDistance negativo para que se deslice hacia el otro lado. Si se mueve de menos o de más, pon SlideDistance en la cantidad de studs que quieres en vez de depender del ancho medido.
Tengo la llave pero la puerta sigue cerrada
La llave debe ser una Tool, no una Part ni un Model, y su nombre debe coincidir exactamente con KeyName, mayúsculas incluidas. Tiene que estar en tu Backpack o en tu mano. Comprueba también que KeyName en la puerta es un atributo string.
Constrúyelo con RoCode
Si prefieres no montar todo esto a mano, RoCode puede construirlo en el place que tienes abierto. RoCode es un agente de IA independiente para Roblox Studio, no lo hace Roblox: describes el cambio en un chat web y su plugin de Studio crea los scripts y las instancias en tu Explorer, así que no hay código que pegar.
Haz que las puertas con el tag Door se abran con un prompt de mantener E: que giren 90 grados alrededor del pivote en 0.6 segundos, se cierren después de 4 segundos, se deslicen cuando el atributo Style sea Slide y sigan cerradas a menos que el jugador tenga la Tool que indica KeyName. Todo en el servidor, con una comprobación de distancia.
- Puede revisar tu place cuando un paso lo necesita, con Search Game y Search Scripts, para construir sobre los objetos, remotes o código de guardado que ya tienes en vez de añadir un segundo sistema
- Escribe el Script en ServerScriptService con Create Script, y puede crear una parte de puerta con Create Instance y ponerle atributos como Style y KeyName
- Tiene la instrucción de comprobar que cada script que escribe compila con Check Script, que lo compila en Studio sin ejecutarlo
- Pone un punto de deshacer antes y después de cada lote de cambios, así que Ctrl+Z retrocede un lote cada vez
Revisa el pivote de cada puerta con la herramienta Pivot de Studio antes de probar: la puerta gira alrededor de él. Con el plugin 3.9 o posterior RoCode puede hacer una prueba corta y leer los errores, y con el plugin 3.9.15 o posterior puede controlar un personaje de prueba que camina y pulsa teclas, pero solo comprueba lo que eligió probar, así que acércate a cada puerta y mantén E tú mismo. Cómo se conecta RoCode a Studio.
Preguntas frecuentes
¿Cómo hago una puerta que se abra con E en Roblox Studio?
Pon un ProximityPrompt en la puerta y conecta su evento Triggered en un Script del servidor, que mueve la puerta. DoorService hace las dos cosas para cada puerta con el tag Door. E es la tecla por defecto del prompt, y Roblox muestra la entrada correcta para teclados, mandos y pantallas táctiles.
¿Por qué mi puerta gira sobre su centro?
Su pivote sigue en el centro. Activa Pivot en la pestaña Model y arrastra el pivote al borde de las bisagras; el script gira la puerta alrededor del pivote.
¿Cómo hago una puerta corrediza?
Pon el atributo Style de la puerta en Slide. Se mueve de lado lo que mide su propio ancho, o SlideDistance studs; usa una distancia negativa para deslizarla hacia el otro lado.
¿Puedo hacer una puerta sin programar?
Sí. El tutorial de la puerta con bisagra de Roblox une una puerta sin anclar a su marco con un HingeConstraint, con límites, así que los jugadores la abren al empujarla caminando. Esa puerta no tiene prompt, ni cerradura, ni cierre automático.
¿Cómo hago una puerta que solo puedan abrir los VIP?
Usa la puerta VIP de la guía de game pass (en inglés), que deja pasar a los dueños del pase, o añade al manejador de Triggered de DoorService una comprobación que lea en el servidor si el jugador tiene el pase antes de abrir, como el atributo OwnsPass_VIP que pone esa guía.
¿Por qué mi puerta se abre para mí pero no para los demás jugadores?
La está abriendo un LocalScript, y un cambio que hace un LocalScript se queda en el dispositivo de ese jugador. Pasa el código que abre la puerta a un Script del servidor, como hace DoorService, para que el cambio llegue a todos.
Fuentes y lecturas
- Roblox Creator Docs: PVInstance:PivotTo (en inglés). mover una parte o un modelo entero por su pivote
- Roblox Creator Docs: Pivot tools (en inglés). mover el pivote, Snap y los puntos de ajuste, y pivotes con PrimaryPart
- Roblox Creator Docs: Model (en inglés). WorldPivot, GetExtentsSize que sigue al pivote, y SetPrimaryPartCFrame reemplazado
- Roblox Creator Docs: CFrame:Lerp (en inglés). la rotación se interpola por el arco más corto
- Roblox Creator Docs: TweenService (en inglés). qué admite tween, y un segundo tween sobre la misma propiedad cancela el primero
- Roblox Creator Docs: Proximity prompts (en inglés). crear y personalizar prompts, entradas para cada dispositivo y línea de visión
- Roblox Creator Docs: ProximityPrompt (en inglés). tecla y botón por defecto, HoldDuration, MaxActivationDistance y Triggered
- Roblox Creator Docs: CollectionService (en inglés). tags, GetTagged y GetInstanceAddedSignal
- Roblox Creator Docs: Properties window (en inglés). añadir tags y atributos en Studio
- Roblox Creator Docs: Securing the client-server boundary (en inglés). los ProximityPrompts como superficie de ataque, y la comprobación del permiso de la llave y la puerta
- Roblox Creator Docs: Network ownership, movement validation, and physics (en inglés). qué puede hacer un cliente con su propio personaje
- Roblox Creator Docs: Build a hinged door (en inglés). la puerta sin código con HingeConstraint
- Roblox Creator Docs: In-game tools (en inglés). el Handle, el anclaje y StarterPack
- Roblox Creator Docs: Tool.CanBeDropped (en inglés). qué hace Retroceso con una tool equipada
Cómo se comprobó el código: cada script de esta página pasa el verificador de tipos estricto de Luau con las definiciones de la API de Roblox (luau-lsp, 12 de noviembre de 2026). Una verificación de tipos detecta APIs mal escritas y tipos incorrectos, no la lógica del juego, así que pruébalo en Studio antes de publicar.