Added First Person VR item management

- Implemented DVDReadVrAsset function to read mapped disc paths for VR assets.
- Created HeldItem structure and ReadHeldItem function for managing held items in the game.
- Developed unit tests for ReadHeldItem to ensure correct functionality and edge case handling.
- Added cockpit item data tests to validate model indexing and parsing of archives.

runtime/include/vr/mkw_vr_first_person.h

@@ -3,6 +3,7 @@
 #pragma once
 
 #include "vr/steering_wheel.h"
+#include "vr/mkw_vr_item.h"
 
 #include <algorithm>
 #include <array>
@@ -572,4 +573,8 @@ void MkwVRFirstPersonRecenter() noexcept;
 // anchor has been missing long enough to give up holding the last one.
 FirstPersonAnchor MkwVRFirstPersonGetAnchor() noexcept;
 
+// Guest-frame inventory snapshot, sampled at the race draw boundary. A
+// generation change invalidates any item retained by a prior race.
+HeldItem MkwVRFirstPersonGetHeldItem() noexcept;
+
 } // namespace mkw::vr

runtime/include/vr/mkw_vr_item.h

@@ -0,0 +1,47 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+#pragma once
+
+#include <cstdint>
+
+namespace mkw::vr {
+
+struct HeldItem {
+    uint8_t id = 0x14;
+    uint8_t count = 0;
+    bool valid = false;
+    uint64_t race_generation = 0;
+};
+
+namespace detail {
+
+// PAL RMCP01 Item::Manager and Item::Player. Item::PlayerInventory is at
+// Player+0x88. Read the inventory, never PlayerRoulette::nextItemId: roulette
+// teardown clears the latter, and an interrupted roulette may predict an item
+// the player never receives.
+template <typename GuestMemory>
+HeldItem ReadHeldItem(uint32_t local_racer, uint64_t race_generation) noexcept {
+    HeldItem result{};
+    result.race_generation = race_generation;
+    if (local_racer >= 12) return result;
+    uint32_t manager = 0, players = 0;
+    if (!GuestMemory::TryRead32(0x809C3618u, manager) || !manager ||
+        !GuestMemory::TryRead32(manager + 0x14u, players) || !players) return result;
+    const uint32_t player = players + local_racer * 0x248u;
+    if (player < players || !GuestMemory::Contains(player, 0x94u)) return result;
+    try {
+        if (GuestMemory::Read8(player + 0x18u) != local_racer ||
+            GuestMemory::Read32(player + 0x58u) != 0) return result;
+        const uint32_t id = GuestMemory::Read32(player + 0x8Cu);
+        const uint32_t count = GuestMemory::Read32(player + 0x90u);
+        if (id > 0x12u || count == 0 || count > 3) return result;
+        result.id = static_cast<uint8_t>(id);
+        result.count = static_cast<uint8_t>(count);
+        result.valid = true;
+    } catch (const typename GuestMemory::AccessViolation&) {
+        return result;
+    }
+    return result;
+}
+
+} // namespace detail
+} // namespace mkw::vr