Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/libgdx/ashley

A Java entity system inspired by Ash & Artemis.
https://github.com/libgdx/ashley

Last synced: about 2 months ago
JSON representation

A Java entity system inspired by Ash & Artemis.

Awesome Lists containing this project

README

        

![](http://i.imgur.com/w8oAC73.png?1)

[![GitHub Actions build status](https://img.shields.io/github/workflow/status/libgdx/ashley/Compile%20and%20publish%20snapshot)](https://github.com/libgdx/ashley/actions/workflows/publish_snapshot.yml)

[![Sonatype Nexus (Releases)](https://img.shields.io/nexus/r/com.badlogicgames.ashley/ashley?nexusVersion=2&server=https%3A%2F%2Foss.sonatype.org&label=release)](https://search.maven.org/artifact/com.badlogicgames.ashley/ashley)
[![Sonatype Nexus (Snapshots)](https://img.shields.io/nexus/s/com.badlogicgames.ashley/ashley?server=https%3A%2F%2Foss.sonatype.org&label=snapshot)](https://oss.sonatype.org/#nexus-search;gav~com.badlogicgames.ashley~ashley)

A tiny entity framework written in Java. It's inspired by frameworks like
[Ash](http://www.ashframework.org/) (hence the name) and
[Artemis](http://gamadu.com/artemis/). Ashley tries to be a high-performance
entity framework without the use of black-magic and thus making the API easy
and transparent to use.

Ashley is awesome, if you don't believe it, check out some [games](https://github.com/libgdx/ashley/wiki/Games-made-with-Ashley) made with it!

Ashley lives under the [libGDX](https://github.com/libgdx) family but it does not force you to use that specific framework if you do not wish to do so.

libGDX Discord : [![Discord Chat](https://img.shields.io/discord/348229412858101762?logo=discord)](https://libgdx.com/community/discord/)

### Get started

* [Use Ashley in your project](https://github.com/libgdx/ashley/wiki/Getting-started-with-Ashley)
* [Read the wiki](https://github.com/libgdx/ashley/wiki)
* [Refer to the javadocs](https://javadoc.io/doc/com.badlogicgames.ashley/ashley)
* [Read the examples](https://github.com/libgdx/ashley/tree/master/tests)

### News and community

Stay up to date in Ashley matters by following [@d_saltares](https://twitter.com/d_saltares) and reading [saltares.com](http://saltares.com). Check the [libGDX](https://libgdx.com/) blog as well for additional updates.

### Report issues

Something not working quite as expected? Do you need a feature that has not been implemented yet? Check the [issue tracker](https://github.com/libgdx/ashley/issues) and add a new one if your problem is not already listed. Please try to provide a detailed description of your problem, including the steps to reproduce it.

### Contribute

Awesome! If you would like to contribute with a new feature or submit a bugfix, fork this repo and send a pull request. Please, make sure all the [unit tests](https://github.com/libgdx/ashley/tree/master/ashley/tests/com/badlogic/ashley) are passing before submitting and add new ones in case you introduced new features.

### License

Ashley is licensed under the [Apache 2 License](https://github.com/libgdx/ashley/blob/master/LICENSE), meaning you
can use it free of charge, without strings attached in commercial and non-commercial projects. We love to
get (non-mandatory) credit in case you release a game or app using Ashley!