{"id":"sbi-n/serius","name":"serius","scope":"sbi-n","platform":"roblox","description":"Mirrored from the Wally registry.","version":"0.1.1","latest":"0.1.1","versions":["0.1.1"],"license":"MIT","licenseRating":"safe","licenseCaveats":["License identified from the packaged LICENSE file; the manifest declared none."],"licenseVerified":true,"dependencies":{},"integrity":"863f16690d9a7abdc85bdbbfc630d4c72cb06ea5185418b690d39d98012edf4d","likes":0,"downloads":0,"install":"forest install sbi-n/serius","url":"https://forest.dev/p/roblox/sbi-n/serius","files":"https://api.forest.dev/ai/package/roblox/sbi-n/serius/files","readme":"# serius\nRoblox binary model serialization using `buffer` and `ReflectionService`.\n\n```luau\nconst Serius = require(\"./serius\")\n\nlocal bytes = Serius.serialize_model(workspace.Model)\nlocal roots = Serius.deserialize_model(bytes)\nfor _, instance in roots do\n\tinstance.Parent = workspace\nend\n```\n\n`serialize_model(model: Instance | { Instance }): buffer` includes the supplied\nroots and their descendants. Duplicate and overlapping roots are included once.\nInstance references outside the serialized hierarchy become `nil`.\n\n`deserialize_model(bytes: buffer): { Instance }` returns detached roots with their\nproperties, descendants, internal references, attributes, and tags restored.\nMeshParts with mesh content are created concurrently with `AssetService:CreateMeshPartAsync`\nbefore properties and references are restored, preserving their mesh IDs and\ncollision, render, and fluid fidelity settings. This function may yield until all\nmesh requests finish. Mesh creation failures emit a warning and fall back to empty\nMeshParts, allowing the remaining properties, hierarchy, and references to be restored.\nFor engine-generated RBXM, collision fidelity is recovered from physical config\nheaders (versions 0, 7, and 8) when no explicit property is present.\nFailed imports wait for outstanding requests and destroy the instances they created.\n\nThe reader extends [Bolt's rbxm.luau](https://github.com/unityjaeger/Bolt/blob/main/BoltMesh/Modules/rbxm.luau)\nand accepts uncompressed, LZ4, and Zstd chunks. The writer emits uncompressed RBXM.\nThe original `read_model`, `read_shared_strings`, and `internal` exports remain available.\n\nProperty discovery calls `ReflectionService` for each operation without caching\nclass or property metadata; access follows the calling script's capabilities.\nProperties that Luau cannot both read and write are omitted,\nincluding engine identifiers, internal mesh data, and script source when source\naccess is unavailable. MeshPart geometry is reloaded from its mesh asset rather\nthan embedded in the buffer. Union/Intersect/Negate geometry is not restored;\nonly their accessible properties and hierarchy are recreated.\nServices and other non-creatable classes are rejected.\n\n`src/init.luau` provides the public API and restores instance hierarchies.\n`src/Rbxm.luau` reads and writes the RBXM container, `src/Values.luau` handles\nbinary values and attributes, and `src/Reflection.luau` handles property discovery\nand access.\n\nBuild the ModuleScript with `rojo build -o serius.rbxm`.\n\n## Releases\n\nPublishing a GitHub Release automatically publishes `sbi-n/serius` to Wally.\nBefore the first release, run `wally login` with an account that can publish to\nthe `sbi-n` scope. Copy the token for `https://api.wally.run/` from\n`~/.wally/auth.toml` into the repository's `WALLY_AUTH_TOKEN` Actions secret.\n\nFor each release, update `package.version` in `wally.toml`, commit and push the\nchanges, then publish a GitHub Release from that commit. Wally uses the version\nin `wally.toml`; the release tag does not change it. Draft releases do not publish\nto Wally.\n","readmeTruncated":false}