Skip to content

BlobTheKat/blob-machine

Repository files navigation

Play the game here

Credit to the original game, Cell Machine (by sam hogan)

Textures credit to https://cellmachine.net No, we are not going to include a link to your license. No, you cannot claim right to the subticking mechanism. Legal concerns can go to /dev/null (Or you can email me at [email protected]) If you have any concerns in general (legal or not), create an issue! That's what they're for!

Modding API

Loading custom cells works by loading ES6 modules from the link copied to clipboard

To create a cell pack, you must host your .js file to a permenant URL (like a raw github url)

Example file contents:

const { BACKWARD, FORWARD, LEFT, RIGHT, UP, DOWN, sound, BEAT, BREAK, cell, DIRECTIONAL, TICK } = CELLMODDING


// Define a cell
// This one rotates cells around it to point to itself
cell({
	//Cell name
	name: 'Attract cell',

	//TICK = updates every tick, DIRECTIONAL = updates every tick but in cell direction order like movers and generators
	update: TICK,

	//Location of cell in texture image. (tx: 0, ty: 0) means top left, and each increment after that is 16px right / down
	//Here (tx: 2, ty: 3) means the texture is at x=32, y=48 (size is always 16x16)
	tx: 2, ty: 3,

	tick(){
		//Update the cell
		// Get cells around it, and make them face us
		const above = this.get(UP)
		if(above){
			above.face(DOWN)
		}
		const left = this.get(LEFT)
		if(left){
			left.face(RIGHT)
		}
		const right = this.get(RIGHT)
		if(right){
			right.face(LEFT)
		}
		const below = this.get(DOWN)
		if(below){
			below.face(UP)
		}
	},

	// This is called when the cell gets pushed. Return a force to push back.
	push(dir, force){
		if(dir % 2 == this.dir % 2){
			//Direction is aligned
			return 0 //Allow being pushed
		}else{
			//Returning a force of -Infinity will in effect make it impossible to push the cell
			return -Infinity
		}
		//You could also return DELETE to delete the cell that was pushing you (e.g trash cell)
	}
})

Available methods on cells

cell.dir

Current cell direction. May be == UP, == DOWN, == LEFT or == RIGHT


cell.dir = dir
//or
cell.face(dir)

Make cell face direction


cell.rot(dir)

Face direction relative to current facing (e.g RIGHT will make cell rotate once right)


cell.get(dir)

Get cell in that direction


cell.look(dir)

Get cell in relative direction (e.g direction FORWARD)


cell.move(dir, force?)

Move in direction

Returns false if failed to move (e.g a wall in the way)


cell.go(dir, force?)

Move cell in relative direction

Returns false if failed to move (e.g a wall in the way)


cell.summon(dir, otherCell, force?)

Summon a cell in direction

Returns null if failed to move (e.g a wall in the way)

Returns the new cell otherwise


cell.make(dir, otherCell, force?)

Summon a cell in relative direction

Returns null if failed to move (e.g a wall in the way)

Returns the new cell otherwise


cell.pop()

Delete cell


cell.explode(colors[])

Make explosion particles (does not delete cell) colors is an array of css colors (e.g ['#f00', '#e22', '#c44'])

Other methods

sound(sound)

Plays a sound. Supported sounds:

  • BEAT
  • BREAK

Texture packs

Like mods, texture pack are a link to a hosted image. Any size will work, but default cells use the arrangement as shown in ./cellset.png, so the recommended size for a texture pack image is 64x64. All textures are 16x16, regardless of texture pack image size or cell definition

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •