From 6dd3c610f0fa7cae0a86d6575c23031478e686ff Mon Sep 17 00:00:00 2001
From: ademerdogan2008 <ademerdogan2008@gmail.com>
Date: Fri, 26 Jun 2026 12:27:44 -0500
Subject: [PATCH 1/2] updated contributing.md

added tracy documentation for new users
---
 CONTRIBUTING.md | 48 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 48 insertions(+)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index bf11ae72..6ca5a289 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -62,6 +62,54 @@ Sometimes there's something that Rojo doesn't do that it probably should.
 
 Please file issues and we'll try to help figure out what the best way forward is.
 
+## Profiling with Tracy
+
+Rojo can be built with [Tracy](https://github.com/wolfpld/tracy) support to help find performance problems. Snapshot, patch, and build code paths are instrumented with the [`profiling`](https://crates.io/crates/profiling) crate.
+
+### Installing Tracy
+
+1. Download the Tracy profiler UI from the [Tracy releases page](https://github.com/wolfpld/tracy/releases), or build it from source. Each release includes a `tracy.pdf` manual with build instructions.
+2. Use a Tracy version that matches Rojo's `tracy-client` dependency. Check the `tracy-client-sys` version in [`Cargo.lock`](Cargo.lock) and find the corresponding Tracy release in the [tracy-client version table](https://crates.io/crates/tracy-client#version-support-table).
+
+### Building Rojo with Tracy support
+
+```bash
+cargo build --features profile-with-tracy
+```
+
+For meaningful performance data, prefer a release build:
+
+```bash
+cargo build --release --features profile-with-tracy
+```
+
+### Capturing a trace
+
+1. Start the Tracy profiler UI.
+2. Run Rojo with the feature enabled, for example:
+
+```bash
+cargo run --release --features profile-with-tracy -- serve
+```
+
+3. In Tracy, connect to the running `rojo` process.
+4. Perform the actions you want to profile (syncing, building, etc.) and inspect the timeline in Tracy.
+
+Short-lived commands like `build` may exit before Tracy can connect. Set `TRACY_NO_EXIT=1` to keep the process alive until you connect:
+
+```bash
+TRACY_NO_EXIT=1 cargo run --release --features profile-with-tracy -- build
+```
+
+### Adding instrumentation
+
+Use these `profiling` macros in Rust code:
+
+* `#[profiling::function]` on a function traces the entire function body.
+* `profiling::scope!("name")` traces a block within a function.
+
+These macros compile to no-ops unless the `profile-with-tracy` feature is enabled.
+
 ## Local Development Gotchas
 
 If your build fails with an error about a missing path under `plugin/Packages`, such as `plugin/Packages/Roact`, you need to update your Git submodules.

From 83ab5d8ec71cadb6baa7607f5efca4f32754ae9c Mon Sep 17 00:00:00 2001
From: ademerdogan2008 <ademerdogan2008@gmail.com>
Date: Fri, 26 Jun 2026 12:36:41 -0500
Subject: [PATCH 2/2] updated cargo.toml, and contributing.md

---
 CONTRIBUTING.md | 6 ++++--
 Cargo.toml      | 3 ++-
 2 files changed, 6 insertions(+), 3 deletions(-)

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 6ca5a289..8dcdbb1d 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -95,12 +95,14 @@ cargo run --release --features profile-with-tracy -- serve
 3. In Tracy, connect to the running `rojo` process.
 4. Perform the actions you want to profile (syncing, building, etc.) and inspect the timeline in Tracy.
 
-Short-lived commands like `build` may exit before Tracy can connect. Set `TRACY_NO_EXIT=1` to keep the process alive until you connect:
+Short-lived commands like `build` may exit before Tracy can connect. Set `TRACY_NO_EXIT=1` to keep the process alive until you connect (not supported on macOS):
 
 ```bash
-TRACY_NO_EXIT=1 cargo run --release --features profile-with-tracy -- build
+TRACY_NO_EXIT=1 cargo run --release --features profile-with-tracy -- build test-projects/benchmark_small_place --output /tmp/out.rbxlx
 ```
 
+On macOS, prefer profiling long-running commands like `serve` instead.
+
 ### Adding instrumentation
 
 Use these `profiling` macros in Rust code:
diff --git a/Cargo.toml b/Cargo.toml
index edf211a1..b950b917 100644
--- a/Cargo.toml
+++ b/Cargo.toml
@@ -31,7 +31,8 @@ default = []
 dev_live_assets = []
 
 # Run Rojo with this feature to open a Tracy session.
-# Currently uses protocol v63, last supported in Tracy 0.9.1.
+# See CONTRIBUTING.md for setup instructions. Match the Tracy GUI version to
+# the tracy-client-sys version in Cargo.lock (see the tracy-client version table).
 profile-with-tracy = ["profiling/profile-with-tracy"]
 
 [workspace]