Feature Matrix

Built as a production-ready Discord music ecosystem

Hima is not just a play command bot. It contains data-layer features, premium gates, interactive components, recovery logic, and configurable behavior per guild/user.

Music Core

Lavalink Playback Layer

Queue engine, play/pause/resume/skip/stop/disconnect, autoplay, loop modes and real-time nowplaying updates.

  • Fast search routing
  • Queue pagination + controls
  • Track-stuck fallback handling
Components V2

Container-first UI

All bot responses are aligned to component-driven layouts with modern in-message controls.

  • Button interactions
  • Dropdown category switchers
  • Pagination and panel ownership locks
Audio FX

Realtime Filter Presets

Rich filter presets for users who need custom listening vibe without leaving the server.

  • Bassboost, nightcore, 8D
  • Karaoke, tremolo, radio
  • Instant filter reset
Spotify

Profile and Playlist Integration

Users can connect Spotify profile, list cloud playlists and launch playback through bot commands.

  • spconnect / spstatus
  • spplaylists browsing
  • spplay direct queue load
Premium Data

Vote + Buy Access Model

Dual premium system with timed vote access and paid token redemption for long-term guild unlocks.

  • 12h vote premium checks
  • Guild token redeem plans
  • 24/7 and musicard gates
Cloud Storage

Playlists + Favorites

Save tracks permanently, create shared playlists, import/export JSON, autosync and autoload flow.

  • Playlist ID share/import
  • Favorites from player controls
  • Queue-to-collection actions
Guild Controls

Settings and Moderation

Per-guild prefix, music channel lock, config insights and owner-only governance commands.

  • Custom prefix storage
  • Music command lock channel
  • Server list + no-prefix controls
General

AFK + Profile Tools

Advanced AFK with status, mention notifications, and profile media utilities.

  • Global/server AFK mode
  • Avatar and banner viewer
  • Member presence counters
Reliability

Recovery and Runtime Safety

Error handling and fallback logic designed for long-running music sessions across multiple guilds.

  • Graceful command error UI
  • Node reconnect awareness
  • State cleanup and panel expiry

Core Stack

Tech foundation

Node.js Runtime20+
Discord API Layerdiscord.js v14+
Music EngineShoukaku + Lavalink
DatabaseSupabase
SpotifyWeb API Integration
UI ProtocolComponents V2

Execution Flow

From command to music output

  1. Message Handler

    Prefix/no-prefix parsing, permission and premium checks.

  2. Resolver Layer

    Lavalink/Spotify search resolution and queue insert strategy.

  3. Player Pipeline

    Voice connection control, playback update and autoplay logic.

  4. Container Renderer

    Live controls, musicard visuals and interactive command panels.