https://github.com/libgdx/ashley

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

Last synced: 15 days ago
JSON representation

A Java entity system inspired by Ash & Artemis.

• Host: GitHub
• URL: https://github.com/libgdx/ashley
• Owner: libgdx
• License: apache-2.0
• Created: 2013-02-14T19:31:07.000Z (almost 12 years ago)
• Default Branch: master
• Last Pushed: 2023-06-26T12:37:20.000Z (over 1 year ago)
• Last Synced: 2024-08-02T07:08:17.053Z (4 months ago)
• Language: Java
• Homepage:
• Size: 8.48 MB
• Stars: 856
• Watchers: 77
• Forks: 144
• Open Issues: 20
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS
  • Authors: AUTHORS

Awesome Lists containing this project

• awesome-libgdx - Ashley - A Java entity system inspired by Ash & Artemis. (Resources / Entity Component System (ECS))

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!