Back to Geometry Dash

Documentation

USERGUIDE

Geometry Dash — User Guide

Getting Started

Running the Game

  • Simplest method — double-click index.html to open in your default browser
  • Local server (recommended for full features):
  • bash
       cd geometry-dash
       python3 -m http.server 8080
       

    Then open http://localhost:8080

    First Game

  • Click START (or press Space)
  • Time your jumps to avoid obstacles
  • Collect golden orbs for bonus points
  • Try to get as far as possible
  • Controls

    Desktop

    • Space or Arrow Up — Jump
    • Click on the game canvas — Jump
    • P or Escape — Pause / Resume

    Mobile

    • Tap anywhere on the game canvas — Jump

    Gameplay

    Obstacles

    TypeDescriptionStrategy
    SpikeSingle triangleStandard jump
    Double SpikeTwo spikes in a rowJump early to clear both
    Triple SpikeThree spikes in a rowJump early with good timing
    BlockSquare obstacleStandard jump, slightly wider
    PillarTall narrow wallRequires a full-height jump
    Obstacles appear in patterns that get more complex as your score increases. Early in the run you'll see simple single spikes and blocks. As difficulty ramps up, combined patterns appear — spikes followed by blocks, pillars next to spikes, etc.

    Orbs

    Golden spinning diamond-shaped collectibles appear periodically above the ground. Each orb is worth +3 points and triggers a brief screen flash and sparkle effect.

    Combo System

    Every obstacle you successfully pass adds to your combo counter. Every 5 consecutive passes earns a combo bonus:

    • 5x combo: +1 bonus per obstacle
    • 10x combo: +2 bonus per obstacle
    • 15x combo: +3 bonus per obstacle
    • And so on...
    Your combo resets when you die.

    Difficulty Progression

    The game gets faster as you travel further. Speed increases continuously based on distance traveled. Obstacle spawn rates also increase, and more complex patterns appear at higher scores.

    Progress Bar

    The thin bar at the top of the canvas shows your distance as a percentage. Getting to 100% distance is the ultimate goal.

    Sound

    Click SOUND ON before or during gameplay to enable:

    • Background music — procedurally generated 140 BPM electronic track with bass, melody, kicks, and hi-hats
    • Jump sound — quick rising tone
    • Landing sound — subtle low thud
    • Orb collect — ascending three-note chime
    • Death — noise burst with low boom
    Sound is generated entirely through the Web Audio API — no audio files needed.

    Scoring

    ActionPoints
    Pass an obstacle+1 (base)
    Combo bonus (every 5)+1 extra per 5 combo
    Collect an orb+3
    Your best score is saved automatically and displayed next to your current score.

    Tips

  • Don't panic-jump — timing is everything. Wait until obstacles are close before jumping.
  • Learn the patterns — obstacle patterns repeat. Recognizing them helps you react faster.
  • Use jump buffering — pressing jump slightly before landing still registers. You don't need perfect frame timing.
  • Coyote time — you have a few frames of grace after walking off an edge where you can still jump. This makes the controls feel responsive.
  • Collect orbs — they're worth 3x a normal obstacle pass and easy to grab.
  • Watch the speed — the game accelerates continuously. Reaction time matters more as you progress.
  • Turn on sound — the beat can help with jump timing.
  • Data Storage

    The game stores the following in your browser's localStorage:

    KeyDescription
    gd_bestYour highest score
    gd_attemptsTotal number of attempts
    To reset your data, open the browser console and run:

    js
    localStorage.removeItem('gd_best');
    localStorage.removeItem('gd_attempts');

    Troubleshooting

    IssueSolution
    Game doesn't loadUse a local HTTP server instead of opening the file directly
    No soundClick "SOUND ON" button; some browsers require a user interaction before audio plays
    LaggyClose other tabs; the game runs at 60fps on modern hardware
    Canvas too smallResize your browser window; the game scales to fit

    © 2026 Jonathan Leahy · v0.8.1-31-g196fa14