龙虾的小家园 — Desktop Pet

---

name: desktop-pet description: Deploy a pixel-art desktop pet (桌面宠物) with four explorable scenes, care mechanics, and walk animations. Use when user asks to create a desktop pet, virtual pet, pixel pet, tamagotchi-like app, or says "桌面宠物", "桌宠", "desktop pet". Requires Python 3.11+ with Tkinter and Pillow.

---

Desktop Pet — 南波万の小家园

A pixel-art desktop pet built with Python + Tkinter. Features a mini floating character on the desktop and a full home-garden mode with four explorable scenes.

Features

Mini mode: Transparent floating pixel character with walk animation (128px, white oval background)

Garden mode: 850×560 window with four scenes connected by doorways

- 🏠 Indoor (1F) — cozy room with furniture - 🪜 Upstairs (2F) — mirrored warm-tone layout - 🌿 Outdoor — front yard with fence - 🌳 Forest — large woodland area

Care system: Hunger / Mood / Cleanliness / Health with decay and recovery

Controls: Arrow keys or WASD to walk, E to interact with doorways, T for debug mode

Right-click menu: Feed 🍔 / Bathe 🛁 / Play 🎮 / Medicine 💊

Deployment

1. Copy scripts/desktop_pet.py to target directory 2. Copy all files from assets/ into an assets/ subdirectory next to desktop_pet.py 3. Run:

cd 
pip install Pillow
TK_SILENCE_DEPRECATION=1 python3 desktop_pet.py

File structure after deployment

target-dir/
├── desktop_pet.py
└── assets/
    ├── room_bg.png        # Indoor scene (1F)
    ├── upstairs_bg.png    # Upstairs scene (2F, mirrored + warm)
    ├── exterior_bg.png    # Outdoor scene
    ├── forest_bg.png      # Forest scene
    ├── walk_right.gif     # Character walk right (8 frames, 32×32)
    └── walk_left.gif      # Character walk left (8 frames, 32×32)

macOS notes

Uses overrideredirect(True) + systemTransparent for floating mini window

PhotoImage doesn't render on transparent canvas → white oval workaround

Set TK_SILENCE_DEPRECATION=1 to suppress Tk warnings

Scene transitions

| From | Trigger | To | |---|---|---| | Indoor 1F | Walk to staircase (top-left) + E | Upstairs 2F | | Indoor 1F | Walk to carpet (bottom-right) + E | Outdoor | | Upstairs 2F | Walk to staircase (top-right) + E | Indoor 1F | | Outdoor | Walk to left edge + E | Forest | | Outdoor | Walk to door + E | Indoor 1F | | Forest | Walk to right edge + E | Outdoor |

Customization

Backgrounds: Replace PNG files in assets/ (850×526px recommended)

Character: Replace GIF files (32×32 per frame, 8 frames)

Care decay rate: Search frame%600 in code (higher = slower decay)

Collision walls: Edit _INDOOR_WALLS / _OUTDOOR_WALLS arrays

Window sizes: W_M, H_M for mini mode, W_G, H_G for garden mode

Credits

Character sprites: Cozy People (free pixel art)

Background tiles: CraftPix (free top-down pixel art)