Repository files navigation

Current version: 0.16.0

Unity version: 2018.1.0f2 (last tested)

Repository link:https://github.com/KonH/UDBase

DevBlog:http://konhit.blogspot.ru/

UDBase is module-based game template forUnity. Modules in UDBase are calledControllers, their implementation can be replaced without changing your project source code. It is Open-Source project with MIT license, so you overview source code, send pull requests, create your own issues and fork the project, if you want.

UDBase is used semantic versioning convention (http://semver.org/).

You can overview releases here -https://github.com/KonH/UDBase/releases.

Release notes in plain text you can find here -Docs/_ReleaseNotes.txt.

1. First time:
   1. Add project as git-submodule to your Unity project:git submodule add https://github.com/KonH/UDBase.git Assets/UDBase
2. If you clone your project already with submodule:
   1. Initialize submodule:git submodule init
   2. Update submodule:git submodule update

You can download last version here:https://github.com/KonH/UDBase/archive/master.zip

Just update submodule:git submodule update

Also, you can re-install project as described above.

UDBase is usesZenject in the core, you need to use it to reach controller functionality.

1. Firstly, createsProjectContext in your Resources directory
2. Creates your installer class(es), then adds adn assign it on ProjectContext
3. You can inherit fromUDBaseInstaller to bind controllers in easy way using Add* methods
4. If you need conditional binding (e.g. some controller implementation depends on environment), createsBuildTypeInstaller (Create/UDBase/BuildTypeSettings) and assign it on your ProjectContext
5. If you need to use UI system, place custom scene context from UDBase/Prefabs/UDBSceneContext
6. Otherwise, use default scene context
7. In your installer class(es) adds required controllers
8. Implement your logics based on Zenject DI features
9. ...
10. PROFIT

When you use Add* methods inUDBaseInstaller, method signature indicates required dependencies, so you can simply creates it from where you want. For example, all 'settings' arguments can be exposed as fields of your installer and serialized in Unity-friendly way.

Almost all controllers requiresILog, so you need to add it before adding these controllers. You can use EmptyLog when you do not need any logs, it is not affect performance (if you use it properly and do not make string concatenations in your log calls or something like that).

In other cases, Zenject asserts show you what hidden dependencies is required and must me added using Add* methods.

• Scene (load scenes)
• Config (load permanent configuration, json)
• Save (load and save user data, json)
• Log (custom logging with visual logger)
• Event (lightweight event manager)
• Content (content loading system using direct load and AssetBundles)
• UTime (local/network time controller)
• UI (UI system)
• User (User system)
• Leaderboard (Leaderboard system)
• Audio (Audio system)
• Sound (Sound playing system)
• Music (Music playing system for scenes)
• Localization (localization)
• Analytics (analytics)

• Zenject - DI-container
• Full Serializer - JSON serializer, used for defaultConfig/Save implementation
• AssetBundleManager - asset bundle manager forContent controller
• ObjectPool - pooling script to prevent garbage generation and performance hiccups while create and recycle objects
• DOTween - tweening library
• ClassTypeReference - helper to serialize types
• OneLine - editor helper to draw simple one-line inspectors

• Utils - set of useful IO, network, text and etc. utilily classes;

• Helpers - docs about helper tools and common features;

Using menu items atUDBase/Screenshots you can make screenshots (with upscaling resolution) and manage directory to save these screenshots (you can clean or open it).

Helper methods to createScriptableObject assets in project, create and remove sub-assets.

Example project -https://github.com/KonH/UDBaseExample

You can read contribution rules here -CONTRIBUTING.md.

SeeLICENSE.txt beside.