Create a Mission

01The four mission types

All four derive from ACCDS_MultiplayerMissionBase and support local gameplay with or without Photon PUN2 installed. The _MP suffix identifies the shared mission classes; it does not make the SDK a single-player requirement. When the optional integration is configured and the player joins a room, the same mission content supports multiplayer.

A fifth component, CCDS_MissionObjective_FreeRoam_MP, exists as an open-world placeholder. It is not exposed by CCDS.CreateMission.

02The three pieces

A working mission is always three things:

Missing any one of them produces a mission that exists but can never be played.

03Create the mission

From a script, or from an editor script / the Console:

using BoneCrackerGames.CCDS;

// Creates the GameObject, adds the right component, parents it to the
// mission manager, and registers it. Returns null if the manager is absent.
GameObject mission = CCDS.CreateMission("Downtown Sprint", CCDS.MissionType.Race);

CreateMission requires CCDS_MissionObjectiveManager to be in the scene. Without it you get "CreateMission: CCDS_MissionObjectiveManager not found in scene!" and a null return — see Set Up a New City Scene for creating the managers.

By hand: create an empty GameObject under CCDS_MissionObjectiveManager, add the mission component from Add Component → BoneCracker Games → CCDS → Missions → Multiplayer →, and register it with the manager.

For multiplayer authoring, the mission also needs a CCDS_NetworkBinding for its runtime network view. CreateMission creates and registers the mission component; it does not add that binding. Keep the binding when working without the SDK so the same content can be used after PUN2 is installed. Register the saved scene after placing networked content, as described below.

04Place the objective positions

Positions are where the mission's checkpoints, race waypoints or obstacles go.

// At a specific place in the world
CCDS.CreateMissionPosition(new Vector3(120f, 0f, -45f), Quaternion.identity, "Checkpoint_01");

// Or at the origin, to drag into place
CCDS.CreateMissionPosition("Checkpoint_01");

Both overloads route through CCDS_MissionObjectivePositionsManager, which owns the object and parents it. Creating a bare GameObject with the component on it will not register it.

Rotation matters for anything directional — checkpoint gates and race waypoints use forward to decide which way the player should be travelling.

05Add the start marker

Drag a marker prefab from Assets/CCDS/Prefabs/Markers/ into the world where the mission should begin:

Then set the marker's fields:

The marker inspector has three tabs — Setup (the mission reference), Config (name, description, cooldown) and Validation.

Check the marker's local trigger setup and its optional networking data:

• Its Layer is CCDS_Marker.
• Its collider has Is Trigger enabled.
• For multiplayer, its CCDS_NetworkBinding includes the marker component in the ordered observed list. The runtime uses this data to generate its PhotonView when the PUN integration is compiled.

Use the supplied marker prefabs as a starting point. For a marker built from an empty GameObject, add and configure the binding as well as the trigger and mission references; an authored PhotonView is not required.

After placing or duplicating bindings, save the scene, open Tools → BoneCracker Games → CCDS → Multiplayer Setup, and click Register Active Scene and Assign IDs. This assigns persistent scene IDs and adds the scene bootstrap when needed. Save the resulting scene changes. Prefab assets keep sceneId = 0; see Set Up a New City Scene for the full workflow.

06How the player starts it

Drive into the marker, then press Y.

The key is CCDS_Settings.missionConfirmKey, read live by CCDS_MissionMarkerInputHandler. Change it in CCDS_Settings.asset and the marker's own prompt text updates to match — it is not hard-coded anywhere in the UI.

If you rebind it, avoid F and R: both are already taken by RCCP (NOS and record). See the control table in Install and First Drive.

When the mission ends, the marker enters cooldown for markerCooldown seconds and shows a Cooldown Ns countdown before becoming available again.

07Marker states

CCDS_Marker_MultiplayerMission uses the same logical states locally and online. In multiplayer the master client sends the logical state and remaining cooldown through the generated view.

08Cops and pursuit

Pursuit missions need police vehicles. CCDS_CopsManager handles spawning, and you can add one directly:

// Uses CCDS_Settings.copVehicle
CCDS.CreateCop(new Vector3(50f, 0f, 20f));

// Or an explicit prefab
CCDS.CreateCop(myCopPrefab, position, rotation);

The prefab must carry CCDS_AI_Cop. Build one with Tools → BoneCracker Games → CCDS → Vehicle Setup → Add Cop AI Components To Selected.

09Mission AI runs locally — keep it that way

Each participant activates the mission's AI locally, when the mission GameObject enables. There is no RPC broadcast telling everyone to spawn racers.

The consequence: players who are not in the mission never enable it, so they never see its AI racers or pursuit vehicles. That is deliberate. If you add code that spawns mission AI over the network, every player in the room gets them and the city fills with cars that should not be there.

The rationale is written up in Assets/CCDS/Scripts/Missions/MISSION_SYSTEM_REFACTORING.md.

10Verify

1. Open a gameplay scene, press Play.
2. Drive into the marker — the prompt appears.
3. Press Y.
4. The mission starts, objectives appear, the arrow indicator points at the next one.
5. Complete it and confirm the marker goes into cooldown.

If the prompt appears but Y does nothing, the marker's mission field is empty.

11Common problems

12Next

• Set Up a New City Scene — the managers missions depend on.
• Multiplayer — spawn assignment and participant tracking.
• Events Catalog — OnMissionStarted, OnMissionCompleted and friends.