Technical Breakdown

Relaxy! is a multipurpose Discord bot first written by me in 2019. It is a pure Node.js program written in modern JavaScript (ES Modules) with JSDoc + TypeScript declaration files for type-checking. There is no build step, the bot runs directly from source. It is sharded and clustered so it can easily scale horizontally across multiple machines.

Boot sequence

• ./start sets UV_THREADPOOL_SIZE=64 and execs Node with nice -n 20, --stack_size=1000, --trace-uncaught and --max-old-space-size=32768 (32 GB V8 heap).
• The Manager parses key.json, empties caches, then spawn()s clusters sequentially (7s apart).
• Each client loads its modules in parallel, connects to MongoDB, spawns the database workers, loads commands, then logs into the Discord gateway, music extractors load in the background, off the critical path.
• Before the clusters report clusterReady, they launch Mutes, Reminds, TicketSystems, RelaxyForums, ClearingChannels, and every other feature's intervals.

• miscellaneous 38 commands
• moderation 33 commands
• image 30 commands
• administrator 25 commands
• music 24 commands
• fun 21 commands

relaxy-private/
├── start                     # launcher: ./start [--client], sets Node flags
├── index.js                  # root entry -> boots the manager
├── detect_os.js              # host detection (void / raspberry-pi / windows / linux)
├── package.json              # ESM, ~80 dependencies, no build step
├── tsconfig.json / jsconfig.json
├── bot/                      # process entry points + handlers
│   ├── Manager.js            # supervisor process entry
│   ├── Client.js             # cluster/client process entry
│   ├── commands/             # 171 commands in 6 categories
│   │   ├── administrator/  fun/  image/
│   │   └── miscellaneous/  moderation/  music/
│   └── events/               # discord/ + music/ event handlers
├── src/                      # the engine
│   ├── ModuleLoader.js  HotPatch.js  MainFrame.js  DataTable.js
│   ├── Manager/
│   │   ├── Manager.js
│   │   ├── Core/             # SelfRepair, HeartBeatManager
│   │   └── Modules/          # ClusterSpawnProcessor, ConsoleInputProcessor
│   └── Client/
│       ├── Relaxy.js         # the bot client
│       └── Modules/
│           ├── Database/     # Mongoose models (Blueprints) + Database
│           ├── MusicPlayer/  # custom player, equalizer, extractors
│           ├── VoiceRecorder/  Handlers/  Workers/
│           └── ADSR/         # active diagnosis + rate limiter
├── types/                    # 14 .d.ts type declarations
├── assets/                   # config, images, fonts, sounds, text, scripts
├── storage/                  # runtime caches (users / guilds)
└── docs/                     # STARTUP.md and other internals