Version 1.56.3 Released


Version 1.56.3 is a focused hotfix addressing a critical startup issue discovered after the 1.56.2 release.

Critical Startup Fix

A real-device test revealed that the game could fail during initialization with the following error:

“undefined is not an object (evaluating 'state.advancedBuildcraft')”

The issue occurred during the creation of a fresh game state.

Starter equipment is generated before the global game state has been fully assigned. Since the Advanced Buildcraft update introduced Target Farming checks into the shared item-generation pipeline, item generation could attempt to access advancedBuildcraft too early.

This caused initialization to fail, particularly for:

  • completely new players
  • empty browser storage
  • some older saves without an existing Advanced Buildcraft state

Bootstrap-Safe Item Generation

The affected systems are now safe during early initialization.

The following systems no longer assume that the full player state already exists:

  • Unique Target Farming
  • Set Target Farming
  • Protect Targets
  • equipment/loadout protection checks
  • starter equipment generation

Once the normal save state has finished loading, all existing Buildcraft and Target Farming functionality continues to work normally.

No Buildcraft mechanics or loot probabilities were removed.

Save Compatibility

No save reset is required.

  • Save Schema remains 39
  • 1.56.2 saves remain compatible
  • older saves without advancedBuildcraft are normalized automatically
  • fresh games correctly create the required Buildcraft state
  • starter cards and starter equipment initialize normally

New Boot Regression Testing

The release QA process has been expanded to include the complete game startup sequence rather than testing only individual modules.

Three important startup scenarios are now tested directly:

  • completely empty browser storage / new player
  • existing 1.56.2 save
  • older 1.55.1-style save without Advanced Buildcraft data

All three now initialize successfully.

The startup harness loads the real game scripts in their release order and verifies that the Home screen can be reached without initialization errors.

Regression Results

The existing game systems remain intact after the fix:

  • Release Candidate — 15/15
  • Full Quality Audit — 21/21
  • Systems Balance — 14/14
  • Advanced Buildcraft — 27/27
  • Buildcraft Hardening — 44/44
  • 1.55 Content — 22/22
  • Content Expansion Audit — 30/30
  • Content/Boss Hardening — 32/32
  • Advanced Maps — 28/28
  • Advanced Maps Hardening — 20/20
  • Legendary Hunts — 23/23
  • Legendary Hunts Hardening — 23/23
  • Combat 2.0 — 7/7
  • Boss Tactics — 14/14
  • UI Layout — 10/10

Release Integrity

The clean release package was also rechecked after extraction:

  • JavaScript files: 117/117
  • local references: 114/114
  • CSS assets: 31/31
  • duplicate static IDs: 0
  • cache references synchronized to 1.56.3.263
  • runtime catalog remains 152 Jobs / 83 Sets / 208 Uniques / 90 Bosses
  • Save Schema remains 39
  • UI Routes remain 40

Why This Patch Matters

1.56.2 passed extensive system, content, item, balance, localization, and package validation, but the real-device report exposed an important blind spot in the previous QA process:

the complete fresh-game bootstrap path was not being exercised in the same way as an actual browser startup.

That gap is now closed.

Future releases will retain dedicated regression coverage for fresh installs, current saves, and older save migrations so this class of initialization failure is much harder to reintroduce.

Thanks for reporting the issue and continuing to test Knights of Crystalis.

Version 1.56.3 is the recommended release build.

Files

Knights_of_Crystalis_1.56.3_Initialization_Bootstrap_Hotfix.zip Play in browser
10 hours ago

Leave a comment

Log in with itch.io to leave a comment.