에러 코드 색인

quad가 던지는 모든 에러 메시지는 QuadNNNN 식별자로 시작합니다 — Luau가 붙이는 파일:줄: 접두 바로 뒤, 첫 토큰입니다.

Main.client.luau:12: Quad0042 Slot:List: duplicate key "a"

• 번호 하나는 실수 하나입니다. 같은 규칙을 어기면 어느 경로로 닿았든(직접 넘겼든 State에 담겼든, q.debug를 켰든 껐든, Effect든 Observer든) 같은 번호이고, 어디서 났는지는 메시지의 주어가 말합니다. Effect: fn must be a function처럼 API가 자기 인자 모양을 검사하는 것은 API마다 다른 규칙이라 번호도 따로입니다.
• 어떤 실수가 어느 번호로 보고되는지는 4.0.0부터 계약입니다 — 바꾸면 메이저 버전입니다. 문구는 계약이 아닙니다 — 메시지는 번호를 머리에 담을 뿐이고 그 뒤의 글은 언제든 바뀔 수 있으니, 검색·분기는 번호로 하세요(Fallback의 err가 문자열일 때 string.match(err, "Quad%d%d%d%d")).
• 한 번 붙은 번호는 다른 뜻으로 재사용하지 않습니다. 폐기된 번호는 각 페이지 끝 “폐기된 번호” 절의 접힌 목록에 남아 지금 쓰는 번호를 가리킵니다.
• 번호에 뜻은 없습니다 — 층은 메시지의 주어(Slot:List:·Tween:…)가 말해 주고, 아래 페이지는 그 층별로 묶여 있습니다.
• 엔진(Roblox)이 내는 에러에는 번호가 없습니다 — 번호가 없으면 quad 밖에서 난 것입니다.
• 절마다 고치려면은 그 에러의 원인을 고치는 법만 적습니다. 에러가 난 뒤 무엇이 남는지는 원인을 찾는 데 도움이 될 때만 따로 관측(계약 아님) 줄로 적습니다 — 지금의 동작을 기록한 것이지 정리 절차의 약속이 아니고, 다음 버전에서 달라질 수 있습니다. 던진 뒤에 대해 quad가 약속하는 것은 관측과 계약의 둘뿐이고, 그중 하나(던진 Effect는 죽는다)에 해당하는 절은 에러 뒤 줄로 적습니다.

페이지	층
반응형 코어	Source/State/Store/Blocker/Context/Operator/Debounce·Throttle/Gate
디스패치와 장부	Dispatch/Bookkeeping/Modifier/None/핸들러 계약
Slot	Slot CRUD·:List·:Single·dispose
Ref·Observer·Effect·훅	Ref/PreRef/PostRef/Observer/Effect/생명주기 훅
Tag·Attr	Tag/Attr/AttrKey/타입드 Attr
모듈·백엔드 계약	UseProvider/플러그인/Brand/ModuleIdentity/미설치 op 스텁/bindLifetime·unbindLifetime/Relate/Claim(base)
Roblox — Elem·Claim·핸들러	Elem/Modifier/Spread/Mapper/Claim/Property/Event/OnChange/OnEvent/Out/숏핸드
Roblox — Tween·Animate	Tween/Animate
슈거	Fallback/Traceback(버전 검사 type_version_check는 타입 시점 진단이라 이 번호 체계 밖)

번호와 문서의 정합은 scripts/error-codes.py가 지킵니다(소스의 모든 번호에 절이 있어야 하고, 한 번호를 여러 자리에서 던지려면 그 자리마다 공유 표시가 있어야 합니다).