robloxmemoryapi 0.3.0__tar.gz → 0.3.2__tar.gz

robloxmemoryapi-0.3.2/.github/workflows/publish.yml

@@ -0,0 +1,84 @@
+name: Publish to PyPI
+
+on:
+  workflow_dispatch:
+  release:
+    types: [published]
+
+jobs:
+  build-sdist:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build source distribution
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install build
+          python -m build --sdist
+
+      - name: Upload source distribution
+        uses: actions/upload-artifact@v4
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+
+  build-wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: windows-latest
+            cibw_archs: AMD64
+          - os: macos-15-intel
+            cibw_archs: x86_64
+          - os: macos-15
+            cibw_archs: arm64
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v4
+
+      - name: Set up Python
+        uses: actions/setup-python@v5
+        with:
+          python-version: "3.11"
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.20.0
+        env:
+          CIBW_BUILD: "cp39-* cp310-* cp311-* cp312-* cp313-*"
+          CIBW_SKIP: "pp* *-musllinux*"
+          CIBW_ARCHS: ${{ matrix.cibw_archs }}
+
+      - name: Upload wheels
+        uses: actions/upload-artifact@v4
+        with:
+          name: wheels-${{ matrix.os }}
+          path: wheelhouse/*.whl
+
+  publish:
+    needs: [build-sdist, build-wheels]
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Download distributions
+        uses: actions/download-artifact@v4
+        with:
+          pattern: "*"
+          merge-multiple: true
+          path: dist
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          password: ${{ secrets.PYPI_API_TOKEN }}
+          skip-existing: true

robloxmemoryapi-0.3.2/.gitignore

@@ -0,0 +1,12 @@
+.DS_Store
+offset_finder.py
+**/__pycache__/
+dist/
+build/
+*.egg-info/
+.eggs/
+pip-wheel-metadata/
+.venv/
+venv/
+misc/BytecodeToWrite.luac
+documentation/

robloxmemoryapi-0.3.2/.luaurc

@@ -0,0 +1,5 @@
+{
+  "aliases": {
+    "lune": "~/.lune/.typedefs/0.10.4/"
+  }
+}

robloxmemoryapi-0.3.2/CMakeLists.txt

@@ -0,0 +1,18 @@
+cmake_minimum_required(VERSION 3.15)
+
+project(robloxmemoryapi_native LANGUAGES CXX)
+
+find_package(Python COMPONENTS Interpreter Development.Module REQUIRED)
+find_package(pybind11 CONFIG REQUIRED)
+
+pybind11_add_module(memory MODULE src/robloxmemoryapi/_native/memory.cpp)
+target_compile_features(memory PRIVATE cxx_std_17)
+
+if(WIN32)
+    target_link_libraries(memory PRIVATE psapi)
+endif()
+
+install(TARGETS memory
+    LIBRARY DESTINATION robloxmemoryapi/_native
+    RUNTIME DESTINATION robloxmemoryapi/_native
+)

{robloxmemoryapi-0.3.0/src/robloxmemoryapi.egg-info → robloxmemoryapi-0.3.2}/PKG-INFO

@@ -1,33 +1,32 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: robloxmemoryapi
-Version: 0.3.0
+Version: 0.3.2
 Summary: Python Library that abstracts reading and writing data from the Roblox DataModel
-Author-email: upio <notpoiu@users.noreply.github.com>, mstudio45 <mstudio45@users.noreply.github.com>, ActualMasterOogway <ActualMasterOogway@users.noreply.github.com>
+Keywords: roblox,memory,windows,macOS
+Author-Email: upio <notpoiu@users.noreply.github.com>, mstudio45 <mstudio45@users.noreply.github.com>, ActualMasterOogway <ActualMasterOogway@users.noreply.github.com>
 License: Copyright 2025 upio, mstudio45, master oogway
