Skip to main content

Gummworld2 - 0.0.5

Gummworld2 is a pygame framework for a scrolling game, where the map is larger than the display. It emphasizes simplicity and performance.

::: News :::

Version 2.0.0 is released. New HUD, more speed, less junk.

  • There is a new and much improved HUD.
  • SpatialHash is much faster thanks to a challenge I made to DR0ID. :D
  • Demos are tweaked where needed.
  • world editor has been retired.
  • PGU has been retired.

The full image of the screenshot collage is available in Gummworld2 Downloads (gw2_screenshots.png), as well as the individual screenshots used to make the collage.


::: About :::

Gummworld2 is a pygame framework for a scrolling game, where the map is larger than the display. It emphasizes simplicity and performance. You add the display elements and game logic, the engine provides the framework for timing, events, updates, and rendering.

Tiled helpers are included for elaborate mapping. However, Tiled is not required.

Source and documentation, plenty of uncomplicated examples, as well as some elaborate ones are included. Source available at Bitbucket. The wiki cites completed games.

Compatible with Python 2.7 and 3.x.

The fast renderer BasicMapRenderer matured in v0.5.0. The Mana World's map01 blazes. It is a five layer map with many SRCALPHA tiles. See examples/ This is super fast. The demo examples/ renders 8,000+ tiny tiles at 800 fps, and typically sluggish jobs like dynamic hex maps at very high speeds.

::: More :::

Also available in downloads (Gummworld2 required):

  • gw2_skeleton, a la skellington. Get this for fast skeleton setup. Highly recommended. I've gotten a fair number of how-to questions that are solved by this module layout. (Note: this is not the same as game_skel, also available in downloads. game_skel is standalone, whereas gw2_skeleton is a drop-in skeleton specifically for Gummworld2.)
  • The Mana World resources needed by some Gummworld2 examples (sorry, TMW is kept separate because it is GPL v2). This is just a drop-in data directory.
Standalone (Gummworld2 not required): Various small projects I use often, and some games and proofs-of-concept.


This release contains numerous changes and additions to the model portion of the library.


  • New QuadTree class in support of quadtree worlds.
  • Classes for different purposes in model module: simple world, no world, quadtree world, as well as pymunk world.
  • "use_pymunk" obsolesced in Engine. Replaced with world types: none, simple, quad tree, and pymunk.
  • Special purpose keyword arguments added to Engine for quadtree world type.
  • Examples updated for compatibility.
  • New examples for quadtree world, and simple world.
  • Bunny minigame modified to use quadtree world.

Thanks to Dylan J. Raub for his excellent pygame demo, Quadtree test, after which Gummworld2's quad_tree module has been fundamentally modeled. Visit the project page:


Home Page


Gummworld2 0.3.0 — 28 Nov, 2011

Gummworld2 0.4.4 — 23 Aug, 2013

Gummworld2 1.0.0 — 25 Mar, 2015

Gummworld2 0.0.0 — 31 Dec, 2010

Gummworld2 0.0.2 — 3 Jan, 2011

Gummworld2 0.4.0 — 6 Apr, 2012

Gummworld2 0.0.4 — 7 Jan, 2011

Gummworld2 0.0.5 — 10 Jan, 2011

Gummworld2 0.0.11 — 8 Feb, 2011

Gummworld2 0.1.0 — 27 Feb, 2011

Gummworld2 0.0.10 — 29 Jan, 2011

Gummworld2 0.0.9 — 22 Jan, 2011

Gummworld2 0.1.1 — 25 Mar, 2011

Gummworld2 0.0.12 — 20 Feb, 2011

Gummworld2 0.2.0 — 21 May, 2011

Gummworld2 0.4.1 — 28 Mar, 2013

Gummworld2 0.4.3 — 20 Aug, 2013

Gummworld2 0.5.0 — 16 Apr, 2014

Gummworld2 0.4.2 — 6 Aug, 2013

Gummworld2 0.4.5 — 26 Mar, 2014

Gummworld2 2.0.0 — 15 Sep, 2017 account Comments