CBump Template: Difference between revisions

From GiderosMobile
added content
No edit summary
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
__TOC__
__TOC__
Here you will find various resources to help you create games and apps in Gideros Studio.


<languages />
'''note''': You may have to provide your own assets (fonts, gfx, …).


<translate><!--T:1--> Here you will find various resources to help you create games and apps in Gideros Studio.</translate>
=== Description ===
 
 
<translate><!--T:2--> '''note''': You may have to provide your own assets (fonts, gfx, …).</translate>
 
 
=== <translate>Description</translate> ===
 
<translate><!--T:3-->
This section deals with various ways to use CBump.
This section deals with various ways to use CBump.
</translate>


=== Using CBump and TILED (handles collisions) ===
It's easy: you draw your map with Tile then you export your map to a lua file.<br/>
The class handles tile collisions automatically.


=== <translate>Using CBump and TILED (handles collisions)</translate> ===
<syntaxhighlight lang="lua">
 
<source lang="lua">
-- usage
-- usage
--local map = CBumpTiled.new("tiled/test.lua", world, bg, true)
--local map = CBumpTiled.new("tiled/test.lua", world, bg, true)
Line 122: Line 115:
end
end
end
end
</source>
</syntaxhighlight>
 


==== <translate>Usage</translate> ====
'''Usage'''


This is an example of how to set up CBump and TILED.
This is an example of how to set up CBump and TILED.
 
<syntaxhighlight lang="lua">
 
<source lang="lua">
-- cbump
-- cbump
local cbump = require "cbump"
local cbump = require "cbump"
local world = cbump.newWorld() -- default is 64
-- Constructor: BumpWorld.new([cellSize = 64])
local world = BumpWorld.new()


-- camera
-- camera
local camera = Sprite.new()
local camera = Sprite.new()
local bg = Sprite.new()
local bg = Sprite.new()
bg:setColorTransform(255/255, 0/255, 0/255, 255/255)
local fg = Sprite.new()
local fg = Sprite.new()
camera:setScale(1)
camera:addChild(bg)
camera:addChild(bg)
camera:addChild(fg)
camera:addChild(fg)
Line 147: Line 136:
-- tiled
-- tiled
local map = CBumpTiled.new("tiled/test.lua", world, bg, true)
local map = CBumpTiled.new("tiled/test.lua", world, bg, true)
</source>
</syntaxhighlight>
<br/>
 
=== A Full CBump Platformer Level with enemies, collectibles, exit,... ===
This class is an example of a full CBump platformer level using TILED as a map editor. Please note that you need to modify the code depending on your assets path. Enjoy!
<syntaxhighlight lang="lua">
LevelX = Core.class(Sprite)
 
function LevelX:init()
-- BG
application:setBackgroundColor(0x403C38)
 
-- cbump
local cbump = require "cbump"
self.world = cbump.newWorld() -- default is 64*64
 
-- camera
self.camera = Sprite.new()
self.bg = Sprite.new()
self.fg = Sprite.new()
self.camera:setScale(1.75)
self.camera:addChild(self.bg)
self.camera:addChild(self.fg)
self:addChild(self.camera)
 
-- class lists
self.enemies = {}
self.coins = {}
self.bullets = {}
 
-- TILED: the level map
CBumpTiled.new("tiled/level01.lua", self.world, self.bg, true)
-- TILED: process the tiled layers
local level = loadfile("tiled/level01.lua")()
local layers = level.layers
for i = 1, #layers do
local layer = layers[i]
local layerType = layer.type
local layerName = layer.name
 
if layerType == "imagelayer" then
-- process image layer here
 
elseif layerType == "objectgroup" then
local objects = layer.objects
for i = 1, #objects do
local object = objects[i]
local objectName = object.name -- type of object
 
if objectName == "player" then
-- process player start location
self.player1 = Sprite_Maker.new("player1", "gfx/player/HQ_Trooper_all.png", 6, 13, object.x, object.y)
self.player1:setScale(0.9)
self.player1:setAlpha(0.75)
self.player1.lives = 3
self.player1.filter = function(item, other)
if other.name == "coin01" then
return "cross"
elseif other.name == "bullet01" then
return "cross"
elseif other.name == "exit" then
return "cross"
else
return "slide"
end
end
self.fg:addChild(self.player1)
self.world:add(self.player1, self.player1.x, self.player1.y, self.player1.w * self.player1:getScaleX(), self.player1.h * self.player1:getScaleY())
 
