로블록스 플레이 노트

Roblox Studio Instance Attribute tool

로블록스 Attribute Luau 코드 생성기

Instance 변수와 Attribute 이름, 값 형식을 입력하면 SetAttribute()·GetAttribute()·변경 감지 코드를 만듭니다. 입력은 이 브라우저 안에서만 처리하며 Roblox 계정이나 게임에 연결하지 않습니다.

Attribute 값 입력

target처럼 이미 Instance를 가리키는 Luau 변수 이름을 입력하세요. 객체 경로 코드는 별도로 준비해야 합니다.

영문자·숫자와 마침표(.), 하이픈(-), 슬래시(/), 밑줄(_)만 사용하며 100자 이하로 검사합니다. RBX로 시작하는 이름은 제외합니다.

이 도구는 초보자가 자주 쓰는 다섯 형식만 생성합니다. 다른 지원 형식은 Studio의 Attributes 창과 최신 공식 문서를 확인하세요.

줄바꿈·따옴표·역슬래시는 Luau 문자열에 맞게 이스케이프합니다. 최대 500자는 이 페이지의 입력 제한입니다.

GetAttributeChangedSignal()로 이 이름의 값이 바뀔 때만 실행되는 연결을 추가합니다.

Attribute 이름과 값을 입력한 뒤 Luau 코드 생성하기를 누르세요.

변수 이름이 같아도 대상 Instance 보존

Instance 변수 이름을 attributeName, Attribute 이름을 Speed로 입력하면 도우미 이름과 겹칩니다. 생성 코드는 do ... end 블록 안에서 대상 Instance를 먼저 보관한 뒤 이름·현재값·새 값을 선언합니다. currentValue나 newValue를 입력해도 같은 원칙을 적용합니다.

Studio에서 local attributeName = workspace:WaitForChild("Part")를 준비한 뒤 생성 코드를 붙이고 Part의 Speed Attribute를 확인하세요. 해당 Part가 없으면 실제 경로로 바꾸는 단계가 먼저입니다. 이 페이지는 브라우저에서 코드 생성을 확인했으며 실제 Instance 변경·복제 동작은 실행하지 않았습니다.

문서 재확인·도구 수정: 2026년 10월 24일 · 작성: Robux.co.kr 운영자. 입력·예상·브라우저 출력 검증 기록에서 같은 값으로 재현할 수 있습니다. Roblox Studio·Player 실행 검증은 포함하지 않습니다.

생성한 코드를 Studio에 옮기는 순서

  1. Explorer에서 Attribute를 붙일 Instance를 고르고, 기존 Attributes 목록에 같은 이름이 있는지 확인합니다.
  2. Script에서 그 Instance를 가리키는 변수를 준비합니다. 경로가 길면 Instance 경로 코드 생성기로 target 변수를 먼저 만들 수 있습니다.
  3. 이 페이지에 변수 이름·Attribute 이름·값 형식을 입력하고 코드를 생성합니다.
  4. 생성 코드를 붙인 뒤 Studio Play 테스트에서 Output 오류와 GetAttribute() 결과를 확인합니다.
  5. 서버와 클라이언트가 같은 Attribute를 바꾸는 구조라면 어느 쪽이 값의 기준인지 먼저 정하고, 클라이언트 입력은 서버에서 다시 검증합니다.

공식 규칙을 도구에 반영한 범위

Roblox Creator Hub의 Properties and attributes 문서는 SetAttribute()가 이름과 값을 설정하며 기존 Attribute가 없으면 새로 만든다고 설명합니다. GetAttribute()는 지정한 이름의 값을 반환하고, 해당 이름이 없으면 nil을 반환합니다.

Instance API에 따르면 Attribute 이름은 영문자·숫자에 마침표, 하이픈, 슬래시, 밑줄을 포함할 수 있지만 공백과 특수 기호는 허용되지 않습니다. 이름은 100자 이하여야 하며 Roblox 코어 스크립트가 아니라면 RBX로 시작할 수 없습니다. SetAttribute(name, nil)은 해당 Attribute를 제거합니다.

두 공개 문서의 Markdown 원문은 2026년 9월 14일 23:02 UTC에 최종 갱신된 것으로 표시됐습니다. 이는 기능의 최초 발표일이 아니라 문서 갱신 시각입니다. 2026년 9월 15일 Windows 데스크톱 브라우저에서 내용을 확인했으며, 실제 Roblox Studio에서 생성 코드를 실행한 범위는 아닙니다.

도구의 제한과 오류 복구

  • 지원 형식: String, Number, Boolean, Vector3, Color3만 생성합니다. Attribute가 지원할 수 있는 모든 Variant 형식을 열거하는 도구가 아닙니다.
  • 변수 이름: 단일 Luau 식별자만 받습니다. workspace.Part 같은 경로를 입력하지 말고 먼저 변수에 담으세요.
  • 숫자 범위: 매우 큰 오입력을 막기 위한 이 페이지의 제한입니다. Roblox Engine의 자료형 한도라고 해석하지 마세요.
  • 오류가 나면: 빨간 오류 영역의 첫 문장을 읽고 표시된 입력을 고친 뒤 다시 생성합니다. 초기화하면 String 형식과 target 기본값으로 돌아갑니다.
  • 보안: 클라이언트에서 보이는 Attribute를 권한·결제·보상 판정의 유일한 근거로 쓰지 말고 중요한 결정은 서버에서 검증하세요.

GetAttributeChangedSignal을 선택하는 기준

공식 Instance API는 GetAttributeChangedSignal(name)이 지정한 Attribute가 바뀔 때 발생하는 이벤트를 반환한다고 설명합니다. 하나의 이름만 관찰하려면 모든 Attribute 변화 뒤 이름을 검사하는 AttributeChanged보다 의도가 분명합니다. 반환되는 신호에는 새 값이 인수로 전달되지 않으므로 생성 코드는 콜백 안에서 GetAttribute()를 다시 호출합니다.

연결을 여러 번 만들면 같은 변경에 콜백이 중복 실행될 수 있습니다. UI가 열릴 때마다 새 연결을 만드는 구조라면 기존 연결을 정리하는 흐름까지 별도로 설계하세요. 이 도구는 연결 해제 시점과 객체 수명 관리를 자동으로 결정하지 않습니다.