-        
-        Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
-        
-        The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
-        
-        THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
-        
-Project-URL: Homepage, https://github.com/notpoiu/RobloxMemoryAPI
-Project-URL: Issues, https://github.com/notpoiu/RobloxMemoryAPI/issues
-Keywords: roblox,memory,windows
+         
+         Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+         
+         The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+         
+         THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+         
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: MacOS
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: Topic :: Software Development :: Libraries
+Project-URL: Homepage, https://github.com/notpoiu/RobloxMemoryAPI
+Project-URL: Issues, https://github.com/notpoiu/RobloxMemoryAPI/issues
 Requires-Python: >=3.9
-Description-Content-Type: text/markdown
-License-File: LICENSE.md
 Requires-Dist: requests>=2.0
 Requires-Dist: zstandard>=0.19.0
 Requires-Dist: xxhash>=3.6.0
 Requires-Dist: blake3>=1.0.8
-Dynamic: license-file
+Description-Content-Type: text/markdown
 
 # RobloxMemoryAPI
 

robloxmemoryapi-0.3.2/example.py

@@ -0,0 +1,106 @@
+from robloxmemoryapi import RobloxGameClient, RobloxRandom
+from robloxmemoryapi.utils.rbx.datastructures import UDim2
+import platform
+import os
+import hashlib
+
+## Random Class ##
+Test = RobloxRandom(5)
+print("Roblox Random Demo")
+print("math.random() with seed '5' result:", Test.NextNumber())
+
+## Memory Reading ###
+if platform.system() != "Windows":
+    print("Sorry! The memory reading module only works in windows, trying to access it will cause client.failed = True")
+    exit()
+
+# Create a client instance
+# allow_write is by default False, but can be enabled by passing True
+client = RobloxGameClient(allow_write=True)
+# client = RobloxGameClient(pid=2398) # PID is also possible
+
+if client.failed:
+    print("Failed to get data model")
+    exit()
+
+# Get the client's data model
+game = client.DataModel
+
+print("")
+
+# Refresh hooks let you react when Roblox swaps between home screen and game.
+def on_refresh(datamodel):
+    if game.is_lua_app():
+        print("[Refresh] You are now in the Roblox Home Screen.")
+    else:
+        print(f"[Refresh] You are now in-game (PlaceId: {game.PlaceId})")
+
+# Register callback (optional invoke to run immediately with the current model).
+game.bind_to_refresh(on_refresh, invoke_if_ready=True)
+
+LocalPlayer = game.Players.LocalPlayer
+
+print("")
+
+# Print some info about the game
+print("RobloxMemoryAPI Demo:")
+print("An External Roblox Memory Reader")
+print("==============================")
+print("PlaceID:", game.PlaceId)
+print("GameID:", game.GameId)
+print("JobId:", game.JobId)
+print("Loaded:", game.IsLoaded())
+print("==============================")
+print("Player Name:", LocalPlayer.Name, f"({LocalPlayer.DisplayName} | userid: {LocalPlayer.UserId})")
+
+# LuaApp = Roblox Home Screen
+if not game.is_lua_app():
+    print("Player HRP Parent:", LocalPlayer.Character.PrimaryPart.GetFullName())
+    print("Health:", LocalPlayer.Character.Humanoid.Health, LocalPlayer.Character.Humanoid.MaxHealth)
+    print("Player Count:", len(game.Players.GetPlayers()))
+    print("==============================")
+    print("CurrentCamera CFrame:", game.Workspace.CurrentCamera.CFrame)
+    print("CurrentCamera FOV:", game.Workspace.CurrentCamera.FieldOfView)
+    print("CurrentCamera ViewportSize:", game.Workspace.CurrentCamera.ViewportSize)
+
+    print("")
+
+    # Attributes
+    print("Attributes:")
+    for name, attribute in game.Workspace.GetAttributes().items():
+        print(f"Attribute: '{name}' | Type: {attribute.type_name} | Value: {attribute.value}")
+    
+    print("")
+    
+    if game.Workspace.GetAttribute("Test") is not None:
+        print("Test attribute found, testing...")
+        print(f"Old attribute: {game.Workspace.GetAttribute("Test")}")
+        game.Workspace.SetAttribute("Test", "Hello World")
+        print(f"New attribute: {game.Workspace.GetAttribute("Test")}")
+
+    print("")
+
+    # Bytecode operations (READING)
+    PlayerModule = LocalPlayer.PlayerScripts.PlayerModule
+    if PlayerModule is not None and PlayerModule.Bytecode is not None:
+        print("PlayerModule Script Hash:", hashlib.sha384(PlayerModule.RawBytecode).hexdigest())
+
+    # Bytecode write operations (WRITING)
+    if os.path.exists("misc/BytecodeToWrite.luac"):
+        with open("misc/BytecodeToWrite.luac", "rb") as f:
+            BytecodeToWrite = f.read()
+        
+        PlayerModule.Bytecode = BytecodeToWrite
+        print("Set bytecode of PlayerModule to BytecodeToWrite.luac")
+    else:
+        print("misc/BytecodeToWrite.luac not found")
+else:
+    print("Roblox is not in a game. No preview data available.")
+
+# Write to the client's memory (kills player)
+#LocalPlayer.Character.Humanoid.Health = 0
+
+print("")
+
+input("Press Enter to close.\n\n")
+client.close()

