By 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)