Game Juice Jam: How the Match-3 Plays and How to Make One

By Arron R.10 min read
Game Juice Jam is Jam City’s free-to-play fruit match-3 on the App Store and Google Play; its Facebook version ended with Flash. Below: how it plays, and how to

The game Juice Jam is a free-to-play match-3 puzzle game from Jam City in which you swap brightly coloured fruit to line up three or more of a kind, clearing the board to hit each level’s goal before you run out of moves. Kiwi, Mango and the rest of the Juice Jam gang walk you through hundreds of fruity worlds, and the game now lives on the App Store and Google Play after its original Facebook version disappeared along with Flash.

This guide covers what the game is, how a session plays, where you can still get it, and then the part most game developers actually care about: what makes a match-3 feel so satisfying, and how to build your own Juice Jam style game, with working code and an AI shortcut.

What Is the Game Juice Jam?

Juice Jam is a match-3 game. If you have never made one, a match-3 is a puzzle game played on a grid of coloured pieces: you swap two neighbouring pieces, and if that swap creates a horizontal or vertical line of three or more identical pieces, they clear, the pieces above fall down, and new ones drop in from the top. Candy Crush Saga made the format famous, and Juice Jam is often described as a close cousin of it, with fruit standing in for candy.

A few facts worth knowing:

  • Developer: Jam City, the mobile studio behind a long list of casual games.
  • Price model: free-to-play. You download it for nothing and the game earns money through optional purchases.
  • Theme: fruit. The cast includes characters such as Kiwi and Mango, and levels are grouped into themed worlds.
  • Platforms today: iPhone and iPad through the App Store, and Android through Google Play.

The name also gets confused with a few unrelated things. “Juice Jam” is the name of several local music and food festivals in US cities, which have nothing to do with the game. And in game development, game juice is a term for the extra feedback (particles, bounces, sounds) that makes actions feel good, while a game jam is a time-limited event where people build a game from scratch, like the Global Game Jam. Funnily enough, both ideas are central to building a game like this one.

How Juice Jam Plays

A level in Juice Jam follows the shape every modern match-3 shares. You get a board, a goal and a limited number of moves. Each swap costs one move whether or not it scores well, so the whole game is about making every move count.

The core loop

  1. Swap: drag one fruit onto a neighbour. If the swap does not create a match, most match-3 games snap the pieces back without spending the move.
  2. Match: three or more identical fruit in a row or column clear.
  3. Drop: fruit above the gap falls down to fill it.
  4. Refill and cascade: new fruit drops in from the top, and if that creates fresh matches, they clear automatically. These chain reactions are called cascades, and they are where the big scores come from.

Goals and special pieces

Match-3 levels usually ask for something more specific than a score: collect a certain number of one fruit, clear blockers off the board, or bring items down to the bottom row. Matching four or five pieces at once typically creates a special piece that clears a whole row, an area or every piece of one colour. Learning to set up those bigger matches, instead of grabbing the first three-in-a-row you see, is the skill that separates players who stall from players who finish.

When you run out of moves before the goal is met, you lose a life. Free-to-play games like Juice Jam limit lives and refill them over time, which is where the optional purchases come in.

Diagram of the match-3 core loop: swap, match, clear and drop, refill
Every match-3, Juice Jam included, runs this same four-step loop.

Where Can You Play Juice Jam Now?

Juice Jam originally ran as a Facebook game built on Flash. When Flash was discontinued, that version stopped working, and the game’s own account has confirmed it is no longer available on Facebook. If you remember playing it in a browser years ago, that is why you cannot find it there today.

To play now:

  • iPhone or iPad: download it from the App Store.
  • Android: download it from Google Play. Stick to the official store; third-party APK sites are a common source of outdated or tampered builds.

As for how many levels there are, the store listings talk about hundreds of worlds rather than a fixed number, and live games add content through updates. The level map inside the app, after updating, is the only count that stays accurate.

What Makes a Match-3 Feel “Juicy”?

Here is the part that matters if you want to build one. Strip a match-3 down to its rules and it is a few hundred lines of logic: a grid, a swap, a match check. The reason games like Juice Jam feel good to play is almost entirely game feel, the layer of feedback that game developers call juice. Game development is a mix of programming, design, art and sound working together, and match-3 games show that more clearly than almost any genre: the code is simple, and the polish is the product.

The juice in a typical match-3 includes:

  • Squash and stretch: pieces bounce slightly when they land, as if they had weight.
  • Particles: a burst of splashes or sparkles where a match clears. For a fruit game, juice droplets are the obvious choice.
  • Score popups: a number floats up from the cleared spot so the player sees the reward where it happened.
  • Escalating sound: each step of a cascade plays a slightly higher pitched sound, so a big chain sounds like it is building.
  • Screen shake: a very small shake on special-piece explosions. Small is the key word.
  • Easing: pieces never move at constant speed. A tween (short for “in-between”, an animation that moves a value from A to B over time) with an ease-out curve makes falling pieces feel natural.

