kikito/bump.lua

Health v2 · maintenance only

Adoption not part of the score

1099 stars · 84 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

bump.lua is a Lua library for axis-aligned bounding-box (AABB) collision detection with basic collision response, designed for gameistic (not realistic) physics. It uses a spatial grid for fast queries and works in any Lua-compatible environment, including LÖVE.

Use cases

• detect collisions between rectangles in a Lua game
• build a platformer like Super Mario with sliding collision response
• make a top-down Zelda-style game with wall collisions
• prevent fast-moving bullets from tunneling through walls
• query which game entities touch a point, segment, or rectangular zone
• add simple physics to a shoot 'em up or fighting game

When to choose

• your game entities can be represented as axis-aligned rectangles
• you want gameistic collision handling for a platformer or top-down game
• you need tunnelling protection for fast-moving objects
• you want a small, fast, memory-efficient pure-Lua library

When to avoid

• you need circle or polygon collision shapes
• you need realistic physics like stacking or rolling
• you need simultaneous multi-object collision resolution in a deterministic order
• you are building a full physics simulation

Facets

library · maturity maintenance

game-engine simulation gaming-tools lua cross-platform collision-detection aabb game-physics love2d spatial-hash game-development

Member repositories

For agents

markdown · JSON · MCP: product_card(name="kikito/bump.lua")