Lava

由 Lavalink 驅動且擁有眾多功能且完全開源、免費的音樂機器人
閱讀更多 »

English ·
試用 · 回報問題 · 請求功能

目錄

1. 螢幕截圖
2. 開始使用
   • Spotify 支援
   • 需求
3. 用法
4. 設定
5. 計畫
6. 授權
7. 貢獻

螢幕截圖

(回到頂部)

開始使用

如果你只是想體驗的話，你可以到 Yeecord 直接使用裡面的 Lava#8364

一鍵架設

你可以透過 LavaLauncher 這個一鍵式腳本，你可以在裡面按照教學一步一步創建 Lavalink 節點 和 Discord 機器人

Docker

Docker compose

確保 Docker 已經安裝在你的電腦或伺服器上，接著：

1. Clone 這個 Repository

git clone https://github.com/Nat1anWasTaken/Lava.git

2. cd 到專案目錄

cd Lava

3. 將 example.stack.env 重新命名為 stack.env

mv example.stack.env stack.env

填入 stack.env 的內容

4. 啟動

docker compose up

Docker CLI

確保 Docker 已經安裝在你的電腦或伺服器上，接著：

1. 拉取映像檔

docker pull ghcr.io/nat1anwastaken/lava:latest

2. 設置好你的 Lavalink 節點，並將其 IP 和 Port 填入 configs/lavalink.json，如果你懶得架設 Lavalink，請使用 Docker Compose

{
    "host": "Lavalink 節點 IP",
    "port": "Lavalink 節點 Port"
}

3. 創建一個 stac.env 檔案，並填入以下內容

TOKEN=機器人 Token
SPOTIFY_CLIENT_ID=Spotify client id
SPOTIFY_CLIENT_SECRET=Spotify client secret

4. 啟動機器人

docker run -it \
  --name ghcr.io/nat1anwastaken/lava:latest \
  --restart unless-stopped \
  lava

如果你有需要跳過 Spotify 自動設定 (Go to the following url: ...)，你可以將 SKIP_SPOTIFY_SETUP 設定為 1

(回到頂部)

用法

在成功架設起機器人並邀請進伺服器後，你可以直接使用 /play 指令播放音樂，就像上方的截圖一樣

每個指令的用途都寫在了指令描述裡，你可以透過他們來學會如何使用這個機器人

(回到頂部)

設定

Lava 提供了一些簡單的設定讓你能夠輕鬆地自定義你的音樂機器人，像是：

進度條

你可以透過修改 configs/icons.json 來自定義進度條要使用的表情符號

{
    "empty": "⬛",
    "progress": {
        "start_point": "⬜",
        "start_fill": "⬜",
        "mid_point": "⬜",
        "end_fill": "⬛",
        "end_point": "⬛",
        "end": "⬛"
    },
    "control": {
        "rewind": "⏪",
        "forward": "⏩",
        "pause": "⏸️",
        "resume": "▶️",
        "stop": "⏹️",
        "previous": "⏮️",
        "next": "⏭️",
        "shuffle": "🔀",
        "repeat": "🔁",
        "autoplay": "🔥"
    }
}

狀態

你可以透過修改 configs/activity.json 來自定義機器人的狀態

{
    "type": 0, // 0: 正在玩, 1: 正在直播, 2: 正在聆聽, 3: 正在觀看
    "name": "音樂", // 狀態文字
    "url": "" // 直播連結（僅適用於直播狀態）
}

(回到頂部)

計畫

計畫已遷移至 Projects

(回到頂部)

授權

這個專案基於 MIT License，查看 LICENSE.txt 來獲取更多資訊

貢獻

你可以前往 CONTRUBUTING.md 來查看完整的貢獻指南