How coolgromov/avabox works
AvaBox is a set of custom modules for the AvaCity virtual-world game server, with a companion web service and VK bot. The main player-facing capabilities cover avatar and inventory changes, social relationships and clans, room activities, and trading; web flows provide account access and payment-related functionality. The tree shows these modules but not the game server’s dispatcher, so links from clients into individual game modules are omitted. Redis usage is visible in sampled modules; several other capabilities are documented in the README but their internal wiring was not sampled.
Main entry points: web.py Web Service · bot_vk.py VK Bot · avatar.py Avatar · relations.py Relationships
Components 22
Web and Payments
- Web Service
web.py - UnitPay
Player and Economy
Social World
- Relationships
modules/relations.py - Clans
modules/clan.py - Trading
modules/trade.py - Mail
modules/mail.py
Activities
- Rooms and Actions
modules/location.py - Housing
modules/house.py - Location Games
modules/location_game.py
Community Operations
- Campaigns
modules/campaign.py - News
modules/news.py - Chat and Moderation
modules/component.py - VK Bot
utils/bot_vk.py
Other components
- Players
- Game Client
- VK Users
- Redis
Connections 10
- Players → Web Service: use web routes
- Web Service → Redis: read/write
- Web Service → UnitPay: payment integration
- VK Users → VK Bot: send commands
- VK Bot → Redis: read/write
- Avatar → Redis: read/write
- Rooms and Actions → Redis: read/write
- Clans → Redis: read/write
- Relationships → Redis: read/write
- Game Client → Location Games: send game commands