Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/vovgou/loxodon-framework
An MVVM & Databinding framework that can use C# and Lua to develop games
https://github.com/vovgou/loxodon-framework
mvvm unity unity-mvvm
Last synced: 30 days ago
JSON representation
An MVVM & Databinding framework that can use C# and Lua to develop games
- Host: GitHub
- URL: https://github.com/vovgou/loxodon-framework
- Owner: vovgou
- License: mit
- Created: 2017-01-02T03:25:02.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2024-08-30T04:28:47.000Z (2 months ago)
- Last Synced: 2024-10-08T11:19:11.507Z (about 1 month ago)
- Topics: mvvm, unity, unity-mvvm
- Language: C#
- Homepage:
- Size: 175 MB
- Stars: 1,897
- Watchers: 64
- Forks: 363
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Loxodon Framework(Unity-MVVM)
[](https://github.com/vovgou/loxodon-framework/blob/master/LICENSE)
[](https://github.com/vovgou/loxodon-framework/releases)
[](https://openupm.com/packages/com.vovgou.loxodon-framework/)
[](https://www.npmjs.com/package/com.vovgou.loxodon-framework)
[(中文版)](README_CN.md)
**MVVM and Databinding for Unity3d(C# & XLua & ILRuntime)**
*Developed by Clark*
Requires Unity 2018.4 or higher.
LoxodonFramework is a lightweight MVVM (Model-View-ViewModel) framework specifically crafted for Unity3D. It includes data binding and various useful components. The framework's performance is meticulously optimized, avoiding value type boxing and unboxing, minimizing garbage collection overhead. It utilizes dynamic delegates/static code weaving techniques to ensure comparable performance between data binding and direct invocation, zero garbage collection during UI view updates, and more. Additionally, it has been validated in projects, demonstrating superior performance, stability, and reliability with a clear, extensible architecture. We hope it can contribute to making your game development faster and more effortless.
For tutorials,examples and support,please see the project.You can also discuss the project in the Unity Forums.
The plugin is compatible with MacOSX,Windows,Linux,UWP,WebGL,IOS and Android,and provides all the source code of the project.
If you like this framework or think it is useful, please write a review on [AssetStore](https://assetstore.unity.com/packages/tools/gui/loxodon-framework-2-0-178583#reviews) or give me a STAR or FORK it on Github, thank you!
**Tested in Unity 3D on the following platforms:**
PC/Mac/Linux
IOS
Android
UWP(window10)
WebGL
## Installation
For detailed installation steps, please refer to the **[installation documentation](Installation.md)**.
## English manual
- [HTML](https://github.com/vovgou/loxodon-framework/blob/master/docs/LoxodonFramework_en.md)
- [PDF](https://github.com/vovgou/loxodon-framework/blob/master/docs/LoxodonFramework_en.pdf)
## Key Features:
- MVVM Framework;
- Multiple platforms;
- Higher Extensibility;
- async&await (C#&Lua)
- try&catch&finally for lua
- XLua support(You can make your game in lua.);
- Asynchronous result and asynchronous task are supported;
- Scheduled Executor and Multi-threading;
- Messaging system support;
- Preferences can be encrypted;
- Localization support;
- Code weaving
- Databinding support:
- Avoiding boxing and unboxing of value types;
- Optimizing performance through dynamic delegates/static code weaving techniques, avoiding the use of reflection;
- Minimizing garbage collection, avoiding memory allocations during string concatenation, and numeric-to-string conversions;
- Data binding performance is comparable to direct invocation;
- Zero garbage collection during UI view updates;
- Field binding;
- Property binding;
- Dictionary,list and array binding;
- Event binding;
- Unity3d's EventBase binding;
- Static property and field binding;
- Method binding;
- Command binding;
- ObservableProperty,ObservableDictionary and ObservableList binding;
- Expression binding;
## Notes
- .Net2.0 and .Net2.0 Subset,please use version 1.9.x.
- LoxodonFramework 2.0 supports .Net4.x and .Net Standard2.0
- LoxodonFramework 2.0 supports Mono and IL2CPP
## Plugins
- [Loxodon Framework OSA](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.OSA)
This plugin is designed to optimize [Optimized ScrollView Adapter](https://assetstore.unity.com/packages/tools/gui/optimized-scrollview-adapter-68436), specifically adding data binding capabilities to ListView and GridView.
**Note: This plugin depends on [Optimized ScrollView Adapter](https://assetstore.unity.com/packages/tools/gui/optimized-scrollview-adapter-68436). Please ensure you have installed Optimized ScrollView Adapter before using this plugin.**
- [Loxodon Framework TextFormatting](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.TextFormatting)
This is a text formatting plugin modified based on the official C# library. By extending the AppendFormat function of StringBuilder, it aims to avoid garbage collection (GC) when concatenating strings or converting numbers to strings. This optimization is particularly beneficial in scenarios with high-performance requirements.
Furthermore, the plugin extends Unity's Unity GUI (UGUI) by introducing two new text controls: TemplateText and FormattableText. These controls support the data binding features of MVVM, allowing the binding of ViewModel or value-type objects to the controls. This approach eliminates the need for boxing and unboxing of value-type objects, thus maximizing the optimization of garbage collection (GC).
It's worth noting that using the controls TemplateTextMeshPro or FormattableTextMeshProUGUI from Loxodon.Framework.TextMeshPro can further reduce garbage collection (GC), achieving a completely GC-free update of the game view.
- [Loxodon Framework TextMeshPro](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.TextMeshPro)
This plugin primarily serves to enhance AlertDialog and Toast views by providing TextMeshPro support, replacing UnityEngine.UI.Text with TextMeshProUGUI for optimized UI views.
Additionally, the plugin depends on the Loxodon.Framework.TextFormatting plugin, further optimizing garbage collection. By utilizing FormattableTextMeshProUGUI and TemplateTextMeshProUGUI controls, updating UI views results in absolutely no garbage collection (GC), achieving a fully GC-free view update.
- [Loxodon Framework Data](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Data)
This plugin supports exporting data from Excel files to Json files, Lua files, or LiteDB databases. Additionally, it enables converting data to C# objects using Json.Net. It is recommended to use LiteDB for storing configuration data, as it is a lightweight NoSQL embedded database that supports ORM functionality, BSON format, and data indexing, making it highly convenient to use.
- [Loxodon.Framework.Data.LiteDB](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Data/Packages/com.vovgou.loxodon-framework-data-litedb)
- [Loxodon.Framework.Data.Newtonsoft](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Data/Packages/com.vovgou.loxodon-framework-data-newtonsoft)
- [Loxodon Framework Fody](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Fody)
This is a plugin for static code weaving, comprising multiple sub-plugins. It supports static weaving for objects, including the addition of the ToString function, integration of the PropertyChanged event, incorporation of the BindingProxy class, and more. This not only optimizes performance but also enhances development efficiency.
- [Loxodon.Framework.Fody.PropertyChanged](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Fody/Packages/com.vovgou.loxodon-framework-fody-propertychanged)
- [Loxodon.Framework.Fody.ToString](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Fody/Packages/com.vovgou.loxodon-framework-fody-tostring)
- [Loxodon.Framework.Fody.BindingProxy](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Fody/Packages/com.vovgou.loxodon-framework-fody-bindingproxy)
- [Loxodon Framework UIToolkit](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.UIToolkit)
This plugin integrates UIToolkit into the Loxodon.Framework, introducing the UIToolkitWindow class. It supports data binding and allows for a mix of UIToolkit and UGUI.
- [Loxodon Framework ILRuntime](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.ILRuntime)
- [Loxodon Framework Localization For CSV](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.LocalizationsForCsv)
It supports localization files in csv format, requires Unity2018.4 or higher.
- [Loxodon Framework XLua](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.XLua)
It supports making games with lua scripts.
- [Loxodon Framework Bundle](https://assetstore.unity.com/packages/slug/87419)
Loxodon Framework Bundle is an AssetBundle manager.It provides a functionality that can automatically manage/load an AssetBundle and its dependencies from local or remote location.Asset Dependency Management including BundleManifest that keep track of every AssetBundle and all of their dependencies. An AssetBundle Simulation Mode which allows for iterative testing of AssetBundles in a the Unity editor without ever building an AssetBundle.
The asset redundancy analyzer can help you find the redundant assets included in the AssetsBundles.Create a fingerprint for the asset by collecting the characteristic data of the asset. Find out the redundant assets in all AssetBundles by fingerprint comparison.it only supports the AssetBundle of Unity 5.6 or higher.
- [Loxodon Framework NLog](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.NLog)
This plug-in integrates NLog into Loxodon.Framework. It is recommended to use this plug-in instead of the Log4Net plug-in. It allocates less heap memory during the log printing process.
- [Loxodon Framework Log4Net](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Log4Net)
This is a log plugin.It helps you to use Log4Net in the Unity3d.
- [Loxodon Framework Obfuscation](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Obfuscation)
The plugin is a data type memory obfuscation tool that supports ObfuscatedByte, ObfuscatedShort, ObfuscatedInt, ObfuscatedLong, ObfuscatedFloat, and ObfuscatedDouble types. Its purpose is to prevent memory modification of game values by memory editors. The plugin supports all arithmetic operators for numerical types and can automatically convert between them and their standard counterparts (byte, short, int, long, float, double).
During the obfuscation of Float and Double types, the plugin converts them to int and long types for bitwise AND and OR operations to ensure that precision is not lost. Unsafe code is used for type conversion to balance conversion performance. The plugin aims to provide a comprehensive solution for protecting game values against memory modification, allowing for seamless integration with different numerical types and maintaining performance through careful type conversion.
**Example:**
ObfuscatedInt length = 200;
ObfuscatedFloat scale = 20.5f;
int offset = 30;
float value = (length * scale) + offset;
- [Loxodon Framework Addressable](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Addressable)
- [Loxodon Framework Connection](https://github.com/vovgou/loxodon-framework?path=Loxodon.Framework.Connection)
This is a network connection component, implemented using TcpClient, supports IPV6 and IPV4, automatically recognizes the current network when connecting with a domain name, and preferentially connects to the IPV4 network.
- [DotNetty for Unity](https://github.com/vovgou/DotNettyForUnity)
DotNetty is a port of [Netty](https://github.com/netty/netty), asynchronous event-driven network application framework for rapid development of maintainable high performance protocol servers & clients.
This version is modified based on [DotNetty](https://github.com/Azure/DotNetty)'s 0.7.5 version and is a customized version for the Unity development platform. It includes the removal of certain dependency libraries, bug fixes, performance optimizations, and enhancements to cater to game development on the Unity platform. Additionally, it has undergone testing under IL2CPP for compatibility and reliability.
- [LiteDB](https://github.com/mbdavid/LiteDB)
LiteDB is a small, fast and lightweight NoSQL embedded database.
## Quick Start
Create a view and view model of the progress bar.
public class ProgressBarViewModel : ViewModelBase
{
private string tip;
private bool enabled;
private float value;
public ProgressBarViewModel()
{
}
public string Tip
{
get { return this.tip; }
set { this.Set(ref this.tip, value, nameof(Tip)); }
}
public bool Enabled
{
get { return this.enabled; }
set { this.Set(ref this.enabled, value, nameof(Enabled)); }
}
public float Value
{
get { return this.value; }
set { this.Set(ref this.value, value, nameof(Value)); }
}
}
public class ProgressBarView : UIView
{
public GameObject progressBar;
public Text progressTip;
public Text progressText;
public Slider progressSlider;
protected override void Awake()
{
var bindingSet = this.CreateBindingSet();
bindingSet.Bind(this.progressBar).For(v => v.activeSelf).To(vm => vm.Enabled).OneWay();
bindingSet.Bind(this.progressTip).For(v => v.text).To(vm => vm.Tip).OneWay();
bindingSet.Bind(this.progressText).For(v => v.text)
.ToExpression(vm => string.Format("{0:0.00}%", vm.Value * 100)).OneWay();
bindingSet.Bind(this.progressSlider).For(v => v.value).To(vm => vm.Value).OneWay();
bindingSet.Build();
}
}
IEnumerator Unzip(ProgressBarViewModel progressBar)
{
progressBar.Tip = "Unziping";
progressBar.Enabled = true;//Display the progress bar
for(int i=0;i<30;i++)
{
//TODO:Add unzip code here.
progressBar.Value = (i/(float)30);
yield return null;
}
progressBar.Enabled = false;//Hide the progress bar
progressBar.Tip = "";
}
## Tutorials and Examples
## Introduction
- Window View
- Localization
- Databinding
- Variable Example
- ListView Binding
## Contact Us
Email: [[email protected]](mailto:[email protected])
Website: [https://vovgou.github.io/loxodon-framework/](https://vovgou.github.io/loxodon-framework/)
QQ Group: 622321589 15034148