1.8.0 • Published 5 years ago

phaser3-plugin-pathbuilder v1.8.0

Weekly downloads
4
License
MIT
Repository
github
Last release
5 years ago

Phaser 3 Plugin Path Builder

A tool to build paths for Pathfollowers and path tweens. Draw and edit Lines, Bezier Curves, Splines and Ellipses during runtime and export them to Phaser. Demo.

npm.io

Description

  • Draw your path in-game.
  • Pause, resume and explore your scene while drawing paths.
  • Export created path to JSON.
  • Import existing paths from JSON.
  • Load path into Phaser and create awesome animations.
  • 90% Phaser API code.

Usage

  1. Grab the PathBuilder.js or PathBuilder.min.js file inside the dist folder.

  2. Load it in Phaser.

function preload ()
{
    this.load.plugin('PathBuilder', "<path-to-plugin>/PathBuilder.js",'PathBuilder');
    //or if using minified:
    //this.load.plugin('PathBuilder.min', "<path-to-plugin>/PathBuilder.min.js",'PathBuilder');

}
  • UI:

    • Controls:
      • Use left mouse to draw.
      • Zoom and move trough scene using middle mouse and mousewheel.
      • Use right mouse to select different curves.

    • Buttons:
      • Undo : Undo the previous path draw.
      • Clear : Clear the entire path.
      • Draw : Enter draw mode.
      • Hide : Hide Plugin.
      • Show : Show Plugin.
      • Pause : Pause main scene.
      • Resume : Resume main scene.
      • Reset view : Reset the camera.
      • Snap : Snap mouse to a fixed grid.
      • Import : Import existing path (JSON).
      • Export : Save the current path as JSON file.

Having questions or problems with usage, suggest a feature? Please submit an Issue.

Requirements:

  • Phaser 3, latest recommended to guarantee matching API.
  • Mouse with middle mouse button if you want to explore A scene.
  • Chrome browser recommended.

Dev notes

Run npm install and then npm run build to build the plugin. Use npm run dev to run webpack-dev-server on port 8000.

There is an existing ES5 branch, but it is no longer maintained since v.1.6.1:

https://github.com/samid737/phaser3-plugin-pathbuilder/tree/ES5

Contributions, optimizations, suggestions are very welcome. All changes are found in the Changelog;

Phaser 3.