How meta-dusk/pytoningans works
PyToNingans is a PySide6 desktop-pet app with a control panel, multiple animated pet windows, and user-editable pet mods. The main workflow selects a mod in the menu, spawns pets, then the manager ticks each pet’s AI, physics, and animation; mod configuration supplies sprites, behavior, and dialogue. Users also manage and edit mods, including animation grids, crops, and behavior settings. The README is brief, so subsystem wiring beyond the sampled entry points is omitted where not evidenced.
Main entry points: mod_editor/window.py Mod editor · pet_manager.py Pet manager · main.py App startup · pet/window.py Pet window
Components 21
App control
- App startup
src/pytoningans/main.py - Asset paths
src/pytoningans/utils/paths.py - Control panel
src/pytoningans/ui/main_menu.py - Tray menu
src/pytoningans/ui/tray_menu.py
Pet runtime
- Pet manager
src/pytoningans/core/pet_manager.py - Pet window
src/pytoningans/core/pet/window.py - Pet AI
src/pytoningans/core/pet/ai_brain.py - Pet physics
src/pytoningans/core/pet/physics.py - Pet animation
src/pytoningans/core/pet/animation.py - Speech bubbles
src/pytoningans/core/pet/speech_bubble.py
Mods and assets
- Mod manager
src/pytoningans/core/mod_manager.py - Installed mod files
assets/mods/default_pet/config.json
Mod editor
- Mod manager hub
src/pytoningans/ui/mod_manager_hub.py - Mod editor
src/pytoningans/ui/mod_editor/window.py - Editor controller
src/pytoningans/ui/mod_editor/controller.py - Animation panel
src/pytoningans/ui/mod_editor/panels/animation_panel.py - Behavior panel
src/pytoningans/ui/mod_editor/panels/behavior_panel.py - Dialogue panel
src/pytoningans/ui/mod_editor/panels/dialogue_panel.py - Debug panel
src/pytoningans/ui/mod_editor/panels/debug_panel.py
Other components
- Desktop user
- Visible OS windows
Connections 27
- Desktop user → Control panel: operates
- App startup → Asset paths: resolves assets
- App startup → Mod manager: loads mods
- App startup → Pet manager: creates manager
- App startup → Control panel: opens panel
- App startup → Tray menu: opens tray
- Control panel → Pet manager: spawns pets
- Control panel → Mod manager hub: opens manager
- Pet manager → Mod manager: loads pet mod
- Pet manager → Pet window: creates windows
- Pet manager → Visible OS windows: queries titles
- Pet manager → Pet window: ticks systems
- Pet window → Pet AI: updates AI
- Pet window → Pet physics: updates physics
- Pet window → Pet animation: updates animation
- Pet AI → Speech bubbles: triggers dialogue
- Pet AI → Visible OS windows: matches triggers
- Mod manager → Installed mod files: reads and saves
- Mod manager hub → Mod manager: lists mods
- Mod manager hub → Mod editor: opens editor
- Mod editor → Editor controller: uses
- Mod editor → Animation panel: hosts
- Mod editor → Behavior panel: hosts
- Mod editor → Dialogue panel: hosts
- Mod editor → Debug panel: hosts
- Animation panel → Editor controller: requests previews
- Editor controller → Mod manager: reads and updates