미션 패키지

미션 기능 패키지는 플레이어가 완료하여 보상을 받고 경험을 진행할 수 있는 미션을 생성할 수 있는 즉시 사용 가능한 기능을 제공합니다. 모든 미션은 ID, 카테고리 및 플레이어가 미션을 완료하기 위해 수행해야 하는 작업 목록을 가져야 합니다. 그러나 작업 목록은 비워둘 수 있어, 미션의 보상을 즉시 클레임할 수 있습니다.

패키지의 사용자 정의 옵션을 사용하여 고유한 게임 플레이 요구 사항을 충족하도록 모든 미션을 개인화할 수 있습니다. 예를 들어:

• 새로운 플레이어가 당신의 경험에 적응하도록 온보딩하는 미션을 생성하고 D1 유지율을 개선합니다.
• 중장기 목표와 진행 감각을 추가하여 D7 및 D30 유지율을 목표로 합니다.
• 게임 내의 다양한 시스템을 드러내고 플레이어가 상호작용할 때 보상을 제공하여 참여도를 증가시킵니다.

패키지 가져오기

크리에이터 스토어는 프로젝트 내에서 사용할 수 있는 Roblox와 Roblox 커뮤니티에서 제작한 모든 자산을 찾을 수 있는 툴박스의 탭입니다. 여기에는 모델, 이미지, 메쉬, 오디오, 플러그인, 비디오, 글꼴 자산이 포함됩니다. 크리에이터 스토어를 사용하여 열린 경험에 하나 이상의 자산을 직접 추가할 수 있으며, 기능 패키지도 포함됩니다!

모든 기능 패키지가 제대로 작동하려면 코어 기능 패키지가 필요합니다. 코어 및 미션 기능 패키지 자산이 귀하의 인벤토리에 있으면 플랫폼의 어떤 프로젝트에서도 재사용할 수 있습니다.

인벤토리에서 패키지를 경험으로 가져오려면:

1. 다음 구성 요소 세트의 인벤토리에 추가 링크를 클릭하여 Studio 내 인벤토리에 코어 및 미션을 추가하십시오.

   코어 기능 패키지

   코어 기능 패키지는 모든 기능 패키지에 대한 공유 데이터 저장소 로직을 제공합니다.

   인벤토리에 추가

   미션 기능 패키지

   미션 기능 패키지는 플레이어가 완료하여 보상을 받고 경험을 진행할 수 있는 미션을 생성하는 기능을 제공합니다.

   인벤토리에 추가

2. Studio의 창 메뉴 또는 홈 탭 툴바에서 툴박스를 엽니다.

3. 툴박스 창에서 인벤토리 탭을 클릭합니다. 내 모델 정렬이 표시됩니다.

   

4. 기능 패키지 코어 타일을 클릭한 다음 미션 기능 패키지 타일을 클릭합니다. 두 패키지 폴더가 탐색기 창에 표시됩니다.

5. 패키지 폴더를 ReplicatedStorage로 끌어다 놓습니다.

미션 정의하기

각 완료 가능한 미션은 미션을 완료하기 위해 완료해야 할 작업 세트, 구성 옵션 및 선택적 표시 메타데이터를 포함하며, 이는 ReplicatedStorage.Missions.Configs.Missions 내에서 정의할 수 있습니다. 이와 관련된 유형은 동일 폴더의 Types 스크립트에서 내보낼 수 있습니다.

필수 필드

각 미션에 필요한 필드는 다음과 같습니다.

잠금 조건

기본적으로 미션은 플레이어에게 자동으로 잠금 해제되며 정확히 한 번만 완료할 수 있습니다. 그러나 다음 선택적 구성 옵션을 사용하여 이 동작을 변경할 수 있습니다.

메타데이터

미션은 미션 사용자 인터페이스에 어떻게 표시될지를 명시하는 메타데이터를 가지고 있습니다. 다음 선택적 필드를 사용하여 메타데이터를 사용자 정의할 수 있습니다.

작업 정의하기

각 미션은 0개 이상의 작업을 가질 수 있습니다. 미션에 작업이 없는 경우, 잠금 해제와 동시에 클레임할 수 있습니다. 미션에 하나 이상의 작업이 있는 경우, 작업이 완료되면 플레이어는 미션과 관련된 보상을 수령할 수 있습니다. 각 작업에는 해당 미션과 관련된 키인 taskId가 있습니다.

작업은 두 가지 유형이 있습니다:

