Control
Start
start
Duck Cards, a free deck for classrooms
Every card is one thing a Microduck can do. Lay the cards in a row and you have a program a class can read, act out, fix, and run in Microduck Studio.
Nothing scans these cards yet. A person reads the row, and that is the first lesson.
Control
Start
start
Sound
Hello
greet
Walk
Walk forward
walk_forward
Speed
Slow
slow
Walk
Turn left
turn_left
Trick
Kick, right
kick_right
Control
End
end
Start with people. Move to the phone when the class is ready, and to a real duck when there is one.
One student is the duck and does exactly what the cards say, one at a time, and nothing else. When the duck does something nobody meant, the class has found a bug.
The duck in Microduck Studio walks in physics on an iPhone or iPad. Record the row as you drive it, or type the walking part as a sentence the phone reads by itself. Here is how.
Every card the gamepad can do names its button. Read the row aloud and press the buttons in order. Nobody has a Microduck yet, so this one waits for the robot.
The cards below, then a sheet of blank ones. Print two copies for each group, so a row can say Walk forward twice.
Where the duck goes, and when it holds still.
Walk
Walk forward
walk_forward
Walk
Walk back
walk_backward
Walk
Turn left
turn_left
Walk
Turn right
turn_right
Walk
Stop
stop
How fast. A Speed card changes the card above it.
Goes under Walk forward, Walk back, Turn left or Turn right.
Speed
Slow
slow
Speed
Fast
fast
Where the head points. A Look card changes the card above it.
Goes under Walk forward, Walk back, Turn left, Turn right or Stop.
Look
Look left
look_left
Look
Look right
look_right
Look
Look up
look_up
Look
Look down
look_down
Look
Straight ahead
straight
A whole move the duck already knows, from start to finish.
Trick
Kick, left
kick_left
Trick
Kick, right
kick_right
Trick
Sit or stand
sit_or_stand
Trick
Roll
roll
Trick
Peck the ground
peck_ground
The duck makes a sound.
Sound
Hello
greet
Sound
Chirp
chirp
Sound
Coo
coo
Sound
Alarm
alarm
Sound
Wheee
wheee
These shape the row. They never move the duck.
Control
Start
start
Control
End
end
Control
Repeat
times
repeat
Control
End repeat
end_repeat
Starts a second row that waits for something to happen.
When
When it falls
when_falls
Blank cards with codes of their own, for moves your class invents.
The last sheet of the deck is these, each with its own code.
Your card
Name it
card_1
It does
200The starter deck is the duck's own vocabulary. The best cards in your room will be the ones your students invent.
In Studio's Play screen, Mimic puts the duck in the pose of whoever stands in front of the camera. Strike a pose, keep it as a motion, then draw a card for it and give it a name.
A blank card can mean anything the class agrees on: Bow, Dance, Celebrate. Write what the duck does on the card. Its code is its own, so a reader can tell it from every other card.
Studio's plan has a few words the starter deck skips, like Normal and Inquire. Their code numbers are already set aside in the format, so a card you make for one matches everyone else's.
A good card shows one action, has a picture that someone who cannot read yet understands, and has been acted out before it is printed.
Should a Look card go under a kick? Studio's plan says no. Your class can say yes, as long as everyone acts it out the same way.
Photograph your deck and open an issue on this site's repository. CC BY means anyone can print it, with your name on it.
Each one fits a class period with paper only. The Studio step is there when you want it.
Sequences
One student is the duck. The class builds a row that gets the duck from the door to a chair, and the duck does exactly what it says.
Ask: what did the duck do that you did not mean?
Debugging
Draw where the duck should end up. Hand out a row with one wrong card. Groups act it out, find the card, and fix the row with a single swap.
Ask: how did you find it without trying every card?
Loops
Write a dance that does the same few cards again and again. Then rewrite it with Repeat and End repeat, and count the cards you saved.
Ask: what changes if the dance repeats once more?
Parameters
A Speed or Look card changes the card above it. In Studio's plan a walk can carry both, a stop can carry a Look, and a kick carries neither.
Ask: why would a kick take nothing under it?
Events
Walking robots fall. Start a second row with When it falls: what the duck does once it is back on its feet. To test it, the student playing the duck sits down when you say "fall".
Ask: should it do the same thing after every fall?
Timing
Groups write rows of the same length, with Stop cards as rests. On a count, every duck runs its row at once, and the class watches for who drifts.
Ask: which card put the ducks back in step?
A pack turns the deck into a game for one grade band: the cards in play, a board, challenges that ramp from easy to hard, and lessons. Each challenge prints as its own activity card.
Studio's duck walks in physics on an iPhone or iPad. Every control named here is already in the beta.
Join the TestFlight betaforward for two seconds then turn left. The app tells you how it read them:
No model was asked. This is a fixed list of words matched against the drive limits this app already enforces, which is why it works on a phone with nothing configured.
Look and Sound cards stay with people. The bench in Studio takes walking and the tricks, but no head pose, and it moves no beak. Act those cards out. On a real duck, the Look cards and Wheee have buttons; the other sounds wait for a reader.
Every card carries a code a camera can read, an AprilTag, with the code's number under it.
Nothing in Studio reads these. They are printed now so the cards you cut out today mean the same thing when something does. A number never changes meaning; a new card gets a new number.
A sticker on the back of a card, or inside its sleeve, can carry the same card. The format says exactly what to write on it, and a phone that taps it opens that card's entry on this site.
A row of cards becomes the same kind of plan Studio's plan editor works with, so a reader written for a class project lands in a format Studio already speaks.
Nobody has the hardware yet. Everything on this page works without a Microduck: paper first, then the duck in Studio.
Everything here is free, and the format is open.