<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Software Engineering | Étienne Peillard</title><link>https://www.etiennepeillard.com/tag/software-engineering/</link><atom:link href="https://www.etiennepeillard.com/tag/software-engineering/index.xml" rel="self" type="application/rss+xml"/><description>Software Engineering</description><generator>Wowchemy (https://wowchemy.com)</generator><language>en-us</language><lastBuildDate>Mon, 02 Mar 2026 00:00:00 +0000</lastBuildDate><image><url>https://www.etiennepeillard.com/media/sharing.png</url><title>Software Engineering</title><link>https://www.etiennepeillard.com/tag/software-engineering/</link></image><item><title>Lab — Virtual reality engineering and debugging</title><link>https://www.etiennepeillard.com/teaching/lab/vr-engineering/</link><pubDate>Mon, 02 Mar 2026 00:00:00 +0000</pubDate><guid>https://www.etiennepeillard.com/teaching/lab/vr-engineering/</guid><description>&lt;h2 id="objective">Objective&lt;/h2>
&lt;p>This lab (~7 hours) aims to teach you how to &lt;strong>develop and maintain a VR application&lt;/strong> with:&lt;/p>
&lt;ul>
&lt;li>a &lt;strong>clear architecture&lt;/strong> (separation of responsibilities, explicit dependencies),&lt;/li>
&lt;li>an &lt;strong>efficient iteration workflow&lt;/strong> (test as much as possible without a headset, debug builds),&lt;/li>
&lt;li>&lt;strong>basic observability&lt;/strong> (VR overlay, structured logs),&lt;/li>
&lt;li>&lt;strong>XR debugging practices&lt;/strong>,&lt;/li>
&lt;li>an &lt;strong>introduction to VR profiling&lt;/strong> (optional, depending on the time remaining).&lt;/li>
&lt;/ul>
&lt;p>The application is a &lt;strong>VR solar system visualization workbench&lt;/strong>: a manipulable tabletop model, a world-space UI, viewing modes and time controls.&lt;/p>
&lt;hr>
&lt;h2 id="prerequisites">Prerequisites&lt;/h2>
&lt;h3 id="skills">Skills&lt;/h3>
&lt;ul>
&lt;li>C# / Unity basics (scenes, prefabs, scripts)&lt;/li>
&lt;li>Git basics (commit, tag, push)&lt;/li>
&lt;li>VR basics (comfort, world-space UI) are helpful but not essential&lt;/li>
&lt;/ul>
&lt;h3 id="tools">Tools&lt;/h3>
&lt;ul>
&lt;li>&lt;strong>Unity LTS&lt;/strong> (2022.3 or 2023 LTS)&lt;/li>
&lt;li>Unity packages:
&lt;ul>
&lt;li>&lt;strong>OpenXR&lt;/strong>&lt;/li>
&lt;li>&lt;strong>XR Interaction Toolkit (XRI)&lt;/strong>&lt;/li>
&lt;li>&lt;strong>Input System&lt;/strong>&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>An OpenXR-compatible VR headset&lt;/li>
&lt;/ul>
&lt;h3 id="resources">Resources&lt;/h3>
&lt;ul>
&lt;li>&lt;a href="PlanetData.cs">PlanetData.cs&lt;/a> (provides data and orbital calculation functions)&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="engineering-rules-required">Engineering rules (required)&lt;/h2>
&lt;p>In this lab, you must explicitly apply the following rules:&lt;/p>
&lt;ol>
&lt;li>
&lt;p>&lt;strong>No implicit dependencies&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>No &lt;code>FindObjectOfType&lt;/code>, no &lt;code>GameObject.Find&lt;/code>, no “magic” dependencies.&lt;/li>
&lt;li>Required references are injected through the Inspector or a &lt;em>bootstrapper&lt;/em>.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>No business logic in &lt;code>Update()&lt;/code> by default&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>Reserve &lt;code>Update()&lt;/code> for continuous operations that are &lt;em>actually necessary&lt;/em>.&lt;/li>
&lt;li>Prefer events, actions and controlled timers.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Separation of responsibilities&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>Data models / services (calculations, time, conversion) ≠ views (GameObjects) ≠ controllers.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Debuggability&lt;/strong>&lt;/p>
&lt;ul>
&lt;li>Every critical behavior must produce useful logs.&lt;/li>
&lt;li>Implement a &lt;strong>DebugOverlay&lt;/strong> visible in the headset.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>
&lt;p>&lt;strong>Performance&lt;/strong> &lt;em>(optional)&lt;/em>&lt;/p>
&lt;ul>
&lt;li>No avoidable per-frame allocations (strings/LINQ).&lt;/li>
&lt;li>Profiling is required (before/after evidence for one improvement).&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;hr>
&lt;h2 id="scenario-solar-system-vr-workbench">Scenario: Solar System VR Workbench&lt;/h2>
&lt;p>You will develop a VR application containing:&lt;/p>
&lt;ul>
&lt;li>a solar system tabletop model (with adjustable scale),&lt;/li>
&lt;li>planets positioned at a given time &lt;em>t&lt;/em> (calculation functions are already provided by &lt;code>PlanetData&lt;/code>),&lt;/li>
&lt;li>time controls (date + speed),&lt;/li>
&lt;li>orbits that can be shown or hidden,&lt;/li>
&lt;li>a “planet focus” mode (centering/inspection),&lt;/li>
&lt;li>a world-space VR UI to control the application,&lt;/li>
&lt;li>a debug overlay (FPS, state, recent events, warnings).&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="lab-structure">Lab structure&lt;/h2>
&lt;p>The lab consists of &lt;strong>5 main steps&lt;/strong> and &lt;strong>2 optional extensions&lt;/strong>.&lt;/p>
&lt;p>Required:&lt;/p>
&lt;p>1 — XR boot&lt;br>
2 — Architecture&lt;br>
3 — Events / simulation&lt;br>
4 — VR interactions&lt;br>
5 — UI + debug overlay&lt;/p>
&lt;p>Optional (if time allows):&lt;/p>
&lt;p>6 — Guided XR debugging&lt;br>
7 — Performance optimization&lt;/p>
&lt;hr>
&lt;h2 id="submission-organization-git">Submission organization (Git)&lt;/h2>
&lt;p>You must submit:&lt;/p>
&lt;ul>
&lt;li>a &lt;strong>Git repository&lt;/strong> (link),&lt;/li>
&lt;li>&lt;strong>Git tags&lt;/strong> for each step (v1.0, v1.1, … v2.0),&lt;/li>
&lt;li>a &lt;strong>short report&lt;/strong> (README or PDF):
&lt;ul>
&lt;li>screenshots (headset view or mirror),&lt;/li>
&lt;li>implemented features,&lt;/li>
&lt;li>architecture diagram (simple and readable),&lt;/li>
&lt;li>a “debug story” (if you completed step 6),&lt;/li>
&lt;li>a “perf story” (if you completed step 7).&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ul>
&lt;h3 id="tag-reminder">Tag reminder&lt;/h3>
&lt;p>At each step:&lt;/p>
&lt;ul>
&lt;li>&lt;code>git add .&lt;/code>&lt;/li>
&lt;li>&lt;code>git commit -m &amp;quot;…&amp;quot;&lt;/code>&lt;/li>
&lt;li>&lt;code>git tag -a v1.x -m &amp;quot;…&amp;quot;&lt;/code>&lt;/li>
&lt;li>&lt;code>git push origin main&lt;/code>&lt;/li>
&lt;li>&lt;code>git push origin --tags&lt;/code>&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="useful-concepts-for-this-lab">Useful concepts for this lab&lt;/h2>
&lt;p>Before starting, here are some important concepts we will use throughout the session. They are common in Unity projects and even more important in XR.&lt;/p>
&lt;h3 id="1--business-logic">1 — Business logic&lt;/h3>
&lt;p>&lt;strong>Business logic&lt;/strong> means the rules that define how your application works, independently of its visual presentation.&lt;/p>
&lt;p>Examples in this lab:&lt;/p>
&lt;p>Business logic:&lt;/p>
&lt;ul>
&lt;li>calculating a planet&amp;rsquo;s position at a given date&lt;/li>
&lt;li>changing the speed of time&lt;/li>
&lt;li>showing or hiding orbits&lt;/li>
&lt;li>changing the solar system&amp;rsquo;s scale&lt;/li>
&lt;/ul>
&lt;p>Display (not business logic):&lt;/p>
&lt;ul>
&lt;li>moving a GameObject&lt;/li>
&lt;li>changing UI text&lt;/li>
&lt;li>showing a panel&lt;/li>
&lt;/ul>
&lt;h6 id="bad-example">Bad example&lt;/h6>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">void&lt;/span> &lt;span class="n">Update&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">planet&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">transform&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">position&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">ComputePosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Now&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Calculation and display are mixed together.&lt;/p>
&lt;h6 id="good-example">Good example&lt;/h6>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">DateTime&lt;/span> &lt;span class="n">currentTime&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">void&lt;/span> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">currentTime&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">UpdateView&lt;/span>&lt;span class="p">();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>The logic decides &lt;strong>when&lt;/strong> to update; the view decides &lt;strong>how&lt;/strong> to display the result.&lt;/p>
&lt;h3 id="2--separation-of-responsibilities">2 — Separation of responsibilities&lt;/h3>
&lt;p>In a Unity project, it is very easy to put a lot of functionality in a single script. This works for small projects but quickly becomes difficult to maintain.&lt;/p>
&lt;p>We therefore separate the roles.&lt;/p>
&lt;h6 id="simple-structure-used-in-this-lab">Simple structure used in this lab&lt;/h6>
&lt;p>Data / Model ←→ Services ←→ Controllers ←→ Views&lt;/p>
&lt;h6 id="model-data">Model (data)&lt;/h6>
&lt;p>Contains only data.&lt;/p>
&lt;p>&lt;em>Example:&lt;/em>&lt;/p>
&lt;blockquote>
&lt;p>TimeModel&lt;/p>
&lt;ul>
&lt;li>currentTime&lt;/li>
&lt;li>timeSpeed&lt;/li>
&lt;/ul>
&lt;/blockquote>
&lt;p>A model normally does not depend on Unity.&lt;/p>
&lt;h6 id="services">Services&lt;/h6>
&lt;p>Contain calculations or rules.&lt;/p>
&lt;p>&lt;em>Example:&lt;/em>&lt;/p>
&lt;blockquote>
&lt;p>PlanetEphemerisService&lt;/p>
&lt;ul>
&lt;li>computePosition()&lt;/li>
&lt;/ul>
&lt;/blockquote>
&lt;h6 id="controllers">Controllers&lt;/h6>
&lt;p>Coordinate the application.&lt;/p>
&lt;p>They receive events and update views.&lt;/p>
&lt;p>&lt;em>Example:&lt;/em>&lt;/p>
&lt;blockquote>
&lt;p>SolarSystemController&lt;/p>
&lt;/blockquote>
&lt;h6 id="views">Views&lt;/h6>
&lt;p>Visible Unity objects.&lt;/p>
&lt;p>&lt;em>Examples:&lt;/em>&lt;/p>
&lt;blockquote>
&lt;ul>
&lt;li>PlanetView&lt;/li>
&lt;li>OrbitRenderer&lt;/li>
&lt;li>UI panels&lt;/li>
&lt;/ul>
&lt;/blockquote>
&lt;h6 id="summary">Summary&lt;/h6>
&lt;ul>
&lt;li>Model → store state&lt;/li>
&lt;li>Service → calculate&lt;/li>
&lt;li>Controller → decide what to do&lt;/li>
&lt;li>View → display&lt;/li>
&lt;/ul>
&lt;h3 id="3--bootstrapper">3 — Bootstrapper&lt;/h3>
&lt;h6 id="the-problem">The problem&lt;/h6>
&lt;p>Many Unity projects contain:&lt;/p>
&lt;ul>
&lt;li>FindObjectOfType&lt;/li>
&lt;li>GameObject.Find&lt;/li>
&lt;li>Singletons used everywhere&lt;/li>
&lt;/ul>
&lt;p>These approaches work but make the project fragile.&lt;/p>
&lt;h6 id="a-simple-solution">A simple solution&lt;/h6>
&lt;p>Create an object that initializes the application.&lt;/p>
&lt;p>This is called a &lt;strong>Bootstrapper&lt;/strong>.&lt;/p>
&lt;p>Example:&lt;/p>
&lt;blockquote>
&lt;p>AppBootstrapper&lt;/p>
&lt;/blockquote>
&lt;p>Its role:&lt;/p>
&lt;ul>
&lt;li>create services&lt;/li>
&lt;li>connect objects&lt;/li>
&lt;li>initialize data&lt;/li>
&lt;/ul>
&lt;h6 id="simple-example">Simple example&lt;/h6>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">AppBootstrapper&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">MonoBehaviour&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">SolarSystemController&lt;/span> &lt;span class="n">controller&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">Start&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="kt">var&lt;/span> &lt;span class="n">timeModel&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">new&lt;/span> &lt;span class="n">TimeModel&lt;/span>&lt;span class="p">();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">controller&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Init&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">timeModel&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Dependencies become visible and controlled.&lt;/p>
&lt;h3 id="4--events">4 — Events&lt;/h3>
&lt;p>Events allow different objects to communicate without being tightly coupled.&lt;/p>
&lt;p>Without events:&lt;/p>
&lt;p>UI → Manager → Controller → Camera&lt;/p>
&lt;p>Everything depends on everything else.&lt;/p>
&lt;p>With events:&lt;/p>
&lt;p>UI → Event → Interested objects&lt;/p>
&lt;p>Each system remains independent.&lt;/p>
&lt;h6 id="example">Example&lt;/h6>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">event&lt;/span> &lt;span class="n">Action&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>When the date changes:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">?.&lt;/span>&lt;span class="n">Invoke&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">newTime&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Another script can listen for this event:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">void&lt;/span> &lt;span class="n">Start&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">planetManager&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">OnTimeChanged&lt;/span> &lt;span class="p">+=&lt;/span> &lt;span class="n">UpdatePosition&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="5--actions">5 — Actions&lt;/h3>
&lt;p>An &lt;strong>Action&lt;/strong> is simply a function stored in a variable.&lt;/p>
&lt;p>Example:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">Action&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">callback&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>In Unity, actions are used for:&lt;/p>
&lt;ul>
&lt;li>events&lt;/li>
&lt;li>callbacks&lt;/li>
&lt;li>UI interactions&lt;/li>
&lt;/ul>
&lt;h3 id="6--managing-simulation-state">6 — Managing simulation state&lt;/h3>
&lt;p>In this application, the central variable is not really a technical “timer”. What matters is simply &lt;strong>the simulation date&lt;/strong>.&lt;/p>
&lt;p>In other words, we manipulate a &lt;strong>global state&lt;/strong>:&lt;/p>
&lt;p>Simulated date → planet positions → display&lt;/p>
&lt;p>When this date changes:&lt;/p>
&lt;ul>
&lt;li>planet positions must be recalculated&lt;/li>
&lt;li>some visualizations must be updated&lt;/li>
&lt;li>the interface can display the new value&lt;/li>
&lt;/ul>
&lt;p>Instead of constantly recalculating in &lt;code>Update()&lt;/code>, trigger an &lt;strong>event only when the state changes&lt;/strong>.&lt;/p>
&lt;h4 id="bad-approach">Bad approach&lt;/h4>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">void&lt;/span> &lt;span class="n">Update&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">UpdatePlanets&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">currentDate&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Each object constantly checks whether something has changed.&lt;/p>
&lt;h4 id="recommended-approach">Recommended approach&lt;/h4>
&lt;p>Use an event to signal a state change.&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">event&lt;/span> &lt;span class="n">Action&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>When the date changes:&lt;/p>
&lt;p>UI → PlanetManager → event → interested objects&lt;/p>
&lt;p>Example:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">void&lt;/span> &lt;span class="n">Start&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">PlanetManager&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">current&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">OnTimeChanged&lt;/span> &lt;span class="p">+=&lt;/span> &lt;span class="n">UpdatePosition&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>This provides:&lt;/p>
&lt;ul>
&lt;li>fewer unnecessary calculations&lt;/li>
&lt;li>more readable code&lt;/li>
&lt;li>easier debugging&lt;/li>
&lt;li>better VR performance&lt;/li>
&lt;/ul>
&lt;h3 id="7--why-this-matters-even-more-in-xr">7 — Why this matters even more in XR&lt;/h3>
&lt;p>In VR and XR:&lt;/p>
&lt;ul>
&lt;li>builds take longer&lt;/li>
&lt;li>bugs are harder to diagnose&lt;/li>
&lt;li>performance is critical&lt;/li>
&lt;/ul>
&lt;p>A clear architecture makes it possible to:&lt;/p>
&lt;ul>
&lt;li>test some parts without a headset&lt;/li>
&lt;li>understand a bug quickly&lt;/li>
&lt;li>modify an interaction without breaking the whole project&lt;/li>
&lt;/ul>
&lt;h3 id="8--scriptableobject">8 — ScriptableObject&lt;/h3>
&lt;p>A &lt;strong>ScriptableObject&lt;/strong> is a Unity asset used to store &lt;strong>editable parameters&lt;/strong>.&lt;/p>
&lt;p>Unlike a &lt;code>MonoBehaviour&lt;/code>, it is not attached to a GameObject.&lt;/p>
&lt;p>Example in this lab:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="na">[CreateAssetMenu(menuName = &amp;#34;XR/Solar System Config&amp;#34;)]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">SolarSystemConfig&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">ScriptableObject&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">distanceScale&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">planetSizeScale&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">bool&lt;/span> &lt;span class="n">showOrbits&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Then create the asset in Unity:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Assets → Create → XR → Solar System Config
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Assign it in the Inspector.&lt;/p>
&lt;p>Benefits:&lt;/p>
&lt;ul>
&lt;li>centralized configuration&lt;/li>
&lt;li>editable without changing code&lt;/li>
&lt;li>reusable across scenes&lt;/li>
&lt;/ul>
&lt;h3 id="what-to-remember">What to remember&lt;/h3>
&lt;p>Throughout the lab, keep asking yourself:&lt;/p>
&lt;ul>
&lt;li>Does this script do too many things?&lt;/li>
&lt;li>Does this code depend on another object unnecessarily?&lt;/li>
&lt;li>Can I understand this system quickly?&lt;/li>
&lt;li>Could I easily debug this on a VR headset?&lt;/li>
&lt;/ul>
&lt;p>If the answer to either of the last two questions is “no”, you probably need to simplify or separate responsibilities more clearly.&lt;/p>
&lt;hr>
&lt;h2 id="step-1--xr-boot--minimal-scene-tag-v10--45-min">Step 1 — XR boot + minimal scene (Tag: v1.0) — ~45 min&lt;/h2>
&lt;h3 id="objectives">Objectives&lt;/h3>
&lt;ul>
&lt;li>Have a &lt;strong>working&lt;/strong> VR scene and a &lt;strong>debuggable&lt;/strong> build pipeline.&lt;/li>
&lt;/ul>
&lt;h3 id="tasks">Tasks&lt;/h3>
&lt;ol>
&lt;li>Create the Unity project.&lt;/li>
&lt;li>Install and enable:
&lt;ul>
&lt;li>OpenXR&lt;/li>
&lt;li>XR Interaction Toolkit
&lt;ul>
&lt;li>You can add the Starter Assets (for a complete XR rig) and the XR Simulator (to test without a headset) from the package samples.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Input System&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Configure the project:
&lt;ul>
&lt;li>Enable the plug-in providers required for your headset (OpenXR, Oculus, etc.) in Player Settings / XR Plug-in Management.&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Add a VR rig (XRI):
&lt;ul>
&lt;li>XR Origin&lt;/li>
&lt;li>XR Interaction Manager&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Create a &lt;code>Boot&lt;/code> scene:
&lt;ul>
&lt;li>ground + reference frame (for example, X/Y/Z axes to show the world origin in the scene)&lt;/li>
&lt;li>an interactable cube (grab) to validate XRI&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Configure a &lt;strong>debug&lt;/strong> build:
&lt;ul>
&lt;li>Development Build&lt;/li>
&lt;li>Script Debugging&lt;/li>
&lt;li>(if possible) Autoconnect Profiler&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;h3 id="expected-deliverables">Expected deliverables&lt;/h3>
&lt;ul>
&lt;li>Screenshot (headset mirror view or XR simulator) showing the cube being grabbed in VR&lt;/li>
&lt;li>Repository tagged &lt;code>v1.0-boot&lt;/code> (remember the &lt;a href="https://github.com/github/gitignore/blob/main/Unity.gitignore" target="_blank" rel="noopener">.gitignore&lt;/a>)&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="step-2--architecture-models-services-controllers">Step 2 — Architecture: models, services, controllers&lt;/h2>
&lt;p>Tag: &lt;strong>v1.1-architecture&lt;/strong> — ~1h15&lt;/p>
&lt;h3 id="objective-1">Objective&lt;/h3>
&lt;p>Before adding VR, interactions and UI, we will &lt;strong>structure the application properly&lt;/strong>.&lt;/p>
&lt;p>In XR projects, problems often come from:&lt;/p>
&lt;ul>
&lt;li>scripts referencing each other in every direction&lt;/li>
&lt;li>logic mixed with display code&lt;/li>
&lt;li>invisible dependencies&lt;/li>
&lt;li>code that cannot be tested without a headset&lt;/li>
&lt;/ul>
&lt;p>We will build a simple architecture:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Bootstrapper
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Models / Config
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Services
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Controllers
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Views (Unity)
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="1--folder-organization">1 — Folder organization&lt;/h3>
&lt;p>Create the following folders:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├── Bootstrap
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├── Models
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├── Services
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├── Controllers
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├── Views
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> └── Config
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Purpose:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Folder&lt;/th>
&lt;th>Role&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Bootstrap&lt;/td>
&lt;td>entry point&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Models&lt;/td>
&lt;td>simulation state&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Services&lt;/td>
&lt;td>calculations&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Controllers&lt;/td>
&lt;td>coordination&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Views&lt;/td>
&lt;td>Unity GameObjects&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Config&lt;/td>
&lt;td>editable parameters&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h3 id="2--the-time-model">2 — The time model&lt;/h3>
&lt;p>In our simulation, the central variable is &lt;strong>simulated time&lt;/strong>.&lt;/p>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Models/TimeModel.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">TimeModel&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">DateTime&lt;/span> &lt;span class="n">CurrentTime&lt;/span> &lt;span class="p">{&lt;/span> &lt;span class="k">get&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="k">private&lt;/span> &lt;span class="k">set&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">TimeScale&lt;/span> &lt;span class="p">{&lt;/span> &lt;span class="k">get&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="k">private&lt;/span> &lt;span class="k">set&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="p">}&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">1f&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">bool&lt;/span> &lt;span class="n">IsPlaying&lt;/span> &lt;span class="p">{&lt;/span> &lt;span class="k">get&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="k">private&lt;/span> &lt;span class="k">set&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="p">}&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">true&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">event&lt;/span> &lt;span class="n">Action&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">SetTime&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">CurrentTime&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">?.&lt;/span>&lt;span class="n">Invoke&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">CurrentTime&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">SetScale&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="kt">float&lt;/span> &lt;span class="n">scale&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">TimeScale&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">scale&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">Play&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">IsPlaying&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">true&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">Pause&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">IsPlaying&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">false&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Important:&lt;/p>
&lt;ul>
&lt;li>this script &lt;strong>does not depend on Unity&lt;/strong>&lt;/li>
&lt;li>it contains &lt;strong>only state and events&lt;/strong>.&lt;/li>
&lt;/ul>
&lt;h3 id="3--solar-system-configuration">3 — Solar system configuration&lt;/h3>
&lt;p>Some parameters must be editable in Unity.&lt;/p>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Config/SolarSystemConfig.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">
&lt;/span>&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="na">[CreateAssetMenu(menuName = &amp;#34;XR/Solar System Config&amp;#34;)]&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">SolarSystemConfig&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">ScriptableObject&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">distanceScale&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">0.000001f&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">planetSizeScale&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">0.01f&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">bool&lt;/span> &lt;span class="n">showOrbits&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">true&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Then create the asset:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Assets → Create → XR → Solar System Config
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="4--using-the-provided-astronomical-data">4 — Using the provided astronomical data&lt;/h3>
&lt;p>The lab already provides a class:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">PlanetData.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>It contains:&lt;/p>
&lt;ul>
&lt;li>orbital parameters&lt;/li>
&lt;li>orbit calculations&lt;/li>
&lt;li>the following function:&lt;/li>
&lt;/ul>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Planet&lt;/span> &lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">DateTime&lt;/span> &lt;span class="n">time&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>⚠️ This class is &lt;strong>the official source for planet positions&lt;/strong>.
Students &lt;strong>must not modify this file&lt;/strong>.&lt;/p>
&lt;h3 id="5--planet-position-service">5 — Planet position service&lt;/h3>
&lt;p>Even though the function already exists, we access it through a &lt;strong>service&lt;/strong>.&lt;/p>
&lt;p>Why?&lt;/p>
&lt;ul>
&lt;li>keep the architecture clean&lt;/li>
&lt;li>allow the implementation to be replaced later&lt;/li>
&lt;li>make testing easier&lt;/li>
&lt;/ul>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Services/IPlanetEphemerisService.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">interface&lt;/span> &lt;span class="nc">IPlanetEphemerisService&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Vector3&lt;/span> &lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Planet&lt;/span> &lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">DateTime&lt;/span> &lt;span class="n">date&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Implementation:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Services/PlanetEphemerisService.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">PlanetEphemerisService&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">IPlanetEphemerisService&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">Vector3&lt;/span> &lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Planet&lt;/span> &lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">DateTime&lt;/span> &lt;span class="n">date&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">return&lt;/span> &lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">date&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>This service acts as an &lt;strong>abstraction layer&lt;/strong>.&lt;/p>
&lt;h3 id="6--planet-view">6 — Planet view&lt;/h3>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Views/PlanetView.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">PlanetView&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">MonoBehaviour&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">PlanetData&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Planet&lt;/span> &lt;span class="n">planet&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">SetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">Vector3&lt;/span> &lt;span class="n">pos&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">transform&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">localPosition&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">pos&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Role:&lt;/p>
&lt;ul>
&lt;li>represent a planet in the scene&lt;/li>
&lt;li>apply the calculated positions&lt;/li>
&lt;/ul>
&lt;h3 id="7--solar-system-controller">7 — Solar system controller&lt;/h3>
&lt;p>The controller connects:&lt;/p>
&lt;ul>
&lt;li>the model&lt;/li>
&lt;li>the service&lt;/li>
&lt;li>the views&lt;/li>
&lt;/ul>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Controllers/PlanetSystemController.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">PlanetSystemController&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">TimeModel&lt;/span> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">IPlanetEphemerisService&lt;/span> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">PlanetView&lt;/span>&lt;span class="p">[]&lt;/span> &lt;span class="n">planets&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">PlanetSystemController&lt;/span>&lt;span class="p">(&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">TimeModel&lt;/span> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">,&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">IPlanetEphemerisService&lt;/span> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">,&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">PlanetView&lt;/span>&lt;span class="p">[]&lt;/span> &lt;span class="n">planets&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">this&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">timeModel&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">this&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">ephemeris&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">this&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">planets&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">planets&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">OnTimeChanged&lt;/span> &lt;span class="p">+=&lt;/span> &lt;span class="n">UpdatePlanets&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">UpdatePlanets&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span> &lt;span class="n">time&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Debug&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Log&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="s">&amp;#34;[TIME] Updating planets &amp;#34;&lt;/span> &lt;span class="p">+&lt;/span> &lt;span class="n">time&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">foreach&lt;/span> &lt;span class="p">(&lt;/span>&lt;span class="kt">var&lt;/span> &lt;span class="n">planet&lt;/span> &lt;span class="k">in&lt;/span> &lt;span class="n">planets&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Vector3&lt;/span> &lt;span class="n">pos&lt;/span> &lt;span class="p">=&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">planet&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">time&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">planet&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">SetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">pos&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Responsibilities:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Element&lt;/th>
&lt;th>Role&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Model&lt;/td>
&lt;td>simulation state&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Service&lt;/td>
&lt;td>position calculation&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Controller&lt;/td>
&lt;td>coordination&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>View&lt;/td>
&lt;td>display&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h3 id="8--bootstrapper">8 — Bootstrapper&lt;/h3>
&lt;p>Create:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Scripts/Bootstrap/AppBootstrapper.cs
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">AppBootstrapper&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">MonoBehaviour&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">SolarSystemConfig&lt;/span> &lt;span class="n">config&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">PlanetView&lt;/span>&lt;span class="p">[]&lt;/span> &lt;span class="n">planets&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">TimeModel&lt;/span> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">PlanetSystemController&lt;/span> &lt;span class="n">controller&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">Start&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Debug&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Log&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="s">&amp;#34;[BOOT] Initializing application&amp;#34;&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">timeModel&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">new&lt;/span> &lt;span class="n">TimeModel&lt;/span>&lt;span class="p">();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="kt">var&lt;/span> &lt;span class="n">ephemeris&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">new&lt;/span> &lt;span class="n">PlanetEphemerisService&lt;/span>&lt;span class="p">();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">controller&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">new&lt;/span> &lt;span class="n">PlanetSystemController&lt;/span>&lt;span class="p">(&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">,&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">,&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">planets&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">timeModel&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">SetTime&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Now&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Role:&lt;/p>
&lt;ul>
&lt;li>create the main objects&lt;/li>
&lt;li>connect dependencies&lt;/li>
&lt;li>start the simulation&lt;/li>
&lt;/ul>
&lt;p>This is called the &lt;strong>composition root&lt;/strong>.&lt;/p>
&lt;h3 id="9--scene-setup">9 — Scene setup&lt;/h3>
&lt;p>Create a GameObject:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">App
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Add:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">AppBootstrapper
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>In the Inspector:&lt;/p>
&lt;ul>
&lt;li>assign &lt;code>SolarSystemConfig&lt;/code>&lt;/li>
&lt;li>assign the &lt;code>PlanetView&lt;/code> references&lt;/li>
&lt;/ul>
&lt;p>Possible structure:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">App
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">SolarSystem
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Sun
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Mercury
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Venus
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Earth
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Mars
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Jupiter
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Saturn
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ Uranus
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> └ Neptune
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Each planet has a:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">PlanetView
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="10--quick-test">10 — Quick test&lt;/h3>
&lt;p>Run the scene.&lt;/p>
&lt;p>Expected result:&lt;/p>
&lt;ul>
&lt;li>the planets appear&lt;/li>
&lt;li>they are positioned correctly&lt;/li>
&lt;li>a &lt;code>[BOOT]&lt;/code> log appears&lt;/li>
&lt;/ul>
&lt;p>If nothing happens, check that:&lt;/p>
&lt;ul>
&lt;li>the PlanetView references are assigned&lt;/li>
&lt;li>the bootstrapper is active&lt;/li>
&lt;li>the scene is saved&lt;/li>
&lt;/ul>
&lt;blockquote>
&lt;p>If you follow the steps carefully, you should notice a small bug. Modify the service to fix it.&lt;/p>
&lt;/blockquote>
&lt;h3 id="11--architecture-check">11 — Architecture check&lt;/h3>
&lt;p>Your code must meet these requirements:&lt;/p>
&lt;ul>
&lt;li>no &lt;code>FindObjectOfType&lt;/code>&lt;/li>
&lt;li>no &lt;code>GameObject.Find&lt;/code>&lt;/li>
&lt;li>visible dependencies&lt;/li>
&lt;li>a model independent of Unity&lt;/li>
&lt;li>logic separated from display&lt;/li>
&lt;/ul>
&lt;h3 id="12--architecture-diagram">12 — Architecture diagram&lt;/h3>
&lt;script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js">&lt;/script>
&lt;script>
document.addEventListener("DOMContentLoaded", () => {
const mermaidApi = window.mermaid;
if (!mermaidApi) return;
const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
mermaidApi.initialize({
theme: isDark ? "dark" : "default",
logLevel: "fatal",
securityLevel: "loose",
startOnLoad: false
});
mermaidApi.run({ querySelector: ".mermaid" });
});
&lt;/script>
&lt;div class="mermaid">
flowchart TD
subgraph BOOT[Bootstrap]
AB[AppBootstrapper - MonoBehaviour]
end
subgraph MC[Models and Config]
TM[TimeModel - model]
SSC[SolarSystemConfig - ScriptableObject]
end
subgraph SVC[Services]
IES[IPlanetEphemerisService interface]
PES[PlanetEphemerisService implementation]
PD[PlanetData static data]
end
subgraph CTRL[Controllers]
PSC[PlanetSystemController controller]
end
subgraph VIEW[Views]
PV[PlanetView array MonoBehaviour]
GO[Planet GameObjects]
end
AB -->|creates| TM
AB -->|reads| SSC
AB -->|creates| PES
AB -->|injects| PSC
AB -->|assigns refs| PV
PES -.->|implements| IES
PSC -->|uses| IES
PSC -->|uses| TM
PSC -->|updates| PV
PES -->|calls GetPlanetPosition| PD
PV -->|attached to| GO
TM -->|OnTimeChanged| PSC
PSC -->|SetPosition| PV
&lt;/div>
&lt;script src="https://cdn.jsdelivr.net/npm/mermaid/dist/mermaid.min.js">&lt;/script>
&lt;script>
document.addEventListener("DOMContentLoaded", () => {
const mermaidApi = window.mermaid;
if (!mermaidApi) return;
const isDark = window.matchMedia('(prefers-color-scheme: dark)').matches;
mermaidApi.initialize({
theme: isDark ? "dark" : "default",
logLevel: "fatal",
securityLevel: "loose",
startOnLoad: false
});
mermaidApi.run({ querySelector: ".mermaid" });
});
&lt;/script>
&lt;div class="mermaid">
classDiagram
class AppBootstrapper {
+SolarSystemConfig config
+PlanetView[] planets
-TimeModel timeModel
-PlanetSystemController controller
+Start()
}
class TimeModel {
+DateTime CurrentTime
+float TimeScale
+bool IsPlaying
+OnTimeChanged : ActionDateTime
+SetTime(DateTime)
+SetScale(float)
+Play()
+Pause()
}
class SolarSystemConfig {
+float distanceScale
+float planetSizeScale
+bool showOrbits
}
class IPlanetEphemerisService {
+GetPlanetPosition(Planet, DateTime) Vector3
}
class PlanetEphemerisService {
+GetPlanetPosition(Planet, DateTime) Vector3
}
class PlanetData {
+GetPlanetPosition(Planet, DateTime) Vector3
}
class PlanetSystemController {
-TimeModel timeModel
-IPlanetEphemerisService ephemeris
-PlanetView[] planets
+PlanetSystemController(TimeModel, IPlanetEphemerisService, PlanetView[])
}
class PlanetView {
+Planet planet
+SetPosition(Vector3)
}
AppBootstrapper --> TimeModel : creates
AppBootstrapper --> PlanetEphemerisService : creates
AppBootstrapper --> PlanetSystemController : creates
AppBootstrapper --> PlanetView : references inspector
AppBootstrapper --> SolarSystemConfig : references asset
PlanetSystemController --> TimeModel : subscribes
PlanetSystemController --> IPlanetEphemerisService : uses
PlanetEphemerisService ..|> IPlanetEphemerisService : implements
PlanetEphemerisService --> PlanetData : calls
PlanetSystemController --> PlanetView : updates
&lt;/div>
&lt;h3 id="expected-result">Expected result&lt;/h3>
&lt;p>At the end of this step:&lt;/p>
&lt;ul>
&lt;li>the application is structured&lt;/li>
&lt;li>the planets use &lt;code>PlanetData&lt;/code>&lt;/li>
&lt;li>dependencies are explicit&lt;/li>
&lt;li>the simulation is driven by a model&lt;/li>
&lt;/ul>
&lt;p>Git tag:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">v1.1-architecture
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="step-3--planet-positioning--events">Step 3 — Planet positioning + events&lt;/h2>
&lt;p>Tag: &lt;strong>v1.2-events&lt;/strong> — ~1h15&lt;/p>
&lt;h3 id="objective-2">Objective&lt;/h3>
&lt;p>Implement the &lt;strong>main simulation flow&lt;/strong>:&lt;/p>
&lt;ul>
&lt;li>time changes,&lt;/li>
&lt;li>an event is triggered,&lt;/li>
&lt;li>the controller updates the planets.&lt;/li>
&lt;/ul>
&lt;p>We deliberately avoid running all the logic in &lt;code>Update()&lt;/code>.&lt;/p>
&lt;p>Expected flow:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">TimeController
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">TimeModel
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">OnTimeChanged
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">PlanetSystemController
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">PlanetView
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>We already created most of these elements in the previous step. Now we need to connect them properly using events.&lt;/p>
&lt;p>Responsibilities:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Element&lt;/th>
&lt;th>Role&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>Model&lt;/td>
&lt;td>time state&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Service&lt;/td>
&lt;td>position calculation&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Controller&lt;/td>
&lt;td>applies positions&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>View&lt;/td>
&lt;td>moves objects&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;h3 id="1--trigger-updates-through-an-event">1 — Trigger updates through an event&lt;/h3>
&lt;blockquote>
&lt;p>This was already implemented in the previous step, but it is important to understand how it works.&lt;/p>
&lt;/blockquote>
&lt;p>In &lt;code>TimeModel&lt;/code>:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">SetTime&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">DateTime&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">CurrentTime&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">OnTimeChanged&lt;/span>&lt;span class="p">?.&lt;/span>&lt;span class="n">Invoke&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">CurrentTime&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>In the controller:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">timeModel&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">OnTimeChanged&lt;/span> &lt;span class="p">+=&lt;/span> &lt;span class="n">UpdatePlanets&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>The planets therefore update &lt;strong>only when time changes&lt;/strong>.&lt;/p>
&lt;h3 id="2--advancing-time">2 — Advancing time&lt;/h3>
&lt;p>Create a small Unity component:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">TimeController
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">TimeController&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">MonoBehaviour&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">float&lt;/span> &lt;span class="n">secondsPerDay&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">1f&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">TimeModel&lt;/span> &lt;span class="n">model&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">DateTime&lt;/span> &lt;span class="n">current&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="k">void&lt;/span> &lt;span class="n">Init&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">TimeModel&lt;/span> &lt;span class="n">m&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">model&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">m&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">current&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">DateTime&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Now&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">model&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">SetTime&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">current&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">Update&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">if&lt;/span> &lt;span class="p">(!&lt;/span>&lt;span class="n">model&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">IsPlaying&lt;/span>&lt;span class="p">)&lt;/span> &lt;span class="k">return&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">current&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">current&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">AddDays&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">Time&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">deltaTime&lt;/span> &lt;span class="p">*&lt;/span> &lt;span class="n">secondsPerDay&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">model&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">SetTime&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">current&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>In &lt;code>AppBootstrapper&lt;/code>:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="n">timeController&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Init&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">timeModel&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="3--verification">3 — Verification&lt;/h3>
&lt;p>When the scene starts, the Console should show:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">[BOOT] Initializing application
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">[TIME] Updating planets ...
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>The planets should move.&lt;/p>
&lt;p>Checklist:&lt;/p>
&lt;ul>
&lt;li>no &lt;code>FindObjectOfType&lt;/code>&lt;/li>
&lt;li>no &lt;code>GameObject.Find&lt;/code>&lt;/li>
&lt;li>updates go through &lt;strong>OnTimeChanged&lt;/strong>&lt;/li>
&lt;li>the &lt;code>PlanetView&lt;/code> references are assigned&lt;/li>
&lt;/ul>
&lt;h3 id="optional-orbits">(Optional) Orbits&lt;/h3>
&lt;p>To display an orbit:&lt;/p>
&lt;ul>
&lt;li>add a &lt;strong>LineRenderer&lt;/strong>&lt;/li>
&lt;li>calculate several positions&lt;/li>
&lt;li>do not recalculate every frame&lt;/li>
&lt;/ul>
&lt;p>Principle:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">for&lt;/span> &lt;span class="p">(&lt;/span>&lt;span class="kt">int&lt;/span> &lt;span class="n">i&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">0&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="n">i&lt;/span> &lt;span class="p">&amp;lt;&lt;/span> &lt;span class="n">samples&lt;/span>&lt;span class="p">;&lt;/span> &lt;span class="n">i&lt;/span>&lt;span class="p">++)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="kt">var&lt;/span> &lt;span class="n">t&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">start&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">AddDays&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">i&lt;/span> &lt;span class="p">*&lt;/span> &lt;span class="m">10&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">points&lt;/span>&lt;span class="p">[&lt;/span>&lt;span class="n">i&lt;/span>&lt;span class="p">]&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="n">ephemeris&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">GetPlanetPosition&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">planet&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">t&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="expected-result-1">Expected result&lt;/h3>
&lt;p>At the end:&lt;/p>
&lt;ul>
&lt;li>the simulation is driven by &lt;code>TimeModel&lt;/code>&lt;/li>
&lt;li>the planets correctly follow the simulated time&lt;/li>
&lt;li>updates go through the &lt;code>OnTimeChanged&lt;/code> event&lt;/li>
&lt;li>the architecture remains clear and testable&lt;/li>
&lt;/ul>
&lt;p>Your &lt;strong>report&lt;/strong> must also include:&lt;/p>
&lt;ul>
&lt;li>a simple diagram of the &lt;code>TimeModel → Controller → PlanetView&lt;/code> flow&lt;/li>
&lt;li>a short explanation of how it works&lt;/li>
&lt;li>a screenshot of the application&lt;/li>
&lt;/ul>
&lt;p>Tag:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">v1.2-events
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="step-4--vr-interactions-grab--focus--scale">Step 4 — VR interactions: grab / focus / scale&lt;/h2>
&lt;p>Tag: &lt;strong>v1.3-vr-interactions&lt;/strong> — ~1h30&lt;/p>
&lt;h3 id="objective-3">Objective&lt;/h3>
&lt;p>In this step, you will turn your simulation into &lt;strong>an object that can be manipulated in VR&lt;/strong>.&lt;/p>
&lt;p>The user must be able to:&lt;/p>
&lt;ul>
&lt;li>move the solar system,&lt;/li>
&lt;li>change its scale,&lt;/li>
&lt;li>select a planet to obtain information.&lt;/li>
&lt;/ul>
&lt;p>The goal is to make these interactions work and &lt;strong>integrate them cleanly into the project architecture&lt;/strong>.&lt;/p>
&lt;p>XR interactions should trigger &lt;strong>intentions&lt;/strong>, which are then applied by a clearly defined system (controller / manager), rather than directly manipulating all the objects in the scene.&lt;/p>
&lt;p>Recommended flow:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">XR Interaction
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Interaction script
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Controller
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">Views
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="1--prepare-a-manipulable-tabletop">1 — Prepare a manipulable tabletop&lt;/h3>
&lt;p>To make interactions easier, organize the scene around a manipulable root object.&lt;/p>
&lt;p>Create a structure similar to:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">SolarSystemRoot
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ├ SolarSystem
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ ├ Sun
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ ├ Mercury
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ ├ Venus
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> │ └ ...
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> └ Handle
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>&lt;code>SolarSystemRoot&lt;/code> becomes the object you will:&lt;/p>
&lt;ul>
&lt;li>move&lt;/li>
&lt;li>rotate&lt;/li>
&lt;li>scale&lt;/li>
&lt;/ul>
&lt;p>All planets must be children of this object.&lt;/p>
&lt;p>Why?&lt;/p>
&lt;ul>
&lt;li>it makes interactions much simpler,&lt;/li>
&lt;li>it avoids modifying each planet individually,&lt;/li>
&lt;li>it provides a central point for controllers.&lt;/li>
&lt;/ul>
&lt;h3 id="2--grab-interaction">2 — Grab interaction&lt;/h3>
&lt;h4 id="objective-4">Objective&lt;/h4>
&lt;p>Allow the user to &lt;strong>grab the solar system and move it&lt;/strong> through space.&lt;/p>
&lt;h5 id="tasks-1">Tasks&lt;/h5>
&lt;p>Create an object to serve as a &lt;strong>manipulation handle&lt;/strong>.&lt;/p>
&lt;p>Add an XR interactable that allows the user to:&lt;/p>
&lt;ul>
&lt;li>grab the object with the controller,&lt;/li>
&lt;li>move the entire system.&lt;/li>
&lt;/ul>
&lt;p>Some necessary components:&lt;/p>
&lt;ul>
&lt;li>collider&lt;/li>
&lt;li>rigidbody (often kinematic)&lt;/li>
&lt;li>XR interaction component&lt;/li>
&lt;/ul>
&lt;p>Expected test:&lt;/p>
&lt;ul>
&lt;li>the user can grab the object,&lt;/li>
&lt;li>move it,&lt;/li>
&lt;li>release it.&lt;/li>
&lt;/ul>
&lt;h5 id="best-practices">Best practices&lt;/h5>
&lt;ul>
&lt;li>do not attach this interaction directly to the planets,&lt;/li>
&lt;li>keep a dedicated handle object,&lt;/li>
&lt;li>add useful logs:&lt;/li>
&lt;/ul>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">[XR] Table grabbed
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">[XR] Table released
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="3--scale-control">3 — Scale control&lt;/h3>
&lt;h4 id="objective-5">Objective&lt;/h4>
&lt;p>Allow the user to &lt;strong>zoom in / out&lt;/strong> on the solar system.&lt;/p>
&lt;p>The scale must:&lt;/p>
&lt;ul>
&lt;li>remain within reasonable limits,&lt;/li>
&lt;li>be centralized in a single script,&lt;/li>
&lt;li>produce useful logs.&lt;/li>
&lt;/ul>
&lt;h5 id="implementation">Implementation&lt;/h5>
&lt;p>Create a system responsible for:&lt;/p>
&lt;ul>
&lt;li>receiving a scale value,&lt;/li>
&lt;li>clamping it if necessary,&lt;/li>
&lt;li>applying the transformation to &lt;code>SolarSystemRoot&lt;/code>.&lt;/li>
&lt;/ul>
&lt;p>For example, you could create a dedicated component:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">ScaleController
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>This component could expose a method such as:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">SetScale(float value)
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>This component is responsible for actually applying the scale.&lt;/p>
&lt;h5 id="user-interaction">User interaction&lt;/h5>
&lt;p>You are free to choose how to change the scale:&lt;/p>
&lt;ul>
&lt;li>a VR UI slider&lt;/li>
&lt;li>a + button&lt;/li>
&lt;li>a rotating knob&lt;/li>
&lt;li>a two-handed gesture (bonus)&lt;/li>
&lt;/ul>
&lt;p>In all cases:&lt;/p>
&lt;ul>
&lt;li>the interaction must not manipulate the transform directly&lt;/li>
&lt;li>it calls a controller&lt;/li>
&lt;/ul>
&lt;h5 id="expected-logs">Expected logs&lt;/h5>
&lt;p>Examples:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">[INPUT] Scale requested
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">[XR] Scale applied
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">[WARN] Scale clamped
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="4--selecting-a-planet">4 — Selecting a planet&lt;/h3>
&lt;h4 id="objective-6">Objective&lt;/h4>
&lt;p>Allow the user to &lt;strong>point at a planet with an XR ray&lt;/strong> and select it.&lt;/p>
&lt;p>When a planet is selected:&lt;/p>
&lt;ul>
&lt;li>an event must be triggered,&lt;/li>
&lt;li>the system must know &lt;strong>which planet is active&lt;/strong>.&lt;/li>
&lt;/ul>
&lt;h5 id="setup">Setup&lt;/h5>
&lt;p>Each planet must be able to:&lt;/p>
&lt;ul>
&lt;li>be detected by a ray interactor,&lt;/li>
&lt;li>signal its selection.&lt;/li>
&lt;/ul>
&lt;p>For example, you could create a script such as:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">PlanetSelectable
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>This script can:&lt;/p>
&lt;ul>
&lt;li>reference the &lt;code>PlanetView&lt;/code>,&lt;/li>
&lt;li>trigger an event or call a central system.&lt;/li>
&lt;/ul>
&lt;p>&lt;strong>Important:&lt;/strong> the selection script must not contain all the focus or UI logic.&lt;/p>
&lt;p>It only signals that &lt;em>a planet has been selected&lt;/em>.&lt;/p>
&lt;h3 id="5--focus-mode">5 — Focus mode&lt;/h3>
&lt;h4 id="objective-7">Objective&lt;/h4>
&lt;p>When a planet is selected:&lt;/p>
&lt;ul>
&lt;li>the planet must be highlighted (for example, centered, enlarged, etc.),&lt;/li>
&lt;li>an information panel appears.&lt;/li>
&lt;/ul>
&lt;h5 id="implementation-1">Implementation&lt;/h5>
&lt;p>Create a system responsible for focus.&lt;/p>
&lt;p>For example:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">FocusController
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>Possible responsibilities:&lt;/p>
&lt;ul>
&lt;li>move the XR origin or camera,&lt;/li>
&lt;li>activate an information panel,&lt;/li>
&lt;li>record the active planet.&lt;/li>
&lt;/ul>
&lt;p>The panel could display:&lt;/p>
&lt;ul>
&lt;li>planet name&lt;/li>
&lt;li>distance from the Sun&lt;/li>
&lt;li>orbital period&lt;/li>
&lt;li>current simulated time&lt;/li>
&lt;/ul>
&lt;p>You can choose the exact content.&lt;/p>
&lt;h3 id="6--recommended-organization">6 — Recommended organization&lt;/h3>
&lt;p>One possible division of responsibilities:&lt;/p>
&lt;table>
&lt;thead>
&lt;tr>
&lt;th>Element&lt;/th>
&lt;th>Role&lt;/th>
&lt;/tr>
&lt;/thead>
&lt;tbody>
&lt;tr>
&lt;td>XR Interactable&lt;/td>
&lt;td>capture the interaction&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Interaction script&lt;/td>
&lt;td>translate the user&amp;rsquo;s action&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>Controller&lt;/td>
&lt;td>apply the logic&lt;/td>
&lt;/tr>
&lt;tr>
&lt;td>View&lt;/td>
&lt;td>display the result&lt;/td>
&lt;/tr>
&lt;/tbody>
&lt;/table>
&lt;p>Example flow:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Ray Interactor
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">PlanetSelectable
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">PlanetSelectionSystem
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">FocusController
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> ↓
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">UI
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h3 id="7--checks">7 — Checks&lt;/h3>
&lt;p>Before moving on to the next step, check:&lt;/p>
&lt;h5 id="grab">Grab&lt;/h5>
&lt;ul>
&lt;li>the solar system can be moved&lt;/li>
&lt;li>movement is stable&lt;/li>
&lt;li>logs appear&lt;/li>
&lt;/ul>
&lt;h5 id="scale">Scale&lt;/h5>
&lt;ul>
&lt;li>the scale can change&lt;/li>
&lt;li>limits are respected&lt;/li>
&lt;li>transformations remain consistent&lt;/li>
&lt;/ul>
&lt;h5 id="focus">Focus&lt;/h5>
&lt;ul>
&lt;li>ray selection works&lt;/li>
&lt;li>the correct planet is detected&lt;/li>
&lt;li>visual feedback appears&lt;/li>
&lt;/ul>
&lt;h3 id="expected-result-2">Expected result&lt;/h3>
&lt;p>At the end of this step, the user can:&lt;/p>
&lt;ul>
&lt;li>manipulate the solar system,&lt;/li>
&lt;li>change its scale,&lt;/li>
&lt;li>select a planet,&lt;/li>
&lt;li>see associated information.&lt;/li>
&lt;/ul>
&lt;p>The architecture must remain:&lt;/p>
&lt;ul>
&lt;li>readable,&lt;/li>
&lt;li>decoupled,&lt;/li>
&lt;li>debuggable.&lt;/li>
&lt;/ul>
&lt;p>Git tag:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">v1.3-vr-interactions
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;hr>
&lt;h2 id="step-5--world-space-ui--instrumentation-tag-v14--1h00">Step 5 — World-space UI + instrumentation (Tag: v1.4) — ~1h00&lt;/h2>
&lt;h3 id="objectives-1">Objectives&lt;/h3>
&lt;p>Make the application controllable and debuggable &lt;em>inside the headset&lt;/em>.&lt;/p>
&lt;h3 id="tasks-2">Tasks&lt;/h3>
&lt;h4 id="a-world-space-ui">A) World-space UI&lt;/h4>
&lt;p>Create a VR panel with at least:&lt;/p>
&lt;ul>
&lt;li>Date (or scrubbing)&lt;/li>
&lt;li>Play/pause + speed (x1, x10, x100…)&lt;/li>
&lt;li>Orbit visibility toggle&lt;/li>
&lt;li>Reset viewpoint / reset scale&lt;/li>
&lt;/ul>
&lt;blockquote>
&lt;p>The UI panel can be an interactive world-space Canvas using the XR Interaction Toolkit.&lt;/p>
&lt;/blockquote>
&lt;h4 id="b-debugoverlay-required">B) DebugOverlay (required)&lt;/h4>
&lt;p>Create a discreet overlay displaying:&lt;/p>
&lt;ul>
&lt;li>FPS / frame time (approximate)&lt;/li>
&lt;li>Current date + speed&lt;/li>
&lt;li>Last user action&lt;/li>
&lt;li>Key warnings (scale out of bounds, suspected performance issues, event spam)&lt;/li>
&lt;/ul>
&lt;p>The DebugOverlay can be a simple TextMeshPro panel updated periodically.&lt;/p>
&lt;p>Unity allows you to capture all logs (Debug.Log, warnings, errors) through:&lt;/p>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-fallback" data-lang="fallback">&lt;span class="line">&lt;span class="cl">Application.logMessageReceived
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;p>You can use this callback to:&lt;/p>
&lt;ul>
&lt;li>capture important messages&lt;/li>
&lt;li>keep recent logs&lt;/li>
&lt;li>display them in the overlay&lt;/li>
&lt;/ul>
&lt;h5 id="example-1">Example&lt;/h5>
&lt;div class="highlight">&lt;pre tabindex="0" class="chroma">&lt;code class="language-csharp" data-lang="csharp">&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">UnityEngine&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">TMPro&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">using&lt;/span> &lt;span class="nn">System.Collections.Generic&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="k">public&lt;/span> &lt;span class="k">class&lt;/span> &lt;span class="nc">DebugOverlay&lt;/span> &lt;span class="p">:&lt;/span> &lt;span class="n">MonoBehaviour&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="n">TextMeshProUGUI&lt;/span> &lt;span class="n">text&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Queue&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="kt">string&lt;/span>&lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">lines&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="k">new&lt;/span> &lt;span class="n">Queue&lt;/span>&lt;span class="p">&amp;lt;&lt;/span>&lt;span class="kt">string&lt;/span>&lt;span class="p">&amp;gt;();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">public&lt;/span> &lt;span class="kt">int&lt;/span> &lt;span class="n">maxLines&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="m">15&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">OnEnable&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Application&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">logMessageReceived&lt;/span> &lt;span class="p">+=&lt;/span> &lt;span class="n">HandleLog&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">OnDisable&lt;/span>&lt;span class="p">()&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">Application&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">logMessageReceived&lt;/span> &lt;span class="p">-=&lt;/span> &lt;span class="n">HandleLog&lt;/span>&lt;span class="p">;&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">void&lt;/span> &lt;span class="n">HandleLog&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="kt">string&lt;/span> &lt;span class="n">logString&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="kt">string&lt;/span> &lt;span class="n">stackTrace&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">LogType&lt;/span> &lt;span class="n">type&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">{&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">lines&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Enqueue&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="n">logString&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="k">while&lt;/span> &lt;span class="p">(&lt;/span>&lt;span class="n">lines&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Count&lt;/span> &lt;span class="p">&amp;gt;&lt;/span> &lt;span class="n">maxLines&lt;/span>&lt;span class="p">)&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">lines&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Dequeue&lt;/span>&lt;span class="p">();&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="n">text&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">text&lt;/span> &lt;span class="p">=&lt;/span> &lt;span class="kt">string&lt;/span>&lt;span class="p">.&lt;/span>&lt;span class="n">Join&lt;/span>&lt;span class="p">(&lt;/span>&lt;span class="s">&amp;#34;\n&amp;#34;&lt;/span>&lt;span class="p">,&lt;/span> &lt;span class="n">lines&lt;/span>&lt;span class="p">);&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl"> &lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;span class="line">&lt;span class="cl">&lt;span class="p">}&lt;/span>
&lt;/span>&lt;/span>&lt;/code>&lt;/pre>&lt;/div>&lt;h4 id="c-structured-logs">C) Structured logs&lt;/h4>
&lt;p>All critical events must produce logs in the following format:&lt;/p>
&lt;ul>
&lt;li>&lt;code>[TIME] …&lt;/code>&lt;/li>
&lt;li>&lt;code>[INPUT] …&lt;/code>&lt;/li>
&lt;li>&lt;code>[XR] …&lt;/code>&lt;/li>
&lt;li>&lt;code>[PERF] …&lt;/code>&lt;/li>
&lt;/ul>
&lt;h3 id="expected-deliverables-1">Expected deliverables&lt;/h3>
&lt;ul>
&lt;li>Screenshot showing the UI panel + debug overlay visible in VR&lt;/li>
&lt;li>Tag &lt;code>v1.4-ui-debug&lt;/code>&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="step-6--guided-xr-debugging-tag-v15--optional">Step 6 — Guided XR debugging (Tag: v1.5) — (Optional)&lt;/h2>
&lt;h3 id="objectives-2">Objectives&lt;/h3>
&lt;p>Learn a reproducible XR debugging method.&lt;/p>
&lt;h3 id="required-work">Required work&lt;/h3>
&lt;p>You must address at least &lt;strong>2 tickets&lt;/strong> from the following 3 (depending on the starter project provided by the instructor):&lt;/p>
&lt;ul>
&lt;li>&lt;strong>Ticket A — Input works in the Editor but not on the headset&lt;/strong>&lt;/li>
&lt;li>&lt;strong>Ticket B — Events fire twice after reloading the scene&lt;/strong>&lt;/li>
&lt;li>&lt;strong>Ticket C — Inconsistent scale/reference frames: objects appear “far away” or “huge”&lt;/strong>&lt;/li>
&lt;/ul>
&lt;p>For each ticket:&lt;/p>
&lt;ul>
&lt;li>provide a &lt;strong>minimal reproduction&lt;/strong>&lt;/li>
&lt;li>describe the &lt;strong>method&lt;/strong> (instrumentation → hypothesis → test → fix)&lt;/li>
&lt;li>add a simple regression test (for example, log + guard + assert)&lt;/li>
&lt;/ul>
&lt;h3 id="expected-deliverables-2">Expected deliverables&lt;/h3>
&lt;ul>
&lt;li>“Debug story” section in the README&lt;/li>
&lt;li>Tag &lt;code>v1.5-debug-tickets&lt;/code>&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="step-7--xr-performance-tag-v20--optional">Step 7 — XR performance (Tag: v2.0) — (Optional)&lt;/h2>
&lt;h3 id="objectives-3">Objectives&lt;/h3>
&lt;p>Identify and fix a typical VR performance problem (CPU/GPU/GC).&lt;/p>
&lt;h3 id="tasks-3">Tasks&lt;/h3>
&lt;ol>
&lt;li>Measure (Profiler):
&lt;ul>
&lt;li>CPU main thread&lt;/li>
&lt;li>GC allocations&lt;/li>
&lt;li>scripts running in Update&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Choose &lt;strong>one bottleneck&lt;/strong> and improve it:
&lt;ul>
&lt;li>orbit caching&lt;/li>
&lt;li>pooling&lt;/li>
&lt;li>reducing update frequency&lt;/li>
&lt;li>eliminating allocations&lt;/li>
&lt;/ul>
&lt;/li>
&lt;li>Demonstrate the improvement:
&lt;ul>
&lt;li>before/after profiler screenshots&lt;/li>
&lt;li>describe the change (2–5 lines)&lt;/li>
&lt;/ul>
&lt;/li>
&lt;/ol>
&lt;h3 id="expected-deliverables-3">Expected deliverables&lt;/h3>
&lt;ul>
&lt;li>“Perf story” section in the README&lt;/li>
&lt;li>Tag &lt;code>v2.0-final&lt;/code>&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="bonus-tasks-optional">Bonus tasks (optional)&lt;/h2>
&lt;ul>
&lt;li>Proper planet rotation (axial + orbital)&lt;/li>
&lt;li>Skybox / celestial sphere&lt;/li>
&lt;li>“Planet surface” mode (viewpoint, constellations)&lt;/li>
&lt;li>Teleportation + comfort (snap turn, vignette)&lt;/li>
&lt;li>Small in-VR “debug console” with category filters&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="assessment-criteria-indicative">Assessment criteria (indicative)&lt;/h2>
&lt;ul>
&lt;li>Architecture &amp;amp; code quality — 40%&lt;/li>
&lt;li>VR interactions — 30%&lt;/li>
&lt;li>Observability — 20%&lt;/li>
&lt;/ul>
&lt;p>Bonus:&lt;/p>
&lt;ul>
&lt;li>Debugging (tickets + method)&lt;/li>
&lt;li>Performance (measurement + improvement)&lt;/li>
&lt;/ul>
&lt;hr>
&lt;h2 id="quick-checklist-before-submission">Quick checklist (before submission)&lt;/h2>
&lt;ul>
&lt;li>&lt;input disabled="" type="checkbox"> Public/private repository accessible, tags present&lt;/li>
&lt;li>&lt;input disabled="" type="checkbox"> Application works on the headset&lt;/li>
&lt;li>&lt;input disabled="" type="checkbox"> World-space UI works&lt;/li>
&lt;li>&lt;input disabled="" type="checkbox"> DebugOverlay works&lt;/li>
&lt;li>&lt;input disabled="" type="checkbox"> README includes screenshots + diagrams&lt;/li>
&lt;li>&lt;input disabled="" type="checkbox"> No &lt;code>FindObjectOfType&lt;/code> / &lt;code>GameObject.Find&lt;/code> in the final code&lt;/li>
&lt;/ul></description></item></channel></rss>