{"id":21358833,"url":"https://github.com/gameframex/com.gameframex.unity","last_synced_at":"2026-05-28T07:03:30.827Z","repository":{"id":240846814,"uuid":"803194407","full_name":"GameFrameX/com.gameframex.unity","owner":"GameFrameX","description":"GameFrameX是一款全面的集成式游戏开发框架，提供了从前端到后端的完整解决方案。该框架支持包括Unity、Cocos Creator、LayaBox、和Godot等多种主流游戏开发平台，确保开发者能够为不同的目标平台打造精美的游戏体验。","archived":false,"fork":false,"pushed_at":"2025-12-16T11:14:39.000Z","size":1574,"stargazers_count":10,"open_issues_count":0,"forks_count":8,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-12-20T00:46:35.885Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gameframex.doc.alianblank.com","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GameFrameX.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2024-05-20T08:55:26.000Z","updated_at":"2025-12-16T11:14:43.000Z","dependencies_parsed_at":"2024-07-06T06:38:40.816Z","dependency_job_id":"7d22263d-f228-4147-828c-6eb26ae78bcd","html_url":"https://github.com/GameFrameX/com.gameframex.unity","commit_stats":null,"previous_names":["alianblank/com.alianblank.gameframex.unity","gameframex/com.gameframex.unity"],"tags_count":26,"template":false,"template_full_name":null,"purl":"pkg:github/GameFrameX/com.gameframex.unity","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GameFrameX%2Fcom.gameframex.unity","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GameFrameX%2Fcom.gameframex.unity/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GameFrameX%2Fcom.gameframex.unity/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GameFrameX%2Fcom.gameframex.unity/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GameFrameX","download_url":"https://codeload.github.com/GameFrameX/com.gameframex.unity/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GameFrameX%2Fcom.gameframex.unity/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30071670,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T03:25:38.285Z","status":"ssl_error","status_checked_at":"2026-03-04T03:25:05.086Z","response_time":59,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-22T05:22:34.463Z","updated_at":"2026-05-28T07:03:30.818Z","avatar_url":"https://github.com/GameFrameX.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n![GameFrameX Logo](https://download.alianblank.com/gameframex/gameframex_logo_320.png)\n\n# GameFrameX Unity Package\n\n[![Version](https://img.shields.io/github/v/release/GameFrameX/com.gameframex.unity)](https://github.com/GameFrameX/com.gameframex.unity)\n[![Unity](https://img.shields.io/badge/Unity-2019.4+-green.svg)](https://unity3d.com/get-unity/download)\n[![License](https://img.shields.io/badge/license-MIT+Apache%202.0-orange.svg)](LICENSE.md)\n[![Documentation](https://img.shields.io/badge/docs-gameframex.doc.alianblank.com-brightgreen.svg)](https://gameframex.doc.alianblank.com)\n\n**All-in-One Solution for Indie Game Development · Empowering Indie Developers' Dreams**\n\n[📖 Documentation](https://gameframex.doc.alianblank.com) • [🚀 Quick Start](#quick-start) • [💬 QQ Group: 467608841](https://qm.qq.com/cgi-bin/qm/qr?k=sYFd1nv6m2KZIWFLorZ5pBR0AE5ZhbuL\u0026jump_from=webapi\u0026authKey=oCu+uoL3n35fT5SEt7iLgGtROPxh31n/rHUxRlp0w1f+j38W4tKBuWyRH3KEdwHN)\n\n---\n\n🌐 **Language**: **English** | [繁體中文](./README.zh-TW.md) | [简体中文](./README.zh-CN.md) | [日本語](./README.ja.md) | [한국어](./README.ko.md)\n\n---\n\n\u003c/div\u003e\n\n## 📑 Table of Contents\n\n- [🏗️ Project Overview](#🏗️-project-overview)\n- [📂 Architecture](#📂-architecture)\n  - [Runtime Module](#-runtime-module)\n  - [Plugins Module](#-plugins-module)\n  - [Editor Module](#-editor-module)\n- [🚀 Quick Start](#🚀-quick-start)\n- [💡 Usage Examples](#💡-usage-examples)\n  - [Runtime Examples](#runtime-usage-examples)\n  - [Editor Tools](#editor-tools)\n- [🎯 Platform Support](#🎯-platform-support)\n- [📚 Documentation \u0026 Resources](#📚-documentation--resources)\n- [🤝 Community \u0026 Support](#🤝-community--support)\n- [📄 License](#📄-license)\n\n---\n\n## 🏗️ Project Overview\n\nGameFrameX is a modern Unity game framework designed for independent game developers, providing a complete end-to-end solution for game development. The framework follows a **three-layer modular architecture** design with rich built-in game development tools and components, helping developers quickly build high-quality game projects.\n\n### 🎯 Key Features\n\n- 🏗️ **Three-Layer Architecture** - Clear separation: Runtime, Plugins, and Editor\n- 🔧 **Rich Toolset** - Built-in development aids and editor extensions\n- 📦 **Object Pool Management** - Efficient memory management and object reuse\n- 🎨 **Extension Methods Library** - Extensive Unity engine extensions\n- 🛠️ **Utility Classes** - Encryption, compression, networking, and more\n- 📱 **Multi-Platform Support** - PC, Mobile, WebGL and more\n- 🔥 **Hotfix Support** - Built-in HybridCLR hotfix solution\n- 🎮 **Mini Game Adaptation** - One-click switch between multiple mini game platforms\n\n### 📋 System Requirements\n\n- **Unity Version**: 2019.4 or higher\n- **Platform Support**: Windows, macOS, Linux, iOS, Android, WebGL\n- **.NET Version**: .NET Standard 2.0+\n\n---\n\n## 📂 Architecture\n\nGameFrameX uses a clear three-layer architecture design, with each module having its own responsibilities and working together.\n\n### 📦 Runtime Module\n\nCore runtime code providing all functionality needed for game runtime.\n\n```\nRuntime/\n├── Base/                          # Framework Core Foundation\n│   ├── DataStruct/               # Data Structures\n│   │   └── TypeNamePair.cs       # Type Name Pair\n│   ├── EventPool/                # Event Pool System\n│   │   ├── BaseEventArgs.cs      # Base Event Args\n│   │   ├── EventPool.EventNode.cs # Event Node\n│   │   ├── EventPool.cs          # Event Pool Core\n│   │   └── EventPoolMode.cs      # Event Pool Mode\n│   ├── Log/                      # Logging System\n│   │   ├── GameFrameworkLog.ILogHelper.cs # Log Interface\n│   │   ├── GameFrameworkLog.cs   # Log Core\n│   │   └── GameFrameworkLogLevel.cs # Log Level\n│   ├── ReferencePool/            # Reference Pool System\n│   │   ├── IReference.cs        # Reference Interface\n│   │   ├── ReferencePool.ReferenceCollection.cs # Reference Collection\n│   │   ├── ReferencePool.cs      # Reference Pool Core\n│   │   └── ReferencePoolInfo.cs   # Reference Pool Info\n│   ├── TaskPool/                 # Task Pool System\n│   │   ├── ITaskAgent.cs        # Task Agent Interface\n│   │   ├── StartTaskStatus.cs    # Task Status\n│   │   ├── TaskBase.cs          # Task Base\n│   │   ├── TaskInfo.cs          # Task Info\n│   │   ├── TaskPool.cs          # Task Pool Core\n│   │   └── TaskStatus.cs        # Task Status\n│   ├── Variable/                 # Variable System\n│   │   ├── GenericVariable.cs    # Generic Variable\n│   │   └── Variable.cs          # Variable Base\n│   ├── Version/                  # Version Management\n│   │   ├── Version.IVersionHelper.cs # Version Interface\n│   │   └── Version.cs           # Version Core\n│   ├── BaseComponent.cs          # Base Component\n│   ├── GameEntry.cs             # Game Entry\n│   ├── GameFrameworkComponent.cs # Framework Component\n│   ├── GameFrameworkEntry.cs    # Framework Entry\n│   ├── GameFrameworkEventArgs.cs # Framework Event Args\n│   ├── GameFrameworkException.cs # Framework Exception\n│   ├── GameFrameworkGuard.cs    # Framework Guard\n│   ├── GameFrameworkLinkedList.cs # Linked List\n│   ├── GameFrameworkLinkedListRange.cs # Linked List Range\n│   ├── GameFrameworkModule.cs   # Framework Module\n│   ├── GameFrameworkMonoSingleton.cs # Mono Singleton\n│   ├── GameFrameworkMultiDictionary.cs # Multi-Value Dictionary\n│   ├── GameFrameworkSerializer.cs # Serializer\n│   ├── GameFrameworkSingleton.cs # Singleton Base\n│   ├── ObjectDontDestroyOnLoad.cs # Scene Persistent Object\n│   └── ShutdownType.cs           # Shutdown Type\n├── Extension/                     # Extension Methods Library\n│   ├── Extension/                # Common Extensions\n│   │   ├── BidirectionalDictionary.cs # Bidirectional Dictionary\n│   │   ├── BinaryExtension.cs      # Binary Extension\n│   │   ├── BufferExtension.cs      # Buffer Extension\n│   │   ├── CollectionExtensions.cs # Collection Extensions\n│   │   ├── DateTimeExtensions.cs   # DateTime Extension\n│   │   ├── ObjectExtension.cs      # Object Extension\n│   │   ├── SpanExtension.cs        # Span Extension\n│   │   ├── StringExtensions.cs     # String Extensions\n│   │   ├── ThreadLocalRandom.cs    # Thread Local Random\n│   │   └── TypeExtensions.cs       # Type Extensions\n│   ├── SequenceReader/            # Sequence Reader\n│   │   ├── SequenceReader.cs       # Sequence Reader Core\n│   │   └── SequenceReaderExtensions.cs # Sequence Reader Extensions\n│   ├── UnityEngine.GameObject/    # GameObject Extension\n│   │   └── UnityEngine.GameObjectExtension.cs # GameObject Extension\n│   └── UnityEngine/               # Unity Type Extensions\n│       ├── Transform/             # Transform Extension\n│       ├── Vector2/               # Vector2 Extension\n│       ├── Vector3/               # Vector3 Extension\n│       └── Vector4/               # Vector4 Extension\n├── Helper/                        # Helper Classes\n│   ├── ApplicationHelper.cs      # Application Helper\n│   ├── CameraHelper.cs          # Camera Helper\n│   ├── DefaultCompressionHelper.cs # Default Compression Helper\n│   ├── DefaultLogHelper.cs       # Default Log Helper\n│   ├── DefaultTextHelper.cs      # Default Text Helper\n│   ├── DefaultVersionHelper.cs   # Default Version Helper\n│   ├── DistinctHelper.cs         # Distinct Helper\n│   ├── DoTweenHelper.cs          # DoTween Animation Helper\n│   ├── FileHelper.cs            # File Helper\n│   ├── GameObjectHelper.cs      # GameObject Helper\n│   ├── Helper.cs                # Helper Base Class\n│   ├── MathHelper.cs            # Math Helper\n│   ├── NetworkHelper.cs         # Network Helper\n│   ├── NewtonsoftJsonHelper.cs  # Newtonsoft JSON Helper\n│   ├── ObjectHelper.cs          # Object Helper\n│   ├── PathHelper.cs            # Path Helper\n│   ├── PositionHelper.cs        # Position Helper\n│   ├── RandomHelper.cs          # Random Helper\n│   ├── TimerHelper/             # Timer Helper\n│   │   ├── TimerHelper.cs       # Timer Core\n│   │   ├── TimerHelper.Current.cs # Current Time\n│   │   ├── TimerHelper.Day.cs   # Day Calculation\n│   │   ├── TimerHelper.Difference.cs # Time Difference\n│   │   ├── TimerHelper.Month.cs  # Month Calculation\n│   │   ├── TimerHelper.Range.cs  # Time Range\n│   │   ├── TimerHelper.TimeOffset.cs # Time Offset\n│   │   ├── TimerHelper.Timestamp.cs # Timestamp\n│   │   ├── TimerHelper.Week.cs   # Week Calculation\n│   │   └── TimerHelper.Year.cs   # Year Calculation\n│   ├── UnityRendererHelper.cs   # Unity Renderer Helper\n│   └── ZipHelper.cs             # ZIP Compression Helper\n├── ObjectPool/                    # Object Pool System\n│   ├── IObjectPool.cs           # Object Pool Interface\n│   ├── ObjectBase.cs            # Object Pool Base\n│   └── ObjectPoolComponent.cs   # Object Pool Component\n├── Property/                      # Property System\n│   └── BindableProperty.cs      # Bindable Property\n├── ReferencePool/                # Reference Pool System\n│   └── ReferencePoolComponent.cs # Reference Pool Component\n└── Utility/                       # Utility Classes\n    ├── Log.cs                     # Log Utility\n    ├── Utility.Assembly.cs        # Assembly Utility\n    ├── Utility.Asset.Path.cs      # Asset Path Utility\n    ├── Utility.Compression/      # Compression\n    │   ├── ICompressionHelper.cs  # Compression Interface\n    │   └── Utility.Compression.cs # Compression Core\n    ├── Utility.Const/            # Constants\n    │   └── FileNameSuffix.cs      # File Name Suffix\n    ├── Utility.Converter.cs       # Type Converter\n    ├── Utility.Encryption/        # Encryption\n    │   ├── Utility.Encryption.cs  # Encryption Core\n    │   ├── Aes.cs                # AES Encryption\n    │   ├── Rsa.cs                # RSA Encryption\n    │   └── Dsa.cs                # DSA Encryption\n    ├── Utility.File.cs           # File Operations\n    ├── Utility.Hash/             # Hash Calculation\n    │   ├── HMACSha256.cs         # HMAC SHA256\n    │   ├── Md5.cs                # MD5\n    │   ├── Sha1.cs               # SHA1\n    │   ├── MurmurHash3.cs        # MurmurHash3\n    │   └── XxHash.cs             # XxHash\n    ├── Utility.IdGenerator.cs     # ID Generator\n    ├── Utility.Json/             # JSON Serialization\n    │   ├── IJsonHelper.cs        # JSON Interface\n    │   └── Utility.Json.cs       # JSON Core\n    ├── Utility.Marshal.cs         # Marshal Utility\n    ├── Utility.Net.cs            # Network Utility\n    ├── Utility.Object.cs          # Object Utility\n    ├── Utility.Path.cs           # Path Handling\n    ├── Utility.Random.cs         # Random Number\n    ├── Utility.Text/             # Text Processing\n    │   ├── ITextHelper.cs        # Text Interface\n    │   └── Utility.Text.cs       # Text Core\n    ├── Utility.Verifier/          # Verifier\n    │   ├── Verifier.cs           # Verifier Core\n    │   ├── Crc32.cs             # CRC32\n    │   └── Crc64.cs             # CRC64\n    ├── Utility.cs                # Utility Entry\n    └── XString.cs                # Efficient String\n```\n\n#### Runtime Sub-Modules\n\n| Sub-Module        | Description           | Main Features                                                                                                                                     |\n| ----------------- | --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |\n| **Base**          | Framework Core        | Component management, event pool, logging, reference pool, task pool, variable system, lifecycle management, singleton pattern                    |\n| **Extension**     | Extension Library     | Common extensions (string, collection, datetime), Unity type extensions (Transform, Vector), sequence reader, GameObject extensions               |\n| **Helper**        | Helper Classes        | Application, camera, file, path, math, random, timer, network, JSON, rendering, position and more                                                 |\n| **ObjectPool**    | Object Pool System    | Object reuse, memory optimization, performance improvement                                                                                        |\n| **Property**      | Property System       | Bindable properties, data binding, MVVM support                                                                                                   |\n| **ReferencePool** | Reference Pool System | Reference type management, GC optimization                                                                                                        |\n| **Utility**       | Utility Classes       | Encryption (AES/RSA/DSA), compression, hash (MD5/SHA1/HMAC), CRC, JSON, file operations, ID generation, type conversion, text processing, logging |\n\n### 🔌 Plugins Module\n\nNative platform plugins and third-party dependencies.\n\n```\nPlugins/\n├── iOS/                          # iOS Native Plugin\n│   └── GameFrameX/\n│       ├── GameFrameX.mm                    # Core Functionality\n│       └── GameFrameXTrackingAuthorization.mm # Permission Tracking\n├── ICSharpCode.SharpZipLib.dll   # ZIP Compression Library\n├── Microsoft.NET.StringTools.dll  # String Tools\n├── System.Buffers.dll            # Memory Buffer\n├── System.IO.Pipelines.dll       # IO Pipeline\n├── System.Memory.dll            # Memory Management\n└── System.Runtime.CompilerServices.Unsafe.dll # Runtime Support\n```\n\n#### Plugins Sub-Modules\n\n| Sub-Module              | Description                        | Dependencies                 |\n| ----------------------- | ---------------------------------- | ---------------------------- |\n| **iOS Plugin**          | iOS native functionality           | GameFrameX.mm                |\n| **Compression Library** | ZIP file compression/decompression | SharpZipLib                  |\n| **Memory Management**   | Efficient memory operations        | StringTools, Memory, Buffers |\n| **Runtime Support**     | .NET runtime extensions            | CompilerServices.Unsafe      |\n\n### 🛠️ Editor Module\n\nEditor tools and extensions for improved development efficiency.\n\n```\nEditor/\n├── BuildHotfix/                  # Hotfix Build Tools\n│   ├── BuildHotfixHelper.cs     # Build Helper\n│   ├── HotFixAssemblyDefinitionHelper.cs # Hotfix Assembly\n│   └── HotFixEditorCompilerHelper.cs # Editor Compiler\n├── BuildProduct/                 # Product Build Assistant\n│   ├── BuildProductHelper.cs    # Build Helper\n│   ├── BuildPostProcessHelper.cs # Post Build Processing\n│   ├── IBuilderPreHookHandler.cs # Pre-Build Hook\n│   └── IBuilderPostHookHandler.cs # Post-Build Hook\n├── BuildWebGLTools/             # WebGL Build Tools\n│   └── BuildWebGLToolsWithHybridCLR.cs # HybridCLR WebGL Build\n├── Cropping/                     # Image Cropping Tool\n│   └── CroppingWindow.cs        # Cropping Window\n├── Inspector/                    # Custom Inspector Panels\n│   ├── BaseComponentInspector.cs # Base Component Inspector\n│   ├── ObjectPoolComponentInspector.cs # Object Pool Inspector\n│   └── ReferencePoolComponentInspector.cs # Reference Pool Inspector\n├── InspectorLockShortcut/        # Inspector Lock\n│   └── InspectorLockShortcut.cs # Keyboard Shortcut Lock\n├── MiniGame/                      # Mini Game Platform Adaptation (21 Platforms) ⭐\n│   ├── MiniGameDefineSymbolHelper.cs # Base Define Symbol Manager\n│   ├── DomesticMiniGames/          # Domestic (China) Mini Games\n│   │   ├── MiniGameDefineSymbolHelper.WeChat.cs # WeChat\n│   │   ├── MiniGameDefineSymbolHelper.Alipay.cs # Alipay\n│   │   ├── MiniGameDefineSymbolHelper.DouYin.cs # DouYin\n│   │   ├── MiniGameDefineSymbolHelper.KuaiShou.cs # KuaiShou\n│   │   ├── MiniGameDefineSymbolHelper.Baidu.cs # Baidu\n│   │   ├── MiniGameDefineSymbolHelper.JingDong.cs # JingDong\n│   │   ├── MiniGameDefineSymbolHelper.Meituan.cs # Meituan\n│   │   ├── MiniGameDefineSymbolHelper.Taobao.cs # Taobao\n│   │   └── MiniGameDefineSymbolHelper.Bilibili.cs # Bilibili\n│   ├── InternationalMiniGames/     # International Mini Games\n│   │   ├── MiniGameDefineSymbolHelper.CrazyGames.cs # CrazyGames\n│   │   ├── MiniGameDefineSymbolHelper.Discord.cs # Discord\n│   │   ├── MiniGameDefineSymbolHelper.Facebook.cs # Facebook\n│   │   ├── MiniGameDefineSymbolHelper.GooglePlay.cs # Google Play\n│   │   ├── MiniGameDefineSymbolHelper.Poki.cs # Poki\n│   │   ├── MiniGameDefineSymbolHelper.TikTok.cs # TikTok\n│   │   └── MiniGameDefineSymbolHelper.YouTube.cs # YouTube\n│   ├── DeviceOEMs/                # Device OEM Mini Games\n│   │   ├── MiniGameDefineSymbolHelper.Huawei.cs # Huawei\n│   │   ├── MiniGameDefineSymbolHelper.OPPO.cs # OPPO\n│   │   ├── MiniGameDefineSymbolHelper.Vivo.cs # vivo\n│   │   └── MiniGameDefineSymbolHelper.Xiaomi.cs # Xiaomi\n│   └── GamePlatforms/             # Game Platform\n│       └── MiniGameDefineSymbolHelper.TapTap.cs # TapTap\n├── PackageManager/               # Package Manager Window\n│   ├── PackageManagerWindow.cs   # Package Manager Window\n│   └── PackagesManifest.cs     # Package Manifest\n├── UpdatePackages/               # Package Update Tools\n│   └── UpdateAllPackageHelper.cs # Batch Update\n├── Welcome/                      # Welcome Window\n│   └── WelcomeWindow.cs         # Welcome Interface\n└── Misc/                         # Miscellaneous Tools\n    ├── HelperInfo.cs            # Helper Info\n    ├── LogRedirection.cs        # Log Redirection\n    ├── ScriptingDefineSymbols.cs # Define Symbol Manager\n    ├── Type.cs                  # Type Utility\n    └── OpenFolder.cs            # Open Folder\n```\n\n#### Editor Sub-Modules\n\n| Sub-Module                | Description          | Main Features                                                                                                           |\n| ------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| **BuildHotfix**           | Hotfix Build         | HybridCLR hotfix assembly build and management                                                                          |\n| **BuildProduct**          | Product Build        | Build process automation, pre/post hooks                                                                                |\n| **BuildWebGLTools**       | WebGL Build          | WebGL platform specific build tools                                                                                     |\n| **Cropping**              | Image Cropping       | Visual image cropping tool                                                                                              |\n| **Inspector**             | Custom Inspectors    | Object pool, reference pool visual monitoring                                                                           |\n| **InspectorLockShortcut** | Inspector Lock       | Keyboard shortcut for locking Inspector panel                                                                           |\n| **MiniGame**              | Mini Game Adaptation | One-click switch between 21 mini game platforms (categorized into domestic, international, device OEMs, game platforms) |\n| **PackageManager**        | Package Management   | Visual package management interface                                                                                     |\n| **UpdatePackages**        | Package Update       | Batch update project dependencies                                                                                       |\n| **Welcome**               | Welcome Interface    | New user guide and quick access                                                                                         |\n| **Misc**                  | Miscellaneous        | Logging, define symbols, types and more                                                                                 |\n\n---\n\n## 🚀 Quick Start\n\n### Installation\n\n#### Method 1: Unity Package Manager (Recommended)\n\n1. Open Unity Editor\n2. Go to `Window` → `Package Manager`\n3. Click the `+` button in the top-left corner\n4. Select `Add package from git URL`\n5. Enter: `https://github.com/GameFrameX/com.gameframex.unity.git`\n\n#### Method 2: Manual Download\n\n1. Download the latest [Release](https://github.com/GameFrameX/com.gameframex.unity/releases)\n2. Extract to your project's `Packages` directory\n\n#### Method 3: Using scopedRegistries (UPM)\n\nEdit your Unity project's `Packages/manifest.json` and add the `scopedRegistries` section:\n\n```json\n{\n  \"scopedRegistries\": [\n    {\n      \"name\": \"GameFrameX\",\n      \"url\": \"https://gameframex.upm.alianblank.uk\",\n      \"scopes\": [\n        \"com.gameframex\"\n      ]\n    }\n  ],\n  \"dependencies\": {\n    \"com.gameframex.unity\": \"1.10.1\"\n  }\n}\n```\n\n`scopes` controls which packages are resolved through this registry. Only packages whose names start with `com.gameframex` will be fetched from it.\n\n### Basic Usage\n\n```csharp\nusing GameFrameX.Runtime;\n\npublic class GameManager : MonoBehaviour\n{\n    void Start()\n    {\n        // Get object pool component\n        var objectPool = GameEntry.GetComponent\u003cObjectPoolComponent\u003e();\n        \n        // Get reference pool component\n        var referencePool = GameEntry.GetComponent\u003cReferencePoolComponent\u003e();\n        \n        // Use extension methods\n        transform.SetPositionX(10f);\n        gameObject.SetActiveOptimized(true);\n    }\n}\n```\n\n---\n\n## 💡 Usage Examples\n\n### Runtime Usage Examples\n\n#### 🎯 Object Pool System\n\n```csharp\n// Get object pool component\nvar objectPool = GameEntry.GetComponent\u003cObjectPoolComponent\u003e();\n\n// Create object pool\nobjectPool.CreatePool\u003cMyObject\u003e(\"MyObjectPool\", 10, 100);\n\n// Spawn object from pool\nvar obj = objectPool.Spawn\u003cMyObject\u003e(\"MyObjectPool\");\n\n// Return object to pool\nobjectPool.Unspawn(obj);\n\n// Destroy object pool\nobjectPool.DestroyPool(\"MyObjectPool\");\n```\n\n#### 📝 Extension Methods\n\n```csharp\n// Transform extensions\ntransform.SetPositionX(10f);\ntransform.SetLocalScaleXYZ(2f, 2f, 2f);\ntransform.ResetTransformation();\n\n// Vector3 extensions\nVector3 pos = transform.position;\npos = pos.WithX(5f).WithY(10f);\n\n// GameObject extensions\ngameObject.SetActiveOptimized(true);\ngameObject.SetLayerRecursively(LayerMask.NameToLayer(\"UI\"));\n```\n\n#### 🔐 Utility Classes\n\n```csharp\n// File operations\nUtility.File.WriteAllBytes(\"path/to/file\", data);\nbyte[] content = Utility.File.ReadAllBytes(\"path/to/file\");\n\n// AES encryption/decryption\nstring encrypted = Utility.Encryption.Aes.Encrypt(\"plaintext\", \"key\");\nstring decrypted = Utility.Encryption.Aes.Decrypt(encrypted, \"key\");\n\n// Hash calculation\nstring md5 = Utility.Hash.Md5.ComputeHash(\"input\");\nstring sha1 = Utility.Hash.Sha1.ComputeHash(\"input\");\n\n// JSON serialization\nvar json = Utility.Json.ToJson(myObject);\nvar obj = Utility.Json.FromJson\u003cMyClass\u003e(json);\n```\n\n#### 📡 Event System\n\n```csharp\n// Define event args\npublic class PlayerDeadEventArgs : BaseEventArgs\n{\n    public int PlayerId { get; set; }\n    public float Damage { get; set; }\n}\n\n// Subscribe to event\nGameEntry.Event.Subscribe(PlayerDeadEventArgs.EventId, OnPlayerDead);\n\n// Fire event\nGameEntry.Event.Fire(this, PlayerDeadEventArgs.Create(playerId, damage));\n\n// Unsubscribe from event\nGameEntry.Event.Unsubscribe(PlayerDeadEventArgs.EventId, OnPlayerDead);\n```\n\n### Editor Tools\n\n#### 🎮 Mini Game Platform Adaptation\n\nQuickly switch between mini game platforms in Unity menu:\n\n```\nGameFrameX/\n├── Scripting Define Symbols/\n│   ├── Domestic Mini Games/\n│   │   ├── Enable WeChat Mini Game\n│   │   ├── Enable Alipay Mini Game\n│   │   ├── Enable DouYin Mini Game\n│   │   ├── Enable KuaiShou Mini Game\n│   │   ├── Enable Baidu Mini Game\n│   │   ├── Enable JingDong Mini Game\n│   │   ├── Enable Meituan Mini Game\n│   │   ├── Enable Taobao Mini Game\n│   │   └── Enable Bilibili Mini Game\n│   ├── International Mini Games/\n│   │   ├── Enable Discord Mini Game\n│   │   ├── Enable YouTube Mini Game\n│   │   ├── Enable Facebook Mini Game\n│   │   ├── Enable Google Play Mini Game\n│   │   ├── Enable TikTok Mini Game\n│   │   ├── Enable CrazyGames Mini Game\n│   │   └── Enable Poki Mini Game\n│   ├── Device OEMs/\n│   │   ├── Enable Huawei Mini Game\n│   │   ├── Enable OPPO Mini Game\n│   │   ├── Enable Vivo Mini Game\n│   │   └── Enable Xiaomi Mini Game\n│   └── Game Platforms/\n│       └── Enable TapTap Mini Game\n```\n\n#### 🏗️ Build Tools\n\n```\nGameFrameX/\n├── Build Hotfix\n├── Build Product\n└── Build WebGL With HybridCLR\n```\n\n#### 📦 Package Management\n\n```\nGameFrameX/\n├── Package Manager\n└── Update All Packages\n```\n\n---\n\n## 🎯 Platform Support\n\n### Operating Systems\n\n| Platform | Status      | Supported Version |\n| -------- | ----------- | ----------------- |\n| Windows  | ✅ Supported | Unity 2019.4+     |\n| macOS    | ✅ Supported | Unity 2019.4+     |\n| Linux    | ✅ Supported | Unity 2019.4+     |\n| iOS      | ✅ Supported | Unity 2019.4+     |\n| Android  | ✅ Supported | Unity 2019.4+     |\n| WebGL    | ✅ Supported | Unity 2019.4+     |\n\n### Mini Game Platform Adaptation\n\nGameFrameX provides one-click mini game platform adaptation, supporting **21 mainstream mini game platforms** worldwide:\n\n#### 🇨🇳 Domestic Mini Games (9)\n\n| Platform            | Define Symbol                                    | Region  | Menu Priority |\n| ------------------- | ------------------------------------------------ | ------- | ------------- |\n| WeChat Mini Game    | `ENABLE_WECHAT_MINI_GAME` / `WEIXINMINIGAME`     | 🇨🇳 China | 2000          |\n| Alipay Mini Game    | `ENABLE_ALIPAY_MINI_GAME` / `ALIPAYMINIGAME`     | 🇨🇳 China | 2400          |\n| DouYin Mini Game    | `ENABLE_DOUYIN_MINI_GAME` / `DOUYINMINIGAME`     | 🇨🇳 China | 2100          |\n| KuaiShou Mini Game  | `ENABLE_KUAISHOU_MINI_GAME` / `KUAISHOUMINIGAME` | 🇨🇳 China | 2200          |\n| Baidu Mini Game     | `ENABLE_BAIDU_MINI_GAME` / `BAIDUMINIGAME`       | 🇨🇳 China | 2300          |\n| JD Mini Game        | `ENABLE_JINGDONG_MINI_GAME` / `JINGDONGMINIGAME` | 🇨🇳 China | 2500          |\n| Taobao Mini Program | `ENABLE_TAOBAO_MINI_GAME` / `TAOBAOMINIGAME`     | 🇨🇳 China | 2600          |\n| Meituan Mini Game   | `ENABLE_MEITUAN_MINI_GAME` / `MEITUANMINIGAME`   | 🇨🇳 China | 2800          |\n| Bilibili Mini Game  | `ENABLE_BILIBILI_MINI_GAME` / `BILIBILIMINIGAME` | 🇨🇳 China | 2900          |\n\n#### 🌍 International Mini Games (7)\n\n| Platform    | Define Symbol                                        | Region   | Menu Priority |\n| ----------- | ---------------------------------------------------- | -------- | ------------- |\n| Discord     | `ENABLE_DISCORD_MINI_GAME` / `DISCORDMINIGAME`       | 🌍 Global | 2700          |\n| YouTube     | `ENABLE_YOUTUBE_MINI_GAME` / `YOUTUBEMINIGAME`       | 🌍 Global | 2800          |\n| Facebook    | `ENABLE_FACEBOOK_MINI_GAME` / `FACEBOOKMINIGAME`     | 🌍 Global | 2900          |\n| Google Play | `ENABLE_GOOGLEPLAY_MINI_GAME` / `GOOGLEPLAYMINIGAME` | 🌍 Global | 3000          |\n| TikTok      | `ENABLE_TIKTOK_MINI_GAME` / `TIKTOKMINIGAME`         | 🌍 Global | 3500          |\n| CrazyGames  | `ENABLE_CRAZYGAMES_MINI_GAME` / `CRAZYGAMESMINIGAME` | 🌍 Global | 3600          |\n| Poki        | `ENABLE_POKI_MINI_GAME` / `POKIMINIGAME`             | 🌍 Global | 3700          |\n\n#### 📱 Device OEMs (4)\n\n| Platform         | Define Symbol                                | Region  | Menu Priority |\n| ---------------- | -------------------------------------------- | ------- | ------------- |\n| Huawei Mini Game | `ENABLE_HUAWEI_MINI_GAME` / `HUAWEIMINIGAME` | 🇨🇳 China | 3400          |\n| OPPO Mini Game   | `ENABLE_OPPO_MINI_GAME` / `OPPOSMINIGAME`    | 🇨🇳 China | 3200          |\n| Vivo Mini Game   | `ENABLE_VIVO_MINI_GAME` / `VIVOMINIGAME`     | 🇨🇳 China | 3100          |\n| Xiaomi Mini Game | `ENABLE_XIAOMI_MINI_GAME` / `XIAOMIMINIGAME` | 🇨🇳 China | 3300          |\n\n#### 🎮 Game Platforms (1)\n\n| Platform         | Define Symbol                                | Region  | Menu Priority |\n| ---------------- | -------------------------------------------- | ------- | ------------- |\n| TapTap Mini Game | `ENABLE_TAPTAP_MINI_GAME` / `TAPTAPMINIGAME` | 🇨🇳 China | 2700          |\n\n#### Define Symbol Details\n\n- **Unified Define**: `ENABLE_WEBGL_MINI_GAME` - Shared by all mini game platforms\n- **Platform Defines**: Independent defines for conditional compilation per platform\n- **Mutex Mechanism**: Enabling one mini game platform automatically disables others\n- **Menu Path**: `GameFrameX/Scripting Define Symbols/[Category]/Enable [Platform] Mini Game`\n\n---\n\n## 📚 Documentation \u0026 Resources\n\n- 📖 **Full Documentation**: [https://gameframex.doc.alianblank.com](https://gameframex.doc.alianblank.com)\n- 🎯 **API Reference**: [API Documentation](https://gameframex.doc.alianblank.com/api)\n- 📝 **Example Projects**: [Examples Repository](https://github.com/GameFrameX/Examples)\n- 🎬 **Video Tutorials**: [YouTube Channel](https://youtube.com/gameframex)\n\n---\n\n## 🤝 Community \u0026 Support\n\n- 💬 **QQ Group**: [467608841](https://qm.qq.com/cgi-bin/qm/qr?k=sYFd1nv6m2KZIWFLorZ5pBR0AE5ZhbuL\u0026jump_from=webapi\u0026authKey=oCu+uoL3n35fT5SEt7iLgGtROPxh31n/rHUxRlp0w1f+j38W4tKBuWyRH3KEdwHN)\n- 🐛 **Issue Tracker**: [GitHub Issues](https://github.com/GameFrameX/com.gameframex.unity/issues)\n- 💡 **Feature Requests**: [GitHub Discussions](https://github.com/GameFrameX/com.gameframex.unity/discussions)\n\n---\n\n## 🔄 Changelog\n\n### v1.4.0 (2025-04-16)\n- ✨ Added 13 new mini game platforms (JD, Taobao, Discord, YouTube, Facebook, Google Play, vivo, OPPO, Xiaomi, Huawei, TikTok, CrazyGames, Poki)\n- ✨ Expanded from 8 to 21 platforms, covering global mainstream mini game platforms\n- 📚 Updated all language versions of README documentation with latest platform support\n- 🐛 Optimized platform define symbol management and improved mutex mechanism stability\n\n### v1.3.6 (2025-05-28)\n- 🐛 Fixed duplicate GUID issues\n- ✨ Added Meituan, Bilibili mini game platform adaptation\n- ✨ Added more extension methods\n- 📚 Enhanced README documentation with complete module structure\n- 🔧 Optimized object pool performance\n- 📚 Improved documentation\n\nView full changelog: [CHANGELOG.md](CHANGELOG.md)\n\n---\n\n## 📄 License\n\nThis project is distributed under **MIT License** and **Apache License 2.0** dual licensing.\n\nSee full license text: [LICENSE.md](LICENSE.md)\n\n---\n\n## 👨‍💻 Author\n\n**Blank**\n\n- 🌐 Website: [https://gameframex.doc.alianblank.com](https://gameframex.doc.alianblank.com)\n- 🐙 GitHub: [@GameFrameX](https://github.com/GameFrameX)\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**If this project helps you, please give us a ⭐ Star!**\n\n[⬆ Back to Top](#gameframex-unity-package)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgameframex%2Fcom.gameframex.unity","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgameframex%2Fcom.gameframex.unity","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgameframex%2Fcom.gameframex.unity/lists"}