ชุดฟีเจอร์ภารกิจ

ชุดฟีเจอร์ ภารกิจ นำเสนอฟังก์ชันการทำงานที่จัดเตรียมไว้ล่วงหน้าเพื่อสร้างภารกิจที่ผู้เล่นสามารถทำสำเร็จเพื่อรับรางวัลและก้าวหน้าในประสบการณ์ของคุณ โดยภารกิจทั้งหมดจะต้องมี ID, หมวดหมู่ และรายการของงานที่ผู้เล่นต้องทำเพื่อให้ภารกิจเสร็จสมบูรณ์ อย่างไรก็ตาม รายการงานสามารถว่างเปล่าได้ ทำให้ผู้เล่นสามารถรับรางวัลภารกิจได้ทันที

โดยใช้ตัวเลือกการปรับแต่งของชุดฟีเจอร์ คุณสามารถปรับเปลี่ยนภารกิจทั้งหมดให้ตรงกับความต้องการในการเล่นเกมที่ไม่ซ้ำใครของคุณ เช่น:

• สร้างภารกิจที่ช่วย แนะนำ ผู้เล่นใหม่ให้เข้าสู่ประสบการณ์ของคุณและปรับปรุง ความคงอยู่ D1
• มุ่งเน้นการรักษาผู้เล่นในวันที่ 7 และ 30 โดยการเพิ่มเป้าหมายระยะกลางถึงระยะยาวและรู้สึกถึงความก้าวหน้า
• เพิ่ม การมีส่วนร่วม โดยการนำเสนอระบบต่างๆ ในเกมของคุณและให้รางวัลแก่ผู้เล่นสำหรับการโต้ตอบกับมัน

รับชุดฟีเจอร์

Creator Store เป็นแท็บใน Toolbox ที่คุณสามารถใช้เพื่อค้นหาทรัพยากรทั้งหมดที่สร้างโดย Roblox และชุมชน Roblox สำหรับใช้ในโปรเจกต์ของคุณ รวมถึงโมเดล, รูปภาพ, เมช, เสียง, ปลั๊กอิน, วิดีโอ และทรัพยากรฟอนต์ คุณสามารถใช้ Creator Store เพื่อเพิ่มทรัพยากรหนึ่งหรือมากกว่าโดยตรงลงในประสบการณ์ที่เปิดอยู่ รวมถึงชุดฟีเจอร์ด้วย!

ชุดฟีเจอร์ทุกชุดต้องการ Core ชุดฟีเจอร์เพื่อทำงานได้อย่างถูกต้อง เมื่อคุณมี Core และ Missions ชุดฟีเจอร์ในคลังของคุณแล้ว คุณสามารถนำไปใช้ซ้ำในโปรเจกต์ใดๆ บนแพลตฟอร์ม

ในการนำชุดฟีเจอร์จากคลังของคุณเข้าสู่ประสบการณ์ของคุณ:

1. เพิ่ม Core และ Missions ลงในคลังของคุณภายใน Studio โดยคลิกที่ลิงก์ Add to Inventory ในชุดของส่วนประกอบถัดไป

   ชุดฟีเจอร์ Core

   ชุดฟีเจอร์ Core นำเสนอโลจิกการเก็บข้อมูลที่ใช้ร่วมกันสำหรับชุดฟีเจอร์ทั้งหมด

   เพิ่มไปยังคลังไอเท็ม

   ชุดฟีเจอร์ภารกิจ

   ชุดฟีเจอร์ภารกิจเสนอฟังก์ชันการสร้างภารกิจที่ผู้เล่นสามารถทำสำเร็จเพื่อรับรางวัลและก้าวหน้าในประสบการณ์ของคุณ

   เพิ่มไปยังคลังไอเท็ม

2. จากเมนู Window ของ Studio หรือแถบเครื่องมือ Home เปิด Toolbox

3. ในหน้าต่าง Toolbox คลิกที่แท็บ Inventory แสดงการจัดเรียง My Models

   

4. คลิกที่ไทล์ Feature Package Core จากนั้นคลิกที่ไทล์ Missions Feature Package โฟลเดอร์ของทั้งสองชุดจะแสดงในหน้าต่าง Explorer

5. ลากโฟลเดอร์ชุดไปไว้ใน ReplicatedStorage

กำหนดภารกิจ

ภารกิจที่ทำได้แต่ละรายการจะรวมถึงชุดของงานที่ต้องทำให้เสร็จเพื่อให้ภารกิจเสร็จสมบูรณ์ ตัวเลือกการกำหนดค่า และ metadata เสริม ซึ่งทั้งหมดสามารถกำหนดได้ภายใน ReplicatedStorage.Missions.Configs.Missions โดยประเภทเหล่านี้จะถูกส่งออกจากสคริปต์ Types ในโฟลเดอร์เดียวกัน

ฟิลด์ที่จำเป็น

ฟิลด์ดังต่อไปนี้เป็นสิ่งจำเป็นสำหรับแต่ละภารกิจ

เงื่อนไขการปลดล็อก

ตามค่าเริ่มต้น ภารกิจจะปลดล็อกสำหรับผู้เล่นโดยอัตโนมัติและสามารถทำสำเร็จได้เพียงครั้งเดียว อย่างไรก็ตาม คุณสามารถใช้ตัวเลือกการกำหนดค่าที่ เลือกได้ ต่อไปนี้เพื่อเปลี่ยนแปลงพฤติกรรมนี้

Metadata

ภารกิจมี metadata ที่ระบุวิธีการแสดงในส่วนติดต่อผู้ใช้ภารกิจ คุณสามารถใช้ฟิลด์ เลือกได้ ดังต่อไปนี้เพื่อปรับแต่ง metadata ของมัน

