Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

The Lovely Tactics Hex project is a framework for development of tactical role-playing games (TRPG), built using the LÖVE2D engine. The main games used as inspiration for this project are Final Fantasy Tactics Advance (for GBA), Jeanne D'arc, and Trails in the Sky (both for PSP). The "Hex" in the name is because the battle grid is hexagonal, but isometric and orthogonal tiles are also available.

Project's repository:


To run this project, you need to first install LÖVE2D. Follow steps here: Once the engine is properly installed, all you have to do is run the project folder as any other game made in the engine.


For Windows users who are new to LÖVE2D, here is a simple step-by-step to run the project:

  1. Download this project as a zip, in the green button at the top of this page;
  2. Download LÖVE2D zip from the site above, according to your platform (32-bit should work);
  3. Extract LÖVE2D files into a new empty folder;
  4. Extract the project's root folder into the same newly created folder. The project's root folder, that cointans the main.lua file inside, should be in the same folder as "love.exe" file;
  5. Drag the project's root folder and drop over "love.exe" file. This should run the game.


For Linux users,

  1. Download this project as a zip, in the green button at the top of this page;
  2. Download LÖVE2D package from the site above and install it;
  3. Extract the project's root folder to any folder;
  4. Enter the project's root folder (the one containing "main.lua" file), open the terminal and type
love ./

This should run the game.

How to Play

  • Use arrow keys or mouse to navigate around the field or GUI;
  • Press shift to walk faster;
  • Press Z/Enter/Space to confirm a GUI selection or interact with NPCs;
  • Press X/Backspace/ESC to cancel a GUI selection;
  • Press a cancel button in field to show the Field Menu;
  • Collide with green jellies to start a battle;
  • For debugging:
    • Press F1 to quick-save and F5 to quick-load (does not work during battle);
    • Hold K to kill all enemies in the next turn;
    • Hold L to kill all allies in the next turn.


I am also working on a complementary project, which is an editor for the json files - database, settings and fields. It's still in a very early stage, but it can be already found here:

Documentation and API

Since this project is still under development, its design and features may change a lot, so I'll write a proper documentation when it gets more stable.



My e-mail is nightlywhiskers (at) You can also find me in DeviantArt, Instagram and some random art/gamedev forums, as GloamingCat.


Lovely Tactics Hex, a framework for creation of TRPGs, built with LÖVE2D engine.







No packages published