Fan Wiki · Updated May 2026

Yerba Buena Wiki

Master the Oscillator, conquer every chapter, and unlock all achievements in Mad About Pandas' surreal 1970s puzzle-platformer.

Start with the Oscillator
Chapters
14
Achievements
40
Languages
15
Platforms
3

Game Overview

Yerba Buena is a surreal puzzle-platforming adventure set in a glitch-ridden version of 1970s San Francisco. You play as Barb, an NPC who discovers the Oscillator and must save the city from a sinister plot.

Released on May 26, 2026 by Mad About Pandas and published by Focus Entertainment, Yerba Buena blends environmental physics puzzles with a meta-narrative about living inside an abandoned video game world. The name references San Francisco's original Spanish name — Yerba Buena means "good herb" — and the real Yerba Buena Gardens park that becomes central to the story.

Unlike traditional platformers, you cannot push objects manually. Every solution flows through the Oscillator: a radar-gun-like device that copies movement vectors and physical traits from one object and pastes them onto glitched targets in the environment.

The game runs 8–12 hours for a first playthrough, with optional achievement hunting adding several more. A free Steam demo covers the tutorial plus early levels, and save data transfers to the full release.

Free Demo & Save Transfer

The Steam demo includes the tutorial, Brewery, and Amusement Park levels (~90–120 minutes). All progress carries over automatically when you purchase the full game — no extra steps required.

Developer Mad About Pandas
Publisher Focus Entertainment
Genre Puzzle Platformer
Perspective First-Person
Release May 26, 2026
Platforms PC, PS5, Xbox Series X|S
Price ~$24.99 / €24.99
Storage 9 GB (SSD required on PC)

Story & Characters

Barb arrives in 1970s San Francisco searching for work when a flat tire derails her job interview. What follows is a journey through a city — and a gameworld — unraveling at the seams.

After Russell, her cab-driver friend, is kidnapped by a biker gang member named Bear, Barb finds a briefcase containing the Oscillator. The Glitch is spreading through San Francisco while tech billionaire Noel buys Yerba Buena Gardens to build a TV tower. Barb must rescue Russell, stop Noel, and uncover why this world feels like a video game on loop.

The central twist: this is literally a video game. Barb is an NPC in an abandoned gameworld called Bay Angels. Out-of-bounds markers, reload mechanics on bosses, and developer audio logs confirm the meta layer. The narrative blends Free Guy-style self-awareness with 1970s counterculture themes and contemporary AI anxieties.

Tone shifts midway: the first half is playful and humorous (moving half a building across the street to skip a jump), while the second half turns serious with multi-step puzzles, lasers, grinders, and longer level layouts.

Barb

Protagonist

A young woman new to San Francisco, struggling to find work. Becomes an unlikely hero wielding the Oscillator.

Russell

Ally

Barb's cab-driver friend kidnapped by Bear's gang. His rescue drives the early story.

Bear

Antagonist (Early)

Biker gang member who carjacks Russell's cab and leaves the Oscillator behind.

Noel

Main Antagonist

Tech billionaire buying Yerba Buena Gardens for a TV tower. His true plan ties into the Glitch and the gameworld's nature.

Jorge

Ally

Runs a corner store. One of Barb's friends who helps throughout the adventure.

Wanda

Ally

Another friend supporting Barb's quest to save San Francisco.

Florian

Supporting

Connected to the Sticky Oasis area and secrets tied to the Positive Vibes achievement.

Oscillator Mechanics

The Oscillator is the heart of Yerba Buena. Mastering its copy-and-paste system is essential for every puzzle in the game.

Scanning the Environment

Activate scan mode to highlight interactable objects. Orange/yellow objects are copy sources — they hold traits you can capture. Blue objects are glitched paste targets — only these can receive copied properties.

  • Scan constantly, even in rooms that look empty. Steam vents, coils, and ceiling elements are easy to miss.
  • Some entire buildings can be glitched — scanning reveals when you need to launch a structure across the street.
  • The Oscillator display shows your currently copied trait with a directional arrow for movement vectors.
  • Interactable lore objects require finishing their audio before you can scan nearby puzzle elements.