กำหนดงาน

แต่ละภารกิจสามารถมีงานได้ศูนย์หรือมากกว่า หากภารกิจมีงานศูนย์ งานนั้นสามารถเคลมได้ทันทีหลังจากที่ปลดล็อก หากภารกิจมีหนึ่งงานหรือมากกว่า เมื่องานเสร็จสมบูรณ์ ผู้เล่นสามารถเก็บรางวัลใดๆ ที่เกี่ยวข้องกับภารกิจนั้นได้ งานแต่ละงานมี taskId ซึ่งคือคีย์ที่เกี่ยวข้องกับงานสำหรับภารกิจที่กำหนด

งานมีอยู่สองประเภท:

• Timed Tasks - ช่วยให้คุณเริ่มและหยุดงานในช่วงเวลาที่แตกต่างกัน จำนวนเวลาหนึ่งต้องผ่านไปในขณะที่ตัวจับเวลาในงานกำลังทำงาน จากนั้นงานจะเสร็จสมบูรณ์
• Count Tasks - ช่วยให้คุณเพิ่มหรือกำหนดความก้าวหน้าของงาน เมื่อความก้าวถึงค่าที่ตั้งไว้ งานจะเสร็จสมบูรณ์

ทั้งสองประเภทของงานมีฟิลด์ดังต่อไปนี้:

ฟิลด์ของงานนับ

งานนับมีค่าที่จำเป็น เมื่อความก้าวหน้าของงานตรงตามจำนวนนี้ งานจะเสร็จสมบูรณ์

ฟิลด์ของงานที่ใช้เวลา

งานที่ใช้เวลามีจำนวนเป้าหมายของเวลาที่ใช้และจะเริ่มและหยุด เมื่อปริมาณเวลาที่กำหนดถูกต้อง งานจะเสร็จสมบูรณ์

กำหนดหมวดหมู่

หมวดหมู่ไม่จำเป็นต้องถูกกำหนดอย่างชัดเจนเพื่อที่จะใช้ หมวดหมู่สำหรับภารกิจมีค่าตั้งต้นที่จะถูกใช้ อย่างไรก็ตาม คุณสามารถกำหนดค่าเหล่านี้ใน ReplicatedStorage.Missions.Configs.Categories เพื่อเพิ่มเอฟเฟกต์ที่เพิ่มเติมให้กับหมวดหมู่ หมวดหมู่จะถูกระบุด้วย CategoryIds ที่ไม่ซ้ำกัน ซึ่งเป็นหมายเลขเดียวกันที่อ้างอิงในการกำหนดค่าภารกิจ

รวมตรรกะเซิร์ฟเวอร์

ดูที่ ReplicatedStorage.Missions.Server.Examples.MissionsExample ซึ่งจะแสดงวิธีที่เซิร์ฟเวอร์ของคุณจะโต้ตอบกับชุดฟีเจอร์ ภารกิจ

คุณจะต้องเชื่อมต่อสี่สิ่งหลังจากลากชุดฟีเจอร์ ภารกิจ เข้าประสบการณ์ของคุณ:

1. กำหนดภารกิจในการกำหนดค่าภารกิจของคุณ

2. เพิ่มตรรกะในประสบการณ์ของคุณเพื่ออัปเดตความก้าวหน้าของงานหรือจำนวนตัวนับที่ติดตามความก้าวหน้า

   README
   -- เพิ่มความก้าวหน้าในภารกิจ Jumping กับรายการงาน Jumps
   Missions.addProgressToTask(player, "Jumping", "Jumps", 1)
   
   -- เริ่มจับเวลาในภารกิจ BattlingTime กับงาน TimeInBattle
   Missions.startTimedTask(player, "BattlingTime", "TimeInBattle")
   
   -- หยุดจับเวลาในภารกิจ BattlingTime กับงาน TimeInBattle
   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")

กำหนดค่าค่าคงที่

ค่าคงที่สำหรับชุดฟีเจอร์ Core จะอยู่ในสองตำแหน่ง:

• ค่าคงที่ที่แชร์จะอยู่ใน ReplicatedStorage.FeaturePackagesCore.Configs.SharedConstants

• ค่าคงที่เฉพาะชุดฟีเจอร์ สำหรับชุดฟีเจอร์ ภารกิจ จะอยู่ใน ReplicatedStorage.Missions.Configs.Constants

นอกจากนี้ คุณสามารถค้นหาสตริงสำหรับการแปลที่แยกออกไปในที่เดียว: ReplicatedStorage.FeaturePackagesCore.Configs.TranslationStrings

ปรับปรุงส่วนประกอบ UI

โดยการปรับแต่งวัตถุของชุดฟีเจอร์ เช่น สี ฟอนต์ และความโปร่งใส คุณสามารถปรับเปลี่ยนการนำเสนอภาพของ UI ภารกิจของคุณได้ ตัวอย่างเช่น ใน ReplicatedStorage.Missions.Configs.Constants คุณสามารถเปิดใช้งาน SingleTaskMode เพื่อแสดงแถบความก้าวหน้าสำหรับงานโดยตรงบนภารกิจสำหรับภารกิจที่มีเพียงงานเดียวเท่านั้น

นอกจากนี้ หากประสบการณ์ของคุณมี UI ที่มีอยู่แล้วซึ่งคุณต้องการรวมกับชุดฟีเจอร์ ภารกิจ สคริปต์โมดูลในไคลเอนต์ ModuleScript MissionsClient จะมีฟังก์ชันทั้งหมดที่จำเป็นในการส่งข้อมูลเกี่ยวกับภารกิจของผู้เล่นจากเซิร์ฟเวอร์