Update: This project has not been abandoned. We at the BII GmbH are planning to rewrite this and to adda ton of new features that we are already using internally, including many non-Unity C# utilities. We'd like to have this done by the end of the year, but I cannot guarantee anything. This will probably be a new project with specific modules.

Update 2: CoreLibrary 2 is scheduled for late 2021, with significantly more features.

The Unity CoreLibrary

The CoreLibrary is a collection of classes and extension methods you didn't even know you were missing. It provides generic, well-tested, well-documented components such as a Pool implementation and object queries as well as numerous extension methods and utilities that make your everyday code cleaner and more type safe.

This project has been developed primarily at the Univeristy of Würzburg, Germany. It remains free and open source for all Games Engineering students as well as anyone else who wants to use it. This project is sponsored, maintained and used by the BII GmbH.

The main goal is to encourage the good sides of functional programming:

Usage of first class functions (delegates)
Immutability (esp. concerning vectors)
Composition of behaviour (coroutines)
Concise, generic and maintainable code
Complete type safety

What the CoreLibrary Offers

For a complete list, see the full documentation.

Unity Extensions

var newVec = someBaseBehaviour.Position.WithY(y => y + 2);

foreach (var child in transform.GetChildren()) { ... }

var rb = gameObject.As<Rigidbody>(Search.InParents);

SetPerceivable(false); // continues coroutines and animations

if (AssignIfAbsent(ref rigidbody)) { /* newly assigned, do sth */ }

LINQ extensions

var list1 = new List<int> { 1, 2, 3 };
var list2 = new List<int> { 4, 5, 6 };

list2.Where(v => v % 2 == 0).ForEach(Debug.Log);

list1.AndAlso(list2);     // IEnumerable<int> { 1, 2, 3, 4, 5, 6 }

list1.Shuffled();         // IEnumerable<int> { 3, 1, 2 }

Declarative Coroutine Creation

StartCoroutine(RepeatEverySeconds(1f, () => Debug.Log("tik tok")));

MyCoroutine().Start() // works outside of MonoBehaviours!

WaitUntil(
    () => InRange(),
    () => Attack()
).Start();

RepeatForSeconds(FlightTime,
    () => _rb.AddForce(Vector3.up * Lift),
    fixedUpdate: true
).Start();

WaitForSeconds(3)
    .YieldWhile(() => InRange())
    .Afterwards(() => {
        Explode();
        Destroy(gameObject);
    }).Start();

Generic Object Pooling

// TODO: inspector screenshot

var bullet = bulletPool.RequestItem(transform.position);

Grows by a factor you can set once empty
Independent interface for reusing objects
No impact on your component design decisions

Object Queries in Scene

abstract class Interactable : QueryableBaseBehaviour { ... }

Query.All<Interactable>()
    .Where(i => Distance(i.transform.position, transform.position) < Threshold)
    .ToList();

Other Utilities

void DoSomething<T>(T value) 
{
    // works around Unity's custom null comparison bugs
    if (!Util.IsNull(value)) { ... }
}

Getting Started

Requires Unity 2018.1 or above. Compatible with C# 4 (.NET 3.5) and above.

Either clone this repository and paste the CoreLibrary folder into your Scripts folder (or anywhere) or download directly from the Asset Store.

Then add the line

using CoreLibrary;

to the top of your file. This will usually happen automatically when you extend BaseBehaviour instead of MonoBehaviour. For now everything is included in this single namespace, in order to ease the usage of the included extension methods.

Contributing

If you have any ideas, problems or feature requests, please add an issue to this project.

I will gladly accept any pull request for a feature you believe is useful for everyone. But be prepared that I might rewrite it to find the general style.

Authors

Cameron Reuschel - XDracam

Want your name and link here? Go and send a pull request!

License

This project is licensed under the MIT License - see the LICENSE file for details

Acknowledgments

Special thanks to Daniel Götz for constant feedback and motivated usage.

Thanks to the BII GmbH for sponsoring development.

Other Useful Plugins

Rotary Heart offers a great implementation for Serialized Dictionaries. This has been a requested feature, but there is no need to reinvent the wheel 😉

XDracam/unity-corelibrary