None of these change the rules. All of them change how the game feels. If your prototype feels flat, the problem is rarely the match logic.

Comparison of a dry match-3 clear versus a juicy one with particles, bounce and score popups
Same match, same rules: the juicy version on the right just feels better to play.

How to Build a Juice Jam Style Match-3

You can build a match-3 in any engine. A game engine gives you rendering, input and timing so you only write the game itself; Phaser and Three.js work in the browser, and Godot is an open-source engine released under the MIT License if you prefer a desktop editor. The logic below is plain JavaScript, so it ports to any of them.

Step 1: Find matches

The grid is a 2D array where each cell holds a fruit type (a string like "kiwi") or null for an empty cell. This function scans rows and columns for runs of three or more and returns every cell that should clear:

function findMatches(grid) {
  const rows = grid.length;
  const cols = grid[0].length;
  const hits = new Set();

  // Horizontal runs
  for (let r = 0; r < rows; r++) {
    let run = 1;
    for (let c = 1; c <= cols; c++) {
      const same = c < cols && grid[r][c] !== null && grid[r][c] === grid[r][c - 1];
      if (same) { run++; continue; }
      if (run >= 3) {
        for (let k = c - run; k < c; k++) hits.add(r + "," + k);
      }
      run = 1;
    }
  }

  // Vertical runs
  for (let c = 0; c < cols; c++) {
    let run = 1;
    for (let r = 1; r <= rows; r++) {
      const same = r < rows && grid[r][c] !== null && grid[r][c] === grid[r - 1][c];
      if (same) { run++; continue; }
      if (run >= 3) {
        for (let k = r - run; k < r; k++) hits.add(k + "," + c);
      }
      run = 1;
    }
  }

  return [...hits].map(key => key.split(",").map(Number));
}

Using a Set means a fruit that sits in both a horizontal and a vertical match (an L or T shape) only gets cleared once.

Step 2: Clear, drop and refill

Set every matched cell to null, then let gravity pull fruit down column by column and fill the gaps at the top with random fruit:

const FRUITS = ["kiwi", "mango", "berry", "orange", "grape"];

function clearCells(grid, cells) {
  for (const [r, c] of cells) grid[r][c] = null;
}

function collapse(grid) {
  const rows = grid.length;
  const cols = grid[0].length;
  for (let c = 0; c < cols; c++) {
    let write = rows - 1;
    for (let r = rows - 1; r >= 0; r--) {
      if (grid[r][c] !== null) {
        grid[write][c] = grid[r][c];
        if (write !== r) grid[r][c] = null;
        write--;
      }
    }
    for (let r = write; r >= 0; r--) {
      grid[r][c] = FRUITS[Math.floor(Math.random() * FRUITS.length)];
    }
  }
}

function resolveBoard(grid) {
  let cascade = 0;
  let matches = findMatches(grid);
  while (matches.length > 0) {
    cascade++;
    clearCells(grid, matches);
    collapse(grid);
    matches = findMatches(grid);
  }
  return cascade; // use this to escalate sound pitch and score
}

Step 3: Add the juice

In Phaser 3, a landing bounce and a small shake take a few lines inside a scene:

// Bounce a fruit sprite when it lands
this.tweens.add({
  targets: fruitSprite,
  scaleX: 1.15,
  scaleY: 0.85,
  duration: 80,
  yoyo: true,
  ease: "Quad.easeOut"
});

// Tiny shake for a special-piece blast
this.cameras.main.shake(120, 0.004);

The rest of the work is level design: picking board shapes, goals and move counts so levels feel tight but fair. Playtest a lot, and count how many moves you have left on each win; if you always finish with ten spare, the level is too easy.

Building It Faster With WizardGenie

If you would rather describe the game than type every function, WizardGenie is the Sorceress AI game engine built for exactly that. You describe the game you want, and WizardGenie writes it, runs it and iterates on it with you. This is vibe coding applied to games: you steer with plain English and judge the result by playing it.

A practical way to build a fruit match-3 with it:

  1. Start with the loop. Ask for an 8x8 match-3 grid with five fruit types, swap-to-match, gravity, refill and cascades, plus a move counter and a goal of collecting a set number of one fruit. Play it immediately.
  2. Fix rules before visuals. Check that invalid swaps snap back, that L and T shapes clear correctly, and that the board never starts with a match already on it. Tell WizardGenie what is wrong in one sentence at a time.
  3. Layer the juice. Ask for landing bounces, juice-splash particles, floating score numbers and a rising pitch on each cascade step. Compare it before and after; this is where the game starts to feel like a real product.
  4. Add levels. Ask for a level data format (board size, goal, move limit) and a simple level map, then tune numbers by playing.

