Scripts - Real Function Reference

스크립트, 바이트코드, 환경 쿼리.

함수 탐색	설명
`decompile`	Roblox script를 decompile하고 bytecode를 사용할 수 있으면 생성된 source text를 반환합니다. argument는 지원되는 script Instance여야 합니다. 사용할 수 있는 bytecode가 없으면 function은 nil을 반환합니다.
`dumpstring`	Roblox script object의 decompressed bytecode string을 반환합니다. dumpstring은 getscriptbytecode와 같은 C++ function에 등록되어 있으므로 동작이 동일합니다. argument는 object여야 합니다. 공유 bytecode reader는 ClassName values ModuleScript, LocalScript, CoreScript, Script를 허용합니다. Script의 경우 RunContext는 Client여야 합니다. ClassName이 없으면 function은 “Invalid Instance”를 발생시킵니다. ClassName이 지원되는 script class가 아니면 “Script expected”를 발생시킵니다. 값이 다른 RunContext의 Script이면 “Expected a Script with RunContext set to Client”를 발생시킵니다. embedded bytecode reference가 유효하지 않거나 stored bytecode 길이가 8 bytes 이하이면 function은 nil을 반환합니다. 그렇지 않으면 DecompressBytecode로 stored bytecode를 압축 해제하고 resulting bytes를 Luau string으로 반환합니다. Hash mismatch, too-short compressed data, ZSTD decompression errors는 여기서 발생하지 않고 DecompressBytecode에 의해 error text bytes로 반환됩니다.
`getcallingscript`	current Luau thread object에 저장된 script를 반환합니다. 이 function은 arguments를 받지 않습니다. stored reference인 the current thread script를 읽습니다. 그 stored reference가 expired가 아니면 function은 Instance cache로 script Instance를 push하고 반환합니다. stored reference가 expired이면 function은 nil을 반환합니다. function은 Lua call stack을 검사하지 않고, ancestor scripts를 찾지 않으며, script ClassName도 확인하지 않습니다.
`getinstancesbyclass`	Instance cache table에서 ClassName field가 요청된 string과 정확히 일치하는 instances를 반환합니다. 첫 번째 인수는 string type checking으로 읽습니다. Empty string은 “ClassName required”를 발생시킵니다. function은 새 array table을 만들고, Instance cache 아래에 저장된 cache을 반복하며, Lua type이 object인 values만 유지하고, 각 object value의 ClassName field를 읽은 뒤 요청된 className과 strcmp로 비교합니다. matches는 index 1부터 sequential로 삽입됩니다. 매칭은 exact이며 case-sensitive입니다. function은 IsA를 사용하지 않고, subclasses를 포함하지 않으며, walk descendants를 하지 않고, Parent로 filter하지 않으며, result를 sort하지 않습니다. getinstancesofclass는 같은 function의 alias입니다.
`getloadedmodules`	Returns a new array table containing live entries from loaded module list. The optional excludeCore argument is read with optional boolean handling and defaults to true when omitted or nil. If excludeCore is true, entries whose instance is a descendant of core packages or CoreGui are skipped. Expired weak entries and locked stored references without a value are skipped. The function pushes each remaining entry with Instance cache at sequential array indexes starting at 1. The function does not check ClassName, does not sort the result, and does not walk the DataModel.
`getmenv`	Returns the environment table associated with a ModuleScript. The argument must be a ModuleScript object. Invalid objects raise “Invalid Instance”, non-ModuleScript objects raise “ModuleScript expected”, and ModuleScripts without an available thread raise “invalid thread”. The function does not accept Script or LocalScript; use getsenv for those cases.
`getreferencedby`	Returns cached Instance values whose supported reference properties point to the provided Instance. The argument must be an Instance.
`getrunningscripts`	live Lua threads에서 가져온 unique script Instances의 새 array table을 반환합니다. 이 function은 arguments를 받지 않습니다. the live Luau thread list를 순회하고 각 thread node를 읽으며, thread node, weak thread ref, LiveLuaRef, Lua state, object가 없거나 expired Script stored reference가 있는 entries를 건너뜁니다. 남은 각 thread에 대해 scriptThread->object->Script()를 lock하고, script reference로 중복을 제거하고, Instance cache로 Instance를 push한 뒤 1부터 시작하는 순차 array indexes에 삽입합니다. Function은 DataModel을 스캔하지 않고, ClassName을 확인하지 않으며, result를 정렬하지 않습니다.
`getscriptbytecode`	Roblox script object의 decompressed bytecode string을 반환합니다. getscriptbytecode는 dumpstring과 같은 C++ function에 등록되어 있으므로 동작이 동일합니다. argument는 object여야 합니다. 공유 bytecode reader는 ClassName values ModuleScript, LocalScript, CoreScript, Script를 허용합니다. Script의 경우 RunContext는 Client여야 합니다. ClassName이 없으면 function은 “Invalid Instance”를 발생시킵니다. ClassName이 지원되는 script class가 아니면 “Script expected”를 발생시킵니다. 값이 다른 RunContext의 Script이면 “Expected a Script with RunContext set to Client”를 발생시킵니다. embedded bytecode reference가 유효하지 않거나 stored bytecode 길이가 8 bytes 이하이면 function은 nil을 반환합니다. 그렇지 않으면 DecompressBytecode로 stored bytecode를 압축 해제하고 resulting bytes를 Luau string으로 반환합니다. Hash mismatch, too-short compressed data, ZSTD decompression errors는 여기서 발생하지 않고 DecompressBytecode에 의해 error text bytes로 반환됩니다.
`getscriptclosure`	Loads the stored bytecode for a supported Roblox script Instance and returns it as a Lua closure. Returns nil when usable bytecode is not available.
`getscripthash`	Roblox script object의 stored bytecode string에 대한 uppercase SHA384 hex digest를 반환합니다. argument는 object여야 합니다. 공유 bytecode reader는 ClassName 값 ModuleScript, LocalScript, CoreScript, Script를 허용합니다. Script의 경우 RunContext가 Client여야 합니다. ClassName이 없으면 function은 “Invalid Instance”를 발생시킵니다. ClassName이 지원되는 script classes 중 하나가 아니면 “Script expected”를 발생시킵니다. 값이 다른 RunContext의 Script이면 “Expected a Script with RunContext set to Client”를 발생시킵니다. embedded bytecode reference가 유효하지 않거나 stored bytecode 길이가 8 bytes 이하이면 function은 nil을 반환합니다. 그렇지 않으면 정확한 stored bytecode bytes를 SHA384로 hash하고 uppercase hex string을 반환합니다. function은 DecompressBytecode를 호출하지 않으며 decompressed bytecode를 hash하지 않습니다.
`getscripts`	현재 Instance cache에 있는 script object 값을 반환합니다. 이 function은 arguments를 받지 않습니다. Instance cache 아래에 저장된 cache을 순회하고 value가 object인 entries만 고려합니다. 각 value의 ClassName field를 optional string handling으로 읽습니다. LocalScript와 ModuleScript entries는 포함됩니다. Script entries는 RunContext offset이 CLIENT 또는 PLUGIN과 같을 때만 포함됩니다. 다른 ClassName 값, string ClassName이 없는 entries, CoreScript entries는 건너뜁니다. 결과는 순차 Luau table입니다. function은 DataModel을 순회하지 않으며 sorted order를 보장하지 않습니다.
`getscriptthread`	Real이 찾을 수 있을 때 script object와 연결된 Lua thread를 반환합니다. argument는 object여야 합니다. 이 function은 값의 ClassName field를 읽고 그 field가 string이 아니면 “not a valid Instance”를 발생시킵니다. 허용되는 ClassName 값은 Script, LocalScript, ModuleScript입니다. 다른 값은 “Script expected”를 발생시킵니다. 먼저 script reference로 Real의 ScriptThreadCache를 확인합니다. cache hit이면 캐시된 Luau thread를 thread로 반환합니다. cache miss이면 Script 값은 RunContext Client여야 하며, 그렇지 않으면 function은 “Expected a Script with RunContext set to Client”를 발생시킵니다. 그런 다음 the live Luau thread list를 순회하고 각 thread node의 first weak thread reference를 LiveLuaRef로 따라가며, missing thread data 또는 expired Script stored references를 건너뛰고 각 script reference를 요청한 script와 비교합니다. match를 찾으면 해당 Luau thread를 thread로 반환합니다. match가 없으면 nil을 반환합니다.
`getsenv`	Returns the environment table associated with a LocalScript, Script, or ModuleScript. Unsupported script objects or scripts without an available thread raise the same errors as the underlying script lookup.
`loadstring`	Compiles a Luau source string and returns the loaded function. If loading fails, it returns nil and an error message. The returned function is not executed automatically.

⌘I