ภาพรวม LCGUdonSharp
เวอร์ชันเอกสาร: 0.3.12 · บันทึกประจำรุ่น
LCGUdonSharp (com.logiccuteguy.lcgudonsharp) คือคอมไพเลอร์ UdonSharp สำหรับ VRChat ที่รองรับ C# interface, async/await ตอน build, try/catch/finally แบบ synchronous, C# collection และ JSON, ความสามารถภาษาเพิ่มเติม และระบบ packet network แบบกำหนดเอง ไฟล์ที่แก้ไขทั้งหมดอยู่ใน Packages/com.logiccuteguy.lcgudonsharp โดยไม่แก้ Worlds SDK หรือ Assets
สถานะ
Interface, synchronous exception, async lowering และความสามารถภาษาเพิ่มเติมพร้อมสำหรับทดสอบใน world ส่วน
[LCGPacket]/LCGNetworkZoneยังเป็นฟีเจอร์ทดลองและ protocol อาจเปลี่ยนระหว่างเวอร์ชัน
สิ่งใหม่ใน 0.3.12
- ปรับ dependency ของ Worlds SDK จาก
3.10.5แบบตายตัวเป็น3.x.x(>=3.10.5) payload ของคอมไพเลอร์ยัง build จาก SDK 3.10.5
สิ่งใหม่ใน 0.3.11
LCGUdonSharp 0.3.11 เตือนแทนการบล็อกเมื่อ VRChat Worlds SDK ที่ติดตั้งอยู่ไม่ตรงกับเวอร์ชันที่รองรับ 3.10.5: payload (build จาก SDK 3.10.5) ยังติดตั้งตามเดิม พร้อมแจ้งว่า Tools > LCGUdonSharp > Restore ย้อนกลับไปยัง UdonSharp ต้นฉบับที่สำรองไว้ นอกจากนี้ยังประกาศตัวอย่าง LCGUdonSharp Examples ใน package.json ทำให้ Package Manager แสดงรายการ ให้นำเข้าหลังติดตั้งคอมไพเลอร์อัตโนมัติเสร็จ
สิ่งใหม่ใน 0.3.10
LCGUdonSharp 0.3.10 ติดตั้ง dependency แบบ embedded SBP compatibility 1.21.26 ผ่าน VPM ก่อน Unity compile เพื่อกัน VRChat SDK ExtensionMethods ชนทั้งตอนติดตั้งใหม่และอัปเกรด ใช้ฐาน Unity SBP 1.21.25 โดยรักษา source/GUID และ Unity Companion License และยังอยู่หลังสร้าง Library ใหม่ Unity Localization 1.4.5 ยังรองรับ ดูการติดตั้ง การติดตั้งเองต้องใช้ release ZIP ทั้งสองไฟล์
สิ่งใหม่ใน 0.3.9
LCGUdonSharp 0.3.9 เพิ่ม Localization ของข้อความและ asset: bake Unity String/Asset Tables เป็น Udon, เลือกภาษาแบบ local พร้อม fallback, dropdown/callback, Smart Strings ที่ตรวจ syntax และสลับ sprite/texture/เสียง/prefab เพิ่มตัวอย่าง EN/TH/JA, เครื่องมือ JSON เดิม, dependency Unity Localization 1.4.5 และ Scriptable Build Pipeline 1.21.25 พร้อมแก้ compatibility ตอน build และ compiler worker thread ต้อง build world ใหม่หลังแก้ table หรืออัปเดต
สิ่งใหม่ใน 0.3.8
LCGUdonSharp 0.3.8 เพิ่ม snapshot ข้อมูล ScriptableObject แบบซ้อนและ polymorphic พร้อม type test และ checked cast, ตรวจ cycle/ความลึก และตัวอย่างอุปกรณ์แบบ local ต้อง build Udon program ทั้งหมดและ bake ข้อมูล scene/prefab ใหม่หลังอัปเดต เพราะ snapshot ใช้ layout ใหม่ที่มี runtime type tag
สิ่งใหม่ใน 0.3.7
รองรับ asset ScriptableObject ที่สร้างเองเป็น snapshot ข้อมูลแบบอ่านอย่างเดียวใน Udon อ่าน serialized field ตามชนิดข้อมูล, field ที่สืบทอด และ array ของ asset ได้ การอ่าน array จะคืนสำเนาเพื่อป้องกันการแก้ข้อมูลต้นฉบับ การอ่าน heap กลับยังรักษา asset ที่กำหนดใน Inspector และชนิด native ของ SDK ทำงานตามเดิม
ดูชนิดข้อมูลที่รองรับ ข้อจำกัด และตัวอย่างร้านค้าแบบ local ใน ข้อมูล ScriptableObject นำเข้าตัวอย่างเสริมหลัง setup คอมไพเลอร์เสร็จ และ build world ใหม่เมื่อแก้ข้อมูลหรือ schema ของ asset
สิ่งใหม่ใน 0.3.6
- Object motion ใช้ bounded queue ที่เก็บ state ล่าสุดแยกตาม recipient พร้อม batch delivery, congestion backoff, remote interpolation และ bounded prediction
- ตอนเข้า zone และ
OnPlayerRestoredระบบกู้ scene field/object snapshot ด้วย retry ที่จำกัดและหยุดเมื่อ player ออก - การกู้ ownership หลัง disconnect จะรักษา ownership ของ member ที่ยังถูกต้องและซ่อมการโอนผ่าน ownership callback โดยจับคู่ผู้เล่นที่ออกด้วย identity ก่อน ID ที่อาจซ้ำหรือไม่ valid
- Packet receiver bind กลับจาก serialized compiled program ได้เมื่อ domain reload ล้าง source program cache
- เพิ่มตัวอย่าง native/LCG lamp, moving cube, high-bandwidth แบบ opt-in, prefab ที่ต่อครบ และคู่มือตั้งค่าภาษาไทย
หลังอัปเดตให้ compile UdonSharp program ทั้งหมดและ build world ใหม่ เพราะ build รุ่นเก่า decode motion batch envelope ของ 0.3.6 ไม่ได้
ความสามารถหลัก
| ความสามารถ | รายละเอียด |
|---|---|
| C# Interface | Method, parameter, return value, property, หลาย implementation และ interface array |
| Async/Await | แปลง Task.Yield(), Task.Delay(int) และ VRChat SDK await ตอน build |
| Synchronous Exception | try/catch/finally, throw, rethrow และ guard สำหรับ null, index และหารด้วยศูนย์ |
| Extended Language | ref/out, closed generic, LINQ closure, dynamic, Span<T> บน array |
| Collection และ JSON | แปลง List<T> / Dictionary<TKey,TValue> เป็น VRChat data container พร้อม API แบบ System.Text.Json |
| Manual Packet Network | Frame มีเวอร์ชัน, ตรวจ authority, ป้องกัน replay, รวมการส่ง และส่งถึง player ที่ระบุ |
| Network Zone | LCGNetworkZone จำกัด packet และ ownership ตาม trigger volume รองรับ Continuous behaviour ที่ไม่มี synced field และมี native sync passthrough แบบ instance-wide ให้เปิดใช้อย่างชัดเจน |
| การติดตั้งแบบสะอาด | Setup อัตโนมัติที่ทำซ้ำได้ พร้อม backup/restore โดยไม่แก้ SDK |
คำสำคัญ
- Program asset (
UdonSharpProgramAsset):.assetที่จับคู่กับ U# script หนึ่งไฟล์ โดยอยู่โฟลเดอร์เดียวกันและใช้ชื่อฐานเดียวกัน - U# assembly definition (
UdonSharpAssemblyDefinition): asset อีกชนิดที่ลงทะเบียน.asmdefให้ UdonSharp compile - Assembly scanning:
Assembly-CSharpถูกสแกนเสมอ assembly อื่นต้องมี U# assembly definition - Extern: Unity/SDK method ที่ตรงกับ Udon node ในตัว ข้อผิดพลาดภายใน extern ไม่สามารถจับด้วย
try/catch
วิธีทำงาน
Bootstrap installer ตรวจ Worlds SDK 3.10.5, สำรอง UdonSharp ที่มากับ SDK ไว้ใน Library/LogicCuteGuy.LCGUdonSharp/Backups และเปิดใช้คอมไพเลอร์ของแพ็กเกจ สถานะถูกเก็บใน ProjectSettings/LogicCuteGuy.LCGUdonSharp.json
คอมไพเลอร์แปลง interface call, async continuation, exception control flow, collection/JSON, C# เพิ่มเติม และ [LCGPacket] เป็นคำสั่งที่ Udon ใช้งานได้
คู่มือ
- การติดตั้งและตั้งค่า
- C# Interface
- Async / Await
- Synchronous Exception
- ความสามารถภาษาเพิ่มเติม
- Collection, JSON, Byte และ Bit
- Manual Packet Network
- ตัวอย่าง
- การแก้ปัญหา
MIT © 2026 LogicCuteGuy