Refactor SceneManager / Transform; fix a number of bugs in scene/game object traversal by mitchell-merry · Pull Request #133 · LiveSplit/asr

mitchell-merry · 2026-05-11T12:48:16Z

Another one of the changes I made to asr that I need to upstream...

Why?

I'm now more and more often traversing the gameobject tree in my autosplitters. This has culminated in being able to get a field on a component of a gameobject in a scene: https://github.com/mitchell-merry/autosplitters-wasm/blob/94fbcef38134317b3a5bd7e549a483f18bed17c4/cuphead/src/memory.rs#L170 which does wonders for what's possible.

I have been maintaining a fork with a bunch of tweaks to asr to make this possible, and it's about time I upstream some of it.

Concepts of Scene/SceneManager and Transform/GameObject are a little too interwoven
- I wanted to access GameObject#activeInHierarchy, but it doesn't really make sense to expose that on the Transform directly to me. It's a feature of GameObjects - what if you don't have a transform?
- get_game_object_from_dont_destroy_on_load doesn't really make sense as a specific function, since we can already get the DDoL scene + game objects on arbitrary scenes
Existing logic has some bugs
- We have klass_name in the SceneManager offsets, but this doesn't really make sense there, since that's strictly to do with the version of Mono/IL2CPP
- When traversing root game objects, it actually traverses in reverse

What?

Split operations on a Scene into the Scene struct rather than being on SceneManager
- root_game_objects, get_root_game_object
- Removed get_game_object_from_dont_destroy_on_load (replacement is to get the DDoL scene then call get_root_game_object, like any other scene)
Scene#root_game_objects now reads next instead of prev, so the objects are read in the correct order
Add Transform#find_transform which traverses the game object tree for you via a path of game object names
Split Transform into GameObject & Transform
- Move Transform#get_name logic to GameObject#get_name, add Transform#get_game_object to Transform and make Transform#get_name use the above two
- Move Transform#classes and Transform#get_class to GameObject
Transform#get_class split into GameObject#get_class_mono and GameObject#get_class_il2cpp since the offset of klass.name depends on the mono version / il2cpp version, same way as it does in the regular path dereferencing code
Add GameObject#is_active_in_hierarchy and GameObject#is_active_self, which are self-explanatory

Testing

TODO:

Test on Mono versions
Test on IL2CPP versions
- since the offsets change here for class name especially.

…t of SceneManager and Scene

…ncy - by just shelling out to the Mono/il2cpp class code

mitchell-merry · 2026-05-11T12:49:20Z


 impl Class {
-    pub(super) fn get_name<const N: usize>(
+    pub fn get_from_component(


"component" isn't accurate here, but there's something in between the component and the class. not exactly sure what it is.

[ ] TODO: figure out what it is

mitchell-merry · 2026-05-11T12:49:55Z

+        }))
+    }
+
+    // TODO it's really dumb i have to split this by mono/il2cpp


we really need to implement some sort of strategy pattern here. The amount of code duplication is getting ridiculous

mitchell-merry · 2026-05-11T12:50:27Z

+                game_object_activeself: 0x5E,
+                game_object_activeinhierarchy: 0x5F,
                klass: 0x28,
-                klass_name: 0x48,


this changes depending on the mono version, which, of course it does.

Now we just store the offset to the object handle, and you have to use mono/il2cpp specific code to get the component

mitchell-merry · 2026-05-11T12:52:37Z

-    /// (and so on), as well as a list of `Component`s, which are classes (eg.
-    /// `MonoBehaviour`) containing data we might want to retrieve for the auto
-    /// splitter logic.
-    fn root_game_objects<'a>(


This makes more conceptual sense to live on the Scene rather than the SceneManager

mitchell-merry · 2026-05-11T12:53:07Z