• 시간 제한 작업 - 작업을 여러 시점에서 시작하고 중지할 수 있습니다. 작업 타이머가 실행되는 동안 특정 시간이 경과해야 하고, 그러면 작업이 완료됩니다.
• 수량 작업 - 작업의 진행 상황을 추가하거나 설정할 수 있습니다. 진행 상황이 설정된 값에 도달하면 작업이 완료됩니다.

각 작업 유형은 다음 필드를 공유합니다.

수량 작업 필드

수량 작업에는 필수 값이 있습니다. 작업 진행 상황이 이 수치에 도달하면 작업이 완료됩니다.

시간 작업 필드

시간 작업에는 소비해야 하는 목표 시간이 있으며 시작하고 정지합니다. 목표 시간이 충족되면 작업이 완료됩니다.

카테고리 구성

카테고리는 명시적으로 정의할 필요는 없으며, 미션에 대한 카테고리는 기본값이 사용됩니다. 그러나 ReplicatedStorage.Missions.Configs.Categories에서 이러한 값을 구성하여 카테고리에 추가 효과를 추가할 수 있습니다. 카테고리는 고유한 CategoryIds로 식별되며, 이는 미션 구성에서 참조됩니다.

서버 로직 통합

ReplicatedStorage.Missions.Server.Examples.MissionsExample를 확인하여 서버가 미션 기능 패키지와 어떻게 상호작용하는지 확인하십시오.

미션 기능 패키지를 경험에 드래그한 후 주로 네 가지를 연결해야 합니다:

1. 미션 구성에서 미션을 정의합니다.

2. 작업 진행 상황이나 해당 진행 상황이 연결된 카운터를 업데이트하는 로직을 경험에 추가합니다.

   README
   -- Jumps 작업으로 Jumping 미션의 진행 상황을 증가시킵니다.
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- TimeInBattle 작업으로 BattlingTime 미션의 타이머를 시작합니다.
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- TimeInBattle 작업으로 BattlingTime 미션의 타이머를 중지합니다.
   Missions.stopTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- Jumps 카운터와 연결된 모든 작업의 진행 상황을 증가시킵니다.
   CounterSystem.addCounter(player, "Jumps", 1)
   
   -- TimeInBattle 타이머 카운터와 연결된 모든 시간 제한 작업의 타이머를 시작합니다.
   CounterSystem.startTimer(player, "TimeInBattle")
   
   -- TimeInBattle 타이머 카운터와 연결된 모든 시간 제한 작업의 타이머를 중지합니다.
   CounterSystem.stopTimer(player, "TimeInBattle")

3. 미션 완료 핸들러 및 선택적으로 잠금 해제 또는 실패 핸들러를 설정합니다. 완수 핸들러를 사용하여 경험에서 미션의 보상을 수여합니다.

   README
   local function completeHandler(player: Player, missionId: Types.MissionId)
        print(`{player}가 미션 {missionId}을 완료했습니다.`)
        -- 플레이어에게 보상을 수여합니다.
    end
   
   Missions.setCompletionHandler(missionId, completeHandler)

4. 자동으로 잠금 해제되지 않은 미션을 잠금 해제합니다. 미션 기능 패키지 로직은 미션이 완료되기 전에 모든 미션 요구 사항이 충족되도록 합니다. 그리고 그 보상을 수령할 수 있습니다.

   README
   Missions.unlockMission(player, "Manual")

상수 구성

코어 기능 패키지의 상수는 두 개의 위치에 있습니다:

• 공유 상수는 ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants에 존재합니다.

• 패키지별 상수, 즉 미션 기능 패키지의 경우 ReplicatedStorage.Missions.Configs.Constants에 존재합니다.

추가로, 번역을 위한 문자열은 하나의 위치인 ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings에 나누어져 있습니다.

UI 구성 요소 사용자 정의

패키지 객체(색상, 글꼴 및 투명도 등)를 수정하여 미션 UI의 시각적 프레젠테이션을 조정할 수 있습니다. 예를 들어, ReplicatedStorage.Missions.Configs.Constants에서 SingleTaskMode를 활성화하면 하나의 작업만 있는 미션에 대해 미션 자체에 진행 바를 표시할 수 있습니다.

마지막으로, 경험에 이미 존재하는 UI와 미션 기능 패키지를 통합하고자 하는 경우, 클라이언트 ModuleScript MissionsClient에는 서버에서 플레이어의 미션 정보를 전송하는 데 필요한 모든 기능이 포함되어 있습니다.