How nyxxbit/discord-quest-completer works
Orion automates eligible Discord Quests through either a DevTools userscript or a Vencord plugin. The engine discovers and schedules quests, drives task-specific progress requests, and can claim rewards; the achievement path additionally authorizes the quest app, reports activity progress, and cleans up the grant. The README documents all five task types and the optional local relay for userscript achievement quests. Several engine internals are only partially excerpted, so the graph omits unverified call relationships rather than inferring them.
Main entry points: tasks.ts Quest task handlers · orion.ts Run orchestration · index.tsx Vencord plugin · traffic.ts Request queue
Components 21
Run entry points
- Userscript
index.js - Vencord plugin
index.tsx
Quest engine
- Run orchestration
orion.ts - Quest discovery
questConfig.ts - Quest targeting
questTarget.ts - Task scheduling
schedulerMetadata.ts
Task execution
- Quest task handlers
tasks.ts - Task lifetime control
taskControl.ts - Request queue
traffic.ts - Game presence patch
patcher.ts - Heartbeat watchdog
heartbeatWatchdog.ts - OAuth cleanup
oauthLifecycle.ts - Local relay
tools/orion-relay/orion-relay.py
State and integrations
- Plugin settings
settings.ts - Settings hooks
hooks.ts - Account identity
accountIdentity.ts - Native runtime
native.ts - Reward formatting
questRewards.ts
Companion interface
- Companion events
companionEvents.ts
Other components
- Discord user
- Discord services
Connections 26
- Discord user → Userscript: runs
README.md - Discord user → Vencord plugin: starts
README.md - Userscript → Run orchestration: runs engine
README.md - Vencord plugin → Run orchestration: starts and controls
index.tsx - Vencord plugin → Plugin settings: exposes settings
settings.ts - Plugin settings → Settings hooks: fires changes
settings.ts - Vencord plugin → Settings hooks: registers watcher
index.tsx - Run orchestration → Quest discovery: loads quest config
orion.ts - Run orchestration → Quest targeting: selects quests
orion.ts - Run orchestration → Task scheduling: assigns task lanes
orion.ts - Run orchestration → Quest task handlers: dispatches handlers
orion.ts - Run orchestration → Task lifetime control: tracks task lifetime
orion.ts - Quest task handlers → Request queue: queues requests
tasks.ts - Request queue → Discord services: posts quest requests
traffic.ts - Quest task handlers → Game presence patch: patches game presence
tasks.ts - Quest task handlers → Heartbeat watchdog: monitors heartbeats
tasks.ts - Quest task handlers → OAuth cleanup: cleans OAuth grants
tasks.ts - Quest task handlers → Discord services: authorizes quest app
README.md - Quest task handlers → Local relay: uses for userscript bypass
README.md - Local relay → Discord services: forwards activity requests
- Quest task handlers → Reward formatting: formats reward balance
- Run orchestration → Companion events: emits run events
orion.ts - Game presence patch → Companion events: emits patch events
patcher.ts - Request queue → Companion events: emits retry events
traffic.ts - Vencord plugin → Account identity: reads account state
- Quest task handlers → Native runtime: uses runtime identity
tasks.ts