add tutorial guide

Common/Data/Config/StringToUIntConverter.cs

@@ -0,0 +1,24 @@
+using Newtonsoft.Json;
+
+namespace MikuSB.Data.Config;
+
+public class StringToUIntConverter : JsonConverter<uint>
+{
+    public override uint ReadJson(JsonReader reader, Type objectType, uint existingValue, bool hasExistingValue, JsonSerializer serializer)
+    {
+        if (reader.Value == null)
+            return 0;
+
+        var value = reader.Value.ToString();
+
+        if (string.IsNullOrWhiteSpace(value))
+            return 0;
+
+        return uint.TryParse(value, out var result) ? result : 0;
+    }
+
+    public override void WriteJson(JsonWriter writer, uint value, JsonSerializer serializer)
+    {
+        writer.WriteValue(value);
+    }
+}

Common/Data/Excel/GuideExcel.cs

@@ -0,0 +1,21 @@
+using MikuSB.Data.Config;
+using Newtonsoft.Json;
+
+namespace MikuSB.Data.Excel;
+
+[ResourceEntity("guide/guide.json")]
+public class GuideExcel : ExcelResource
+{
+    public uint ID { get; set; }
+    [JsonConverter(typeof(StringToUIntConverter))] public uint Group { get; set; }
+
+    public override uint GetId()
+    {
+        return (ID << 48) | (Group << 32);
+    }
+
+    public override void Loaded()
+    {
+        GameData.GuideData.TryAdd(GetId(), this);
+    }
+}

Common/Data/GameData.cs

@@ -29,6 +29,7 @@ public static class GameData
     public static Dictionary<uint, CardSkinPartsExcel> CardSkinPartsData { get; private set; } = [];
     public static Dictionary<uint, CallItemExcel> CallItemData { get; private set; } = [];
     public static Dictionary<uint, WeaponPartsExcel> WeaponPartsData { get; private set; } = [];
+    public static Dictionary<uint, GuideExcel> GuideData { get; private set; } = [];
 }
 
 public static class GameResourceTemplateId

GameServer/Game/Character/CharacterManager.cs

@@ -27,11 +27,11 @@ public class CharacterManager(PlayerInstance player) : BasePlayerManager(player)
             Timestamp = Extensions.GetUnixSec()
         };
 
-        var weaponInfo = await Player.InventoryManager!.AddWeaponItem((ItemTypeEnum)CharacterExcel.DefaultWeaponGPDL[0], CharacterExcel.DefaultWeaponGPDL[1], CharacterExcel.DefaultWeaponGPDL[2], CharacterExcel.DefaultWeaponGPDL[3],sendPacket:false);
+        var weaponInfo = await Player.InventoryManager!.AddWeaponItem((ItemTypeEnum)CharacterExcel.DefaultWeaponGPDL[0], CharacterExcel.DefaultWeaponGPDL[1], CharacterExcel.DefaultWeaponGPDL[2], CharacterExcel.DefaultWeaponGPDL[3],sendPacket: true);
         if (weaponInfo != null) character.WeaponUniqueId = weaponInfo.UniqueId;
 
         var skinInfo = Player.InventoryManager!.GetSkinItemGDPL(ItemTypeEnum.TYPE_CARD_SKIN, detail, particular, level)
-              ?? await Player.InventoryManager!.AddSkinItem(ItemTypeEnum.TYPE_CARD_SKIN, detail, particular, level, false);
+              ?? await Player.InventoryManager!.AddSkinItem(ItemTypeEnum.TYPE_CARD_SKIN, detail, particular, level, true);
         if (skinInfo != null) character.SkinId = skinInfo.UniqueId;
 
         if (sendPacket) await Player.SendPacket(new PacketNtfCallScript([character]));

GameServer/Game/Player/PlayerInstance.cs

@@ -370,6 +370,11 @@ public class PlayerInstance(PlayerGameData data)
             yield return (22, levelId, 1_700_000_000);
         }
 
+        foreach (var guide in GameData.GuideData.Values)
+        {
+            yield return (4, guide.ID, 999);
+        }
+
         // Main Scene 0 mean default scene
         yield return (132, 1, 0);
     }