What Does SceneLoadLogger Do?
SceneLoadLogger is like a performance detective for your VAM scenes. It tracks how long your scene takes to load and zooms in on which objects (called Atoms, like characters, props, or plugins) are causing delays. Here’s what it offers:
- Measures Scene Loading Time: Tells you how long your entire scene takes to load, from start to finish.
- Tracks Objects in Order: Records the loading time for each Atom in the order they load, showing how long each one takes and the time gap between them, so you can spot bottlenecks.
- Highlights Slow Objects: Points out which Atoms are taking too long to load, making it easy to focus on what needs fixing.
- Customizable Threshold: Now includes a slider in the UI so you can set what counts as “slow” (default: 0.005s, adjustable 0.001–0.020s).
- Detailed log output: In VAM's in-game log, output a detailed report of each object during the entire loading process.
- Clear Summary: Shows a simple summary in the VAM plugin UI, including total load time, object count, and the slowest Atoms.
- Optional Log File Output: Saves detailed logs only if enabled via UI toggle. Useful for more complex scenes with a high number of atoms, especially when VAM's in-game log is truncated due to excessive entries. Additionally, you can feed the txt file to AI for deeper analysis, diagnostics, and recommendations. Important: You must manually create the Custom/SceneLogs/ folder in your VAM directory before using the plugin, or the log file won’t save.
Why Use SceneLoadLogger?
As a creator, you want your scenes to load quickly, run smoothly, and feel professional. SceneLoadLogger empowers you by:
- Giving You Deeper Resource Control: Gain a clear, comprehensive understanding of how your scene’s resources (like characters, props, and plugins) impact performance, letting you make smarter choices during creation.
- Speeding Up Scenes: Find and fix slow-loading objects to make your scenes feel snappy.
- Saving Time: Get clear, easy-to-read insights without needing to dive into technical details.
- Perfecting Your Work: Catch performance issues before sharing your scenes, ensuring they shine.
- Hardware benchmark: Even if you're not a creator, this plugin has other uses. For example, you can record the loading time of the same complex scene twice—before and after upgrading hardware (CPU, memory, or hard drive)—to visually observe how much improvement the hardware upgrade brings.
How to Use SceneLoadLogger
SceneLoadLogger is a session plugin, meaning it works across all your scenes in VAM. It’s super easy to use, even if you’re new to VAM! Here’s how to get started:
Load the Plugin
Before loading your scene, load SceneLoadLogger as a session plugin in VAM.
Load Your Scene
With the plugin active, it automatically tracks performance every time you load a scene.
You don’t need to add it to each scene—it works globally.
View the Results
Open the plugin’s UI in the Session Plugins panel to see:
- Total time to load the scene
- Number of objects (Atoms)
- A list of the top 10 slowest Atoms
- A customizable slow threshold slider
- A toggle to enable or disable .txt log output
Save Logs (Optional)
Most of the time, you probably don’t need the log writing function. The log in the VAM game already provides detailed records, and the plugin UI offers a summary. The txt log writing is for particularly complex scenes, like those with dozens or hundreds of atoms, where the in-game log might get truncated.
To generate a log file:
- Enable the Output to .txt Log File toggle in the plugin UI
- Make sure the folder Custom/SceneLogs/ exists — it won't be created automatically
- Log files are named by timestamp and include:
- Every Atom’s load time
- Time intervals between Atom loads
- Warning markers for Atoms that exceed the threshold (
)
How It Tracks Objects
SceneLoadLogger records every Atom in load order, giving you a step-by-step view of what happens:
- Loading Time: Logs the moment each Atom finishes loading
- Time Gaps: Shows the delay between each Atom and the previous one
- Spotting Slowdowns: Any Atom exceeding your set threshold is flagged
This allows you to understand the exact flow of scene loading and identify slow points.
Tips for Creators
- Check Slow Atoms: Use the “Top 10 Slow Atoms” in the plugin UI or log file
- Follow the Order: See how one slow Atom might delay others that follow
- Test Changes: Try replacing or simplifying slow assets and re-measure load times
- Share Logs: Get feedback by sharing logs with others (from Custom/SceneLogs/)
- Use It Often: Keep SceneLoadLogger active while building to catch issues early
This plugin is released under an FC license, free to use in the public domain. As a creative auxiliary tool, it’s unlikely to be referenced as a dependency, and no credits are required.