Trait Source Effect
Movement / Momentum Fans, cars, trains, roller coasters, weights Copies direction of motion relative to the world. A fan spinning upward applies upward force; a car moving left applies leftward motion. Movement traits overwrite each other — you cannot make one object move up AND spin simultaneously.
Gaseous / Vapor Steam, smoke, broken pipes, coffee makers Removes solid state from glitched objects. Barb and other objects can pass through gaseous surfaces. Toggle on and off by re-pasting or resetting. Essential for wall-phasing puzzles.
Bouncy Trampolines, bouncy platforms, feat-of-strength machines Makes glitched surfaces springy. Jump height depends on approach angle and starting elevation. Side approaches bounce sideways. Landing precision matters in later puzzles.
Sticky / Honey Sticky Oasis honey, adhesive surfaces Objects stick to surfaces or each other. Combine with spin for complex multi-step solutions. Unlocked in later chapters. Cancels some movement combinations.
Vanish / Phase Out Steam (Amusement Park upgrade) Makes glitched objects temporarily disappear entirely, not just gaseous. Chapter 4 upgrade. Used heavily in the Amusement Park gauntlet.

Core Rules

  • Only glitched (blue) objects can receive pasted traits.
  • Only valid (orange/yellow) sources can be copied.
  • You copy one trait at a time, stored in the Oscillator until replaced.
  • Movement traits overwrite each other; gaseous, bouncy, and sticky can stack with movement.
  • You cannot die — fatal falls reset Barb to a recent checkpoint, encouraging experimentation.
  • You cannot manually push objects. All manipulation goes through the Oscillator.
  • Copied traits persist long enough that they feel permanent — plan before pasting on key objects.

Trait Stacking & Conflicts

Combining traits is where Yerba Buena's puzzles become truly creative. Understanding what stacks and what conflicts saves hours of frustration.

Trait Stacks With Conflicts
Movement (Up/Down/Left/Right/Spin) Gaseous, Bouncy, Sticky Other movement directions
Gaseous Movement, Bouncy None directly — toggle by re-pasting
Bouncy Movement, Gaseous Precise angle requirements in some puzzles
Sticky Movement, Spin Some spin + sticky combos behave unpredictably
Vanish Independent toggle Must restore object before applying other traits in some rooms

Chapter Guide

Yerba Buena spans 14 chapters across San Francisco and surreal tutorial zones. Early chapters teach mechanics; mid-game Amusement Park gauntlets test each new trait; late game levels combine everything with longer layouts.

Ch.1 Tutorial / Opening Easy
Learn basic movement copying. Rescue Russell from behind a police blockade. Multiple solutions: car stepping stones or moving half a building.
Ch.2 Jorge's Store Easy
Visit Jorge's corner store. Introduces lore interactions and light Oscillator use in urban environments.
Ch.3 Brewery Medium
Industrial setting with early multi-step puzzles. First area where scanning every surface matters.
Ch.4 Amusement Park Hard
Major difficulty spike. Unlock Vanish trait. Plinko puzzles, roller coasters, multi-floor coffee maker descent.
Ch.5 The Chase Easy
Action-heavy car chase sequence. Minimal puzzle focus — mostly story and set pieces.
Ch.6 Interlude Easy
Story bridge chapter with lighter puzzle content between major set pieces.
Ch.7 Amusement Park Part Two Hard
Return to the carnival zone. Master Bouncy trait through curated gauntlet challenges.
Ch.8 Noel's Bunker Hard
Underground facility with lasers, grinders, and multi-room puzzles. Safety Inspector achievement location.
Ch.9 Mid-Game Escalation Hard
Difficulty continues climbing. Longer levels with backtracking between areas.
Ch.10 Bay Angels Hideout Medium
Discover secrets of the gameworld. Hideout Hunter achievement tied to this area.
Ch.11 Bank Heist, Park Two Hard
High-stakes set piece combining chase and puzzle elements in Yerba Buena Gardens.
Ch.12 The Virus Hard
Story-critical chapter addressing the Glitch's origins and AI themes.
Ch.13 Boss Fight Hard
Final confrontation. Boss can literally reload a save when defeated — meta mechanic.
Ch.14 The Future Medium
Epilogue chapter wrapping Barb's journey from NPC to protagonist.

