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