feat: 项目初始化 + 3D方块世界原型 + AI助搭系统

初始化 monorepo: Go后端(7微服务) + Unity客户端(9模块) + 启动器 HTML5原型: Three.js 3D体素世界, Perlin噪声地形, 原版材质, 22种方块 Minecraft创造模式背包: 双栏布局, 拖拽移动物品, 方向性元件引脚 AI助搭策划文档 + 客户端/服务端骨架 + Docker Compose + CI
2026-08-08 14:07:56 +08:00
parent 9500c4c80a
commit f70b061d1a
1972 changed files with 159760 additions and 6 deletions
@@ -0,0 +1,58 @@
+using System;
+
+namespace PCL.Core.App.Essentials;
+
+public class RpcPropertyOperationFailedException : Exception;
+
+/// <summary>
+/// RPC 属性<br/>
+/// 大多数时候只需要使用构造方法，其他结构保留供内部使用
+/// </summary>
+public class RpcProperty
+{
+    public delegate void GetValueDelegate(out string? outValue);
+
+    public event GetValueDelegate GetValue;
+
+    public delegate void SetValueDelegate(string? value, ref bool success);
+
+    public event SetValueDelegate? SetValue;
+
+    public readonly string Name;
+    public readonly bool Settable = true;
+
+    public string? Value
+    {
+        get
+        {
+            GetValue.Invoke(out var value);
+            return value;
+        }
+        set
+        {
+            var success = true;
+            SetValue?.Invoke(value, ref success);
+            if (!success)
+                throw new RpcPropertyOperationFailedException();
+        }
+    }
+
+    /// <param name="name">属性名称</param>
+    /// <param name="onGetValue">默认的 <c>GetValue</c> 回调</param>
+    /// <param name="onSetValue">默认的 <c>SetValue</c> 回调</param>
+    /// <param name="settable">指定该属性是否可更改，若该值为 <c>false</c> 的同时 <paramref name="onSetValue"/> 为 <c>null</c>，则该属性成为只读属性</param>
+    public RpcProperty(string name, Func<string?> onGetValue, Action<string?>? onSetValue = null, bool settable = false)
+    {
+        Name = name;
+        GetValue += (out outValue) => { outValue = onGetValue(); };
+        if (onSetValue is not null)
+        {
+            SetValue += (value, ref _) => { onSetValue(value); };
+        }
+        else if (!settable)
+        {
+            Settable = false;
+            SetValue += (_, ref success) => { success = false; };
+        }
+    }
+}