How skyblock-nerds/nerdbot works
Nerd Bot is a Discord bot for the SkyBlock Nerds server. Users interact through Discord commands and events; scheduled features and listeners also perform moderation, curation, tracking, and integrations. A documented end-to-end workflow is Google Drive access sync: a member links an email, role mappings determine folder permissions, and role events or reconciliation keep grants current. The graph preserves other README capabilities. Some implementations were not sampled, so those links are documented or marked unverified rather than inferred from module names.
Main entry points: DrivePermissionService.java Drive permission sync · command Slash commands · Main.java Bot startup · PackUpdater.java Pack updates
Components 19
Bot Runtime
- Bot startup
app/src/main/java/net/hypixel/nerdbot/app/Main.java - Bot orchestration
app/src/main/java/net/hypixel/nerdbot/app/SkyBlockNerdsBot.java - Discord framework
discord-framework/src/main/java/net/hypixel/nerdbot/discord/AbstractDiscordBot.java - Slash commands
app/src/main/java/net/hypixel/nerdbot/app/command
Community Features
- Activity tracking
app/src/main/java/net/hypixel/nerdbot/app/activity/ActivityListener.java - Reminders
app/src/main/java/net/hypixel/nerdbot/app/reminder/ReminderDispatcher.java - Suggestion curation
app/src/main/java/net/hypixel/nerdbot/app/feature/CurateFeature.java - Moderation logs
app/src/main/java/net/hypixel/nerdbot/app/listener/ModLogListener.java - Prometheus metrics
app/src/main/java/net/hypixel/nerdbot/app/metrics/PrometheusMetrics.java
Content Generation
- Image generation
app/src/main/java/net/hypixel/nerdbot/app/generation - Pack updates
app/src/main/java/net/hypixel/nerdbot/app/generation/pack/update/PackUpdater.java
External Integrations
- Drive link workflow
app/src/main/java/net/hypixel/nerdbot/app/drive/DriveLinkWorkflow.java - Drive permission sync
app/src/main/java/net/hypixel/nerdbot/app/drive/DrivePermissionService.java - Drive reconcile sweep
app/src/main/java/net/hypixel/nerdbot/app/drive/DriveSyncSweep.java
Other components
- Discord member
- Discord
- Google Drive
- Hypixel services
- Activity database
Connections 22
- Bot startup → Bot orchestration: starts
app/src/main/java/net/hypixel/nerdbot/app/Main.java - Bot startup → Discord framework: creates
app/src/main/java/net/hypixel/nerdbot/app/Main.java - Discord member → Slash commands: invokes
- Slash commands → Discord: replies through
- Discord → Activity tracking: sends events
README.md - Activity tracking → Activity database: saves activity
README.md - Slash commands → Reminders: sets reminders
README.md - Reminders → Discord: sends DMs
README.md - Discord → Suggestion curation: provides suggestions
README.md - Suggestion curation → Discord: tags suggestions
README.md - Discord → Moderation logs: sends events
README.md - Moderation logs → Discord: logs events
README.md - Discord → Prometheus metrics: provides metrics
README.md - Discord member → Image generation: requests images
README.md - Image generation → Discord member: returns images
README.md - Pack updates → Hypixel services: polls updates
README.md - Pack updates → Discord: announces updates
README.md - Discord member → Drive link workflow: links account
README.md - Drive link workflow → Drive permission sync: requests access sync
- Discord → Drive permission sync: role events trigger
README.md - Drive reconcile sweep → Drive permission sync: reconciles grants
README.md - Drive permission sync → Google Drive: grants and revokes
README.md