elseif objectName == "e01" then
local enemy = Sprite_Maker.new("enemy01", "gfx/nmes/snake.png", 5, 4, object.x, object.y)
enemy:setScale(0.85)
enemy.lives = math.random(2, 4)
enemy.vx = 32
enemy.filter = function(item, other)
if other.name == "enemy01" or other.name == "enemy02" then
--return "cross"
elseif other.name == "exit" then
--return "cross"
else
return "slide"
end
end
self.enemies[#self.enemies + 1] = enemy
self.bg:addChild(enemy)
self.world:add(enemy, enemy.x, enemy.y, enemy.w * enemy:getScaleX(), enemy.h * enemy:getScaleY())
 
elseif objectName == "e02" then
local enemy = Sprite_Maker.new("enemy02", "gfx/nmes/enemy01.png", 23, 4, object.x, object.y)
enemy:setScale(1.25)
enemy.lives = math.random(3, 5)
enemy.vx = 18
enemy.filter = function(item, other)
if other.name == "enemy01" or other.name == "enemy02" then
--return "cross"
elseif other.name == "exit" then
--return "cross"
else
return "slide"
end
end
self.enemies[#self.enemies + 1] = enemy
self.bg:addChild(enemy)
self.world:add(enemy, enemy.x, enemy.y, enemy.w * enemy:getScaleX(), enemy.h * enemy:getScaleY())


elseif objectName == "c01" then
local coin01 = Sprite_Maker.new("coin01", "gfx/coins/coin_20_x01.png", 6, 1, object.x, object.y + 48)
coin01:setAnchorPoint(0.5, 0.5)
self.coins[#self.coins + 1] = coin01
self.bg:addChild(coin01)
self.world:add(coin01, coin01.x, coin01.y, coin01.w * coin01:getScaleX(), coin01.h * coin01:getScaleY())


=== <translate>A Sprite Factory (player, enemies, collectibles...)</translate> ===
elseif objectName == "exit" then
local texture = Texture.new("gfx/doors/door.png")
local tile = Bitmap.new(texture)
tile.name = "exit"
tile:setPosition(object.x, object.y)
self.bg:addChild(tile)
self.world:add(tile, object.x, object.y, tile:getWidth(), tile:getHeight())


This is a sprite factory class where you can control all your characters parameters like speed, animations, ...
else
print("unknown object type")
end
end


else
print("unknown layer type")
end
end


<source lang="lua">
-- AUDIO
Sprite_Maker = Core.class(Sprite)
self.bulletsnd = Sound.new("audio/shoot.wav")
self.coinsnd = Sound.new("audio/coin.wav")


function Sprite_Maker:init(xname, xspritesheet, xcols, xrows, xposx, xposy)
-- LISTENERS
-- settings
self:addEventListener("enterBegin", self.onTransitionInBegin, self)
self.name = xname
self:addEventListener("enterEnd", self.onTransitionInEnd, self)
self.x = xposx
self:addEventListener("exitBegin", self.onTransitionOutBegin, self)
self.y = xposy
self:addEventListener("exitEnd", self.onTransitionOutEnd, self)
self.vx = 0
end
self.vy = 0
self.flip = 1
self.isonfloor = false
self.isattacking = false
self.lives = 1
self.accel = 500
self.maxspeed = 200 -- 150 -- 200
self.jumpspeed = GRAVITY / 1.5


-- animations
-- GAME LOOP
self.currentanim = ""
function LevelX:onEnterFrame(e)
self.frame = 0
-- camera follows player
self.animspeed = 1 / 8
local playerposx, playerposy = self.player1:getPosition()
self.animtimer = self.animspeed
playerposx, playerposy = playerposx * self.camera:getScale(), playerposy * self.camera:getScale()
local offsetX = -(playerposx - application:getContentWidth() / 2 + self.player1:getWidth() / 4 * self.player1:getScaleX())
local offsetY = -(playerposy - (4.5 * 64) * self.camera:getScale() / self.player1:getScale())
self.camera:setPosition(offsetX, offsetY)


-- retrieve all anims in texture
-- player1
local myanimstex = Texture.new(xspritesheet)
if self.player1.lives > 0 then
local cellw = myanimstex:getWidth() / xcols
self:updatePlayer1(self.player1, e.deltaTime)
local cellh = myanimstex:getHeight() / xrows
else
local myanims_list = {}
print("you lose!")
for r = 1, xrows do
-- scenemanager:changeScene("gameover", 3, transitions[6], easing.outBack)
for c = 1, xcols do
end
local myanimstexregion = TextureRegion.new(
-- bullets
myanimstex, (c - 1) * cellw, (r - 1) * cellh, cellw, cellh)
for b = #self.bullets, 1, -1 do
myanims_list[#myanims_list + 1] = myanimstexregion
self:updateBullets(self.bullets[b], e.deltaTime)
end
-- bullets hit
for b = #self.bullets, 1, -1 do
local sprite = self.bullets[b]
if sprite.lives <= 0 then
self.camera:removeChild(sprite)
self.world:remove(sprite)
table.remove(self.bullets, b)
end
end
-- enemies
for n = #self.enemies, 1, -1 do
self:updateEnemies(self.enemies[n], e.deltaTime)
end
-- enemy is dead
for n = #self.enemies, 1, -1 do
local sprite = self.enemies[n]
if sprite.lives <= 0 then
self.bg:removeChild(sprite)
self.world:remove(sprite)
table.remove(self.enemies, n)
end
end
-- coins
for c = #self.coins, 1, -1 do
self:updateCollectibles(self.coins[c], e.deltaTime)
end
-- collectibles collected
for c = #self.coins, 1, -1 do
local sprite = self.coins[c]
if sprite.lives <= 0 then
self.bg:removeChild(sprite)
self.world:remove(sprite)
table.remove(self.coins, c)
end
end
end
end
end
-- FUNCTIONS
function LevelX:updatePlayer1(xsprite, dt)
-- player1 pushed by gravity
xsprite.vy += GRAVITY * dt


-- create anims
-- cbump
self.anims = {}
local goalx = xsprite.x + xsprite.vx * dt
if self.name == "player1" then
local goaly = xsprite.y + xsprite.vy * dt
self:createAnim("idle", 1, 2, myanims_list)
local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
self:createAnim("jump_up", 38, 38, myanims_list)
-- collisions
self:createAnim("jump_down", 39, 39, myanims_list)
for i = 1, len do
self:createAnim("walk", 13, 16, myanims_list)
local col = collisions[i]
elseif self.name == "enemy01" then
-- collectibles collisions
self:createAnim("walk", 1, 7, myanims_list)
if col.other.name == "coin01" then
elseif self.name == "enemy02" then
local sound = self.coinsnd:play()
self:createAnim("walk", 1, 5, myanims_list)
sound:setVolume(0.1)
elseif self.name == "coin01" then
col.other.lives -= 1
self:createAnim("walk", 1, 6, myanims_list)
end
-- enemy collision
if col.other.name == "enemy01" or col.other.name == "enemy02" then
if col.normal.y == -1 then
col.other.lives -= 1
col.item.isattacking = true
end
end
-- sprite collides top or bottom
if col.normal.y == 1 or col.normal.y == -1 then
if col.other.name == "coin01" or col.other.name == "exit" then
-- nothing here
else
col.item.vy = 0
end
end
-- sprite is on floor
if col.normal.y == -1 then
if col.other.name == "coin01" then
col.item.isonfloor = false
elseif col.item.isattacking then
col.item.vy = -col.item.jumpspeed / 1.5
col.item.isonfloor = false
col.item.isattacking = false
else
col.item.isonfloor = true
end
end
-- EXIT
if col.other.name == "exit" then
if #self.coins == 0 then
g_level += 1
if g_level == 4 then
-- scenemanager:changeScene("youwin", 5, transitions[21], easing.outBack)
print("you win!")
g_level = 1
end
scenemanager:changeScene("levelx", 2, transitions[2], easing.outBack)
end
end
end
end


-- the bitmap
-- anim state
self.bmp = Bitmap.new(myanims_list[1]) -- starting bmp texture
if xsprite.isonfloor then
self.bmp:setAnchorPoint(0.5, 0.5)
if xsprite.isshooting then
if self.name == "player1" then
xsprite.currentanim = "shoot"
self.w = self.bmp:getWidth() / 2
else
self.h = self.bmp:getHeight() - 6
if xsprite.vx == 0 then
-- set position inside sprite
xsprite.currentanim = "idle"
self.bmp:setPosition(self.w / 2, self.h / 2 - 6 / 2)
elseif xsprite.vx ~= 0 then
elseif self.name == "enemy01" then
xsprite.currentanim = "walk"
self.w = self.bmp:getWidth() / 2
end
self.h = self.bmp:getHeight() - 12
end
-- set position inside sprite
self.bmp:setPosition(self.w / 2, self.h / 2 - 12 / 2)
elseif self.name == "enemy02" then
self.w = self.bmp:getWidth() / 8
self.h = self.bmp:getHeight() - 38
-- set position inside sprite
self.bmp:setPosition(self.w / 2, self.h / 2 - 38 / 2 + 6)
else
else
self.w = self.bmp:getWidth()
if xsprite.vy < 0 then
self.h = self.bmp:getHeight()
xsprite.currentanim = "jump_up"
-- set position inside sprite
elseif xsprite.vy >= 0 then
self.bmp:setPosition(self.w / 2, self.h / 2)
xsprite.currentanim = "jump_down"
end
end
 
-- keyboard handling
if xsprite.iskeyright then
xsprite.vx += xsprite.accel * dt
if xsprite.vx > xsprite.maxspeed then xsprite.vx = xsprite.maxspeed end
xsprite.flip = 1
elseif xsprite.iskeyleft then
xsprite.vx -= xsprite.accel * dt
if xsprite.vx < -xsprite.maxspeed then xsprite.vx = -xsprite.maxspeed end
xsprite.flip = -1
else
xsprite.vx = 0
end
if xsprite.iskeyup then
if xsprite.isonfloor then
xsprite.vy = -xsprite.jumpspeed
xsprite.isonfloor = false
end
end
if xsprite.iskeyspace then
self:shoot()
xsprite.vx = -96 * xsprite.flip
xsprite.isshooting = true
xsprite.iskeyspace = false
end
end


-- collisions debugging
-- anim loop
local mypixel = Pixel.new(0xff0000, 0.5, self.w, self.h)
if xsprite.currentanim ~= "" then
xsprite.animtimer = xsprite.animtimer - dt
if xsprite.animtimer <= 0 then
xsprite.frame += 1
xsprite.animtimer = xsprite.animspeed
if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
xsprite.frame = 1
xsprite.isshooting = false
end
xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
end
end
 
-- move & flip
xsprite.x = nextx
xsprite.y = nexty
xsprite:setPosition(xsprite.x, xsprite.y)
xsprite.bmp:setScale(xsprite.flip, 1)
end


-- our sprite is ready
function LevelX:shoot()
local mysprite = Sprite.new()
local sound = self.bulletsnd:play()
mysprite:addChild(self.bmp)
sound:setVolume(0.1)
-- mysprite:addChild(mypixel) -- debug
local bullet01 = Sprite_Maker.new("bullet01", "gfx/bullets/laser_01.png", 1, 1,
self:addChild(mysprite)
self.player1.x + (self.player1.w * self.player1.flip), self.player1.y + 16)
bullet01:setScale(1.1)
bullet01.vx = 2 * self.player1.accel * self.player1.flip
bullet01.flip = self.player1.flip
bullet01.filter = function(item, other)
if other.name == "player1" then
-- nothing here
elseif other.name == "coin01" then
-- nothing here
elseif other.name == "enemy01" or other.name == "enemy02" then
if math.abs(other.x - self.player1.x) < application:getContentWidth() / 2 - other.w then
return "slide"
else
return "slide"
end
else
return "slide"
end
end
self.bullets[#self.bullets + 1] = bullet01
self.camera:addChild(bullet01)
self.world:add(bullet01, bullet01.x, bullet01.y,
bullet01.w * bullet01:getScaleX(), bullet01.h * bullet01:getScaleY())
end


-- hero controls
function LevelX:updateBullets(xsprite, dt)
if self.name == "player1" then
-- mouvement
self.iskeyleft = false
xsprite.vx += dt
self.iskeyright = false
-- xsprite.vy += 50
self.iskeyup = false
self.iskeydown = false
self.iskeyspace = false


self:addEventListener(Event.KEY_DOWN, self.onKeyDown, self)
-- cbump
self:addEventListener(Event.KEY_UP, self.onKeyUp, self)
local goalx = xsprite.x + xsprite.vx * dt
local goaly = xsprite.y + xsprite.vy * dt
local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
for i = 1, len do
local col = collisions[i]
if col.other.name == "enemy01" or col.other.name == "enemy02" then
if math.abs(col.other.x - self.player1.x) < application:getContentWidth() / 2 - col.other.w then
col.other:setColorTransform(0, 1, 1, 0.5)
col.other.lives -= 1
col.item.lives -= 1
col.other.vx = 96 * col.other.flip
for t = 1, 1000000 do -- tip from pro
t += 1
end
end
else
-- nothing here!
end
col.item.lives -= 1
end
end
-- move & flip
xsprite.x = nextx
xsprite.y = nexty
xsprite:setPosition(xsprite.x, xsprite.y)
xsprite.bmp:setScale(xsprite.flip, 1)
end
end


-- FUNCTIONS
function LevelX:updateEnemies(xsprite, dt)
function Sprite_Maker:createAnim(xanimname, xstart, xfinish, xanimslist)
-- pushed by gravity
self.anims[xanimname] = {}
xsprite.vy += GRAVITY * dt
for i = xstart, xfinish do
 
self.anims[xanimname][#self.anims[xanimname] + 1] = xanimslist[i]
-- cbump
local goalx = xsprite.x + xsprite.vx * dt
local goaly = xsprite.y + xsprite.vy * dt
local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
-- collisions
for i = 1, len do
local col = collisions[i]
-- sprite collides top or bottom
if col.other.name == "player1" then
col.other.lives -= 1
print("player lives: "..col.other.lives)
end
if col.normal.y == 1 or col.normal.y == -1 then
col.item.vy = 0
end
if col.normal.x == 1 or col.normal.x == -1 then
col.item.vx = -col.item.vx
col.item.flip = -col.item.flip
end
-- sprite is on floor
if col.normal.y == -1 then
col.item.isonfloor = true
end
end
 
-- anim state
if xsprite.isonfloor then
if xsprite.vx == 0 then
xsprite.currentanim = "walk"
elseif xsprite.vx ~= 0 then
xsprite.currentanim = "walk"
end
end
 
-- anim loop
if xsprite.currentanim ~= "" then
xsprite.animtimer = xsprite.animtimer - dt
if xsprite.animtimer <= 0 then
xsprite.frame += 1
xsprite.animtimer = xsprite.animspeed
if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
xsprite.frame = 1
end
xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
xsprite:setColorTransform(1, 1, 1, 1)
end
end
 
-- move & flip
xsprite.x = nextx
xsprite.y = nexty
xsprite:setPosition(xsprite.x, xsprite.y)
xsprite.bmp:setScale(xsprite.flip, 1)
end
 
function LevelX:updateCollectibles(xsprite, dt)
-- anim state
xsprite.currentanim = "walk"
 
-- anim loop
if xsprite.currentanim ~= "" then
xsprite.animtimer = xsprite.animtimer - dt
if xsprite.animtimer <= 0 then
xsprite.frame += 1
xsprite.animtimer = xsprite.animspeed
if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
xsprite.frame = 1
end
xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
end
end
end
-- show
xsprite:setPosition(xsprite.x, xsprite.y)
-- xsprite.bmp:setScale(xsprite.flip, 1)
end
-- EVENT LISTENERS
function LevelX:onTransitionInBegin()
self:addEventListener(Event.ENTER_FRAME, self.onEnterFrame, self)
end
function LevelX:onTransitionInEnd()
self:myKeysPressed()
-- mobile controls
-- local mymobile = MobileX.new(self.player1)
-- self:addChild(mymobile)
end
function LevelX:onTransitionOutBegin()
self:removeEventListener(Event.ENTER_FRAME, self.onEnterFrame, self)
end
function LevelX:onTransitionOutEnd()
end
end


-- KEYS HANDLER
-- KEYS HANDLER
function Sprite_Maker:onKeyDown(e)
function LevelX:myKeysPressed()
-- keys pressed
self:addEventListener(Event.KEY_DOWN, function(e)
if e.keyCode == KeyCode.LEFT then self.iskeyleft = true end
-- for mobiles and desktops
if e.keyCode == KeyCode.RIGHT then self.iskeyright = true end
if e.keyCode == KeyCode.BACK or e.keyCode == KeyCode.ESC then
if e.keyCode == KeyCode.UP then self.iskeyup = true end
-- scenemanager:changeScene("menu", 1, transitions[2], easing.outBack)
if e.keyCode == KeyCode.DOWN then self.iskeydown = true end
end
if e.keyCode == KeyCode.SPACE then self.iskeyspace = true end
end)
end
end
</syntaxhighlight>
=== A YouTube Video ===
A step by step video on how to use this platformer template. Enjoy!
<youtube>https://www.youtube.com/watch?v=WPcbsgOCnLU</youtube>


function Sprite_Maker:onKeyUp(e)
 
-- keys released
{{GIDEROS IMPORTANT LINKS}}
if e.keyCode == KeyCode.LEFT then self.iskeyleft = false end
if e.keyCode == KeyCode.RIGHT then self.iskeyright = false end
if e.keyCode == KeyCode.UP then self.iskeyup = false end
if e.keyCode == KeyCode.DOWN then self.iskeydown = false end
if e.keyCode == KeyCode.SPACE then self.iskeyspace = false end
end
</source>
<br/>
<br/>

Latest revision as of 21:54, 18 November 2023

Here you will find various resources to help you create games and apps in Gideros Studio.

note: You may have to provide your own assets (fonts, gfx, …).

Description

This section deals with various ways to use CBump.

Using CBump and TILED (handles collisions)

It's easy: you draw your map with Tile then you export your map to a lua file.
The class handles tile collisions automatically.

-- usage
--local map = CBumpTiled.new("tiled/test.lua", world, bg, true)
-- where world is the cbump world
-- bg is a sprite layer (here a background sprite layer)
-- true if only foreground is added to cbump collision world

CBumpTiled = Core.class(Sprite)

local function gid2tileset(map, gid)
	for i = 1, #map.tilesets do
		local tileset = map.tilesets[i]
		if tileset.firstgid <= gid and gid <= tileset.lastgid then
			return tileset
		end
	end
end

function CBumpTiled:init(filename, xworld, xlayer, xtop)
	-- Bits on the far end of the 32-bit global tile ID are used for tile flags (flip, rotate)
	local FLIPPED_HORIZONTALLY_FLAG = 0x80000000;
	local FLIPPED_VERTICALLY_FLAG   = 0x40000000;
	local FLIPPED_DIAGONALLY_FLAG   = 0x20000000;
	local map = loadfile(filename)()
	for i = 1, #map.tilesets do
		local tileset = map.tilesets[i]
		tileset.sizex = math.floor((tileset.imagewidth - tileset.margin + tileset.spacing) / (tileset.tilewidth + tileset.spacing))
		tileset.sizey = math.floor((tileset.imageheight - tileset.margin + tileset.spacing) / (tileset.tileheight + tileset.spacing))
		tileset.lastgid = tileset.firstgid + (tileset.sizex * tileset.sizey) - 1
		tileset.texture = Texture.new(tileset.image, false, {transparentColor = tonumber(tileset.transparentcolor)})
	end
	for i = 1, #map.layers do
		if map.layers[i].type == "tilelayer" then
			local layer = map.layers[i]
			local tilemaps = {}
			for y = 1, layer.height do
				for x = 1, layer.width do
					local i = x + (y - 1) * layer.width
					local gid = layer.data[i]
					if gid ~= 0 then
						-- Read flipping flags
						flipHor = gid & FLIPPED_HORIZONTALLY_FLAG
						flipVer = gid & FLIPPED_VERTICALLY_FLAG
						flipDia = gid & FLIPPED_DIAGONALLY_FLAG
						-- Convert flags to gideros style
						if(flipHor ~= 0) then flipHor = TileMap.FLIP_HORIZONTAL end
						if(flipVer ~= 0) then flipVer = TileMap.FLIP_VERTICAL end
						if(flipDia ~= 0) then flipDia = TileMap.FLIP_DIAGONAL end
						-- Clear the flags from gid so other information is healthy
						gid = gid & ~ (
							FLIPPED_HORIZONTALLY_FLAG |
							FLIPPED_VERTICALLY_FLAG |
							FLIPPED_DIAGONALLY_FLAG
						)
					end

					local tileset = gid2tileset(map, gid)
					if tileset then
						local tilemap = nil
						tilemap = TileMap.new(
							layer.width, 
							layer.height,
							tileset.texture,
							tileset.tilewidth,
							tileset.tileheight,
							tileset.spacing,
							tileset.spacing,
							tileset.margin,
							tileset.margin,
							map.tilewidth,
							map.tileheight
						)
						tilemaps[tileset] = tilemap
						local tx = (gid - tileset.firstgid) % tileset.sizex + 1
						local ty = math.floor((gid - tileset.firstgid) / tileset.sizex) + 1
						-- Set the tile with flip info
						tilemap:setTile(x, y, tx, ty, (flipHor | flipVer | flipDia))
						xlayer:addChild(tilemap)
						xlayer:setAlpha(layer.opacity)
						if xtop then
							if layer.id == 1 then
								xworld:add(
									tilemap,
									(x - 1) * tileset.tilewidth * xlayer:getScaleX(),
									(y - 1) * tileset.tileheight * xlayer:getScaleY(),
									tileset.tilewidth * xlayer:getScaleX(),
									tileset.tileheight * xlayer:getScaleY()
								)
							end
						else
							xworld:add(
								tilemap,
								(x - 1) * tileset.tilewidth * xlayer:getScaleX(),
								(y - 1) * tileset.tileheight * xlayer:getScaleY(),
								tileset.tilewidth * xlayer:getScaleX(),
								tileset.tileheight * xlayer:getScaleY()
							)
						end
					end
				end
			end
		end
	end
end

Usage

This is an example of how to set up CBump and TILED.

-- cbump
local cbump = require "cbump"
-- Constructor: BumpWorld.new([cellSize = 64])
local world = BumpWorld.new()

-- camera
local camera = Sprite.new()
local bg = Sprite.new()
local fg = Sprite.new()
camera:addChild(bg)
camera:addChild(fg)
stage:addChild(camera)

-- tiled
local map = CBumpTiled.new("tiled/test.lua", world, bg, true)

A Full CBump Platformer Level with enemies, collectibles, exit,...

This class is an example of a full CBump platformer level using TILED as a map editor. Please note that you need to modify the code depending on your assets path. Enjoy!

LevelX = Core.class(Sprite)

function LevelX:init()
	-- BG
	application:setBackgroundColor(0x403C38)

	-- cbump
	local cbump = require "cbump"
	self.world = cbump.newWorld() -- default is 64*64

	-- camera
	self.camera = Sprite.new()
	self.bg = Sprite.new()
	self.fg = Sprite.new()
	self.camera:setScale(1.75)
	self.camera:addChild(self.bg)
	self.camera:addChild(self.fg)
	self:addChild(self.camera)

	-- class lists
	self.enemies = {}
	self.coins = {}
	self.bullets = {}

	-- TILED: the level map
	CBumpTiled.new("tiled/level01.lua", self.world, self.bg, true)
	
	-- TILED: process the tiled layers
	local level = loadfile("tiled/level01.lua")()
	local layers = level.layers
	for i = 1, #layers do
		local layer = layers[i]
		local layerType = layer.type
		local layerName = layer.name

		if layerType == "imagelayer" then
			-- process image layer here

		elseif layerType == "objectgroup" then
			local objects = layer.objects
			for i = 1, #objects do
				local object = objects[i]
				local objectName = object.name -- type of object

				if objectName == "player" then
					-- process player start location
					self.player1 = Sprite_Maker.new("player1", "gfx/player/HQ_Trooper_all.png", 6, 13, object.x, object.y)
					self.player1:setScale(0.9)
					self.player1:setAlpha(0.75)
					self.player1.lives = 3
					self.player1.filter = function(item, other)
						if other.name == "coin01" then
							return "cross"
						elseif other.name == "bullet01" then
							return "cross"
						elseif other.name == "exit" then
							return "cross"
						else
							return "slide"
						end
					end
					self.fg:addChild(self.player1)
					self.world:add(self.player1, self.player1.x, self.player1.y, self.player1.w * self.player1:getScaleX(), self.player1.h * self.player1:getScaleY())

				elseif objectName == "e01" then
					local enemy = Sprite_Maker.new("enemy01", "gfx/nmes/snake.png", 5, 4, object.x, object.y)
					enemy:setScale(0.85)
					enemy.lives = math.random(2, 4)
					enemy.vx = 32
					enemy.filter = function(item, other)
						if other.name == "enemy01" or other.name == "enemy02" then
							--return "cross"
						elseif other.name == "exit" then
							--return "cross"
						else
							return "slide"
						end
					end
					self.enemies[#self.enemies + 1] = enemy
					self.bg:addChild(enemy)
					self.world:add(enemy, enemy.x, enemy.y, enemy.w * enemy:getScaleX(), enemy.h * enemy:getScaleY())

				elseif objectName == "e02" then
					local enemy = Sprite_Maker.new("enemy02", "gfx/nmes/enemy01.png", 23, 4, object.x, object.y)
					enemy:setScale(1.25)
					enemy.lives = math.random(3, 5)
					enemy.vx = 18
					enemy.filter = function(item, other)
						if other.name == "enemy01" or other.name == "enemy02" then
							--return "cross"
						elseif other.name == "exit" then
							--return "cross"
						else
							return "slide"
						end
					end
					self.enemies[#self.enemies + 1] = enemy
					self.bg:addChild(enemy)
					self.world:add(enemy, enemy.x, enemy.y, enemy.w * enemy:getScaleX(), enemy.h * enemy:getScaleY())

				elseif objectName == "c01" then
					local coin01 = Sprite_Maker.new("coin01", "gfx/coins/coin_20_x01.png", 6, 1, object.x, object.y + 48)
					coin01:setAnchorPoint(0.5, 0.5)
					self.coins[#self.coins + 1] = coin01
					self.bg:addChild(coin01)
					self.world:add(coin01, coin01.x, coin01.y, coin01.w * coin01:getScaleX(), coin01.h * coin01:getScaleY())

				elseif objectName == "exit" then
					local texture = Texture.new("gfx/doors/door.png")
					local tile = Bitmap.new(texture)
					tile.name = "exit"
					tile:setPosition(object.x, object.y)
					self.bg:addChild(tile)
					self.world:add(tile, object.x, object.y, tile:getWidth(), tile:getHeight())

				else
					print("unknown object type")
				end
			end

		else
			print("unknown layer type")
		end
	end

	-- AUDIO
	self.bulletsnd = Sound.new("audio/shoot.wav")
	self.coinsnd = Sound.new("audio/coin.wav")

	-- LISTENERS
	self:addEventListener("enterBegin", self.onTransitionInBegin, self)
	self:addEventListener("enterEnd", self.onTransitionInEnd, self)
	self:addEventListener("exitBegin", self.onTransitionOutBegin, self)
	self:addEventListener("exitEnd", self.onTransitionOutEnd, self)
end

-- GAME LOOP
function LevelX:onEnterFrame(e)
	-- camera follows player
	local playerposx, playerposy = self.player1:getPosition()
	playerposx, playerposy = playerposx * self.camera:getScale(), playerposy * self.camera:getScale()
	local offsetX = -(playerposx - application:getContentWidth() / 2 + self.player1:getWidth() / 4 * self.player1:getScaleX())
	local offsetY = -(playerposy - (4.5 * 64) * self.camera:getScale() / self.player1:getScale())
	self.camera:setPosition(offsetX, offsetY)

	-- player1
	if self.player1.lives > 0 then
		self:updatePlayer1(self.player1, e.deltaTime)
	else
		print("you lose!")
--		scenemanager:changeScene("gameover", 3, transitions[6], easing.outBack)
	end
	-- bullets
	for b = #self.bullets, 1, -1 do
		self:updateBullets(self.bullets[b], e.deltaTime)
	end
	-- bullets hit
	for b = #self.bullets, 1, -1 do
		local sprite = self.bullets[b]
		if sprite.lives <= 0 then
			self.camera:removeChild(sprite)
			self.world:remove(sprite)
			table.remove(self.bullets, b)
		end
	end
	-- enemies
	for n = #self.enemies, 1, -1 do
		self:updateEnemies(self.enemies[n], e.deltaTime)
	end
	-- enemy is dead
	for n = #self.enemies, 1, -1 do
		local sprite = self.enemies[n]
		if sprite.lives <= 0 then
			self.bg:removeChild(sprite)
			self.world:remove(sprite)
			table.remove(self.enemies, n)
		end
	end
	-- coins
	for c = #self.coins, 1, -1 do
		self:updateCollectibles(self.coins[c], e.deltaTime)
	end
	-- collectibles collected
	for c = #self.coins, 1, -1 do
		local sprite = self.coins[c]
		if sprite.lives <= 0 then
			self.bg:removeChild(sprite)
			self.world:remove(sprite)
			table.remove(self.coins, c)
		end
	end
end

-- FUNCTIONS
function LevelX:updatePlayer1(xsprite, dt)
	-- player1 pushed by gravity
	xsprite.vy += GRAVITY * dt

	-- cbump
	local goalx = xsprite.x + xsprite.vx * dt
	local goaly = xsprite.y + xsprite.vy * dt
	local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
	-- collisions
	for i = 1, len do
		local col = collisions[i]
		-- collectibles collisions
		if col.other.name == "coin01" then
			local sound = self.coinsnd:play()
			sound:setVolume(0.1)
			col.other.lives -= 1
		end
		-- enemy collision
		if col.other.name == "enemy01" or col.other.name == "enemy02" then
			if col.normal.y == -1 then
				col.other.lives -= 1
				col.item.isattacking = true
			end
		end
		-- sprite collides top or bottom
		if col.normal.y == 1 or col.normal.y == -1 then
			if col.other.name == "coin01" or col.other.name == "exit" then
				-- nothing here
			else
				col.item.vy = 0
			end
		end
		-- sprite is on floor
		if col.normal.y == -1 then
			if col.other.name == "coin01" then
				col.item.isonfloor = false
			elseif col.item.isattacking then
				col.item.vy = -col.item.jumpspeed / 1.5
				col.item.isonfloor = false
				col.item.isattacking = false
			else
				col.item.isonfloor = true
			end
		end
		-- EXIT
		if col.other.name == "exit" then
			if #self.coins == 0 then
				g_level += 1
				if g_level == 4 then
--					scenemanager:changeScene("youwin", 5, transitions[21], easing.outBack)
					print("you win!")
					g_level = 1
				end
				scenemanager:changeScene("levelx", 2, transitions[2], easing.outBack)
			end
		end
	end

	-- anim state
	if xsprite.isonfloor then
		if xsprite.isshooting then
			xsprite.currentanim = "shoot"
		else
			if xsprite.vx == 0 then
				xsprite.currentanim = "idle"
			elseif xsprite.vx ~= 0 then
				xsprite.currentanim = "walk"
			end
		end
	else
		if xsprite.vy < 0 then
			xsprite.currentanim = "jump_up"
		elseif xsprite.vy >= 0 then
			xsprite.currentanim = "jump_down"
		end
	end

	-- keyboard handling
	if xsprite.iskeyright then
		xsprite.vx += xsprite.accel * dt
		if xsprite.vx > xsprite.maxspeed then xsprite.vx = xsprite.maxspeed end
		xsprite.flip = 1
	elseif xsprite.iskeyleft then
		xsprite.vx -= xsprite.accel * dt
		if xsprite.vx < -xsprite.maxspeed then xsprite.vx = -xsprite.maxspeed end
		xsprite.flip = -1
	else
		xsprite.vx = 0
	end
	if xsprite.iskeyup then
		if xsprite.isonfloor then
			xsprite.vy = -xsprite.jumpspeed
			xsprite.isonfloor = false
		end
	end
	if xsprite.iskeyspace then
		self:shoot()
		xsprite.vx = -96 * xsprite.flip
		xsprite.isshooting = true
		xsprite.iskeyspace = false
	end

	-- anim loop
	if xsprite.currentanim ~= "" then
		xsprite.animtimer = xsprite.animtimer - dt
		if xsprite.animtimer <= 0 then
			xsprite.frame += 1
			xsprite.animtimer = xsprite.animspeed
			if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
				xsprite.frame = 1
				xsprite.isshooting = false
			end
			xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
		end
	end

	-- move & flip
	xsprite.x = nextx
	xsprite.y = nexty
	xsprite:setPosition(xsprite.x, xsprite.y)
	xsprite.bmp:setScale(xsprite.flip, 1)
end

function LevelX:shoot()
	local sound = self.bulletsnd:play()
	sound:setVolume(0.1)
	local bullet01 = Sprite_Maker.new("bullet01", "gfx/bullets/laser_01.png", 1, 1,
			self.player1.x + (self.player1.w * self.player1.flip), self.player1.y + 16)
	bullet01:setScale(1.1)
	bullet01.vx = 2 * self.player1.accel * self.player1.flip
	bullet01.flip = self.player1.flip
	bullet01.filter = function(item, other)
		if other.name == "player1" then
			-- nothing here
		elseif other.name == "coin01" then
			-- nothing here
		elseif other.name == "enemy01" or other.name == "enemy02" then
			if math.abs(other.x - self.player1.x) < application:getContentWidth() / 2 - other.w then
				return "slide"
			else
				return "slide"
 			end
		else
			return "slide"
		end
	end
	self.bullets[#self.bullets + 1] = bullet01
	self.camera:addChild(bullet01)
	self.world:add(bullet01, bullet01.x, bullet01.y,
		bullet01.w * bullet01:getScaleX(), bullet01.h * bullet01:getScaleY())
end

function LevelX:updateBullets(xsprite, dt)
	-- mouvement
	xsprite.vx += dt
--	xsprite.vy += 50

	-- cbump
	local goalx = xsprite.x + xsprite.vx * dt
	local goaly = xsprite.y + xsprite.vy * dt
	local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
	for i = 1, len do
		local col = collisions[i]
		if col.other.name == "enemy01" or col.other.name == "enemy02" then
			if math.abs(col.other.x - self.player1.x) < application:getContentWidth() / 2 - col.other.w then
				col.other:setColorTransform(0, 1, 1, 0.5)
				col.other.lives -= 1
				col.item.lives -= 1
				col.other.vx = 96 * col.other.flip
				for t = 1, 1000000 do -- tip from pro
					t += 1
				end
			end
		else
			-- nothing here!
		end
		col.item.lives -= 1
	end

	-- move & flip
	xsprite.x = nextx
	xsprite.y = nexty
	xsprite:setPosition(xsprite.x, xsprite.y)
	xsprite.bmp:setScale(xsprite.flip, 1)
end

function LevelX:updateEnemies(xsprite, dt)
	-- pushed by gravity
	xsprite.vy += GRAVITY * dt

	-- cbump
	local goalx = xsprite.x + xsprite.vx * dt
	local goaly = xsprite.y + xsprite.vy * dt
	local nextx, nexty, collisions, len = self.world:move(xsprite, goalx, goaly, xsprite.filter)
	-- collisions
	for i = 1, len do
		local col = collisions[i]
		-- sprite collides top or bottom
		if col.other.name == "player1" then
			col.other.lives -= 1
			print("player lives: "..col.other.lives)
		end
		if col.normal.y == 1 or col.normal.y == -1 then
			col.item.vy = 0
		end
		if col.normal.x == 1 or col.normal.x == -1 then
			col.item.vx = -col.item.vx
			col.item.flip = -col.item.flip
		end
		-- sprite is on floor
		if col.normal.y == -1 then
			col.item.isonfloor = true
		end
	end

	-- anim state
	if xsprite.isonfloor then
		if xsprite.vx == 0 then
			xsprite.currentanim = "walk"
		elseif xsprite.vx ~= 0 then
			xsprite.currentanim = "walk"
		end
	end

	-- anim loop
	if xsprite.currentanim ~= "" then
		xsprite.animtimer = xsprite.animtimer - dt
		if xsprite.animtimer <= 0 then
			xsprite.frame += 1
			xsprite.animtimer = xsprite.animspeed
			if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
				xsprite.frame = 1
			end
			xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
			xsprite:setColorTransform(1, 1, 1, 1)
		end
	end

	-- move & flip
	xsprite.x = nextx
	xsprite.y = nexty
	xsprite:setPosition(xsprite.x, xsprite.y)
	xsprite.bmp:setScale(xsprite.flip, 1)
end

function LevelX:updateCollectibles(xsprite, dt)
	-- anim state
	xsprite.currentanim = "walk"

	-- anim loop
	if xsprite.currentanim ~= "" then
		xsprite.animtimer = xsprite.animtimer - dt
		if xsprite.animtimer <= 0 then
			xsprite.frame += 1
			xsprite.animtimer = xsprite.animspeed
			if xsprite.frame > #xsprite.anims[xsprite.currentanim] then
				xsprite.frame = 1
			end
			xsprite.bmp:setTextureRegion(xsprite.anims[xsprite.currentanim][xsprite.frame])
		end
	end

	-- show
	xsprite:setPosition(xsprite.x, xsprite.y)
--	xsprite.bmp:setScale(xsprite.flip, 1)
end

-- EVENT LISTENERS
function LevelX:onTransitionInBegin()
	self:addEventListener(Event.ENTER_FRAME, self.onEnterFrame, self)
end

function LevelX:onTransitionInEnd()
	self:myKeysPressed()
	-- mobile controls
--	local mymobile = MobileX.new(self.player1)
--	self:addChild(mymobile)
end

function LevelX:onTransitionOutBegin()
	self:removeEventListener(Event.ENTER_FRAME, self.onEnterFrame, self)
end

function LevelX:onTransitionOutEnd()
end

-- KEYS HANDLER
function LevelX:myKeysPressed()
	self:addEventListener(Event.KEY_DOWN, function(e)
		-- for mobiles and desktops
		if e.keyCode == KeyCode.BACK or e.keyCode == KeyCode.ESC then
--			scenemanager:changeScene("menu", 1, transitions[2], easing.outBack)
		end
	end)
end

A YouTube Video

A step by step video on how to use this platformer template. Enjoy!