A clean, readable scripting language for branching dialogue and interactive stories.
Built for game developers. Ships with first-class Godot support.
WARNING: Bobbin is in early development... You should expect:
- Some features may be missing or incomplete
- Documentation is sparse
- There may be breaking changes between releases
- The API is not yet stable
extern player_name
extern gold
save met_merchant = false
Welcome to the Brass Lantern, {player_name}!
- Browse wares
set met_merchant = true
The merchant spreads out their goods.
- Buy healing potion (10 gold)
if gold >= 10
temp price = 10
You hand over {price} gold coins.
if met_merchant
Here's a 2 gold discount for a returning customer!
Actually, you only owe {price - 2} gold.
else
You don't have enough gold.
- Just looking
No problem, take your time.
Come back anytime!
- Ask about rumors
The merchant leans in close...
Heard there's treasure in the old ruins.
Farewell, {player_name}! You have {gold} gold remaining.
- Writer-friendly syntax — No boilerplate, just dialogue and choices
- Smart variable scoping —
savepersists across sessions,templives for the scene,externreads from your game - Nested branching — Unlimited nesting depth with automatic gather points
- Conditional logic —
if/elseif/elsewith full expression support - Expressions everywhere — Arithmetic, comparison, and logical operators in assignments and interpolations
- String interpolation — Embed variables and expressions in dialogue with
{variable}or{a + b} - Commands — Trigger game effects like
give_item("sword", 1)with compile-time validation - Rich error messages — Rust-quality diagnostics that point to exactly what went wrong
- Fast & lightweight — Rust-powered runtime, instant parsing
- Cross-platform — Linux, Windows, macOS, and WASM (web exports)
- Download the latest release from GitHub Releases
- Extract the
addons/folder into your Godot project root - Enable the plugin in Project → Project Settings → Plugins
# Create runtime with host state and commandsvarruntime=Bobbin.create("res://dialogue/intro.bobbin", {}, {
"player_name": "Ada",
"gold": 100,
}, {
"give_item": func(args): inventory.add(args[0], int(args[1])),
})
# Main dialogue loopwhileruntime.has_more():
runtime.advance()
print(runtime.current_line())
ifruntime.is_waiting_for_choice():
varchoices=runtime.current_choices()
foriinchoices.size():
print(" %d. %s"% [i+1, choices[i]])
runtime.select_choice(0) # Pick first choice- Character/speaker management
- Localization support
- Visit tracking for choices
See CONTRIBUTING.md for development setup and guidelines.