2D Space Shooter Part 6: Enemies

From GiderosMobile

This won't be a space shooter without enemies to shoot at. Let's define our enemies.

Again we will subclass our ship class for enemies.

Create a new file named 'enemy.lua'. This new file will depend on the Ship Class too (we will use Gideros code dependency by code).

Enemy class

Enemies will come from the top of the screen, so ships will head toward the bottom.

--!NEEDS:ships.lua
EnemyShip = Core.class(Ship)

function EnemyShip:init(type, x, y)
	self.posx = x
	self.posy = y
	self:setRotation(180)
	self.fire = true
	ENEMIES_LAYER:addChild(self)
end

function EnemyShip:advance(amount)
	self.posy += amount
end

function EnemyShip:tick(delay)
	self:setPosition(self.posx, self.posy)
	Ship.tick(self, delay)
end

function EnemyShip:explode()
	-- here we could show some explosion animation and play a sound
	self:destroy()
end

Level Management

Now we need to make the enemies appear in waves. This part is a bit trickier, as it involves choosing a format to design our levels.

I decided to use a plain text representation:

  • enemies will be placed in up to five positions on each row, possibly spanning multiple rows
  • each line of our level definition will be six character long: one character for each 6 possible position, indicating if a ship will be spawn at that location, which kind of ship, plus a sixth character to control the ship waves
  • the sixth character with tell how much time to wait before the next row of ship shows up, or whether the row is the last of a wave

In a new file called level.lua, we define our level manager, starting by our first (and only in this tutorial) level.

local LEVEL1 = [[
..A..0
.....!
.A.A.0
.....!
..A..1
.A...1
...A.0
.....!
..A..0
.B.B.0
.....!
A...A0
..C..0
.....!
]]

local LEVELS = { LEVEL1 }

So this is our 1st level data. We can almost see how ships will be shown on screen.

Now, below LEVELS, we add our loading (init) and sequencing (tick) code:

local SCROLL_DELTA = 0.02

Level = Core.class(Object)

function Level:init(number)
	-- will hold our level info
	self.levelinfo = {}
	-- will hold our position in the level
	self.levelline = 1
	-- hold all the enemy ships in the current wave
	self.enemy_wave = {}
	-- hold the enemy line scroll amount
	self.scroll = 0
	-- fill in level info
	for level_line in LEVELS[number]:gmatch("[%w%p]+") do
		assert(#level_line == 6, "Level description line is not 6 characters long.")
		local wait = tonumber(level_line:sub(6)) or 0
		local clear = level_line:sub(6) == "!" -- this is a boolean
		table.insert(self.levelinfo, { enemies=level_line:sub(1,5), wait=wait, clear=clear } )
	end
	-- register as a wave level
	LEVELS_WAVES[self] = true
end

function Level:tick(delay)
	if self.scroll == 0 then
		-- not started scrolling: build an enemy row
		local lineinfo = self.levelinfo[self.levelline]
		for i = 1, 5 do
			local type = lineinfo.enemies:sub(i,i)
			if type ~= "." then
				local enemy = EnemyShip.new(type, SHIP_SIZE*i+SCR_LEFT, SCR_TOP-SHIP_SIZE/2)
				self.enemy_wave[enemy] = true
				enemy:advance(SCROLL_DELTA*SHIP_SIZE)
			end
		end
		self.scroll = SCROLL_DELTA
	elseif self.scroll < 1 then
		self.scroll += SCROLL_DELTA
		for k, _ in pairs(self.enemy_wave) do
			if ACTORS[k] then
				k:advance(SCROLL_DELTA*SHIP_SIZE)
			end
		end
	else
		local lineinfo = self.levelinfo[self.levelline]
		if lineinfo then -- if no lineinfo, it means that we reached the end of the level
			if lineinfo.wait > 0 then
				lineinfo.wait -= SCROLL_DELTA
			else
				local enemy_count = 0
				if lineinfo.clear then
					for k, _ in pairs(self.enemy_wave) do
						if ACTORS[k] then enemy_count += 1 end
					end
				end
				if enemy_count == 0 then
					self.levelline += 1
					if lineinfo.clear then
						self.enemy_wave = {}
					end
					if self.levelinfo[self.levelline] then
						self.scroll = 0
					else
						-- level finished
						print("FINISHED")
					end
				end
			end
		end
	end
end


We are almost done! Add the levels waves table to 'main.lua' and the tick function in the game loop:

-- lists of all objects that should receive frame ticks
ACTORS = {} -- the ships table
BULLETS = {} -- the bullet table (both player bullets and enemy bullets)
LEVELS_WAVES = {} -- our levels waves of enemies

-- ...

-- this is our game loop
stage:addEventListener(Event.ENTER_FRAME, function()
	background:advance(1)
	for k, _ in pairs(ACTORS) do
		k:tick(1)
	end
	for k, _ in pairs(BULLETS) do
		k:tick(1)
	end
	for k, _ in pairs(LEVELS_WAVES) do
		k:tick(1)
	end
end)

Kicking off our level

It is time to see what we just did by adding a single line of code at the very bottom of the "main.lua" file:

Level.new(1)

And the result!


Going further

In this tutorial we built the foundation of a 2D Space Shooter game. There are some missing pieces but you should be able to implement them or ask on the Gideros forum, we will be happy to help.

I will end this tutorial with some ideas:

  • 2D Space Shooter Part 7: Boosters
  • 2D Space Shooter Part 8: Score
  • 2D Space Shooter Part 9: Effects
  • 2D Space Shooter Part 10: Going even further

Thank you and hope you learned a thing or two. Peace!


Prev.: 2D Space Shooter Part 5: Firing
Next: 2D Space Shooter Part 7: Boosters


Tutorial - Making a 2D space shooter game