Migration notes

Follow these guidelines when upgrading existing projects to new ACTk releases.

General tips

• Back up your project or commit to source control before importing a new package.
• Remove the previous CodeStage/AntiCheatToolkit folder so obsolete assets do not linger.
• After importing new version, run the validation and migration utilities under Tools > Code Stage > Anti-Cheat Toolkit to fix legacy serialized data, if you see any data corruption.

Upgrading from ACTk v2021

The v2022+ series redesigned several APIs:

• CodeHashGeneratorPostprocessor.Instance was removed. Access properties directly:
  • Instance.callbackOrder → CodeHashGeneratorPostprocessor.CallbackOrder
  • Instance.HashesGenerated → CodeHashGeneratorPostprocessor.HashesGenerated
• HashGenerated handlers now receive IReadOnlyList<BuildHashes> instead of arrays. Update your event signatures accordingly.
• BuildHashes.FileHashes and HashGeneratorResult.FileHashes changed from FileHash[] to IReadOnlyList<FileHash>.

Migrating serialized obscured data

Some releases updated the encrypted data model to close vulnerabilities. Use the utilities provided in the package when you upgrade from older versions:

• Menu commands under Tools > Code Stage > Anti-Cheat Toolkit > Migrate and > Validate
• Context menu commands in the Project window (Code Stage > Anti-Cheat Toolkit > …)
• Static helpers such as MigrateEncrypted() or DecryptFromV0() on specific obscured types

If you are coming from version 1.5.1.0 or earlier, request the 1.5.2.0 package to complete the intermediate migration step before jumping to modern releases.

When migrations are not viable

Reset serialized values in the inspector and reconfigure them manually. This is often faster when only a handful of fields are affected.