Detailed Walkthroughs — Hard Chapters

These step-by-step guides cover the most common stuck points. Remember: most puzzles have multiple valid solutions.

Chapter 3: Brewery

  1. Scan every room on entry — industrial pipes often hide copyable steam sources.
  2. Identify all blue (glitched) platforms before copying movement from fans or machinery.
  3. Copy fan rotation or conveyor motion, then paste onto the nearest glitched crate to create stepping paths.
  4. If a platform stops mid-path, you may need a different movement source — look for overhead machinery.
  5. Check corners and behind barrels for secondary glitched objects not visible from the main path.

Chapter 4: Amusement Park

  1. New power: Vanish (not just gaseous). Zap steam skyward, paste on blocking objects to remove them.
  2. Fountain room: vanish the fountain, push shooting-gallery duck obstacle to wall, restore fountain, use both as stairs.
  3. Feat-of-strength: zap weight while rising, stand on glitched car, shoot car to launch upward, restore merry-go-round roof to land.
  4. Plinko machine: zap overhead train for horizontal motion, adjust top-left peg, vanish bottom-left peg, press button to release ball.
  5. Coffee maker descent (floors 5→1): each floor — turn on coffee maker, scan smoke, vanish floor/wall to drop down. Floor 7-8 has stairs instead.
  6. Third floor: open outside wall, scan roller coaster, stand on movable floor piece, ride it across room, jump to second floor.
  7. Final boat: zap last coffee maker, vanish door, enter roller coaster car to finish chapter.

Chapter 7: Amusement Park Part Two — Bouncy

  1. Each gauntlet room teaches one bouncy application — complete them in order rather than skipping ahead.
  2. Scan trampolines and feat-of-strength machines as bounce sources before entering challenge rooms.
  3. Approach bouncy surfaces from the correct angle — side entries bounce horizontally, not vertically.
  4. Combine bounce with gaseous traits to pass through walls at the apex of a jump.
  5. If stuck on a gauntlet, reset the room via main menu Continue to restore all object states.

Chapter 8: Noel's Bunker

  1. Scan for laser paths and grinder timing before moving any objects — some puzzles require precise sequencing.
  2. Multi-room puzzles: note which traits you need in each room before consuming your copy slot.
  3. Sticky + spin combinations appear here — test in safe areas before applying to puzzle-critical objects.
  4. For Safety Inspector achievement: explore every hazard type for unique death animations (no penalty).
  5. Long level — use scan mode at every new room entrance to avoid backtracking.

Puzzle Strategies

When Yerba Buena's environmental puzzles feel impossible, these systematic approaches help more than random experimentation.

The Scan-First Method

  • Enter every new area and hold scan until you've identified ALL orange sources and blue targets.
  • Mentally catalog movement sources before planning — fans, cars, trains, and weights behave differently.
  • Look up: ceiling vents, roller coaster tracks, and overhead trains are frequently missed.
  • Check behind interactive lore objects — some unlock only after audio finishes playing.

Multi-Step Planning

  • Write down the trait sequence: Copy steam → vanish wall → copy train → paste on platform → jump.
  • Some puzzles require visiting multiple rooms — don't consume your only copy on a test object.
  • Restore objects to original state before re-applying traits in a different order.
  • If a puzzle spans floors (Amusement Park coffee descent), work top-down systematically.

Creative Solutions

  • Most puzzles have multiple solutions — moving a building beats precise jumping.
  • Stack traits creatively: gaseous + movement lets objects phase through walls mid-flight.
  • Experiment freely — you cannot die, and falls reset you to a safe checkpoint.
  • If your solution feels overly complex, look for a simpler environmental interaction.

