This tool works to detect Roblox workspaces within .rbxm(x) model files, which could potentially contain stolen/lost places. It runs on the Lune runtime environment.

Project Structure

lib/
├─ fileproc.luau           : File and directory processing
├─ cli.luau                : CLI argument parsing and usage
├─ core.luau               : Core detection logic (workspace scanning, etc)
tests/
├─ containsworkspace/      : Test cases that should contain workspaces
├─ doesntcontainworkspace/ : Test cases that shouldn't contain workspaces
├─ zlibCompressed/         : Zlib compressed test casees
├─ binaryFiles/            : Extensionless/binary test cases
detector.luau              : Main entrypoint

Installation

Prerequisites

Install the Lune runtime using rokit

Setup

Clone or download this repository and ensure all required libraries are installed:

git clone https://github.com/filoxen/workspace-detector.git
cd workspace-detector
rokit install

Usage

Basic Usage

lune run detector path/to/your/model.rbxm(x)

Options

Directory scan (recursive):

lune run detector --directory /path/to/your/directory/with/models

Output list of files containing workspaces:

lune run detector --output /path/to/your/output/file.txt

Process non-extensioned files (i.e no filetype extension / differing extension from .rbxm)

lune run detector --force-binary-read /path/to/your/model.variantfile

Print all instance names while scanning:

lune run detector --print-instance-names /path/to/your/model.rbxm

Decompress zlib-compressed files before scanning:

lune run detector --zlib-decompress /path/to/your/model.rbxm

Recursively decompress zlib

lune run detector --zlib-decompress-recursive /path/to/your/model.rbxm

Limitations

Requires valid .rbxm files (corrupted/invalid/different versioned files may cause errors)

Contributing

Contributions are welcome. Please ensure new features include documentation. Follow existing code style to the best of your ability and try not to make breaking changes.

License

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.