-
-    /// Tries to find the specified root [`Transform`] from the
-    /// `DontDestroyOnLoad` Unity scene.
-    pub fn get_game_object_from_dont_destroy_on_load(


no replacement for this - get the DDoL scene from SceneManager, then call get_root_game_object as with any other Scene

mitchell-merry · 2026-05-11T12:57:02Z

+
+        iter::from_fn(move || {
+            // TODO check if this is correct on other games
+            let [_prev, next, current]: [Address; 3] = match scene_manager.pointer_size {


note: there's a change here, previously we were using [first, _, third] where first was our next element.

That's wrong: https://gist.github.com/just-ero/92457b51baf85bd1e5b8c87de8c9835e#file-list-hpp it actually causes us to go in the reverse order in the list. That caused me some issues in Cuphead

mitchell-merry · 2026-06-27T01:39:44Z

-                v_table: MonoVTableOffsets { vtable: 0x48 },
-            }),
+            (BinaryFormat::ELF | BinaryFormat::MachO, Version::V3, PointerSize::Bit64) => {
+                Some(&Self {


Not sure why this indented a level... I didn't change any offsets here.

mitchell-merry · 2026-06-27T01:54:58Z

+        const SIG_64_BIT_PE_1: Signature<13> =
            Signature::new("48 83 EC 20 4C 8B ?5 ?? ?? ?? ?? 33 F6");
+        const SIG_64_BIT_PE_2: Signature<13> =
+            Signature::new("48 83 EC 20 48 8B 2D ?? ?? ?? ?? 33 F6");


note: In my testing, newer versions of unity (Unity 6000.4.5f1 specifically) didn't work with the old sig, so I just added this new one

mitchell-merry · 2026-06-27T01:56:05Z

+    /// FIXME: This function is a bandaid while we don't have support for all
+    ///   scene manager versions in asr. We should remove this by supporting
+    ///   those versions without override.
+    pub fn attach_with_offsets(


note: Since getting all of the offsets on every unity version is quite a large task, I'm opting to just support passing in offsets manually for now.

…g the mono object and add getting the scene manager when it's not in the UnityPlayer module

mitchell-merry · 2026-06-27T12:46:02Z

+
+            (pointer_size, base_address)
+        } else {
+            // If it's not in UnityPlayer, then it's in the main module (old unity versions)


note: I'm also adding support for older versions of Unity in this PR (well except for the offsets, which have to be overridden, which I'll do in later PRs)

mitchell-merry · 2026-06-27T12:46:49Z

+                    .ok_or(Error {})
+            }
+            // FIXME: Untested on V2
+            mono::Version::V2 | mono::Version::V3 => {


note: previous logic only ever did the equivalent of the V1 branch - I found that at least V3 (or like, newer versions, don't know if it's actually split on mono versions) have an extra dereference

mitchell-merry added 3 commits May 11, 2026 20:56

Separate the concept of Transform and GameObject; separate the concep…

6c56fed

…t of SceneManager and Scene

Add isSelf function, add / update more comments

958fbd8

Create get_class_mono/il2cpp which should fix the klass_name discrepa…

f575ae4

…ncy - by just shelling out to the Mono/il2cpp class code

mitchell-merry commented May 11, 2026

View reviewed changes

mitchell-merry added 2 commits May 11, 2026 23:10

come on now

0152784

remove todo comments

25d397b

mitchell-merry changed the title ~~Transform/GameObject refactors~~ Refactor SceneManager / Transform; fix a number of bugs in scene/game object traversal May 11, 2026

mitchell-merry added 17 commits May 11, 2026 23:37

tweak

d078723

Revert changes for scene name and path as string

c974ef2

tmp

e964365

add new sig, add offsets

5ab8c87

update project settings

135f371

add cheat table

305c1c5

add to todo

440ec35

latest unity version etc

25f596a

create mono::Object and clarify everything

5df5ac0

comments

822dac3

update todo

1b3ed11

Start cleaning

50be285

remove more

1cb0786

more cleaning + formatting

03646e0

Allow manually overriding the scene manager offsets

b54ef8e

Merge branch 'master' into transform-refactor-tweaks

8679e33

Add another fixme

a24f19e

mitchell-merry commented Jun 27, 2026

View reviewed changes

Revert changes to offsets, leave note

63776b0

mitchell-merry commented Jun 27, 2026

View reviewed changes

mitchell-merry added 3 commits June 27, 2026 17:55

Add get_component_mono_object to streamline

972bb5e

Support older Unity versions by splitting on Mono version when readin…

1a29b00

…g the mono object and add getting the scene manager when it's not in the UnityPlayer module

Couple doc improvements

6657b25

mitchell-merry commented Jun 27, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Refactor SceneManager / Transform; fix a number of bugs in scene/game object traversal#133

Refactor SceneManager / Transform; fix a number of bugs in scene/game object traversal#133
mitchell-merry wants to merge 26 commits into
LiveSplit:masterfrom
mitchell-merry:transform-refactor

mitchell-merry commented May 11, 2026 •

edited

Loading

Uh oh!

mitchell-merry May 11, 2026

Uh oh!

mitchell-merry Jun 27, 2026

Uh oh!

mitchell-merry May 11, 2026

Uh oh!

mitchell-merry May 11, 2026 •

edited

Loading

Uh oh!

mitchell-merry May 11, 2026

Uh oh!

mitchell-merry May 11, 2026

Uh oh!

mitchell-merry May 11, 2026

Uh oh!

mitchell-merry Jun 27, 2026 •

edited

Loading

Uh oh!

mitchell-merry Jun 27, 2026

Uh oh!

mitchell-merry Jun 27, 2026

Uh oh!

mitchell-merry Jun 27, 2026

Uh oh!

mitchell-merry Jun 27, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Uh oh!

Conversation

mitchell-merry commented May 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mitchell-merry May 11, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mitchell-merry Jun 27, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

mitchell-merry commented May 11, 2026 •

edited

Loading

mitchell-merry May 11, 2026 •

edited

Loading

mitchell-merry Jun 27, 2026 •

edited

Loading