encompass-cs-docs/content/getting_started/case_study_love.md

2.0 KiB

title date weight
Case Study: LÖVE 2019-05-22T10:38:01-07:00 12

LÖVE is a 2D game engine that uses Lua as its scripting language. Because of this, we can use Encompass-TS with the TypescriptToLua transpiler to make games for it.

If you are new to TypeScript, or even new to programming in general, I strongly recommend reviewing the TypeScript handbook.

Install LÖVE.

Make sure you can run it from the terminal by running:

> love

You should see the LÖVE window pop up with the NO GAME screen. If you don't see this, check your terminal environment. On Windows you probably need to manually add the path where you installed LÖVE to your Path Environment Variable and then restart the machine. Thanks Windows!

Encompass-TS uses Node.js for its build process and npm to manage dependencies. Install Node, which automatically installs npm.

Make sure it is properly installed by running:

> npm

You should see npm print out a bunch of help information. Now we're almost ready to begin.

Download the Encompass/LÖVE starter project. Place its contents in a folder and rename the folder to the name of your project. Change information in the package.json file where appropriate.

Now we are ready. Enter the project folder in your terminal and do:

> npm install

This will install everything you need to compile your project to Lua.

The starter project contains some scripts to automate the build process.

To run your game, do:

> npm run love

Or, on Windows:

> npm run lovec

so that you get proper debug console output.

If you just want to build the game without running it, do:

> npm run build

That's everything you need to start making a game with Encompass and LÖVE!