Stuck? Run Through This Checklist

  • Did you scan the entire room including ceiling, floor, and behind objects?
  • Are you trying to paste onto a non-glitched (non-blue) object?
  • Did you finish listening to nearby lore audio that blocks interactions?
  • Are two movement traits conflicting on the same object?
  • Did you restore a vanished/gaseous object before applying a different trait?
  • Is there a movement source in another room you haven't visited yet?
  • For bounce puzzles: are you approaching from the correct angle and height?
  • Have you tried resetting the area via main menu → Continue?

Recovering from Unwinnable States

Some late-game puzzles allow placing yourself in an unwinnable position — for example, vanishing a critical platform with no way to restore it. The game does not auto-detect this.

  1. Quit to the main menu (do not reload a manual save unless necessary).
  2. Select Continue — this resets the current area to its default object states.
  3. Re-enter the puzzle and try a different trait sequence.
  4. If Continue doesn't reset enough, the last checkpoint within the chapter should restore earlier progress.

Achievements Guide

Yerba Buena features 40 Steam achievements (also on Xbox/PlayStation as trophies). Most unlock through story progress; several require exploration and creative Oscillator use.

Story ProgressExplorationOscillator MasterySecret / Humor
Achievement Description Category
Chapter 2 Complete Finish Part 2: Jorge's Store. Story Progress
Chapter 3 Complete Finish Part 3: Brewery. Story Progress
Chapter 4 Complete Master Airy and finish Part 4: Amusement Park. Story Progress
Chapter 5 Complete Finish Part 5: The Chase. Story Progress
Chapter 6 Complete Finish Part 6. Story Progress
Chapter 7 Complete Master Bouncy and finish Part 7: Amusement Park Part Two. Story Progress
Chapter 8 Complete Finish Part 8: Noel's Bunker. Story Progress
Chapter 9 Complete Finish Part 9. Story Progress
Chapter 10 Complete Finish Part 10. Story Progress
Chapter 11 Complete Finish Part 11: Bank Heist, Park Two. Story Progress
Chapter 12 Complete Finish Part 12: The Virus. Story Progress
Chapter 13 Complete Finish Part 13: Boss Fight. Story Progress
Chapter 14 Complete Finish Part 14: The Future. Story Progress
Hideout Hunter Discover the Bay Angels hideout. Exploration
Off The Grid Discover a secret space. Exploration
Palm Tree Paradise Reach a tropical plateau. Exploration
Namaste Visit the Bouncy Oasis. Exploration
Positive Vibes Learn all of Florian's secrets at the Sticky Oasis. Exploration
Cab Confidential Discover all of Russell's cab secrets. Exploration
Corner Store Connoisseur Find every secret in Jorge's store. Exploration
Spilled The Tea Uncover hidden gossip and lore entries. Exploration
Safety Inspector Die in every possible way in Noel's Bunker. Secret / Humor
Rule Breaker Break the gameworld's boundaries for the first time. Oscillator Mastery
Copy Cat Copy 100 unique object traits. Oscillator Mastery
Paste Perfectionist Solve a puzzle using three or more trait applications. Oscillator Mastery
Building Mover Relocate an entire building using the Oscillator. Oscillator Mastery
Going Up Reach a high point using only bounce mechanics. Oscillator Mastery
Ghost Walk Phase through 10 walls using gaseous traits. Oscillator Mastery
Spin Doctor Make an object spin in place for 30 seconds. Oscillator Mastery
Stack Master Apply three different traits to a single object. Oscillator Mastery
Speed Runner Complete a chase sequence without resetting. Oscillator Mastery
Glitch Hunter Scan 500 glitched objects. Oscillator Mastery
NPC No More Become the main character. Story Progress
Save San Francisco Complete the main story. Story Progress
Demo Veteran Transfer demo save to the full game. Secret / Humor
Out of Bounds Find a developer out-of-bounds marker. Secret / Humor
Reloaded Witness the boss reload a save file. Secret / Humor
Audio Log Archivist Collect all developer audio logs. Exploration
1976 Forever Spend 1976 in-game minutes exploring. Secret / Humor
Completionist Unlock all other achievements. Story Progress

Platforms & Performance

