Tuto tiny-ecs beatemup Part 1 Setup

Setup

As mentionned in the introduction, we will use the Gideros Game Template1.

So make a copy of your Gideros Game Template1 and rename it to anything you want, eg.: "Gideros_BeatThemUp".

Project Properties

• Scale Mode: Fit Width (or anything else really :-) )
• Logical Dimensions: 360 * 640 px
• Orientation: Landscape Left
• FPS: 60 VSync On

Feel free to configure the other tabs.

Plugins

• Bump: to handle collisions
• JSON: to save user preferences to disk

We need to add the "plugin" for tiny-ecs, please grab it Media:tiny-ecs.lua (tip: right click and save link as) and put it in the "classes" folder.

Note: the file is supposed to be tiny-ecs.lua but MediaWiki puts a Capital letter :-(

We will add more Classes later on.

Files and Folders

This is how I would organise my files and folders:

Gideros_Game_Template1 (root)

• Plugins
  • JSON
  • Require
• Files
  • audio (folder)
  • classes (folder)
  • fonts (folder)
  • gfx (folder)
  • scenes (folder)
  • init.lua (file)
  • main.lua (file)

Let's add our first Classes/functions. In the folder classes add these two:

• Media:buttonMonster.lua for player control and keyboard navigation (tip: right click and save link as)
• to save data persistently, in the classes folder, create a file called "save_prefs.lua" and copy the following:

require "json"

function saveData(filepath, value)
	local contents = json.encode(value)
	local file = io.open(filepath, "w") -- create file
	file:write(contents) -- save json string in file
	io.close(file)
end

function getData(filepath)
	local value
	local file = io.open(filepath, "r")
	if file then
		local contents = file:read("*a") -- read contents
		value = json.decode(contents) -- decode json
		io.close(file)
	end
	return value
end

Assets

To build your personalized Game Template you will need some assets like sounds, fonts, ...

In this tutorial I will use my own assets and you will need to replace them with yours in both files and code.

Next?

That should be enough to get us started. In the next part we will code our init.lua file.

Next: Tuto Gideros Game Template1 Part 2 Init

Tutorial - tiny-ecs beatemup

---

• Main Page
• Lua API
• Main API
• Plugins