make autonomous creatures for voxel games
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
example collision radius and collision events Feb 18, 2013
LICENSE
index.js
package.json
readme.markdown

readme.markdown

voxel-creature

create creatures for voxel.js

example

var createGame = require('voxel-engine');
var voxel = require('voxel');
var game = createGame({
    generate: voxel.generator['Valley'],
    texturePath: '/textures/'
});
game.appendTo('#container');

var createPlayer = require('voxel-player')(game);
var substack = createPlayer('substack.png');
substack.possess();
window.substack = substack;

window.addEventListener('keydown', function (ev) {
    if (ev.keyCode === 'R'.charCodeAt(0)) {
        substack.toggle();
    }
});

var createCreature = require('../')(game);
var creature = createCreature((function () {
    var T = game.THREE;
    var body = new T.Object3D;
    
    var head = new T.Mesh(
        new T.CubeGeometry(10, 10, 10),
        new T.MeshLambertMaterial({
            color: 0x800830,
            ambient: 0x800830
        })
    );
    head.position.set(0, 5, 0);
    body.add(head);
    
    var eyes = [0,1].map(function () {
        var eye = new T.Mesh(
            new T.CubeGeometry(1, 1, 1),
            new T.MeshLambertMaterial({
                color: 0xffffff,
                ambient: 0xffffff
            })
        );
        body.add(eye);
        return eye;
    });
    eyes[0].position.set(2, 8, 5);
    eyes[1].position.set(-2, 8, 5);
    
    return body;
})());
window.creature = creature;
 
creature.position.y = 200;
creature.position.x = Math.random() * 300 - 150;
creature.position.z = Math.random() * 300 - 150;

creature.on('block', function () { creature.jump() });
creature.notice(substack, { radius: 500 });

creature.on('notice', function (player) {
    creature.lookAt(player);
    creature.move(0, 0, 0.5);
});

setInterval(function () {
    if (creature.noticed) return;
    creature.rotation.y += Math.random() * Math.PI / 2 - Math.PI / 4;
    creature.move(0, 0, 0.5 * Math.random());
}, 1000);

methods

var voxelCreature = require('voxel-creature')

var createCreature = voxelCreature(game)

Return a function createCreature for making creatures given a voxel-engine game instance.

var creature = createCreature(obj, opts={})

Create a creature with the three.js 3d object (use game.THREE) obj.

Control the bounding box size with a vector3 opts.dims and the force (like gravity) for the object to be subject to with opts.force.

The default opts.dims is [10,10,10]. The default opts.force is [0,-0.00009,0].

creature.jump(power=1)

Jump upward.

creature.move(x, y, z)

Move the creature [x,y,z] smoothly by altering its velocity.

creature.lookAt(target)

Turn toward the 3d object target. target should be a 3d vector itself or it should have a target.position.

creature.notice(target, opts)

Return an interval for detecting the presence of target. target should be a 3d vector itself or it should have a target.position.

The opts.radius controls how nearby target needs to be to trigger a 'notice' event. Otherwise 'frolic' events fire. The default opts.radius is 500.

The opts.collisionRadius controls how nearby target needs to be to trigger a 'collide' event. The default opts.collisionRadius is 25.

The opts.interval controls how often to check the distance to target. The default opts.interval is 1000.

events

creature.on('notice', function (target) {})

When target is within the radius configured by creature.notice(), the 'notice' event fires.

creature.on('collide', function (target) {})

When target is within the collision radius configured in creature.notice(), the 'collide' event fires.

creature.on('block', function () {})

When a creature is constrained by a block in front of it, the 'block' event fires. A good thing to try when a creature is blocked is to jump.

attributes

creature.position

control the creature item position

creature.rotation

control the creature item rotation

install

With npm do:

npm install voxel-creature

license

MIT