Ugoku-v2

Bot Commands

Explore all the commands Ugoku has to offer.

Music Bot

Works on server Only!

/play

Play any song / playlist / album from Spotify, Deezer, YouTube, or anything supported by Yt-dlp, or an audio work (音声作品).

Example:

/play pikasonic lockdown

Options:

  • query: Search a song.
  • service: The streaming service you want to use.
  • play_next: Add the song at the beginning of the queue.
  • playlist_offset: If the query is a playlist, choose from what song index to start, defaults to 0.
  • artist_mode: Play the 10 first tracks of the queried artist if enabled.
  • album: Add an album to queue. Can't combine with artist mode.
  • effect: The audio effect to apply.

*Song search is not available for yt-dlp sources like Soundcloud, URL only.

Pro Tip:

You can query a Discord message link to play the song attached to it!

/search

Search for a song or an artist. Please note that the artist search is limited to 10 results due to Spotify API limitations. Search the name of the artist using track search for more results.

Options:

  • type: The song to search. You can paste Spotify playlist URLs.
  • query: The song or artist to search.
  • max_number_of_results: Fixed to 10 for artists. Default and max is 100 for tracks.
  • play_next: Add the song at the beginning of the queue.
  • offset: Offset the search results.
/play-custom

Play a supported song file that you send.

/skip

Skip the current song.

/previous

Play the previous song.

/pause

Pause the current song.

/resume

Resume the current song.

/seek

Forward to any position in the song (seconds).

Example:

/seek 60

Options:

  • position: The position in seconds to seek to in the current song.
/loop

Repeat / un-repeat the queue.

Options:

  • mode: Choose to loop the current 'Song' or the entire 'Queue'.
/shuffle

Shuffle / unshuffle the queue.

/pop

Remove songs from the queue.

Example:

/pop Single Nanatsukaze - もしも

Options:

  • mode: Select what song to remove.
  • song: The name of the song to remove (uses autocomplete).
  • index: The index of the song to remove. -1 for the last song.
/clear

Clear the current queue and stop the song playing.

/lyrics

Get the lyrics of the current song playing, or any song.

Example:

/lyrics query:pikasonic lockdown convert_to:English

Options:

  • query: The song name or query for lyrics.
  • convert_to: Target language or format (e.g., 'Romaji', 'Japanese Kana', 'English').
/audio-effect

Modify the audio effect of the currently playing song.

Example:

/audio-effect bass boost (mono)

Options:

  • effect: The audio effect to apply.
  • effect_only: Remove the original audio from the mix.
  • dry: [VOLUME WARNING] Amount of dry signal before processing (from 1 to 10).
  • wet: [VOLUME WARNING] Amount of wet signal after processing (from 1 to 10).
/audio-bitrate

Modify the audio bitrate of the currently playing song. Can be useful for limited internet connections.

Example:

/audio-bitrate 128

Options:

  • bitrate: The desired audio bitrate, from 1 kbps to 510 kbps (default).
/spdl

Download a song from Spotify.

Example:

/spdl https://open.spotify.com/track/3Q1UYQcegXHTlfexW2zVoQ

Options:

  • query: Spotify URL or search query for the song/playlist.
/dzdl

Download a song from Deezer.

Example:

/dzdl Ma Meilleure Ennemie

Options:

  • query: Deezer URL/ID or search query for the song/playlist.
/ytdlp

Download a song from Youtube, Soundcloud, or anything supported by Yt-dlp.

Example:

/ytdlp https://soundcloud.com/nothes2/good-morning

Options:

  • query: URL or search query for yt-dlp supported sites.
/now-playing

Delete the old Now playing embed and resend it.

/leave

Leave the current voice channel.

Chatbot / LLM

/ask

Ask Ugoku Anything.

Example:

/ask Write a Python code to display the current time

Options:

  • query: Ask Ugoku anything !
  • ephemeral: Should the message be visible by others ?
  • api: The service to use (e.g., OpenAI, Gemini).

Works on: Allowed servers Only , DMs

&

Activate the chatbot.

Example:

&Hi, who are you ?

Works on: Allowed servers Only , DMs

&-

Force to use Gemini if OpenAI is enabled. If not, this prefix has no effect.

Example:

&-Hi, who are you ?

Works on: Allowed servers Only , DMs

&&

Activate the chatbot - Continuous mode.

Example:

&&Hi, who are you ?

Works on: Allowed servers Only

/summarize

Summarize a given text, an audio file or a YouTube video.

Example:

/summarize https://www.youtube.com/watch?v=Km2DNLbB-6o

Works on: Allowed servers Only , DMs

/translate

Translate anything to any language.

Example:

/translate めっちゃいい曲だね！

Options:

  • language: The language to use.
  • nuance: The style of the translation, between neutral, casual or formal.
  • ephemeral: Should the message be visible by others ?

Works on: Server / Personal

/current-chatbot-service

Show what LLM model is currently used.

Works on: Server / Personal

/switch-chatbot-service

If OpenAI services are enabled, change the model from gpt-4.1-mini-2025-04-14 to gemini-2.5-flash-preview-04-17.

Works on: Server / Personal

/reset-chatbot

Reset the chatbot history. Does not remove Pinecone entries.

Works on: Server / Personal

/forget

Remove Pinecone entries ("vectors") from the database, corresponding to the channel or server you are in.

Options:

  • query: Search the entry you want to delete.

Works on: Server / Personal

Misc

/ping

Check Ugoku's response time.

Example:

/ping

Works on: Server / Personal

/echo

Repeat your message.

Example:

/echo Hibiki is cute

Works on: Server / Personal

/danbooru

Get any image from a tag on danbooru (SFW only).

Example:

/danbooru nanashi_mumei

Options:

  • tag: The Danbooru tag to search for images.

Works on: Server / Personal

/jpsearch

Search a Japanese word in a dictionary.

Example:

/jpsearch 響く

Options:

  • word: The word you want to lookup. Can be romaji, kana or kanji.

Works on: Server / Personal

/review

Review your cards from JPDB !

Options:

  • deck_id: Specify the id of the deck you want to review. Defaults to the first one in your list.
  • api_key: Your JPDB API key you can find in the settings. Will be saved in RAM for your next review.

Works on: Server / Personal

/get-stickers

Download any sticker set from Line.

Example:

/get-stickers https://store.line.me/stickershop/product/28492189/en

Options:

  • url: The Line url. It must start with https://store.line.me/stickershop/product/... .
  • loop: If animated, define the number of times the GIFs should loop. Defaults to 0 (infinite).

Works on: Server / Personal

/get-emotes

Get the direct URL of emotes or a sticker from a message.

Works on: Server

/config

Get the current front-end config of Ugoku !

Works on: Server

Config

Owner only commands!

/database add_emote

Add or update a chatbot emote in the database (Owner only).

Options:

  • name: The keyword for the emote (e.g. happy, sad).
  • emote_value: The emote snowflake (e.g. <:emote_name:12345>). Send an emote then put \ before to get it.
/database add_to_whitelist

Add a server/user/channel ID to a whitelist in the database (Owner only).

Options:

  • list_name: The whitelist to modify.
  • id: The ID to add.
/database remove_from_whitelist

Remove a server ID from a whitelist in the database (Owner only).

Options:

  • list_name: The whitelist to modify.
  • id: The server ID to remove.
/database backend_config

View current configurations from the database (Owner only).

/database remove_emote

Remove a chatbot emote from the database (Owner only).

Options:

  • name: The keyword of the emote to remove.