How xinglingsuiyue/waves-plugin works
WAVES-PLUGIN is a Yunzai bot plugin for Wuthering Waves account access, game-data queries, and related tools. Users issue bot commands; the plugin exposes command handlers, which provide results such as account cards, daily status, exploration and challenge data, gacha history, guides, and damage calculations. The damage-calculation layer parses player panels, loads character/equipment/enemy definitions, and computes results. The README documents additional capabilities not tied to sampled source; those are represented by their apparent app modules where the tree supports a path. Handler-to-service wiring is omitted where source excerpts do not establish it.
Main entry points: index.js App loader · Bind.js Login · CharacterScore.js Echo scoring · User.js Player profile
Components 25
Plugin entry
- App loader
index.js
Accounts and data
- Login
apps/Bind.js - Player profile
apps/User.js - Daily status
apps/Sanity.js - Check-in
apps/SignIn.js - Exploration
apps/Explore.js - Challenges
apps/Challenge.js - Gacha history
apps/Gacha.js
Game reference
- Item guide
apps/Guide.js - Event calendar
apps/Calendar.js - Game news
apps/News.js - Character guides
apps/Strategy.js - Community guides
components/CommunityGuide.js
Analysis tools
- Echo scoring
apps/CharacterScore.js - Damage calculation
utils/damage/engine.js - Panel parsing
utils/damage/parser.js - Combat definitions
resources/Shanghai/characters/达妮娅.js - Gacha simulator
apps/Simulator.js
Shared runtime
- Card rendering
components/Render.js - Configuration
components/Config.js - Login web service
components/Server.js
Other components
- Bot user
- Game services
- Guide service
- OCR provider
Connections 41
- App loader → Login: loads handlers
- App loader → Player profile: loads handlers
- App loader → Daily status: loads handlers
- App loader → Check-in: loads handlers
- App loader → Exploration: loads handlers
- App loader → Challenges: loads handlers
- App loader → Gacha history: loads handlers
- App loader → Item guide: loads handlers
- App loader → Event calendar: loads handlers
- App loader → Game news: loads handlers
- App loader → Character guides: loads handlers
- App loader → Echo scoring: loads handlers
- App loader → Gacha simulator: loads handlers
- Bot user → Login: requests login
- Bot user → Player profile: requests profile
- Bot user → Daily status: requests status
- Bot user → Check-in: requests check-in
- Bot user → Exploration: requests exploration
- Bot user → Challenges: requests challenges
- Bot user → Gacha history: requests history
- Bot user → Item guide: requests guide
- Bot user → Event calendar: requests calendar
- Bot user → Game news: requests news
- Bot user → Character guides: requests strategy
- Bot user → Echo scoring: requests score
- Bot user → Gacha simulator: requests simulation
- Character guides → Community guides: gets guides
- Community guides → Guide service: fetches guide data
- Echo scoring → OCR provider: reads image
- Echo scoring → Card rendering: renders result
- Damage calculation → Panel parsing: parses panel
- Damage calculation → Combat definitions: loads definitions
- Login → Login web service: supports web login
- Login web service → Configuration: reads settings
- Login → Game services: authenticates account
- Player profile → Game services: queries game data
- Daily status → Game services: queries game data
- Check-in → Game services: submits check-in
- Exploration → Game services: queries game data
- Challenges → Game services: queries game data
- Gacha history → Game services: queries history