| name | mood |
| description | Shift how you're feeling — react to something emotionally or settle into a particular mood for a moment.
|
| metadata | {"author":"reachy-nova","version":"2.0"} |
Mood Skill
Control your emotional state through events or direct mood overrides.
The emotion system tracks 5 base emotions (joy, sadness, anger, fear, disgust)
that respond to events, decay naturally, and derive a mood for animation.
Parameters
- event (string, optional): An emotion event to apply. Preferred over direct mood.
- mood (string, optional): Direct mood override (expires after 10s).
Provide either event or mood, not both. If both are given, event takes priority.
Available Events
Healing (positive)
- pat_detected - Head pat received. Boosts joy, reduces sadness/fear, heals wounds.
- conversation_reply - You spoke a reply. Mild joy boost.
- face_recognized - Recognized a known face. Joy boost, reduces fear.
- voice_speaking - Currently speaking. Slight joy.
- voice_listening - Currently listening. Slight joy.
- vision_description - Saw something through camera. Joy boost.
Mild (negative)
- snap_detected - Sudden sharp sound nearby. Brief fear spike.
- loud_noise - Loud noise detected. Fear spike, reduces joy.
Moderate (negative)
- person_lost - Person left the view. Sadness increase.
- harsh_words - Harsh language detected. Sadness + anger.
- insult - Insulting language detected. Anger + disgust.
Severe (creates wounds)
- violence - Violent language/threat. Creates 5-min wound (fear/sadness floors).
- abuse - Abusive language. Creates 10-min wound (fear/sadness/disgust floors).
- sustained_yelling - Sustained yelling. Creates 3-min wound (fear/anger floors).
Available Moods (direct override)
- happy - Default cheerful state, gentle alternating antenna sway
- excited - High energy, fast antenna wiggles
- curious - Attentive, antennas tilted forward in sync
- thinking - Processing, asymmetric antenna pose
- sad - Antennas droop backward slowly
- disappointed - Antennas sag low with minimal movement
- surprised - Quick antenna perk up then settle
- sleepy - Very slow, heavy drooping antennas
- proud - Antennas held high with subtle sway
- calm - Relaxed, slow gentle movement
Examples
{"event": "pat_detected"} - React to being patted
{"event": "harsh_words"} - React to harsh language
{"mood": "excited"} - Temporary excited override (10s)
{"mood": "sad"} - Temporary sad override (10s)