npm install entityEntityJS Website | Demos | Tutorials | API
Systems and groups have been added. Groups are used to contain similar entities and can be used for searches or in systems. Systems should contain all the logic of a game, like updates, drawing and input. Components should only add attributes to an entity while systems will run everything together using groups.
See the examples folder for help.
This becomes a big mess.
In the world of entity-component designs. All logic is implemented in a component, as big or small as you want. You can then create an entity and add/remove components to it. The entity is a live represantation of all its components. With this low coupling of components and entities you can mix and match components together to create powerful functionality yet still portable and robust.
You must have at least Ruby 1.8.1+.
EntityJS is now an easy to install gem. In the terminal type in:
gem install entityjs
This will install the latest version of the gem and now you can easily create some games!
When using these commands make sure you are always in the root directory of your game.
Creating a game is simple, move to any directory and type in:
entityjs new mygame
This will create a new game using the default template.
Create a game with a platform template:
entityjs new mygame platform
See all available templates:
entityjs templates
entityjs comp rock
This will create a new component called rock at scripts/rock.js and will create a test file.
entityjs comp display/hero
This will create a hero component in the directory scripts/display.
entityjs test name test1 test1
Create a test in /tests/name_test.js with two test methods.
entityjs build
This will minify all entityjs src code and game src code into one file inside /builds
Make sure the server is running:entityjs server
To play visit:localhost:2345
To run tests visit:localhost:2345/test
Assets are located here:localhost:2345/assets/*name
View all commands
* Assets - Contains all external assets
* Images - Add any images here and retrieve them with re.assets.images
* Sounds - Add any sounds and retrieve them with re.assets.sounds
* Build - Contains built game
* Scripts - Contains all js, coffee sources. Xml, tmx and json files will be converted into js.
* Plugins - Contains minified scripts for plugin play.
* Tests - Contains test files to run in QUnit
* Styles - Contains all css to be included. Will support sass and others later on.
* game.json - Optional, configurate scripts order, ignore certain files, etc
var tile = re.e('tile');
tile.tileX(1); //sets
tile.tileX(); //gets
#### Setters can even be used in set()
tile.set('tileX', 2); //sets
#### Setter with multiple parameters
tile.tile(1, 2); //sets tilex and tiley
//or
tile.set('tile', [1,2]); //samething
All components now have a factory method which can be used to create complex entities.
re.c("button")
.factory(function(label, click){
this.label = label;
if(click){
this.on('click', click);
}
});
re.button("Hello", function(){
alert(this.label+" clicked!");
});
//Can be overwritten using the method function. A singleton is created below.
re.c("player")
.method(function(){
if(!this.instance){
this.instance = re.e('player');
}
return this.instance;
});
//get player
re.player();
All games use QUnit for testing, its light weight and easy to use. Checkout the platform template to see some example tests.
Factories are used to easily create complex entities. During tests you may need access to a specific type of entity multiple times. Factories make it easy to create any kind of entity at anytime.
Simply create a new factories.js in the /tests directory and add something like below.
factory('enemy', function(){
//make a custom coin
this.health = 100;
this.state = 'idle';
//can use normal entity methods
this.on('update', function(){
//something
});
});
//create new enemy entity anywhere in tests
var e = factory('enemy');
eq(e.state, 'idle') //true
//Same as...
var e = re.e('enemy');
e.health = 100;
//etc...
What if you need multiple enemy factories?
//use f for laziness
f('enemy attacking', function(){
this.state = 'attacking';
});
Some asserts have been added for checking entities, like expectTrigger, expectFlicker and expectListener. For more info check localhost:2345/qunit/qunit.entity.js.
Special methods like keypress() and click() are available to simulate user input. Check localhost:2345/qunit/qunit.input.js for more information.
The awesome tiled map editor is now compatible and can be used in your projects.
Simply create a new directory in /assets named levels or anything you like to save your maps in. They can accessed in code like so:
re('level1.tmx')[0]; //assuming the file name is level1.tmx
re('level'); //find all levels that are in the /assets/levels directory
If you are still confused create a new platform game and view levels are used.
Now you can create a new game from the platform template:entityjs new mygame platform
Move into the mygame directory and play the game:entityjs server
Open your browser and navigate to localhost:2345
Before sending a pull request it would be a good idea to run rspec and rake jasmine to make sure all tests pass in both ruby and javascript.
Running rspec will generate a /mygame/ folder with test files. It will be ignored by git so don't worry about it.