Scripts - Real Function Reference

Запросы сценариев, байт-кода и среды.

Навигация по функциям	Описание
`decompile`	Декомпилирует Roblox script и возвращает сгенерированный source text, когда bytecode доступен. argument должен быть поддерживаемой script Instance. Если usable bytecode недоступен, function возвращает nil.
`dumpstring`	Возвращает decompressed bytecode string для Roblox script object. dumpstring зарегистрирован на ту же C++ function, что и getscriptbytecode, поэтому его поведение идентично. argument должен быть object. Общий bytecode reader принимает значения ClassName ModuleScript, LocalScript, CoreScript и Script. Для Script RunContext должен быть Client. Если ClassName отсутствует, function вызывает “Invalid Instance”. Если ClassName не является поддерживаемой script class, function вызывает “Script expected”. Если значение является Script с другим RunContext, function вызывает “Expected a Script with RunContext set to Client”. Если embedded bytecode reference недействителен или длина stored bytecode равна 8 bytes или меньше, function возвращает nil. Иначе она распаковывает stored bytecode через DecompressBytecode и возвращает resulting bytes как Luau string. Hash mismatch, too-short compressed data или ZSTD decompression errors возвращаются как error text bytes функцией DecompressBytecode, а не выбрасываются здесь.
`getcallingscript`	Возвращает script, сохраненный в current Luau thread object. Function не принимает arguments. Она читает the current thread script, который является stored reference. Если этот stored reference не expired, function помещает script Instance через Instance cache и возвращает ее. Если stored reference expired, function возвращает nil. Function не проверяет Lua call stack, не ищет ancestor scripts и не проверяет script ClassName.
`getinstancesbyclass`	Возвращает instances из Instance cache table, у которых ClassName field точно совпадает с запрошенным string. Первый аргумент читается через string type checking. Empty string вызывает “ClassName required”. Function создает новую array table, итерирует cache, сохраненную под Instance cache, оставляет только values, чей Lua type является object, читает ClassName field каждого object value и сравнивает его через strcmp с запрошенным className. Matches вставляются sequential, начиная с index 1. Совпадение exact и case-sensitive. Function не использует IsA, не включает subclasses, не делает walk descendants, не фильтрует по Parent и не сортирует result. getinstancesofclass является alias той же function.
`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`	Возвращает новую array table с unique script Instances, взятыми из live Lua threads. Function не принимает arguments. Она проходит по the live Luau thread list, читает каждый thread node и пропускает entries без thread node, без weak thread ref, без LiveLuaRef, без Lua state, без object или с expired Script stored reference. Для каждого оставшегося thread она блокирует scriptThread->object->Script(), удаляет дубликаты по script reference, помещает Instance через Instance cache и вставляет его в последовательные array indexes, начиная с 1. Function не сканирует DataModel, не проверяет ClassName и не сортирует result.
`getscriptbytecode`	Возвращает decompressed bytecode string для Roblox script object. getscriptbytecode зарегистрирован на ту же C++ function, что и dumpstring, поэтому его поведение идентично. argument должен быть object. Общий bytecode reader принимает значения ClassName ModuleScript, LocalScript, CoreScript и Script. Для Script RunContext должен быть Client. Если ClassName отсутствует, function вызывает “Invalid Instance”. Если ClassName не является поддерживаемой script class, function вызывает “Script expected”. Если значение является Script с другим RunContext, function вызывает “Expected a Script with RunContext set to Client”. Если embedded bytecode reference недействителен или длина stored bytecode равна 8 bytes или меньше, function возвращает nil. Иначе она распаковывает stored bytecode через DecompressBytecode и возвращает resulting bytes как Luau string. Hash mismatch, too-short compressed data или ZSTD decompression errors возвращаются как error text bytes функцией DecompressBytecode, а не выбрасываются здесь.
`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`	Возвращает uppercase SHA384 hex digest для stored bytecode string из Roblox script object. Argument должен быть object. Общий helper GetBytecode принимает значения ClassName ModuleScript, LocalScript, CoreScript и Script. Для Script значение RunContext должно быть Client. Если ClassName отсутствует, function вызывает ошибку “Invalid Instance”. Если ClassName не является одной из поддерживаемых script classes, вызывается “Script expected”. Если значение является Script с другим RunContext, вызывается “Expected a Script with RunContext set to Client”. Если embedded bytecode reference недействителен или длина stored bytecode равна 8 bytes или меньше, function возвращает nil. Иначе она вычисляет SHA384 для точных stored bytecode bytes и возвращает uppercase hex string. Function не вызывает DecompressBytecode и не хеширует decompressed bytecode.
`getscripts`	Возвращает значения script object, которые сейчас находятся в Instance cache. Function не принимает arguments. Она перебирает cache, сохраненную под ключом Instance cache lightobject, и рассматривает только entries, где value является object. Поле ClassName каждого value читается через optional string handling. Entries LocalScript и ModuleScript включаются. Entries Script включаются только если их RunContext offset равен CLIENT или PLUGIN. Другие значения ClassName, entries без string ClassName и entries CoreScript пропускаются. Результат представляет собой последовательную Luau table. Function не обходит DataModel и не гарантирует sorted order.
`getscriptthread`	Возвращает Lua thread, связанный с script object, когда Real может его найти. Argument должен быть object. Function читает поле ClassName у значения и вызывает “not a valid Instance”, если это поле не является string. Допустимые значения ClassName: Script, LocalScript и ModuleScript; любое другое значение вызывает “Script expected”. Сначала она проверяет ScriptThreadCache Real по script reference. При cache hit возвращает сохраненный Luau thread как thread. При cache miss значения Script должны иметь RunContext Client, иначе function вызывает “Expected a Script with RunContext set to Client”. Затем она проходит по the live Luau thread list, следует по first weak thread reference каждого thread node к 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