Build and Deploy

01Release checklist

Work through this before every release build.

Item 1 covers useProcessIdForSaveFile, enableDebugMessages and enableDebugPanel in one glance — the inspector raises the banner if any of them is still on. All three ship off; you only need to check you did not leave one enabled while developing. See Settings Reference.

02Scenes

File → Build Profiles → Scene List. The shipped order:

Indices are referenced from CCDS_Settings, so reordering scenes without updating mainMenuSceneIndex and defaultSelectedSceneIndex sends players to the wrong scene or to none at all.

Leave CCDS_Vehicles_Prototype disabled. It is a testing sandbox and shipping it only inflates the build.

03Colour space

With autoSetColorSpacePerPlatform enabled (shipped true), CCDS_PreBuildChecker sets the colour space from the build target:

It only acts when the current setting differs, and it confirms with a dialog first — changing colour space triggers a full asset reimport, which on this project is a long wait. Expect it, and do not cancel partway.

Disable the option if you manage colour space yourself.

04Lightmaps

CCDS_BuildProcessor implements IPreprocessBuildWithReport (callbackOrder 0). When overrideLightmapTextures is enabled it walks the lightmaps and, for each one:

• sets maxTextureSize to 1024 if it is larger,
• enables crunchedCompression if it is off.

This shrinks the build at some cost in bake quality. Recommended for mobile and WebGL; optional on desktop. It does nothing when the setting is off.

05Platforms

Windows / macOS / Linux

The primary target. Linear colour space, keyboard and gamepad input, no extra configuration.

Android / iOS

Touch controls come from RCCP's mobile controller, driven by RCCP_Settings.mobileControllerEnabled. CCDS keeps that flag correct automatically: CCDS_MobileControllerSync implements IActiveBuildTargetChanged and sets it to true for Android and iOS and false for every other target, on every platform switch.

Switch the build target before building. A mobile build made without that switch having occurred ships without touch steering.

Also review: traffic density down, shadows off, realtime lights 0, draw distance near 500 m, overrideLightmapTextures on.

WebGL

WebGL is single-threaded and memory-constrained. Expect to cut traffic density, draw distance and texture sizes well below desktop, and test the actual download size — a city build is large.

Consoles

Linear colour space is applied automatically for PS4, PS5, Xbox One and Xbox Series targets. Everything beyond that requires the platform SDK and a developer licence from the platform holder.

06Save data in builds

Saves are JSON in Application.persistentDataPath, which differs per platform and per product name.

Changing the product name changes the path, so existing players appear to lose their saves. Settle on the name before release.

useProcessIdForSaveFile must be false in release builds. With it on, the file name includes the process ID, so a player can get a different save file on a later launch.

07Photon in builds

• The App ID compiles into the build. Rotating it requires a rebuild.
• Pick a region, or let Photon choose by ping. ConnectToRegion(regionCode) pins it.
• The free tier caps concurrent users; check your limits before a launch.
• photonSendRate 50 and photonSerializationRate 35 as shipped are above the tooltip recommendations of 20–30 and 15–20. On the free tier that shortens how long your CCU budget lasts.

08Validate before building

Tools → BoneCracker Games → CCDS → Open Validation Panel, on every scene.

It runs CCDS_SceneManager.CheckMisconfigurations() plus every component implementing ICCDS_CheckEditorError, and names the exact missing reference — for example "Missing UI Text 'Money Text' on MainMenu Manager!". A broken reference that only shows up at runtime is the most common cause of a build that works in the editor and fails on device.

The Welcome Window's Health tab covers project-level settings and offers one-click fixes for some of them.

09Common problems

10Next

• Settings Reference
• Performance
• Common Problems