How kingshot-project/kingshot-discord-bot works
Kingshot Discord Bot is a self-hosted Discord application for alliance administration and game-event operations. Its user-facing workflow runs through Discord interactions: administrators manage alliances and members, record or review attendance (including screenshot OCR), redeem gift codes, plan minister appointments, and configure reminders. Shared permission and theme modules support these features. The README documents the product capabilities; the source index confirms several module dependencies, but startup wiring and many unsampled cog interactions cannot be verified here.
Main entry points: attendance.py Attendance tracking · gift_redemption.py Gift redemption · alliance_member_operations.py Member operations · alliance.py Alliance management
Components 28
Alliance Operations
- Alliance management
cogs/alliance.py - Member operations
cogs/alliance_member_operations.py - Member editing
cogs/alliance_member_edit.py - Alliance history
cogs/alliance_history.py - Power history
cogs/alliance_power_changes.py
Events and Tracking
- Attendance tracking
cogs/attendance.py - OCR parsing
cogs/attendance_ocr_parsers.py - OCR review
cogs/attendance_ocr_review.py - Attendance history
cogs/attendance_history.py - No-show tracking
cogs/attendance_no_shows.py - Bear tracking
cogs/bear_track.py
Gift Redemption
- Gift redemption
cogs/gift_redemption.py - Player state lookup
cogs/gift_state_resolver.py - Gift interfaces
cogs/gift_views.py - Kingshot services
Planning and Notifications
- Minister scheduling
cogs/minister_schedule.py - Minister archive
cogs/minister_archive.py - Event notifications
cogs/notification_system.py - Reminder scheduling
cogs/notification_schedule.py - Notification editor
cogs/notification_editor.py - Notification setup
cogs/notification_wizard.py - Event definitions
cogs/notification_event_types.py
Shared Bot Services
- Process queue
cogs/process_queue.py - Permission handling
cogs/permission_handler.py - Theme customization
cogs/pimp_my_bot.py - OCR runtime lifecycle
cogs/onnx_lifecycle.py - Bot data stores
Other components
- Discord users
Connections 38
- Discord users → Alliance management: manage alliances
- Discord users → Member operations: manage members
- Discord users → Attendance tracking: track attendance
- Discord users → OCR review: review uploads
- Discord users → Bear tracking: track bear damage
- Discord users → Gift redemption: redeem codes
- Discord users → Minister scheduling: plan appointments
- Discord users → Event notifications: configure reminders
- Member operations → Member editing: delegates edits
cogs/alliance_member_operations.py - Member operations → Process queue: uses queue
cogs/alliance_member_operations.py - Attendance tracking → OCR parsing: uses parsers
cogs/attendance.py - Attendance tracking → Attendance history: uses history
cogs/attendance.py - Attendance tracking → No-show tracking: uses no-show tracking
cogs/attendance.py - OCR parsing → OCR review: supports review
cogs/attendance_ocr_parsers.py - OCR parsing → OCR runtime lifecycle: uses runtime
cogs/attendance_ocr_parsers.py - OCR review → OCR parsing: reads event slots
cogs/attendance_ocr_review.py - Bear tracking → Attendance tracking: uses attendance
cogs/bear_track.py - Gift interfaces → Gift redemption: invokes redemption
cogs/gift_views.py - Gift redemption → Process queue: checks queue
cogs/gift_redemption.py - Gift redemption → Player state lookup: uses state lookup
cogs/gift_redemption.py - Gift redemption → Kingshot services: calls game API
- Player state lookup → Kingshot services: probes player state
cogs/gift_state_resolver.py - Minister scheduling → Minister archive: uses archive
cogs/minister_schedule.py - Notification editor → Event definitions: uses event definitions
cogs/notification_editor.py - Reminder scheduling → Event definitions: uses event definitions
cogs/notification_schedule.py - Event notifications → Event definitions: uses event definitions
cogs/notification_system.py - Notification setup → Event definitions: uses event definitions
cogs/notification_wizard.py - Alliance management → Permission handling: uses permissions
cogs/alliance.py - Attendance tracking → Permission handling: uses permissions
cogs/attendance.py - Member operations → Permission handling: uses permissions
cogs/alliance_member_operations.py - Alliance management → Theme customization: uses theme
cogs/alliance.py - Attendance tracking → Theme customization: uses theme
cogs/attendance.py - Gift redemption → Theme customization: uses theme
cogs/gift_redemption.py - Member editing → Power history: records power changes
cogs/alliance_member_edit.py - Alliance management → Bot data stores: reads and writes
- Member operations → Bot data stores: reads and writes
- Attendance tracking → Bot data stores: stores attendance
- Bear tracking → Bot data stores: stores tracking data