[TRACKING] Upcoming Schedule I beta compatibility support

[ifBars]

Goal

Track S1API compatibility work for the upcoming Schedule I game update so the API is ready when the update reaches a public beta or public release channel.

No S1API release should be shipped from closed/private-beta-only evidence. This issue is for early local investigation, compatibility mapping, and migration planning.

Policy

• Keep closed/private beta game files, generated assemblies, decompiled output, manifests, and raw beta-only details local only.
• Do not attach proprietary game artifacts, decompiled dumps, generated IL2CPP wrappers, AssetRipper exports, prefabs, textures, scenes, or private-beta logs.
• Public comments should summarize API impact at a high level until the relevant build is publicly available.
• Release work starts only after the update is available on a public beta/public branch that users can access.

Investigation Checklist

• Snapshot a separate local copy of the beta build for comparison.
• Record local-only baseline metadata: Steam branch, build ID, depot manifest IDs, runtime/backend, MelonLoader version, and S1API version tested.
• Compare public/current build vs beta build for renamed/removed game types, method signatures, fields, registries, save data, UI screens, NPC systems, item systems, shops, quests, and phone apps.
• Validate Mono/alternate compatibility where available.
• Validate IL2CPP compatibility where available, including generated wrapper assumptions and cast/delegate patterns.
• Identify S1API public API changes, compatibility shims, or migration notes needed for mod authors.
• Identify existing open issues that may be fixed, worsened, or made obsolete by the game update.
• Draft docs/release notes, but hold release until public beta/public availability.

Areas To Inspect First

• S1API lifecycle hooks and game initialization timing.
• Item, NPC, shop, saveable, quest, and phone app integration points.
• Harmony patch targets under S1API/Internal/Patches.
• Runtime-specific IL2CPP helpers, casts, delegates, and generated wrapper assumptions.
• Public builders/catalogs/registries that expose game-owned identifiers or prefab paths.
• DocFX/API migration notes for mod authors.

Current Local State

A local beta snapshot has been captured for private inspection. Findings should be translated into non-sensitive compatibility notes before being posted here.

[coderabbitai]

🔗 Related PRs

#44 - Add IL2CPP-aware resource & accessory handling [merged]
#50 - Bug fixes [merged]
#57 - v0.4.4f6 compatibility [merged]
#58 - v0.4.4f10 Game Update [merged]
#69 - Various fixed: PlaceableStorageEntity ID NRE, red eyes not applying, dealer inventory wipe [merged]

---

📝 Issue Planner

_{Check the box below or use the @coderabbitai plan command to generate an implementation plan and prompts that you can use with your favorite coding assistant.}

• Create Plan

---

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[ifBars]

Closed-beta compatibility pass update (local-only evidence, no private assemblies or decompiled source included):

• The closed-beta install is IL2CPP, not Mono. Fresh local MelonLoader IL2CPP wrappers were generated from a copied beta install for build testing.
• Current MonoMelon still builds against the restored alternate install.
• Il2CppMelon against the beta wrappers does not build yet. After the first compatibility pass it still has 139 compile errors.

Initial local compatibility fixes identified/applied:

• ExitAction moved namespace between current Mono and beta IL2CPP wrappers, so TV app exit handling needs runtime-specific aliases.
• Chemistry station UI changed from the old canvas type to an interface-style UI type; recipe UI injection needs to resolve either shape.
• NPCSignal_WaitForDelivery / Customer.DealSignal are not available in the beta wrappers; deal-signal wiring needs to degrade gracefully when that game API is absent.

Remaining beta error groups to track:

• NPC identity and health properties are read-only in the beta wrappers where S1API currently assigns them directly.
• NPC inventory fields changed or disappeared: startup/test/random inventory, random cash, clear-each-night, slot count, contents-changed event, and pickpocket interaction references.
• Dialogue handler APIs changed: InitializeDialogue and runtimeModules are not exposed as before.
• Contacts UI relation circles no longer expose AssignedNPC_ID as used by current patches.
• NPC/customer/dealer surfaces changed: conversation categories, fullName, dealer fee/cut/type fields, default delivery location, and related customer handoff signal references.
• Character/UI/camera APIs changed: character creator open signature, player camera UI counter, and named SetCanLook(c: ...) argument shape.
• Misc API drift: SetEnergy console command type missing, combat default weapon field missing, NPC speed default walk speed missing, relation default delta constant missing.

No public release is planned from this branch; this is just the compatibility backlog for when the beta becomes public.