4.0

Improve export experience for Snap Hutao

README_EN.md

@@ -16,12 +16,8 @@
 - Support for exporting to [Cocogoat](https://cocogoat.work/achievement), [Snap·HuTao](https://github.com/DGP-Studio/Snap.HuTao), [Paimon.moe](https://paimon.moe/achievement/), [Seelie.me](https://seelie.me/achievements)、[XunKong](https://github.com/xunkong/xunkong) and form files (csv)
 - There are no requirements for window size, game language, etc.
 
-## How to use:
-The first time you open it, you need to set the path that contains the Genshin main program (YuanShen.exe / GenshinIimpact.exe)
-![alt](https://upload-bbs.mihoyo.com/upload/2022/04/06/165631158/e540a5a6d50cd5fdee19665435548e00_514247033566841954.jpg)
-After setting up, wait for the game to start.
-When you see the door, press in to enter the game, the game will automatically exit.
-After the game exits, enter a number inside the program to select the site/application to export to
+## Instructions for Use:
+→ [Tutorial_EN.md](Tutorial_EN.md)
 
 ## Download: [Here](https://github.com/HolographicHat/YaeAchievement/releases/latest)
 
@@ -30,7 +26,8 @@ After the game exits, enter a number inside the program to select the site/appli
 
 ## Frequently asked questions
 0. Q: Unable to start   
-   A: Download and install [.NET Runtime 6](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-7.0.3-windows-x64-installer)
+   A: Download and install [.NET Runtime 7](https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-7.0.7-windows-x64-installer) or ` winget install Microsoft.DotNet.Runtime.7`
+ 
 
 1. Q: Error while Genshin started: Data Exception (31-4302)   
    A: Don't place software in the directory containing Genshin Impact.

Tutorial_EN.md

@@ -0,0 +1,73 @@
+## Instructions for Use
+
+
+1.Download YaeAchievement（Latest Version）：
+
+Click Here：https://github.com/HolographicHat/YaeAchievement/releases
+
+Click on the file named "YaeAchievement.exe" in the red box to automatically pop up and download.It is recommended that you save this file in a desktop or other easy-to-see folder.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide1.png)
+
+2.Install .NET Runtime 7 (this step can be ignored if the runtime is already installed)
+
+Click Here：https://dotnet.microsoft.com/en-us/download/dotnet/thank-you/runtime-7.0.7-windows-x64-installer .
+
+Or `winget install Microsoft.DotNet.Runtime.7` if you use Windows 11 or have Winget installed.
+
+The browser automatically pops up and downloads when you enter the web page, as well as saving files in a desktop or other easy-to-see folder.
+
+When you open a file with the name dotnet-runtime-x.x.x-win-x64.exe after the download is complete, an installation window pops up, as shown below.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide2.png)
+
+Just click Install.
+
+3.The actions required to open the main program and the options for the achievement export
+
+Double-click the file named "YaeAchievement.exe" downloaded in the first step to open it successfully, indicating that the original god is starting, as shown below.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide3.png)
+
+Once the primordial startup is complete, click to enter the game.
+
+When you click into the game, the tool prompts you to choose which tool to export, as shown below.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide4.png)
+
+For global user, you should select [3] Seelie.me or  [4] Export to csv file。
+
+After selecting, each page exports the tool as follows:
+
+#### Snap.Hutao：
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide5.png)
+
+#### Seelie.me：
+
+At this point, Yae Achievement will remind that performance data has been exported. Please find the file named export-20xxxxxxxxxxxx-seelie.json in the Yae Achievement save directory.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide6.png)
+
+Then click on the URL: https://seelie.me/settings, enter the website and select Import Account, as illustrated in the figure below.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide7.png)
+
+After clicking Import, select a file named export-20xxxxxxxxxxxx-seelie.json, as shown in the figure below.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide8.png)
+
+When the prompt as shown in the image below pops up, the import process succeeds.
+
+![image](https://github.com/prpjzz/yae-markdown-en/blob/main/image/Guide9.png)
+
+At this time, you can select the Achievements in the left column to view the imported performance data.
+
+### For the introduction of different tools, please visit the official page of each tool to see:
+
+1. [Snap·HuTao](https://github.com/DGP-Studio/Snap.HuTao)
+
+2. [Paimon.moe](https://paimon.moe/achievement/)
+
+3. [Seelie.me](https://seelie.me/achievements)
+

lib/src/dllmain.cpp

@@ -8,8 +8,8 @@ using std::to_string;
 HWND unityWnd = nullptr;
 HANDLE hPipe  = nullptr;
 
-// Allow Protocol: GetPlayerToken, PlayerLogin, AchievementAllDataNotify, Ping
-std::set<UINT16> PacketWhitelist = { 175, 196, 102, 172, 2678, 55, 48, 160 };
+// Allow Protocol: GetPlayerToken, PlayerLogin, AchievementAllDataNotify, Ping, PlayerForceExit
+std::set<UINT16> PacketWhitelist = { 21228, 2407, 25842, 29665, 27422, 5285, 8231, 1819 };
 
 bool OnPacket(KcpPacket* pkt) {
 	if (pkt->data == nullptr) return true;
@@ -30,7 +30,7 @@ bool OnPacket(KcpPacket* pkt) {
 		return false;
 	}
 	printf("Passed cmdid: %d\n", ReadMapped<UINT16>(data->vector, 2));
-	if (ReadMapped<UINT16>(data->vector, 2) == 2678) {
+	if (ReadMapped<UINT16>(data->vector, 2) == 27422) {
 		auto headLength = ReadMapped<UINT16>(data->vector, 4);
 		auto dataLength = ReadMapped<UINT32>(data->vector, 6);
 		auto iStr = Genshin::ToBase64String(data, 10 + headLength, dataLength, nullptr);

lib/src/il2cpp-api-functions.h

@@ -1 +1 @@
-DO_API(0x92e180, 0x92e1f0, Il2CppString*, il2cpp_string_new, (const char* str));
+DO_API(0x9cc850, 0x9ca750, Il2CppString*, il2cpp_string_new, (const char* str));

lib/src/il2cpp-functions.h

@@ -2,30 +2,30 @@ using namespace Genshin;
 
 // DO_APP_FUNC(CN_OFFSET, OS_OFFSET, RETURN, FUNC_NAME, (ARGS...));
 
-DO_APP_FUNC(0x68df290, 0x6822570, Il2CppString*, ToBase64String, (ByteArray* value, int offset, int length, void* method));
+DO_APP_FUNC(0x7974040, 0x792b560, Il2CppString*, ToBase64String, (ByteArray* value, int offset, int length, void* method));
 
-DO_APP_FUNC(0x272fe00, 0x26df410, void, SetVersion, (void* obj, Il2CppString* value, void* method));
+DO_APP_FUNC(0x21e5c10, 0x21bf5c0, void, SetVersion, (void* obj, Il2CppString* value, void* method));
 
-DO_APP_FUNC(0x710a730, 0x70401b0, ByteArray*, RecordUserData, (int32_t nType));
+DO_APP_FUNC(0x81d1a00, 0x818d250, ByteArray*, RecordUserData, (int32_t nType));
 
-DO_APP_FUNC(0x26a7940, 0x2658ae0, void, XorEncrypt, (ByteArray** data, int length, void* method));
+DO_APP_FUNC(0x3174320, 0x3133880, void, XorEncrypt, (ByteArray** data, int length, void* method));
 
-DO_APP_FUNC(0x19d99a0, 0x19b12f0, int, KcpSend, (void* client, KcpPacket* pkt, void* method));
+DO_APP_FUNC(0x2d49720, 0x2d103a0, int, KcpSend, (void* client, KcpPacket* pkt, void* method));
 
-DO_APP_FUNC(0x306e0e0, 0x3001bf0, bool, KcpRecv, (void* client, ClientKcpEvent* evt, void* method));
+DO_APP_FUNC(0x3d6a920, 0x3d11e00, bool, KcpRecv, (void* client, ClientKcpEvent* evt, void* method));
 
-DO_APP_FUNC(0x6b832c0, 0x6ac2040, LPVOID, GetDefaultEncoding, ());
+DO_APP_FUNC(0x7c9c9c0, 0x7c56400, LPVOID, GetDefaultEncoding, ());
 
-DO_APP_FUNC(0x6b82b50, 0x6ac18d0, Il2CppString*, GetString, (LPVOID encoding, LPVOID bytes));
+DO_APP_FUNC(0x7c9c220, 0x7c55c60, Il2CppString*, GetString, (LPVOID encoding, LPVOID bytes));
 
-DO_APP_FUNC(0x6b81980, 0x6ac0760, ByteArray*, GetBytes, (LPVOID encoding, LPVOID str));
+DO_APP_FUNC(0x7c9b030, 0x7c54a20, ByteArray*, GetBytes, (LPVOID encoding, LPVOID str));
 
-DO_APP_FUNC(0x18a0490, 0x187a070, VOID, RequestLogin, (LPVOID obj, LPVOID token, UINT uid));
+DO_APP_FUNC(0x1d2e480, 0x1d0db20, VOID, RequestLogin, (LPVOID obj, LPVOID token, UINT uid));
 
-DO_APP_FUNC(0x3669cd0, 0x1b323c0, VOID, SetChecksum, (LPVOID obj, Il2CppString* value));
+DO_APP_FUNC(0x31285b0, 0x32ee9b0, VOID, SetChecksum, (LPVOID obj, Il2CppString* value));
 
-DO_APP_FUNC(0xed5d70, 0xecc910, VOID, ForceQuit, (LPVOID obj));
+DO_APP_FUNC(0xfa2eb0, 0xf99150, VOID, ForceQuit, (LPVOID obj));
 
-DO_APP_FUNC(0x57fb490, 0x574b7f0, LPVOID, GetSingletonManager, ());
+DO_APP_FUNC(0x7257b20, 0x72079f0, LPVOID, GetSingletonManager, ());
 
-DO_APP_FUNC(0x57fb1c0, 0x574b520, LPVOID, GetSingletonInstance, (LPVOID obj, Il2CppString* value));
+DO_APP_FUNC(0x7257850, 0x7207720, LPVOID, GetSingletonInstance, (LPVOID obj, Il2CppString* value));

lib/src/il2cpp-unity-functions.h

@@ -1,3 +1,3 @@
 using namespace Genshin;
 
-DO_UNI_FUNC(0x1003e0, 0x1003e0, ByteArray*, UnityEngine_RecordUserData, (int32_t nType));
+DO_UNI_FUNC(0x102fa0, 0x102fa0, ByteArray*, UnityEngine_RecordUserData, (int32_t nType));

res/App.Designer.cs

@@ -157,7 +157,7 @@ namespace YaeAchievement.res {
         }
         
         /// <summary>
-        ///   Looks up a localized string similar to Please update SnapGenshin and retry..
+        ///   Looks up a localized string similar to Please update Snap Hutao and retry..
         /// </summary>
         internal static string ExportToSnapGenshinNeedUpdate {
             get {
@@ -166,7 +166,7 @@ namespace YaeAchievement.res {
         }
         
         /// <summary>
-        ///   Looks up a localized string similar to Successfully exported to snap genshin..
+        ///   Looks up a localized string similar to Successfully exported to Snap Hutao..
         /// </summary>
         internal static string ExportToSnapGenshinSuccess {
             get {

res/App.resx

@@ -41,10 +41,10 @@ Input a number (0-5): </value>
         <value>{0}</value>
     </data>
     <data name="ExportToSnapGenshinSuccess" xml:space="preserve">
-        <value>Successfully exported to snap genshin.</value>
+        <value>Successfully exported to Snap Hutao.</value>
     </data>
     <data name="ExportToSnapGenshinNeedUpdate" xml:space="preserve">
-        <value>Please update SnapGenshin and retry.</value>
+        <value>Please update Snap Hutao and retry.</value>
     </data>
     <data name="ExportToFileSuccess" xml:space="preserve">
         <value>Successfully exported to {0}</value>

res/App.zh.resx

@@ -20,13 +20,13 @@
     <data name="ExportChoose" xml:space="preserve">
         <value>导出至: 
 [0] 椰羊 (https://cocogoat.work/achievement, 默认)
-[1] Snap.HuTao
+[1] Snap Hutao
 [2] Paimon.moe
 [3] Seelie.me
 [4] 表格文件
 [5] 寻空
 [6] 原魔工具箱
-[7] UIAF JSON文件
+[7] UIAF JSON 文件
 输入一个数字 (0-7): </value>
     </data>
     <data name="ExportToCocogoatSuccess" xml:space="preserve">
@@ -36,10 +36,10 @@
         <value>在小程序导入页面输入以下代码: {0}</value>
     </data>
     <data name="ExportToSnapGenshinSuccess" xml:space="preserve">
-        <value>在 SnapHutao 进行下一步操作</value>
+        <value>在 Snap Hutao 中进行下一步操作</value>
     </data>
     <data name="ExportToSnapGenshinNeedUpdate" xml:space="preserve">
-        <value>更新 SnapHutao 至最新版本后重试</value>
+        <value>更新/安装 Snap Hutao 最新版本后重试</value>
     </data>
     <data name="ExportToFileSuccess" xml:space="preserve">
         <value>成就数据已导出至 {0}</value>

res/proto/AchievementAllDataNotify.proto

@@ -10,12 +10,12 @@ message Achievement {
     REWARD_TAKEN = 3;
   }
   uint32 timestamp = 15;
-  uint32 current = 5;
-  uint32 total = 14;
-  uint32 id = 3;
+  uint32 current = 14;
+  uint32 total = 4;
+  uint32 id = 5;
   Status status = 10;
 }
 
 message AchievementAllDataNotify {
-    repeated Achievement list = 4;
+    repeated Achievement list = 9;
 }

src/Export.cs

@@ -77,9 +77,17 @@ public static class Export {
     }
 
     private static void ToHuTao(AchievementAllDataNotify data) {
-        Utils.CopyToClipboard(JsonSerializer.Serialize(ExportToUIAFApp(data)));
-        Utils.ShellOpen("hutao://achievement/import");
-        Console.WriteLine(App.ExportToSnapGenshinSuccess);
+        if (CheckWinUIAppScheme("hutao"))
+        {
+            Utils.CopyToClipboard(JsonSerializer.Serialize(ExportToUIAFApp(data)));
+            Utils.ShellOpen("hutao://achievement/import");
+            Console.WriteLine(App.ExportToSnapGenshinSuccess);
+        }
+        else
+        {
+            Console.WriteLine(App.ExportToSnapGenshinNeedUpdate);
+            Utils.ShellOpen("ms-windows-store://pdp/?productid=9PH4NXJ2JN52");
+        }
     }
     
     // ReSharper disable once InconsistentNaming
@@ -161,7 +169,7 @@ public static class Export {
     }
 
     private static void ToXunkong(AchievementAllDataNotify data) {
-        if (CheckXunkongScheme()) {
+        if (CheckWinUIAppScheme("xunkong")) {
             Utils.CopyToClipboard(JsonSerializer.Serialize(ExportToUIAFApp(data)));
             Utils.ShellOpen("xunkong://import-achievement?caller=YaeAchievement&from=clipboard");
             Console.WriteLine(App.ExportToXunkongSuccess);
@@ -203,8 +211,8 @@ public static class Export {
         };
     }
 
-    private static bool CheckXunkongScheme() {
-        return (string?)Registry.ClassesRoot.OpenSubKey("xunkong")?.GetValue("") == "URL:xunkong";
+    private static bool CheckWinUIAppScheme(string protocol) {
+        return (string?)Registry.ClassesRoot.OpenSubKey(protocol)?.GetValue("") == $"URL:{protocol}";
     }
 
     private static string JoinToString(this IEnumerable<object> list, string separator) {

src/GlobalVars.cs

@@ -20,8 +20,8 @@ public static class GlobalVars {
     public static readonly string CachePath = Path.Combine(DataPath, "cache");
     public static readonly string LibFilePath = Path.Combine(DataPath, "YaeAchievement.dll");
     
-    public const uint   AppVersionCode = 38;
-    public const string AppVersionName = "2.8";
+    public const uint   AppVersionCode = 40;
+    public const string AppVersionName = "3.0";
     
     public const string PipeName = "YaeAchievementPipe";
     public const string BucketHost = "https://cn-cd-1259389942.file.myqcloud.com";

src/Utils.cs

@@ -92,7 +92,7 @@ public static class Utils {
     
     public static void CheckUpdate(bool useLocalLib) {
         var info = UpdateInfo.Parser.ParseFrom(GetBucketFileAsByteArray("schicksal/version"))!;
-        if (GlobalVars.AppVersionCode != info.VersionCode) {
+        if (GlobalVars.AppVersionCode < info.VersionCode) {
             Console.WriteLine(App.UpdateNewVersion, GlobalVars.AppVersionName, info.VersionName);
             Console.WriteLine(App.UpdateDescription, info.Description);
             if (info.EnableAutoDownload) {