Yerba Buena runs on PC, PlayStation 5, and Xbox Series X|S with cross-platform parity. PC has the most configuration options; Steam Deck is verified playable with minor frame dips.

PC Minimum Ryzen 5 2600 / i5-8400, 8 GB RAM, RX 580 / GTX 1060, SSD, DX12
PC Recommended Ryzen 5 5600X / i5-12400, 16 GB RAM, RX 7600 XT / RTX 3060, SSD, DX12
Target FPS 30 FPS (Low) / 60 FPS (High) at 1080p
Storage 9 GB — SSD required on PC
PS5 4K/60 with DualSense support, offline play
Xbox Series X|S Optimized for Series X|S, Quick Resume supported
Linux Runs natively on Linux PC without Proton modifications
Steam Deck Playable at 1280×800 Medium preset, ~40-60 FPS, ~90 min battery

Steam Deck Notes

Yerba Buena runs at native 1280×800 on Medium settings. The stylized art hides most visual downgrades from higher presets.

Frame rate targets 60 FPS but briefly dips to low 40s in complex puzzle areas — not detrimental for this slower-paced genre.

Battery life on LCD Steam Deck is approximately 90 minutes per charge. A puzzle game session fits well within one charge cycle.

Use scan mode with the right trigger — controller layout mirrors keyboard bindings. Gyro aiming is not required.

Recommended Settings

  • PC: Install on SSD — loading screens appear mid-cutscene on HDD.
  • Enable VSync if you experience screen tearing during fast Oscillator targeting.
  • Subtitles ON recommended — 1970s audio mixing can obscure dialogue.
  • Field of View: default is comfortable; increase slightly on ultrawide monitors.
  • Steam Deck: Medium preset is the sweet spot; Low saves battery with minimal visual loss.
  • No granular graphics sliders — Low/Medium/High presets only.

Frequently Asked Questions

Does the demo save transfer to the full game?
Yes. Progress from the Steam demo automatically carries over when you purchase the full release. No manual import needed.
How long is Yerba Buena?
Main story takes 8–12 hours. Achievement hunting and exploration add 3–5 more hours.
Can I die in Yerba Buena?
No permanent death. Falls and hazards reset Barb to a recent checkpoint. Some deaths in Noel's Bunker unlock the Safety Inspector achievement.
Why can't I paste a trait onto an object?
Only glitched (blue when scanned) objects accept pasted traits. Non-glitched objects are inert. Scan mode shows valid targets.
I'm stuck with no way forward. What do I do?
Quit to main menu and select Continue to reset the current area. See the Puzzle Strategies section for a full checklist.
Do puzzles have multiple solutions?
Yes. The developers designed most puzzles with alternative approaches — moving a building instead of precise jumping, for example.
What languages does the game support?
15 languages: English (full audio), French, Italian, German, Spanish (Spain & LATAM), Arabic, Japanese, Korean, Polish, Russian, Simplified Chinese, Traditional Chinese, Turkish, and Ukrainian.
Is there New Game Plus?
No New Game Plus at launch. Replay chapters via level select after completing the story to hunt missed achievements.
Does Yerba Buena work on Steam Deck?
Yes. Playable at Medium settings with occasional frame dips. See Platforms section for details.
What is the Oscillator?
A device that copies movement vectors and physical traits (bounce, gas, sticky) from orange sources and pastes them onto blue glitched targets.
Is this an official wiki?
No. This is an independent fan wiki. Yerba Buena is a trademark of Focus Entertainment and Mad About Pandas.
When did Yerba Buena release?
May 26, 2026 on PC (Steam), PlayStation 5, and Xbox Series X|S.
Why is the game called Yerba Buena?
San Francisco was originally named Yerba Buena (good herb). The game centers on Yerba Buena Gardens and the city's history.
Is Yerba Buena like Portal?
Similar in having a physics-manipulation gun, but Yerba Buena focuses on copying object traits rather than creating portals. The 1970s setting and meta-NPC story are unique.
Are there collectibles?
Yes. Hidden areas, audio logs, lore objects, and environment secrets tie to exploration achievements like Hideout Hunter and Spilled The Tea.