Skip to content
Go to file

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. I plan, though, to adapt it to orthogonal and isometric grids someday.

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.

Demo Game

For Windows users that do not use git, I created zip files for each demo game containing all necessary files to test it. Just download, extract and run it.

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:
    • When the game starts, keep holding a cancel button and then start a new game to skip the intro scene;
    • 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.

To-do list

  • Text and dialogue:
    • Optimize dialogue text rendering by not redrawing full lines;
    • Draw sprites in the middle of text;
    • Dialogue text commands:
      • Wait for number of frames;
      • Wait for player input;
      • Ignore player input and close automatically.
  • Additional plugins:
    • ClassEquip: restrict equipment items per battler class;
    • FormationEditor: edit party formation in-game;
    • TerrainDuration: set life time of terrain (snow, fire, magical, etc);
    • PartyRegions: set party escape tiles using regions.
  • Editor:
    • Fix tab flickering on Windows;
    • Optimize field editor (I have no idea how to do this).


Thanks to the following people for source code:

Thanks to the following people for general art/audio resources used in the project:


For now, this work is licensed under the Creative Commons Attribution-NonCommercial 4.0 International License. To view a copy of this license, visit It may have a commercial license in the future, maybe when it's finished. Also, please check the LÖVE2D license here:


My e-mail is nightlywhiskers (at) You may 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 releases published
You can’t perform that action at this time.