explaingit

geanofeefoundry/geanos-jump-n-run-editor

17JavaScriptAudience · generalComplexity · 2/5Setup · easy

TLDR

A Foundry VTT plugin that transforms standard tabletop scenes into playable side-scrolling platformers with a built-in level editor, physics engine, gravity, wall-jumping, configurable traps, and checkpoint logic.

Mindmap

mindmap
  root((Jump n Run))
    What It Does
      Side-scrolling scenes
      Physics engine
      Level editor
    Level Elements
      Platforms and walls
      Hazards and traps
      Checkpoints and portals
    Features
      Parallax backgrounds
      Health display
      RPG stat integration
    Integration
      Monk Active Tiles
      Foundry VTT modules
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Run a platformer mini-game inside a tabletop RPG session as a change-of-pace encounter for your players.

USE CASE 2

Design custom side-scrolling levels with crumbling floors, pressure plates, portals, and healing potions using the built-in visual editor.

USE CASE 3

Tie platformer mechanics to RPG character stats, such as scaling jump height from ability scores or connecting HP to the heart display.

USE CASE 4

Script complex trigger events with Monk's Active Tile Triggers, no code required, such as effects that fire when a player dies or reaches a checkpoint.

Tech stack

JavaScriptFoundry VTT

Getting it running

Difficulty · easy Time to first run · 5min

Install through the Foundry module manager by pasting the manifest URL, no external tools or programming knowledge needed.

In plain English

This is a plugin for Foundry VTT, a popular browser-based virtual tabletop used for playing role-playing games online. The plugin transforms standard Foundry scenes from the usual top-down map view into a side-scrolling platformer, similar in feel to older action games like Prince of Persia. Game Masters use a built-in level editor to draw platforms, walls, hazards, ladders, portals, and checkpoints directly in the Foundry interface. Players control their characters with WASD or arrow keys, and a physics engine handles gravity, jumping, wall-jumping, and collision. Level elements include crumbling floors, pressure plates that open gates, healing potions, and spawn points. Jump height can optionally scale from a character's stats in whatever RPG system the table is running. A background parallax feature lets Game Masters add scrolling background layers to create a sense of depth. Health can be tracked using a classic retro hearts display or tied to a character's hit points in the connected RPG system. Damage amounts for fall damage and spike traps are configurable in the module settings. The module also integrates with another Foundry add-on called Monk's Active Tile Triggers, which lets Game Masters script more complex events: triggering effects when a player dies, reaches a checkpoint, uses a portal, or performs a wall jump. These hooks add custom logic without requiring any code. Installation is through the Foundry module manager by pasting a manifest URL or searching for the module by name. No external tools or programming knowledge are needed to get it running.

Copy-paste prompts

Prompt 1
I'm using the geanos-jump-n-run-editor Foundry VTT module. How do I convert an existing scene into a side-scrolling platformer and start placing platforms with the level editor?
Prompt 2
Using the jump-n-run Foundry module, how do I configure fall damage, spike trap damage, and connect the heart display to my character's actual hit points?
Prompt 3
How do I set up Monk's Active Tile Triggers to fire a custom macro when a player character uses a portal in the geanos jump-n-run module?
Prompt 4
Help me add parallax scrolling background layers to my platformer scene in Foundry VTT using the geanos jump-n-run editor.
Prompt 5
I want jump height in the jump-n-run module to scale from a character's Strength or Athletics score. How do I configure that in the module settings?
Open on GitHub → Explain another repo

← geanofeefoundry on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.