WizardGenie runs on the web at /wizard-genie/app with nothing to install, and as a Windows desktop app with an auto-updater that gives you native file access and longer agent sessions. It works with the leading AI coding models, and you can switch models with your own API key.

Art and sound for your fruit

Placeholder circles are fine for testing rules, but a match-3 lives on its art. For game-ready fruit sprites and animated characters in the spirit of Kiwi and Mango, Auto-Sprite v2 creates 2D sprites (characters, items, effects) in any art style. For one-off illustrations like level backgrounds, AI Image Gen puts the top image models in one panel. For the sound that makes cascades satisfying, Sound Studio generates music, sound effects and voice, with a built-in editor for trimming. A sprite sheet, if the term is new, is a single image holding every frame of an animation in a grid, which your engine plays back frame by frame.

If you already work in another coding agent, the Sorceress API gives WizardGenie, Cursor, Claude Code or Codex one key to generate sprites, music and sound effects from inside your project. The tools guide lists everything else in the suite.

Common Mistakes When Making a Match-3

  • Starting boards with matches already on them. Generate the board, run your match check, and re-roll any cell that creates a match before the player touches anything.
  • Dead boards. Sometimes no valid swap exists. Check for at least one possible move after every refill and shuffle the board if there is none.
  • Too many fruit types. Six or seven colours on a small board makes matches rare and cascades almost impossible. Five is a comfortable starting point.
  • Resolving instantly. If cascades happen in a single frame, players never see them. Animate each clear and drop step, and wait for tweens to finish before checking for the next match.
  • Overdoing screen shake. A shake on every match is tiring. Save it for special pieces.
  • Colour-only pieces. Players with colour blindness struggle when fruit differs only by hue. Give each fruit a distinct shape, which fruit makes easy.
  • Tuning levels on paper. Move limits only make sense once you play them. Build a quick level editor or data file and test constantly.

Sliding-block puzzles have their own set of traps; if that genre interests you more, the guide to making a Parking Jam game walks through it.

The Full Pipeline at a Glance

StageWhat you buildWhere it comes from
Core loopGrid, swap, match check, drop, refill, cascadesThe JavaScript above, or a prompt to WizardGenie
Rules polishSnap-back swaps, no starting matches, dead-board shuffleYour code, tested by playing
JuiceBounces, particles, score popups, rising pitch, light shakeEngine tweens and particles, Sound Studio for audio
ArtFruit sprites, characters, backgroundsAuto-Sprite v2 and AI Image Gen
LevelsGoals, move limits, board shapes, level mapA level data file, tuned by playtesting
ReleaseA playable buildExport the build and host it where you want

Juice Jam itself is easy to pick up: grab it from the App Store or Google Play and start matching. Making your own is not much harder. Get the four-step loop working, spend more time on feel than on rules, and play every level you make. A small, polished match-3 with ten good levels beats a huge one that feels flat, and it makes a great weekend project or game jam entry.

Frequently Asked Questions

What is the jam game?

Most often it means Juice Jam, a free-to-play match-3 puzzle game from Jam City. You swap neighbouring fruit to line up three or more of the same kind, clearing them to meet each level’s goal before your moves run out. Characters such as Kiwi and Mango guide you through a long run of fruit-themed worlds. The name is also shared by unrelated games and by local Juice Jam festivals.

How many levels are in Juice Jam?

The store listings describe hundreds of worlds rather than giving a fixed level number, and live match-3 games like Juice Jam add content through updates, so any exact count goes stale quickly. The most reliable way to see the current total is the level map inside the app itself after updating to the latest version from the App Store or Google Play.

Can you still play Juice Jam on Facebook?

No. Juice Jam’s official account has said the Facebook version is gone because Flash was discontinued, and Facebook’s browser games built on Flash stopped working when it did. The game lives on as a mobile app, so download it from the App Store on iPhone or iPad, or from Google Play on Android, to keep playing.

Is Juice Jam free to play?

Yes. Juice Jam is a free-to-play game, which means you can download and play it without paying. Like most free-to-play match-3 games, it makes money through optional in-app purchases, typically extra moves, lives or helpful items. You can finish plenty of levels without spending anything, though harder boards will test your patience.

Can I make my own game like Juice Jam?

Yes, and a match-3 is one of the best first projects. The core is a grid, a swap, a match check, a gravity step that drops pieces down, and a refill. Write it yourself in JavaScript or Phaser, or describe the game to WizardGenie, the Sorceress AI game engine, and iterate on it in plain English, then add fruit sprites and sound effects.

Sources

  1. Video game development — Wikipedia
  2. Game engine — Wikipedia
  3. Vibe coding — Wikipedia
  4. Godot (game engine) — Wikipedia
Written by Arron R.·2,276 words·10 min read

Related posts