robloxmemoryapi-0.3.2/misc/BytecodeGen.luau

@@ -0,0 +1,16 @@
+local fs = require("@lune/fs")
+local luau = require("@lune/luau")
+
+fs.writeFile("BytecodeToWrite.luac", luau.compile([[
+print("Hello World! :D")
+
+local function sum(...)
+    local s = 0
+    for i, v in {...} do
+        s += v
+    end
+    return s
+end
+return sum(1, 2, 3, 4)]], {
+    optimizationLevel = 2
+}))

{robloxmemoryapi-0.3.0 → robloxmemoryapi-0.3.2}/pyproject.toml

@@ -1,10 +1,10 @@
 [build-system]
-requires = ["setuptools>=68", "wheel"]
-build-backend = "setuptools.build_meta"
+requires = ["scikit-build-core>=0.10", "pybind11>=2.12"]
+build-backend = "scikit_build_core.build"
 
 [project]
 name = "robloxmemoryapi"
-version = "0.3.0"
+version = "0.3.2"
 description = "Python Library that abstracts reading and writing data from the Roblox DataModel"
 readme = { file = "README.md", content-type = "text/markdown" }
 requires-python = ">=3.9"
@@ -14,11 +14,12 @@ authors = [
   { name = "mstudio45", email = "mstudio45@users.noreply.github.com" },
   { name = "ActualMasterOogway", email = "ActualMasterOogway@users.noreply.github.com" },
 ]
