robloxmemoryapi 0.3.0__tar.gz → 0.3.1__tar.gz

robloxmemoryapi-0.3.1/.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.1/.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.1/.luaurc

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

robloxmemoryapi-0.3.1/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.1}/PKG-INFO

@@ -1,33 +1,31 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.1
 Name: robloxmemoryapi
-Version: 0.3.0
+Version: 0.3.1
 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>
-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
+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.
+         
 Classifier: Programming Language :: Python :: 3
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: Microsoft :: Windows
 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.1/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.1/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.1}/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.1"
 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"
@@ -34,13 +34,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.1/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.0 → robloxmemoryapi-0.3.1}/src/robloxmemoryapi/__init__.py

@@ -53,7 +53,8 @@ class RobloxGameClient:
         process_name: str = "RobloxPlayerBeta.exe",
         allow_write: bool = False,
     ):
-        if platform.system() != "Windows":
+        system = platform.system()
+        if system not in {"Windows", "Darwin"}:
             self.failed = True
             return
 
@@ -66,6 +67,9 @@ class RobloxGameClient:
             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:
@@ -87,8 +91,8 @@ class RobloxGameClient:
 
     @property
     def FFlags(self):
-        if platform.system() != "Windows":
-            raise RuntimeError("This module is only compatible with Windows.")
+        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.")
 
@@ -99,10 +103,10 @@ class RobloxGameClient:
 
     @property
     def DataModel(self):
-        if platform.system() != "Windows":
-            raise RuntimeError("This module is only compatible with Windows.")
+        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)
+        return DataModel(self.memory_module)

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

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