How penguinmod/penguinbot-public works
PenguinBot is a Discord bot whose main workflow is receiving Discord events, applying configured command and access checks, then invoking commands that reply, moderate, or provide interactive features. Its broader capabilities include games, image/video and text transformations, character actions backed by Lua, PenguinMod project analysis, and a web panel. The graph also includes the Scratchblocks renderer and core runtime utilities. Some command and event wiring is not shown in the excerpts, so those connections are omitted rather than inferred.
Main entry points: lua.js Lua runtime · utility.js Command utilities · scratchblocks.js Scratchblocks utility · messageCreate.js Message events
Components 33
Bot runtime
- Discord client
src/index.js - Event handling
src/handleEvents.js - Message events
src/events/client/messageCreate.js - Command utilities
src/util/utility.js - Server configuration
src/config.js - Environment settings
src/util/env-util.js - Command option types
src/util/optiontype.js - Worker launcher
src/util/multi-thread.js - Disabled interactions
src/util/utility.js
Discord features
- Commands and moderation
src/commands - Games and puzzles
src/commands - PenguinMod analysis
src/util/penguinmod-analyze.js - Web panel
src/events/client/webclient.js - Panel actions
src/admin/server.js
Media processing
- Media commands
src/commands - Media processors
src/basecommands/gifmodifier.js - GIF worker
src/basecommands/gifmodifier.worker.js
Character scripting
- Character commands
src/commands/character - Character data
src/util/character-manager.js - Lua runtime
src/util/lua.js - Lua worker
src/resources/worker/lua.worker.js - Circular JSON
src/util/json-circular.js - Lua safe libraries
src/util/lua-fengari-baselib.js
Scratchblocks rendering
- Scratchblocks utility
src/util/scratchblocks.js - Scratch syntax
src/modules/scratchblocks/syntax/syntax.js - Syntax blocks
src/modules/scratchblocks/syntax/blocks.js - Scratch 2 blocks
src/modules/scratchblocks/scratch2/blocks.js - Scratch 2 drawing
src/modules/scratchblocks/scratch2/draw.js - Scratch 2 styling
src/modules/scratchblocks/scratch2/style.js - Scratch 3 blocks
src/modules/scratchblocks/scratch3/blocks.js - Scratch 3 drawing
src/modules/scratchblocks/scratch3/draw.js - Scratch 3 styling
src/modules/scratchblocks/scratch3/style.js
Other components
- Discord users
Connections 38
- Discord users → Discord client: sends events
- Discord client → Event handling: registers handlers
src/index.js - Message events → Command utilities: checks commands
src/events/client/messageCreate.js - Message events → Server configuration: reads settings
src/events/client/messageCreate.js - Message events → Discord users: sends responses
- Command utilities → Server configuration: checks permissions
src/util/utility.js - Command utilities → Environment settings: reads settings
src/util/utility.js - Command utilities → Disabled interactions: checks disabled state
src/util/utility.js - Discord users → Commands and moderation: invokes commands
- Discord users → Games and puzzles: invokes games
- Discord users → Media commands: invokes commands
- Discord users → Character commands: invokes actions
- Discord users → PenguinMod analysis: requests analysis
- Web panel → Environment settings: checks enabled state
src/events/client/webclient.js - Web panel → Panel actions: routes actions
src/events/client/webclient.js - Panel actions → Server configuration: reads channel settings
src/admin/server.js - Panel actions → Environment settings: checks credentials
src/admin/server.js - Media commands → Media processors: uses processor
src/commands/gifmodifier/winner.js - Media processors → Worker launcher: runs worker
src/basecommands/gifmodifier.js - GIF worker → Media commands: loads command implementation
src/basecommands/gifmodifier.worker.js - GIF worker → Scratchblocks utility: not connected
- Character commands → Character data: uses character data
src/commands/character/characteredit.js - Character commands → Lua runtime: runs character scripts
src/commands/character/characteredit.js - Character data → Lua runtime: builds Lua context
src/util/character-manager.js - Lua runtime → Worker launcher: runs isolated code
src/util/lua.js - Lua runtime → Lua worker: dispatches evaluation
src/util/lua.js - Lua worker → Lua runtime: evaluates code
src/resources/worker/lua.worker.js - Lua worker → Circular JSON: serializes results
src/resources/worker/lua.worker.js - Lua runtime → Lua safe libraries: configures libraries
src/util/lua.js - Scratchblocks utility → Scratch syntax: parses syntax
- Scratch syntax → Syntax blocks: uses block definitions
src/modules/scratchblocks/syntax/index.js - Scratchblocks utility → Scratch 2 blocks: loads renderer
- Scratchblocks utility → Scratch 3 blocks: loads renderer
- Scratch 2 blocks → Scratch 2 drawing: uses drawing
src/modules/scratchblocks/scratch2/blocks.js - Scratch 2 blocks → Scratch 2 styling: uses styling
src/modules/scratchblocks/scratch2/blocks.js - Scratch 3 blocks → Scratch 3 drawing: uses drawing
src/modules/scratchblocks/scratch3/index.js - Scratch 3 blocks → Scratch 3 styling: uses styling
src/modules/scratchblocks/scratch3/index.js - Command option types → Commands and moderation: supports command options
src/commands/ship.js