> For the complete documentation index, see [llms.txt](https://lionstudios.gitbook.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://lionstudios.gitbook.io/readme/migration-guide/lion-sdk-2.0-upgrade-guide.md).
# Lion SDK 2.0 Upgrade Guide
The release of Lion SDK 2.0 introduces several breaking changes that require manual updates to projects built on earlier versions.
### What's Changed in 2.x
* Lion Settings Manager no longer uses Game Interfaces
* A new optimized splash screen has been released
* Lion Remote Configs initialization has been updated
* Several Lion Analytics methods have been removed
* The Validation package now has a dedicated Lion Settings Manager tab
* Nakama support has been dropped from all packages
* Remote Storage API updates (No longer uses game interfaces)
* The following packages have been deprecated and will no longer be supported
* Lion - Daily Challenge
* Lion - Daily Rewards
* Lion - Fake Leaderboards
* Lion - In-Game Messaging
* Lion - Lucky Wheel
* Lion - Options Menu
* Lion - Metabuild
* Lion - PiggyBank
* Lion - NakamaConnector
***
### Code API update
#### Lion - Remote Config
Due to internal changes in how Lion Remote Configs is initialized, `LionCore.OnInitialized` callback is no longer the recommended way to wait for Remote Configs. Update your code to use `RemoteConfigsController.OnInitialized` instead. More info can be found [here](/readme/features/remote-configs.md#usage).
```
//Previously
LionCore.OnInitialized += FetchRemoteConfigs;
//Now
RemoteConfigsController.OnInitialized += FetchRemoteConfigs;
```
***
### Breaking Changes
#### Lion Settings
For developers updating from **LionSDK 1.x.x** to **Lion SDK 2.0**, settings-related errors may occur if older settings files are still present.
To resolve this, delete the existing Lion settings files and regenerate them:
1. Navigate to: `Assets/LionStudios/Resources`
2. Delete the `Resources` folder.
3. Run the **Lion Setup Wizard** again to recreate the Lion Settings files.
More information about the Setup Wizard can be found [here](/readme/getting-started.md#setup-wizard)
#### Lion Game Interfaces
Lion SDK 2.0 no longer makes use of interfaces for the Lion Settings Manager.
* Delete your `Assets/LionStudios/GameInterfaces` folder as this is no longer needed.
* After updating, verify your `Remote Configs`, `Lion Ads`, `Purchase Validator`, and any other settings in the Lion Settings menu to ensure everything is configured correctly.
#### Lion Splash Scene
A new more optimized splash screen has been released. Existing splash screens will need to be updated.
* Go to `Lion Settings Manager` window and find the `Splash Scene` tab. Click "Manually Setup Loading Scene".
* Note doing so will erase any existing changes you may have had to your previous scene. So be sure to transfer over any scene modifications to the `Assets/LionStudios/AnimatedLionLogoScene.unity` you may have done previously
#### Lion Analytics
The following methods have been removed. If your project uses any of them, remove all references before upgrading.
* `AddMissionTrackingDataCombination(string missionID, string missionName, string missionType, int? missionAttempt)`
* `RemoveMissionTrackingDataCombination(string missionID, string missionName)`
* `AddLevelTrackingDataCombination(int levelNum, string missionName)`
* `RemoveLevelAttemptTrackingData(int levelNum, string levelCollection1, string levelCollection2, string missionType, string missionName)`
* `SetSoftCurrency(int softCurrency)`
* `ClearSoftCurrency()`
* `SetHardCurrency(int hardCurrency)`
* `ClearHardCurrency()`
#### Lion Purchase Validator
The Validation package now manages its configuration through a dedicated Lion Settings Manager tab. You must set your Validator type there before the package will function correctly.\
More info can be found [here](/lionsdk-1.x-legacy-docs/purchasing/iap-validation.md).
* Nakama Validator has been removed as an option
* A new Lion Validator has been added
#### Lion Ads
LionAds have separate migration guide on how to migrate from previous lion ads functionality [here](/readme/features/ads/how-to-convert-to-lion-ads/lionads-v2-to-v3-migration-guide.md)
#### Lion Remote Storage
The following event has been removed
* `OnDataMergedFromCloud`
* Make the `OnRemoteDataUpdated` event instead now. More information can be found [here](https://app.gitbook.com/o/tefS2huU8g4cEbvtYdJ6/s/O3Jns0MMUpUIoCo5ylWF/~/edit/~/changes/127/readme/features/remote-storage#using-the-onremotedataupdated-event)
#### Lion HelpShift Package
The Lion Helpshift package is now available as a standalone package and is no longer included as part of the LionSDK
For detailed instructions on downloading and setting up the package, please refer to the documentation [here](/readme/third-party-sdks/helpshift-customer-support.md)
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://lionstudios.gitbook.io/readme/migration-guide/lion-sdk-2.0-upgrade-guide.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.