存档数据读写接口，让游戏提示更加明显

DarlingZeroX · DarlingZeroX · commit 4570383ff549 · 2026-01-13T18:04:19.000+08:00
diff --git a/Editor/VGEditorFramework/Source/Setting/BuildSettingsPanel.cpp b/Editor/VGEditorFramework/Source/Setting/BuildSettingsPanel.cpp
@@ -131,7 +131,7 @@ namespace VisionGal::Editor
 
 	bool BuildSettingsPanel::BuildOutputDirectoryUI()
 	{
-		ImVec4 invalidTextColor = ImVec4(0.7f, 0.7f, 0.7f, 1.0f);
+		ImVec4 invalidTextColor = ImVec4(1.0f, 0.1f, 0.1f, 1.0f);
 
 		// 生成目录
 		ImGui::Text(EditorText{ "Build output directory" }.c_str());
@@ -180,7 +180,7 @@ namespace VisionGal::Editor
 
 			// 构建平台
 			ImGui::Text(EditorText{ "Target Platform" }.c_str());
-			if (ImGui::BeginCombo("##Editor Theme", "Windows", ImGuiComboFlags_PopupAlignLeft))
+			if (ImGui::BeginCombo("##Target Platform", "Windows", ImGuiComboFlags_PopupAlignLeft))
 			{
 				for (int i = 0; i < m_TargetPlatforms.size(); i++)
 				{
diff --git a/Project/示例项目/Assets/剧情脚本/剧情选择.lua b/Project/示例项目/Assets/剧情脚本/剧情选择.lua
@@ -3,7 +3,7 @@ local 梦旅 = VG:创建人物('梦旅')
 return function()
     梦旅:说('这是一个Galgame游戏脚本初始化模版')
     梦旅:说('你可以在这里添加剧情内容1')
-	当前选择 = VG:剧情选择('分支1',{'选择1','选择2'})
+	当前选择 = VG:剧情选择('分支1',{'选择1','选择2','选择3'})
     if 当前选择 == '选择1' then
         梦旅:说('选择1')
         梦旅:说('选择11')
@@ -16,6 +16,12 @@ return function()
         梦旅:说('选择222')
         梦旅:说('选择2222')
         梦旅:说('选择22222')
+    elseif 当前选择 == '选择3' then
+        梦旅:说('选择3')
+        梦旅:说('选择33')
+        梦旅:说('选择333')
+        梦旅:说('选择3333')
+        梦旅:说('选择33333')
     end
     return
 end
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递1.lua b/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递1.lua
@@ -0,0 +1,9 @@
+local 梦旅 = GalGame.引擎:创建人物('梦旅')
+
+return function()
+    梦旅:说('这是脚本数据传递1')
+    梦旅:说('脚本数据传递1你可以在这里添加剧情内容')
+	VG.存档数据.命名空间1.变量1 = 'VG.存档数据.命名空间1.变量1的值'
+	VG:加载剧情脚本('/assets/剧情脚本/存档数据读写/脚本数据传递2.lua')
+    return
+end
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递1.lua.meta b/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递1.lua.meta
@@ -0,0 +1 @@
+[VGASSET];944921556481458559;GalGameStoryScript
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递2.lua b/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递2.lua
@@ -0,0 +1,8 @@
+local 梦旅 = GalGame.引擎:创建人物('梦旅')
+
+return function()
+    梦旅:说('这是脚本数据传递2.lua')
+    梦旅:说(VG.存档数据.命名空间1.变量1)
+
+    return
+end
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递2.lua.meta b/Project/示例项目/Assets/剧情脚本/存档数据读写/脚本数据传递2.lua.meta
@@ -0,0 +1 @@
+[VGASSET];4455776632857604561;GalGameStoryScript
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/读取剧情选择结果.lua b/Project/示例项目/Assets/剧情脚本/存档数据读写/读取剧情选择结果.lua
@@ -0,0 +1,11 @@
+local 梦旅 = VG:创建人物('梦旅')
+
+return function()
+    梦旅:说('这是一个Galgame游戏脚本初始化模版')
+    梦旅:说('你可以在这里添加剧情内容1')
+	VG:剧情选择('分支1',{'选择1','选择2'})
+	
+	-- 通过 VG.存档数据.  + 剧情选择这个命名空间 + 剧情选择名称  可以跨脚本读取剧情选择结果 
+     梦旅:说(VG.存档数据.剧情选择.分支1)
+    return
+end
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/读取剧情选择结果.lua.meta b/Project/示例项目/Assets/剧情脚本/存档数据读写/读取剧情选择结果.lua.meta
@@ -0,0 +1 @@
+[VGASSET];10527504955218957230;GalGameStoryScript
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/读取文本输入结果.lua b/Project/示例项目/Assets/剧情脚本/存档数据读写/读取文本输入结果.lua
@@ -0,0 +1,9 @@
+local 梦旅 = VG:创建人物('梦旅')
+
+return function()
+    梦旅:说('这是一个Galgame游戏脚本初始化模版')
+    梦旅:说('你可以在这里添加剧情内容')
+	VG:文本输入('输入1',"输入标题",'按钮文本')
+    梦旅:说('你输入的内容是：' .. VG.存档数据.文本输入.输入1)
+    return
+end
diff --git a/Project/示例项目/Assets/剧情脚本/存档数据读写/读取文本输入结果.lua.meta b/Project/示例项目/Assets/剧情脚本/存档数据读写/读取文本输入结果.lua.meta
@@ -0,0 +1 @@
+[VGASSET];14270045416834375330;GalGameStoryScript
diff --git a/Project/示例项目/Assets/剧情脚本/获取文本输入.lua b/Project/示例项目/Assets/剧情脚本/获取文本输入.lua
@@ -3,7 +3,7 @@ local 梦旅 = VG:创建人物('梦旅')
 return function()
     梦旅:说('这是一个Galgame游戏脚本初始化模版')
     梦旅:说('你可以在这里添加剧情内容')
-	输入文本 = VG:获取输入('输入1',"输入标题",'按钮文本')
+	输入文本 = VG:文本输入('输入1',"输入标题",'按钮文本')
     梦旅:说('你输入的内容是：' .. 输入文本)
     return
 end
diff --git a/Project/示例项目/Assets/剧情脚本/获取文本输入.lua.meta b/Project/示例项目/Assets/剧情脚本/获取文本输入.lua.meta
diff --git a/Project/示例项目/Assets/游戏场景.vgasset.meta b/Project/示例项目/Assets/游戏场景.vgasset.meta
@@ -1 +1 @@
-[VGASSET];10709757597985062753;Scene
+[VGASSET];16305749895052941406;Scene
diff --git a/Project/示例项目/Intermediate/runtimeScene.vgasset b/Project/示例项目/Intermediate/runtimeScene.vgasset
@@ -5,96 +5,40 @@
     "VGSCENE_Loader": "DEFAULT;",
     "SegmentNumber": 9,
     "SegmentType": "Script",
-    "ComponentNumber": 1,
-    "Script": {
-        "EntityComponentID": 248188668410156750,
-        "ScriptsData": [
-            {
-                "Type": "LuaScript",
-                "Path": "/assets/启动场景\\启动脚本.lua",
-                "VariableSize": 2,
-                "Variables": [
-                    {
-                        "key": "mGameSprite",
-                        "value": {
-                            "NativeType": 3,
-                            "VariableType": "GameActor",
-                            "VariableName": "mGameSprite",
-                            "Changed": true,
-                            "ValueEntityID": 15724790527033106358,
-                            "ValuePath": "",
-                            "ValueString": "",
-                            "ValueBoolean": true,
-                            "ValueDouble": 0.0
-                        }
-                    },
-                    {
-                        "key": "mLevel",
-                        "value": {
-                            "NativeType": 3,
-                            "VariableType": "Number",
-                            "VariableName": "mLevel",
-                            "Changed": true,
-                            "ValueEntityID": 14757395258967641292,
-                            "ValuePath": "",
-                            "ValueString": "",
-                            "ValueBoolean": true,
-                            "ValueDouble": 0.0
-                        }
-                    }
-                ]
-            }
-        ]
-    },
+    "ComponentNumber": 0,
     "SegmentType": "Entity",
-    "EntityNumber": 5,
-    "Label": "音频源",
-    "ID": 17932482929868524060,
+    "EntityNumber": 4,
+    "Label": "UI文档",
+    "ID": 1121397486019454353,
     "Parent": 0,
     "ComponentIDs": [
-        17932482929868524060,
-        15511477778250133715
+        1121397486019454353,
+        669284186378080398
     ],
-    "Label": "游戏图片",
-    "ID": 15724790527033106358,
+    "Label": "GalGame引擎",
+    "ID": 13669168056528829473,
     "Parent": 0,
     "ComponentIDs": [
-        15724790527033106358,
-        15226218329313936485
+        13669168056528829473,
+        5300828898657221247
     ],
     "Label": "相机",
-    "ID": 13926317088765942365,
-    "Parent": 0,
-    "ComponentIDs": [
-        13926317088765942365,
-        12449631379230503017
-    ],
-    "Label": "引擎图片",
-    "ID": 12449631379230503017,
+    "ID": 3461299980892358326,
     "Parent": 0,
     "ComponentIDs": [
-        13637038770057834674,
-        11877835154696708148,
-        248188668410156750
+        16414287039044744827,
+        6160332589096119729
     ],
     "Label": "Scene",
     "ID": 0,
     "Parent": 0,
     "ComponentIDs": [],
     "SegmentType": "AudioSourceComponent",
-    "ComponentNumber": 1,
-    "AudioSourceComponent": {
-        "EntityComponentID": 15511477778250133715,
-        "HasAudio": true,
-        "m_AudioPath": "/assets/启动场景\\VisionGal.mp3",
-        "playOnAwake": true,
-        "loop": false,
-        "volume": 1.0
-    },
+    "ComponentNumber": 0,
     "SegmentType": "Transform",
-    "ComponentNumber": 4,
+    "ComponentNumber": 3,
     "Transform": {
-        "EntityComponentID": 17932482929868524060,
+        "EntityComponentID": 1121397486019454353,
         "location": {
             "x": 0.0,
             "y": 0.0,
@@ -114,27 +58,7 @@
         "visible": true
     },
     "Transform": {
-        "EntityComponentID": 15724790527033106358,
-        "location": {
-            "x": 0.0,
-            "y": 0.0,
-            "z": 0.0
-        },
-        "rotation": {
-            "x": 0.0,
-            "y": 0.0,
-            "z": 0.0,
-            "w": 1.0
-        },
-        "scale": {
-            "x": 1.0,
-            "y": 1.0,
-            "z": 1.0
-        },
-        "visible": false
-    },
-    "Transform": {
-        "EntityComponentID": 13926317088765942365,
+        "EntityComponentID": 13669168056528829473,
         "location": {
             "x": 0.0,
             "y": 0.0,
@@ -154,7 +78,7 @@
         "visible": true
     },
     "Transform": {
-        "EntityComponentID": 13637038770057834674,
+        "EntityComponentID": 16414287039044744827,
         "location": {
             "x": 0.0,
             "y": 0.0,
@@ -174,64 +98,30 @@
         "visible": true
     },
     "SegmentType": "SpriteRenderer",
-    "ComponentNumber": 2,
-    "SpriteRenderer": {
-        "EntityComponentID": 15226218329313936485,
-        "HasSprite": true,
-        "m_SpriteSize": {
-            "x": 1921.0,
-            "y": 1080.0
-        },
-        "m_SpritePosition": {
-            "x": 0.0,
-            "y": 0.0
-        },
-        "m_SpriteTexturePath": "/assets/UI\\主菜单\\主菜单背景.png",
-        "Color": {
-            "x": 1.0,
-            "y": 1.0,
-            "z": 1.0,
-            "w": 1.0
-        },
-        "Flip": {
-            "x": 0,
-            "y": 0
-        }
-    },
-    "SpriteRenderer": {
-        "EntityComponentID": 11877835154696708148,
-        "HasSprite": true,
-        "m_SpriteSize": {
-            "x": 1920.0,
-            "y": 1081.0
-        },
-        "m_SpritePosition": {
-            "x": 0.0,
-            "y": 0.0
-        },
-        "m_SpriteTexturePath": "/assets/启动场景\\引擎.png",
-        "Color": {
-            "x": 1.0,
-            "y": 1.0,
-            "z": 1.0,
-            "w": 1.0
-        },
-        "Flip": {
-            "x": 0,
-            "y": 0
-        }
-    },
-    "SegmentType": "RmlUIDocumentComponent",
     "ComponentNumber": 0,
+    "SegmentType": "RmlUIDocumentComponent",
+    "ComponentNumber": 1,
+    "RmlUIDocumentComponent": {
+        "EntityComponentID": 669284186378080398,
+        "HasDocument": true,
+        "m_DocumentPath": "/assets/UI\\游戏\\游戏自定义对话效果.html"
+    },
     "SegmentType": "Camera",
     "ComponentNumber": 1,
     "Camera": {
-        "EntityComponentID": 12449631379230503017,
+        "EntityComponentID": 6160332589096119729,
         "HasCamera": true,
         "m_CameraType": "Letterbox2D"
     },
     "SegmentType": "VideoPlayer",
     "ComponentNumber": 0,
     "SegmentType": "GalGameEngine",
-    "ComponentNumber": 0
+    "ComponentNumber": 1,
+    "GalGameEngine": {
+        "EntityComponentID": 5300828898657221247,
+        "m_ScriptPath": "/assets/剧情脚本\\剧情选择.lua",
+        "m_ChoiceUIPath": "/assets/UI\\游戏\\剧情选择.html",
+        "m_FullScreenTextUIPath": "/assets/UI\\游戏\\全屏文字.html",
+        "m_InputUIPath": "/assets/UI\\游戏\\获取输入.html"
+    }
 }
diff --git a/Project/示例项目/Intermediate/runtimeScene.vgasset.meta b/Project/示例项目/Intermediate/runtimeScene.vgasset.meta
@@ -1 +1 @@
-[VGASSET];12964446344817051398;Scene
+[VGASSET];10173852795683378788;Scene
diff --git a/README.md b/README.md
@@ -11,6 +11,9 @@ VisionGal 是一个功能强大的视觉小说引擎，专为创建高质量视
 - 支持跨平台，目前已经在Windows上测试通过，Macos和Linux上的测试正在进行中
 - 完全开源的MIT协议，开发的游戏版权属于个人所有，你也可以修改引擎源代码，完全不受限制
 
+## 直接下载
+请访问 [Releases 页面](https://github.com/DarlingZeroX/VisionGal/releases) 下载最新的预编译版本。
+
 ## 构建与安装
 VisionGal 引擎使用 [CMake](https://cmake.org/)构建，库依赖使用 vcpkg 管理
 
diff --git a/Resource/Editor/localization/ZH_CN.txt b/Resource/Editor/localization/ZH_CN.txt
@@ -190,6 +190,9 @@ Reload=重新加载
 
 Story Script=剧情脚本
 Reload Story Script=重新加载剧情脚本
+Choice UI=剧情选择UI
+Full screen text UI=全屏文字UI
+Input UI=玩家输入UI
 
 The texture is loaded successfully: %s [Width: %d  Height: %d]=成功加载纹理：%s [宽度：%d 高度：%d]
 The texture failed to load: %s=纹理加载失败：%s
diff --git a/Runtime/VGEngine/Include/Galgame/Core/ArchiveDataContainer.h b/Runtime/VGEngine/Include/Galgame/Core/ArchiveDataContainer.h
@@ -19,5 +19,10 @@ namespace VisionGal::GalGame
 	public:
 		ArchiveDataContainer() = default;
 		~ArchiveDataContainer() = default;
+
+		VGDataNamespace* GetChoicesNamespace();
+		VGDataNamespace* GetInputNamespace();
+
+		static void InitializeLuaBinding(sol::table& L);
 	};
 }
diff --git a/Runtime/VGEngine/Include/Galgame/GalGameEngine.h b/Runtime/VGEngine/Include/Galgame/GalGameEngine.h
@@ -76,6 +76,9 @@ namespace VisionGal::GalGame
 
 		// 场景图像捕获接口
 		void CaptureSceneImage();
+
+		// 引擎上下文获取接口
+		ArchiveDataContainer* GetArchiveDataContainer() const;
 	private:
 		void CreateSubsystem(IGameEngineContext* context, Rml::Context* uiContext);		/// 创建引擎的核心子系统。
 		void OnMainSceneChanged(const EngineEvent& evt);			/// 处理主场景更改事件的回调函数。
diff --git a/Runtime/VGEngine/Source/Galgame/Core/ArchiveDataContainer.cpp b/Runtime/VGEngine/Source/Galgame/Core/ArchiveDataContainer.cpp
diff --git a/Runtime/VGEngine/Source/Galgame/GalGameEngine.cpp b/Runtime/VGEngine/Source/Galgame/GalGameEngine.cpp
diff --git a/Runtime/VGEngine/Source/Galgame/Lua/GameLua.cpp b/Runtime/VGEngine/Source/Galgame/Lua/GameLua.cpp
diff --git a/Runtime/VGEngine/Source/Galgame/ScriptSystem/StoryScriptSystem.cpp b/Runtime/VGEngine/Source/Galgame/ScriptSystem/StoryScriptSystem.cpp

Original file line number	Diff line number	Diff line change
`@@ -131,7 +131,7 @@ namespace VisionGal::Editor`
`131`	`131`
`132`	`132`	`bool BuildSettingsPanel::BuildOutputDirectoryUI()`
`133`	`133`	`{`
`134`		`- ImVec4 invalidTextColor = ImVec4(0.7f, 0.7f, 0.7f, 1.0f);`
	`134`	`+ ImVec4 invalidTextColor = ImVec4(1.0f, 0.1f, 0.1f, 1.0f);`
`135`	`135`
`136`	`136`	`// 生成目录`
`137`	`137`	`ImGui::Text(EditorText{ "Build output directory" }.c_str());`
`@@ -180,7 +180,7 @@ namespace VisionGal::Editor`
`180`	`180`
`181`	`181`	`// 构建平台`
`182`	`182`	`ImGui::Text(EditorText{ "Target Platform" }.c_str());`
`183`		`- if (ImGui::BeginCombo("##Editor Theme", "Windows", ImGuiComboFlags_PopupAlignLeft))`
	`183`	`+ if (ImGui::BeginCombo("##Target Platform", "Windows", ImGuiComboFlags_PopupAlignLeft))`
`184`	`184`	`{`
`185`	`185`	`for (int i = 0; i < m_TargetPlatforms.size(); i++)`
`186`	`186`	`{`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+[VGASSET];944921556481458559;GalGameStoryScript`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+[VGASSET];4455776632857604561;GalGameStoryScript`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+[VGASSET];10527504955218957230;GalGameStoryScript`
Original file line number	Diff line number	Diff line change
`@@ -0,0 +1 @@`
	`1`	`+[VGASSET];14270045416834375330;GalGameStoryScript`