Give Up GitHub

This project has given up GitHub. (See Software Freedom Conservancy's Give Up GitHub site for details.)

You can now find this project at https://codeberg.org/apicici/pathfun-editor instead.

Any use of this project's code by GitHub Copilot, past or present, is done without our permission. We do not consent to GitHub's use of this project's code in Copilot.

Join us; you can give up GitHub too!

pathfun editor

A navigation area editor for the pathfun Lua library.

Uses LÖVE as the engine, Dear ImGui for the interface, clipper for polygon operations, and polypartition to partition into convex polygons.

Works on Linux, Windows, and macos.

Features

• Visual editing the navigation area by adding or subtracting polygons in an intuitive way.
• Testing mode to test pathfinding on the navigation area using pathfun.
• Help window with instructions on how to use the editor.
• Exports a .lua file that returns the navigation data expected from pathfun when required from Lua.

The following animation provides a quick overview of the main features of the editor:

How to use

The git repository only contains the LÖVE source code (mostly written in MoonScript). To use the editor you can grab a pre-built release (recommended) or compile code and/or libraries yourself.

Pre-built binaries

Pre-built binaries can be found in the releases page for the following systems/architectures:

• Linux x64
• Windows x86, x64
• macos x64

Compilation

LÖVE archive

1. First you'll need to compile the .moon files in the src directory with MoonScript (see instructions here).
2. Put all the .lua files from the src directory and the ones compiled with MoonScript in a zip file, preserving the directory structure (main.lua should be in the root of the zip file).
3. Rename the zip file to pathfun-editor.love.

The pathfun-editor.love obtained here cannot be run with LÖVE yet, since it requires compilation of the shared libraries.

Shared libraries

The editor needs shared libraries from the following projects:

• cimgui-love (version 1.87-1)
• clipper-luajit-ffi (version 1.1)

You can either grab the pre-compiled libraries from the project releases or compile them yourself.

Running the LÖVE file

1. Place the compiled shared libraries in the same folder as the pathfun-editor.love file.
2. Download the LÖVE binaries from https://love2d.org/
3. Run pathfun-editor.love using LÖVE.