-keywords = ["roblox", "memory", "windows"]
+keywords = ["roblox", "memory", "windows", "macOS"]
 classifiers = [
   "Programming Language :: Python :: 3",
   "License :: OSI Approved :: MIT License",
   "Operating System :: Microsoft :: Windows",
+  "Operating System :: MacOS",
   "Development Status :: 3 - Alpha",
   "Intended Audience :: Developers",
   "Topic :: Software Development :: Libraries",
@@ -34,13 +35,14 @@ dependencies = [
 Homepage = "https://github.com/notpoiu/RobloxMemoryAPI"
 Issues = "https://github.com/notpoiu/RobloxMemoryAPI/issues"
 
-[tool.setuptools]
-package-dir = {"" = "src"}
-include-package-data = true
-
-[tool.setuptools.packages.find]
-where = ["src"]
-
-[tool.setuptools.package-data]
-robloxmemoryapi = ["data/*.json"]
+[tool.scikit-build]
+minimum-version = "build-system.requires"
+build-dir = "build/{wheel_tag}"
+wheel.packages = ["src/robloxmemoryapi"]
 
+[tool.scikit-build.sdist]
+include = [
+  "CMakeLists.txt",
+  "src/robloxmemoryapi/**/*.cpp",
+  "src/robloxmemoryapi/**/*.py",
+]

robloxmemoryapi-0.3.2/rokit.toml

@@ -0,0 +1,7 @@
+# This file lists tools managed by Rokit, a toolchain manager for Roblox projects.
+# For more information, see https://github.com/rojo-rbx/rokit
+
+# New tools can be added by running `rokit add <tool>` in a terminal.
+
+[tools]
+lune = "lune-org/lune@0.10.4"

robloxmemoryapi-0.3.2/src/robloxmemoryapi/__init__.py

@@ -0,0 +1,231 @@
+import platform
+import math
+import os
+import subprocess
+import sys
+import tempfile
+
+from ._version import __version__
+
+__all__ = [
+    "RobloxRandom",
+    "RobloxGameClient",
+    "codesign_roblox_macos",
+    "codesign_python_macos",
+    "__version__",
+]
+
+
+def codesign_roblox_macos(
+    app_path: str | os.PathLike[str] | None = None,
+    *,
+    silicon_app_path: str | os.PathLike[str] = "/Applications/Roblox.app",
+    intel_app_path: str | os.PathLike[str] = "/Applications/RobloxPlayer.app",
+    use_sudo: bool = True,
+) -> str:
+    """Ad-hoc sign a macOS Roblox app bundle for local memory access workflows."""
+    if platform.system() != "Darwin":
+        raise RuntimeError("codesign_roblox_macos is only available on macOS.")
+
+    if app_path is None:
+        app_path = silicon_app_path if platform.machine().lower() == "arm64" else intel_app_path
+
+    app_path = os.fspath(app_path)
+    if not os.path.exists(app_path):
+        raise FileNotFoundError(app_path)
+
+    sudo_prefix = ["sudo"] if use_sudo and os.geteuid() != 0 else []
+    subprocess.run(
+        sudo_prefix + ["codesign", "--remove-signature", app_path],
+        stdout=subprocess.DEVNULL,
+        stderr=subprocess.DEVNULL,
+        check=False,
+    )
+    subprocess.run(
+        sudo_prefix + ["codesign", "--force", "--deep", "--sign", "-", app_path],
+        check=True,
+    )
+
+    return app_path
+
+
+def codesign_python_macos(
+    executable_path: str | os.PathLike[str] | None = None,
+    *,
+    use_sudo: bool = True,
+) -> str:
+    """Ad-hoc sign the Python executable/launcher with the macOS debugger entitlement."""
+    if platform.system() != "Darwin":
+        raise RuntimeError("codesign_python_macos is only available on macOS.")
+
+    if executable_path is None:
+        executable_path = sys.executable
+
+    executable_path = os.path.realpath(os.fspath(executable_path))
+    if not os.path.exists(executable_path):
+        raise FileNotFoundError(executable_path)
+
+    entitlements = """<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
+ "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>com.apple.security.cs.debugger</key>
+  <true/>
+  <key>com.apple.security.get-task-allow</key>
+  <true/>
+  <key>SecTaskAccess</key>
+  <array><string>allowed</string></array>
+</dict>
+</plist>
+"""
+
+    sudo_prefix = ["sudo"] if use_sudo and os.geteuid() != 0 else []
+    with tempfile.NamedTemporaryFile("w", suffix=".plist", delete=False) as entitlement_file:
+        entitlement_file.write(entitlements)
+        entitlement_path = entitlement_file.name
+
+    try:
+        subprocess.run(
+            sudo_prefix + ["codesign", "--remove-signature", executable_path],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            check=False,
+        )
+        subprocess.run(
+            sudo_prefix
+            + [
+                "codesign",
+                "--force",
+                "--sign",
+                "-",
+                "--entitlements",
+                entitlement_path,
+                executable_path,
+            ],
+            check=True,
+        )
+    finally:
+        try:
+            os.unlink(entitlement_path)
+        except OSError:
+            pass
+
+    return executable_path
+
+
+class RobloxRandom:
+    MULT = 6364136223846793005
+    INC = 105
+    MASK64 = (1 << 64) - 1
+
+    def __init__(self, seed):
+        s = math.floor(seed)
+
+        self._state = 0
+        self._inc = RobloxRandom.INC
+        self._next_internal()         # warm-up #1
+        self._state = (self._state + s) & RobloxRandom.MASK64
+        self._next_internal()         # warm-up #2
+
+    def _next_internal(self):
+        old = self._state
+        self._state = (old * RobloxRandom.MULT + self._inc) & RobloxRandom.MASK64
+        x = ((old >> 18) ^ old) >> 27
+        r = old >> 59
+        return ((x >> r) | (x << ((32 - r) & 31))) & 0xFFFFFFFF
+
+    def _next_fraction64(self):
+        lo = self._next_internal()
+        hi = self._next_internal()
+        bits = (hi << 32) | lo
+        return bits / 2**64
+
+    def NextNumber(self, minimum=0.0, maximum=1.0):
+        frac = self._next_fraction64()
+        return minimum + frac * (maximum - minimum)
+
+    def NextInteger(self, a, b=None):
+        if b is None:
+            u = a
+            r = self._next_internal()
+            return ((u * r) >> 32) + 1
+        else:
+            lo, hi = (a, b) if a <= b else (b, a)
+            u = hi - lo + 1
+            r = self._next_internal()
+            return ((u * r) >> 32) + lo
+
+class RobloxGameClient:
+    def __init__(
+        self,
+        pid: int = None,
+        process_name: str = "RobloxPlayerBeta.exe",
+        allow_write: bool = False,
+    ):
+        system = platform.system()
+        if system not in {"Windows", "Darwin"}:
+            self.failed = True
+            return
+
+        if system == "Darwin" and os.geteuid() != 0:
+            raise PermissionError(
+                "macOS memory access requires running the Python process with sudo/root. "
+                "Run this script with sudo and try again."
+            )
+
+        from .utils.memory import (
+            EvasiveProcess,
+            PROCESS_QUERY_INFORMATION,
+            PROCESS_VM_READ,
+            PROCESS_VM_WRITE,
+            PROCESS_VM_OPERATION,
+            get_pid_by_name,
+        )
+
+        if system == "Darwin" and process_name == "RobloxPlayerBeta.exe":
+            process_name = "RobloxPlayer"
+
+        if pid is None:
+            self.pid = get_pid_by_name(process_name)
+        else:
+            self.pid = pid
+
+        if self.pid is None or self.pid == 0:
+            raise ValueError("Failed to get PID.")
+
+        if system == "Darwin":
+            os.environ["ROBLOXMEMORYAPI_ROBLOX_PID"] = str(self.pid)
+
+        desired_access = PROCESS_VM_READ | PROCESS_QUERY_INFORMATION
+        if allow_write:
+            desired_access |= PROCESS_VM_WRITE | PROCESS_VM_OPERATION
+
+        self.memory_module = EvasiveProcess(self.pid, desired_access)
+        self.failed = False
+        self._fflags = None
+
+    def close(self):
+        self.memory_module.close()
+
+    @property
+    def FFlags(self):
+        if platform.system() not in {"Windows", "Darwin"}:
+            raise RuntimeError("This module is only compatible with Windows and macOS.")
+        elif self.failed:
+            raise RuntimeError("There was an error while getting access to memory. Please try again later.")
+
+        if self._fflags is None:
+            from .utils.rbx.fflags import FFlagManager
+            self._fflags = FFlagManager(self.memory_module)
+        return self._fflags
+
+    @property
+    def DataModel(self):
+        if platform.system() not in {"Windows", "Darwin"}:
+            raise RuntimeError("This module is only compatible with Windows and macOS.")
+        elif self.failed:
+            raise RuntimeError("There was an error while getting access to memory. Please try again later.")
+
+        from .utils.rbx.instance import DataModel
+        return DataModel(self.memory_module)

robloxmemoryapi-0.3.2/src/robloxmemoryapi/_native/__init__.py

@@ -0,0 +1 @@
+"""Native extension package for robloxmemoryapi."""