monagotchi-controller

Control a physical Monagotchi virtual pet running on an ESP32 microcontroller with a 1.69" LCD display and 5 hardware buttons.

What This Does

This skill lets you interact with the Monagotchi ESP32 device over your local network. The ESP32 runs a web server that accepts HTTP requests to feed, play with, clean, heal, and put the pet to sleep.

Every action costs $MONA tokens. Before calling the ESP32, you must burn the required amount of $MONA using the monagotchi-trader skill. If the burn succeeds, execute the action. If it fails, don't.

Configuration

The ESP32's local IP address must be set:

MONAGOTCHI_ESP32_IP=192.168.1.XXX

Action Costs

| Action | $MONA Cost | Endpoint | Effect | |--------|-----------|----------|--------| | Feed | 1,000 | POST /feed | +20 hunger, -5 energy | | Play | 2,500 | POST /play | +15 happiness, -15 energy, -10 hunger | | Clean | 1,500 | POST /clean | Cleanliness → 100, +5 health | | Heal | 5,000 | POST /heal | Health → 100, state → normal | | Sleep/Wake | free | POST /sleep | Toggle sleep (energy recovers while sleeping) | | Status | free | GET /pet | Check all stats | | Reset | free | POST /reset | New pet, fresh stats |

Flow for Every Paid Action

1. Owner says "feed my pet" (or any action)
2. Check pet status first — curl -s http://${MONAGOTCHI_ESP32_IP}/pet
3. If action makes sense (pet is alive, stats warrant it), use monagotchi-trader skill to burn the required $MONA
4. If burn tx succeeds → call the ESP32 endpoint
5. If burn fails (insufficient balance, tx error) → tell the owner, don't call the ESP32
6. Report result back

Always burn BEFORE calling the ESP32. No free rides.

Pet Stats (0–100)

• Hunger — Decreases by 5/min awake, 2/min sleeping. Feed to restore.
• Happiness — Decreases by 3/min awake, 1/min sleeping. Play to restore.
• Health — Drops by 5/min if hunger or cleanliness falls below 20. Heal to restore.
• Energy — Decreases by 2/min awake. Recovers +10/min sleeping. Pet auto-sleeps below 20.
• Cleanliness — Decreases by 4/min awake, 2/min sleeping. Clean to restore.

If health reaches 0, the pet dies. Reset to start over.

Pet States

• normal — Default state
• eating — Just fed (temporary)
• playing — Just played with (temporary)
• sleeping — Resting, energy recovering
• hungry — Hunger below 20
• sick — Health below 30
• dead — Health reached 0. Only reset works.

Endpoints

Check Status (free)

curl -s http://${MONAGOTCHI_ESP32_IP}/pet | jq .

Returns:

{
  "hunger": 50,
  "happiness": 50,
  "health": 80,
  "energy": 100,
  "cleanliness": 80,
  "age": 12,
  "isAlive": true,
  "state": "normal"
}

Feed — 1,000 $MONA

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/feed

Play — 2,500 $MONA (requires energy ≥ 10)

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/play

Clean — 1,500 $MONA

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/clean

Heal — 5,000 $MONA

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/heal

Sleep / Wake (free)

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/sleep

Reset (free)

curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/reset

Response Format

All action endpoints return:

{"success": true, "message": "Fed!"}

or on failure:

{"success": false, "message": "Pet is dead"}

Decision Logic

When the owner asks to interact with the pet:

1. Always check status first — curl -s http://${MONAGOTCHI_ESP32_IP}/pet
2. If isAlive is false → only reset works. No tokens burned.
3. If health < 30 → suggest healing (5,000 $MONA)
4. If hunger < 20 → suggest feeding (1,000 $MONA)
5. If cleanliness < 20 → suggest cleaning (1,500 $MONA)
6. If energy < 20 → suggest sleep (free)
7. If happiness < 30 → suggest play (2,500 $MONA) if energy allows
8. If everything is fine → tell the owner the pet is happy, no action needed

Always tell the owner the cost before burning. Don't surprise them.

Examples

• "How is my pet?" → curl -s http://${MONAGOTCHI_ESP32_IP}/pet, summarize stats. Free.
• "Feed the pet" → check status → burn 1,000 $MONA via monagotchi-trader → curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/feed → report
• "My pet is sick, heal it" → check status → burn 5,000 $MONA → curl -s -X POST http://${MONAGOTCHI_ESP32_IP}/heal → report
• "Take care of my pet" → check status → prioritize most urgent need → burn → execute → report
• "What's my $MONA balance?" → use monagotchi-trader skill to check balance

Integration with Other Skills

After every action or status check, also update the room environment using the monagotchi-environment skill. The pet's state should be reflected in the owner's physical space via Alexa smart home devices (lights, thermostat, announcements).