Qiqi Bot

如果你需要中文版的文档，请点击此处 (If you need to Chinese version documentation, click here)

Introduction

​ Qiqi Bot is a Discord Bot programmed by Discord.py. It has various functionalities to provide you a great experience with Discord.

About Qiqi

​ The word "Qiqi" originates from the game Genshin Impact. In the game, Qiqi is a cute and interesting character due to her own experience. Therefore, when the coder created this bot, he decided to choose this character as the bot's name.

​ At this point, the Qiqi Bot is NOT open-source, but it is totally free-to-use (no extra payment at all).

Supported Language

​ The primary language for the Qiqi Bot is English. While the Qiqi Bot can also support Chinese 中文 (Mandarin) for particular functionalities for Genshin Impact.

How to Invite Qiqi Bot to My Server?

​ You could invite Qiqi Bot through Top.gg/discordbotlist by searching the keyword "Qiqi". You could also copy and paste the following link to your browser to invite Qiqi Bot to your server:

    Link to invite Qiqi

    Qiqi support server

Commands

​ This part shows all the commands that Qiqi Bot has. The commands divides into five parts:

• Genshin Impact Commands
• Music Commands
• Fun Commands
• Admin Commands
• Utility Commands

​ For demonstration purposes, the command default prefix is "/" for all examples in this document.

    The prefix / is slash command and it always works. You could also specify your server custom prefix to call commands. (default as q!)

​ Use /help to view all commands within different categories.

• Old fashioned way: Use /commands all to show all the commands in. Use/commands <module> for all commands in a specific module. Use /mobilecommands all if you uses mobile phone for better message experience.

​ Use /help <command> for descriptions for a specific command name.

Genshin Impact Commands

​ Genshin Impact commands by Qiqi Bot mainly focus on the calculations of characters and weapons in this game. It can also support to check all the materials related to the characters，weapons, and related materials.

    All Genshin Impact commands supports both English and 简体中文 (Simplified Chinese). The result of language is determined by the language of command name.

    Also, Qiqi Supports glossaries for official names. You can also use common glossaries for searching information. (Example: /char ayaya for kamisato ayaka). If you think there is a common glossary that is not included, feel free to contact the developer for a patch~

Compatible with Game Version: 3.7 (Yoimiya - Tapestry of Golden Flames | Yae Miko - Everbloom Violet)

• char & 角色: show the basic information of a character. You can also role for this command!

  • Example: /char qiqi or /role qiqi

• talents & 天赋: show the all talents (including passive talents) of a character!

  • Example: /talents qiqi

• cons & 命之座: show all constellations of a character!

  • Example: /cons qiqi or /constellation qiqi

• rolecalc & 角色计算: Calculate role ascension exp, mora, and materials. Enter the role name first and :. Then enter low level and high level next, separated by -. Alternative/Informal name of roles/characters are supported (Most of them huh). All levels (1 - 90) are supported.

  • Example (diluc, from level 26 to level 73): /rolecalc diluc: 26 - 73 (Spaces between data and symbols are fine with Qiqi Bot)
  • Example (Alternative Name for zhongli: Morax, 66 - 89): /rolecalc Morax:66-89 (Capitalization are fine with Qiqi Bot)

• weaponcalc & 武器计算: Calculate weapon ascension exp, mora, and materials. Enter the weapon name first and refinement level from low-level to high-level. (refinement level range: 1 - 5) and then:. Note that refinement level is not REQUIRED (default is 1). So, you could just enter the weapon name and then :. Then enter low level and high level, separated by -. Alternative/Informal name of weapons are supported. (Still most of them haha). All levels (1 - 90) are supported. All weapons(star 1 - 5) are supported.

  • Example (wolf's gravestone, refinement level 2 - 5, 36 - 68): /weaponcalc wolf's gravestone(2-5): 36 - 68
  • Example (WGS, informal abbrev. for wolf's gravestone, no refinement, 36 - 68): /weaponcalc WGS: 36 - 68

• talentcalc & 天赋计算: Calculate the talent needed mora and ascension materials. Enter the name of the role first and then :, Then enter the skill that you want to check (it could be at least 1 skill. It could also be multiple skills separated by ,) The skill (A means normal attack, E means elemental skill, Q means elemental burst) should be followed by =, And after = is the low-level - high level that you want to check for this skill. All levels 1 - 10 are supported.

  • A little bit complicated. But really nice to use. I will show you several examples for demonstration :-)
  • Example (diluc, only want to check elemental skill from lv. 2 to lv. 8): /talentcalc diluc:E=2-8
  • Example (eula, normal attack 1 - 6, elemental burst 1 - 9): /talentcalc eula: A= 1-6, Q = 1 - 9 (spaces are fine with Qiqi Bot)
  • Example (xingqiu, normal attack 1 - 6, elemental skill 2 - 9, elemental burst 3 - 10): /talentcalc xingqiu: A = 1 - 6, E = 2 - 9, Q = 3 - 10

• material & 材料: Show the information about this specific genshin impact material. (Currently supported all the materials related to characters and weapons). glossaries/alternative name for materials are also supported.

  • Example(philosophy of freedom): /material philosophy of freedom

• allroles & 所有角色: show all the characters that Qiqi supports at this moment! You could check roles with a specific element also by input the element after this command.

  • Example(all characters): /allroles
  • Example(cryo characters): /allroles cryo

• allweapons & 所有武器: show all the weapons that Qiqi supports at this moment! You could check weapons with a specific stars or weapon type.

  • Example(all weapons): /allweapons
  • Example(4-star weapons): /allweapons 4
  • Example(catalyst weapons): /allweapons catalyst

• allmaterials & 所有材料: show all the materials that Qiqi supports at this moment! You could view weapon with a specific category (optional): (talent materials | weapon_materials | character materials | enemies | common enemies | elite enemies | normal boss materials | weekly boss drops | local specialities)

  • Example: /allmaterials
  • Example(character materials): /allmaterials character materials

• wishes & 祈愿: show the current wishes opened in Genshin Impact!

  • Example: /wishes

• dbupdate & 数据库更新: check the update progress of Qiqi Genshin Impact database!

  • Example: /dbupdate

Music Commands

​ Qiqi loves playing music for you! It can play the music by YouTube video by url/keywords, Bilibili video by url/keywords, Netease music by url/keywords, Spotify music by url/keywords. It is recommended that Qiqi has manage_messages permission for playing music. If you search the music by keywords, Qiqi will return you 5 choices for you to choose. Isn't that nice?

    Something nicer is that Qiqi now supports to load your custom playlist from mystb.in website. So you can choose your tracks from YouTube, Bilibili, Netease, and Spotify in a single playlist! (Check out Music Custom Playlist)

    Something much nicer is that Qiqi also supports personal (cross-server) favorite playlist in discord. You could add your favorite songs in your own favorites and play it. (See more descriptions Music Favorites)

• play: Qiqi will join your voice channel and play the music. You can directly play:

  • YouTube video url or search by keywords:

    • Example(YouTube by url): /play https://www.youtube.com/watch?v=mWRsgZuwf_8 (please don't forget the https:// for url)

    • Example(YouTube by keywords): /play demons imagine dragons and Qiqi will return your 5 choices. Then you could simply enter number 1-5 to choose the track (You don't need to enter play again for choosing).

  • Bilibili video，play command ONLY supports Bilibili url or video id (av or bv). If you want to search Bilibili by keywords, use bilibili command:

    • Example(Bilibili by url): /play https://www.bilibili.com/video/BV18X4y1N7Yh
    • Example(Bilibili by video-id): /play BV18X4y1N7Yh

  • Netease music ，play command ONLY supports Netease Music url. If you want to search Netease by keywords, use netease command:

    • Example: /play https://music.163.com/#/song?id=1807381939

  • Spotify music, play command ONLY supports Spotify Track url. If you want to search Spotify Track by keywords, use spotify command:

    • Example: /play https://open.spotify.com/track/6MZoXnbjDE2VgUWeMJgrrn

• bilibili: Qiqi will play bilibili video by direct URL/aid/bvid or searching keywords.

  • Example(Bilibili by url): /bilibili https://www.bilibili.com/video/BV18X4y1N7Yh

  • Example(Bilibili by aid/bvid): /bilibili BV18X4y1N7Yh

  • Example(Bilibili by keywords): /bilibili Never gonna give you up

• netease: Qiqi will play netease music by direct URL or searching keywords.

  • Example(Netease music by url): /netease https://music.163.com/#/song?id=1807381939

  • Example(Netease music by keywords): /netease Never gonna give you up

• neteaseplaylist: Qiqi will play netease playlist by direct URL or searching keywords.

  • Example(Netease playlist by url): /neteaseplaylist https://music.163.com/#/playlist?id=5328007337

  • Example(Netease playlist by keywords): /neteaseplaylist rick roll

• neteaseuser: Qiqi will search the netease user profile by direct URL or keywords. You can also click on playlist button to see the user's public playlist.

  • Example(Netease user by url): /neteaseuser https://music.163.com/#/user/home?id=1321189664

  • Example(Netease user by keywords): /neteaseuser hoyo-mix

• mynetease: Qiqi will have two kinds of response based on your command: information/profile of "linked" netease user or "link" a netease user for you. This only tells Qiqi the netease user you want to set to. This doesn't mean to login to your netease account so Qiqi will never ask you for password. Therefore, it could be any netease user basically.

  • Example(Set a netease user by homepage url): /mynetease https://music.163.com/#/user/home?id=1321189664

  • Example(Set a netease user by searching name): /mynetease hoyo-mix

  • Example(check my "linked" netease user profile): /mynetease

• playmynetease: Qiqi will play the number specified playlist based on your "linked" netease user (set by /mynetease <user>). You can always check the playlist number by /mynetease and click playlist button.

  • Example(Play playlist number 3 of my "linked" user, if applicable): /playmynetease 3

• newsongs: Qiqi will show the new songs released on Netease based on specified region: Chinese, EU & America, Japanese, Korean

  • Example(New songs in EU & America): /newsongs EU & America

• spotify: Qiqi will play Spotify track (music) by direct URL or searching keywords.

  • Example(Spotify music by url): /spotify https://open.spotify.com/track/6MZoXnbjDE2VgUWeMJgrrn

  • Example(Spotify music by keywords): /spotify Genshin Impact Main Theme

• spotifyplaylist: Qiqi will play Spotify playlist by direct URL or searching keywords.

  • Example(Spotify playlist by url): /spotifyplaylist https://open.spotify.com/playlist/151KKX3jvHH9FFgQKoaDC0

  • Example(Spotify playlist by keywords): /spotifyplaylist Genshin Impact OST

• spotifyalbum: Qiqi will play Spotify album by direct URL or searching keywords.

  • Example(Spotify album by url): /spotifyalbum https://open.spotify.com/album/2S4UIiVgsFwV2e1vElIMjq

  • Example(Spotify album by keywords): /spotifyalbum Genshin Impact - Realm of Tranquil Eternity

• spotifyartist: Qiqi will search Spotify artist and display information and artist's albums. You could search spotify artist by direct URL or searching keywords.

  • Example(Spotify artist by url): /spotifyartist https://open.spotify.com/artist/2YvlK6lKiKVjXxsjvNbnqg

  • Example(Spotify artist by keywords): /spotifyartist HOYO-MIX

• join: Qiqi will join your voice channel.

  • Example: /join

• leave: Qiqi will leave your voice channel.

  • Example: /leave

• pause: Qiqi will pause the music if it is playing at this moment.

  • Example: /pause

• unpause: Qiqi will unpause the music if it is paused.

  • Example: /unpause

• stop: Qiqi will remove all tracks in the queue and leave the voice channel.

  • Example: /stop

• skip: Qiqi will skip the track(s) by 4 different ways.

  • Example(skip the current playing one): /skip
  • Example(skip the specific nth track, n is a number): /skip n
  • Example(skip the specific range of tracks, x and y are numbers): /skip x-y
  • Example(skip all the tracks queued by a specific user): /skip @user

• queue: Qiqi will show you the current queue or searches specified song position by keywords (doesn't need to be exact name).

  • Example(showing the queue): /queue
  • Example(searching the song position if applicable): /queue never gonna give you up

• jump: Qiqi will jump your selected song to the top one in the waitlist. By using the number of the selected song in the queue to jump the song.

  • If there is no song playing, Qiqi will jump the song to the #1. Otherwise, Qiqi will jump the song to #2, which will be played next after the currently playing one.
  • Example: /jump 5 (jump #5 song in the queue to the top one in the waitlist)

• shuffle: Qiqi will shuffle the all songs (except currently playing one if applicable) in the queue. (Mechanism similar to function jump)

  • Example: /shuffle

• repeat: Qiqi can repeat a the current playing track(s) (song(s)) for you. If the bot is not playing at this moment, Qiqi will set the first song in the queue to be repeated. You could also turn the repeat off by this command.

  • Example(repeat a single song): /repeat single
  • Example(repeat off): /repeat off
  • Example(repeat all the queue): /repeat all

• nowplaying: Qiqi will show the information about the now-playing track.

  • Example: /nowplaying

• history: Qiqi will show you the history tracks from your server. At this stage, Qiqi supports at most 50 history tracks info for each server.

  • Example: /history

• playhistory: Qiqi will play the song in your history list by giving the number of that track. So you don't need to search keywords or copy url again if this track is played recently! If you forgot the number of the track in history list. You could proceed /history first.

  • Example(play the track with number 8 in history list): /playhistory 8

• voteskip: Qiqi will start a voting about skip. Everyone in the same voice channel as the bot's voice channel can vote by clicking the "check mark" reaction under bot's message. Don't forget to also click check-mark even if you start the vote skip. The song will be skipped if the vote rate is greater or equal to 75%.

  • Example(skip track number 5): /voteskip 5

  • Example(skip the whole queue): /voteskip queue or /voteskip all

• export: Save your current queue and history. Qiqi will export urls & name of tracks to mystb.in and give you the two links: one for queue and one for history.

  • Example: /export

• reset: Reset Qiqi and clear all your server music list (queue & history), excluding custom playlist. (Use deletecp to delete custom playlist). This only need to be used when there is a bug/incorrect number about queue or history. Permission manage_server is needed

  • Example: /reset

• restart: Restart the current playing song.

  • Example: /restart

• seek: Seek the position of the current playing song by the time specified. Qiqi supports 3 formats of time: number of seconds, MM:SS, HH:MM:SS. (Note that if the time specified is longer than the total duration of the song, Qiqi will seek the last second of the song)

  • Example (These 3 ways mean the same): /seek 100 OR /seek 1:40 OR /seek 0:01:40

• forward: forward the position of the current playing song by the time specified. Qiqi supports 3 formats of time: number of seconds, MM:SS, HH:MM:SS. (Note that if the target time is longer than the total duration of the song, Qiqi will forward to the last second of the song)

  • Example (These 3 ways mean the same): /forward 30 OR /forward 0:30 OR /forward 0:00:30

• rewind: Rewind the position of the current playing song by the time specified. Qiqi supports 3 formats of time: number of seconds, MM:SS, HH:MM:SS. (Note that if the target time is before the first second of the song, Qiqi will rewind to the first second of the song)

  • Example (These 3 ways mean the same): /rewind 65 OR /rewind 1:05 OR /rewind 0:01:05

• volume: Adjust the volume of the music that is currently playing. The range is from 0% to 100%. The default volume for each music is 70% (to avoid the problem of excessive volume) (Temporarily removed)

  • Example(Adjust volume to 50%): /volume 50

• sleep: set a timer (unit: minutes) and Qiqi will remove all members (including Qiqi) from the voice channel when times up. There will be a precision error that may vary between 0 - 30s. Permission move_members is needed.

  • Example (set a timer of 45 minutes): /sleep 45
  • Example (cancel the timer): /sleep 0

Music Custom Playlist

    To design your custom playlist, there are 5 steps you need to follow!

1. you need to go to mystb.in to create your playlist.

2. You need to paste your music url one for each line. You could optionally add a short name (32 character maximum) for this url (strongly suggested). There should be a space between the url and the name. There should not be anything else except the music url and short name. Four websites (Netease, Bilibili, and YouTube, Spotify) are supported and you can mix them in one playlist!

   Example of a line (suggested): https://www.youtube.com/watch?v=3WPl7p-EVHg of Liyue Clouds and Seas

   Example of a line (works, but not suggested): https://www.youtube.com/watch?v=3WPl7p-EVHg

   Warning: There must be a space between url and the short name. No other symbols (e.g. :,#!.-+^/;) allowed.

3. After you finished creating the playlist, you click the "Save Paste" button. The url will be automatically copied to your clipboard.

4. Check the url area of your browser. After the quick save, mystb.in will give you a permanent link to your playlist.

5. Use /playcp to play this custom playlist or /savecp to save your playlist by Qiqi.

(If you are still confused about how to create the playlist, see FAQ section question 9 and also you could ask this in Qiqi Discord Support Server)

    Important fact

• Qiqi can save 5 playlists url for each server! Then you can use /playcp command to play with saved playlist number. For example(play stored playlist 3): /playcp 3

• Each playlist should have no more than 100 songs.

• Loading playlists might take time. Qiqi will start playing the first one while loading the rest of songs. Be a little bit patient. Qiqi is trying her best!

• When you call /savecp command, you need to give a short name to help yourself to remember what this playlist url is about.

• You could remember cp as the abbreviation of "custom playlist". This can help you remember the shorter form of commands.

    Commands

• playcp: Qiqi will play the specified custom playlist from mystb.in. You can use this command to directly play the url of the playlist or you can type number to play the "stored custom playlist". (Check on https://www.botqiqi.com for more instructions of how to create custom playlist on mystb.in)

  • Example(play mystb.in url directly): /playcp https://mystb.in/HeartHillInteger.less

  • Example(play saved custom playlist 3): /playcp 3

• savecp: Qiqi will save your given playlist url. With this functionality, you don't need to remember your custom playlist url anymore, Qiqi will do this part for you. You need to first provide the url then provide a short name for this playlist (no more than 16 characters). You can view your saved custom playlist by /viewcp command. If there are already 5 playlists (maximum for each server), Qiqi will ask you to replace your new playlist to a older playlist by giving a number between 1-5

  • Example(save my playlist url with name "Rickroll"): /savecp https://mystb.in/HeartHillInteger.less Rickroll

• viewcp: Qiqi will show all your saved playlist to you!

  • Example: /viewcp

• deletecp: Qiqi will delete your specified custom playlist among saved playlists. You could specify a number or you could type "all" to delete all saved playlists.

  • Example(delete saved playlist number 4): /deletecp 4

  • Example(delete all saved playlist): /deletecp all

Music Favorites

    Qiqi Bot can remember your own favorite tracks and you could play them cross-server. There's a 100 songs maximum for you. Also, you could export it to mystb.in to make it a custom playlist.

    Commands about Favorites are all private (conversation only shown to you) except playfavorite command if you use slash prefix /

• addfavorite: You could add a song to be your favorite list. There are two ways of adding:

  1. Adding a general song with url and name to the list

     • Example: /addfavorite http://www.youtube.com/watch?v=dQw4w9WgXcQ Never Gonna Give You Up

     • P.S: The name of the song (customized by you) has a maximum character limit of 32.

  2. Adding the current playing song (played by Qiqi Bot now)

     • Example (all info will be handled by Qiqi): /addfavorite

• viewfavorite: You could view your list of favorites. (Qiqi will not show the url since it's long and lack of viewing experience but Qiqi definitely remembers it ~). Also, it supports two modes of chronological sorting: latest to earliest OR earliest to latest. The default is latest to earliest.

  • Example (default as latest to earliest): /viewfavorite
  • Example (earliest to latest): /viewfavorite earliest

• deletefavorite: You could delete songs in your list of favorite by its number (in the list) or delete the all songs in the list. If you need to view the songs in the list, use command viewfavorite. Also, it supports two modes of chronological sorting: latest to earliest OR earliest to latest. The default is latest to earliest.

  • Example (delete #3 song in the list if it exists, with default sort): /deletefavorite 3

  • Example (delete #3 songs in the list if exists, with earliest to latest): /deletefavorite 3 earliest

  • Example (delete all songs in the list): /deletefavorite all

• playfavorite: You could play a song/all songs from your list directly. Note that this conversation can be seen by other members in the server even slash prefix is used. Also, it supports two modes of chronological sorting: latest to earliest OR earliest to latest. The default is latest to earliest.

  • Example (play #3 song in the list if it exists, default sort): /playfavorite 3

  • Example (play #3 song in the list if it exists, earliest to latest): /playfavorite 3 earliest

  • Example (play all songs in the list, default sort): /playfavorite all

  • Example (play all songs in the list, earliest to latest): /playfavorite all earliest

• exportfavorite: Export your list of favorites to mystb.in in the format of custom playlist(url & name). Also, it supports two modes of chronological sorting: latest to earliest OR earliest to latest. The default is latest to earliest.

  • Example (default, latest to earliest): /exportfavorite
  • Example (earliest to latest): /exportfavorite earliest

Fun Commands

​ Fun commands are open to everyone in the server except the muted users. All the user commands have no restricted permissions. More commands are coming soon. And please contact me to brainstorm more ideas. Have Fun!

• 8ball: Ask Qiqi a question and Qiqi will answer you with her idea!

  • Example: /8ball is Qiqi happy today?

• ping: Ping to Qiqi to test the latency to Qiqi.

  • Example: /ping

• bmi: Calculate BMI result based on weight and height. Enter weight first and then enter the height. Then choose the unit (metric & imperial). You could also specify BMI standard in the end (optional). The default standard is WHO standard if no standard specified in the input.

  • Example (70kg, 1.78m, default WHO standard): /bmi 70 1.78 metric
  • Example (English system, 200 pounds, 6 ft 8 in, Japan standard): /bmi 200 6'8'' Japan
  • Supported Standards: WHO, China, HongKong, Singapore, Japan.

• calcgpa: Qiqi will calculate GPA for you based on your input academic scores and credits. Your message will be deleted immediately right after you sent to protect your privacy. And the result will be sent to you by DIRECT message. (Privacy Protection)

  • It has two modes: different or same credits for classes. (All classes have the same credits if you choose same credit modes by entering =credit)

  • 3 grade formats are supported: letter grade like B+, score points like93.5, GPA grade(by putting word "gpa" after the grade 3.7gpa)

  • if you have different credits for classes. Enter credits:grade and separates classes by ,

  • Example (different credits for classes): /calcgpa 5.0:95, 4:A-, 2.0: 2.7GPA (5 credit course with 95 and 4 credit course with A-, 2 credit course with 2.7GPA)

  • Example (same credits for classes): /calcgpa =credit A-, 93, 2.7GPA (three same credits class with grade A-, 93, and 2.7GPA)

• choose: Give possible amounts of choices to Qiqi and Qiqi will pick one for you. It sometimes help people with allodoxaphobia a lot! But remember to separate your choices by semicolon ;

  • Example: /choose hamburger; sandwich; noodles; fried-chicken; noodles; pizza

• echo: Qiqi would definitely repeat what you just said!

  • Example: /echo Hello!

• eightball (or _8ball, 8ball): It asks a specific question to Qiqi and Qiqi will give her answer back.

  • Example: /eightball Is Qiqi happy today?

• gpascale: Qiqi will show you the GPA scale.

  • Example: /gpascale

• roll: Give a range of numbers by pointing out lower bound and higher bound of range and connects with the symbol - . (The default result will be only 1 result. If you want to specify result number, you will add a number for result after range). This command only supports for positive integers for lower and higher bounds, and this command only return non-repeating results.

  • Example (roll a number from range 5 to 10): /roll 5-10

  • Example (roll three numbers from rang 10 to 20): /roll 10-20 3

• rollrepeat: Give a range of numbers by pointing out lower bound and higher bound of range and connects with the symbol - . (The default result will be only 1 result. If you want to specify result number, you will add a number for result after range). This command only supports for positive integers for lower and higher bounds, and this command allows providing repeating results.

  • Example (roll a number from range 1 to 5): /rollrepeat 1-5
  • Example (roll 10 numbers from range 5 to 10): /rollrepeat 5-10 10

• fortune: Check out your luck today! You could only check your luck once a day with Qiqi!

  • Example: /fortune

• trans or translate: Translate your input to specified language. There's no need to specify the input language type since Qiqi will automatically detects it. If no target language specified, Qiqi will translate the text to English.

  • Example(no specified target language): /trans hello

  • Example(translate to spanish): /trans =spanish hello or /trans =es hello

• time: check local time of by the location specified.

  • Example(local time in Beijing): /time beijing

• weather: check the current weather of the city specified. Qiqi will provide you both celsius and fahrenheit temperature with a lot of other useful weather information!

  • Example(weather in London): /weather london

• wolfram or wolframalpha: you could simply ask your question and Qiqi will give back the answer from wolframalpha.com

  • Example(ask: capital of China): /wolfram capital of China

  • Example(ask: derivative of x^3): /wolfram d/dx(x^3) or /wolfram derivative of x^3

• pat: Qiqi will send you a gif for pat! You could pat someone by @username.

  • Example: /pat
  • Example(pat user if exists): /pat @user

• hug: Qiqi will send you a gif of hug. You could hug someone by @username.

  • Example: /hug
  • Example(hug user if exists): /hug @user

• cry: Qiqi will send you a gif of cry. You could cry to someone by @username.

  • Example: /cry
  • Example(cry user if exists): /cry @user

• cuddle: Qiqi will send you a gif of cuddle. You could cuddle someone by @username.

  • Example: /cuddle

  • Example(cuddle user if exists): /cuddle @user

• vote: Upvote Qiqi to help more people to know about Qiqi!

  • Example: /vote

• rps: Play rock-paper-scissors game with another server member. You could also play with Qiqi if you want.

  • Example: /rps @user

• magic: Only Paimon knows what this command is about. Qiqi forgot.

Admin Commands

​ Admin commands are designed for the convenience for managing server. In order to use managing commands, users need different permissions based on commands. For permissions, if the user is administrator, then that user does NOT need any permission below and still can process these commands.

• ban: ban a user from the server. Permission ban_member is needed.
  • Example: /ban @user
• unban: unban a user from the server. Permission ban_member is needed.
  • Example: /unban @user
• clear: Qiqi will clear specific amount of message. (Maximum of 100 messages for one command) Permission manage_messages is needed.
  • Example(clear 10 closest messages in the current chat history): /clear 10
• changeprefix: Qiqi will change the custom prefix of the server. Default as q! (This is not for slash command prefix /) Permission manage_message is needed.
  • Example(change prefix to "qiqi"): /changeprefix qiqi
• kick: Qiqi will kick the member out of the server. Permission kick_member is needed.
  • Example: /kick @user optional:reason
• mute: Qiqi will mute someone for you. Permission manage_messages and mute_member are needed. After the specific person is muted, he/she cannot send any text to any channel or speak in any voice channels.
  • Example: /mute @user optional: reason
• unmute: Qiqi will unmute someone for you. Permission manage_messages and mute_member are needed.
  • Example: /unmute @user
• tempmute: Qiqi will temporarily mute someone for you. Permission manage_messages and mute_member are needed. Time limit must be specified when processing this command. Maximum time limit is 1 day and time can be specified by d (day), h (hour), m (minute)or s (second). User will automatically unmuted after the specified time. Tempmute also supports time add-on, which means you can use the command for the same target user again and time will sum up.
  • Example (mute for 2 hours): /tempmute @user 2h
  • Example (if you want to unmute the user got tempmute before scheduled time): /unmute @user
• deafen: Or deaf. Qiqi will deafen someone for you. Permission deafen_members is needed. Deafen is only working if the target user is connected to voice channels. This will be a server-side deafen.
  • Example: /deafen @user
• undeafen: Or undeaf. Qiqi will un-deafen someone for you. Permission deafen_members is needed. Undeafen also works only if the user is connected to voice channel.
  • Example: /undeafen @user
• audit: Or al. Qiqi will provide specific amount of most recent audit logs of the servers to you. Permission view_audit_logs is needed. For the current version, the maximum number of logs that Qiqi can provide is 20.
  • Example (view most recent 15 logs): /audit 15

Utility Commands

    Utility commands are some useful commands about the bot itself. For example, like monitoring Qiqi bot information, invite Qiqi Bot to a new server, and so on.

• invite: invite the newest Qiqi Bot to your server. Qiqi will send you a direct invite message.

  • Example: /invite

• userinfo: Check the user's (in the server) public profile by @user.

  • Example: /userinfo @user

• update: See brief reports about recent updates and versions about Qiqi Bot

  • Example: /update

• qiqi: check the current conditions and info about qiqi.

  • Example: /qiqi

• policy: Check out the policy rules, explanations, and statements that Qiqi follows and how Qiqi protects your privacy when using it!

  • Example: /policy

• credits: credits about Qiqi Bot.

  • Example: /credits

• feedback: Send feedbacks to Qiqi Bot developer about bugs, suggestions, or even feature requests for future updates.

  • Example: /feedback

• doc: View official documentation website of Qiqi Bot.

  • Example: /doc

FAQ

1. Why the bot fails to invite to my server?

   Don't rush to give a bad review please. The bot is applied to discord for verification. Before the verification is done, the bot can only add up to 75 servers. You could join the Qiqi Bot server to know the newest update and invite link.

2. Why the bot may sometime unresponding?

   This may due to the reasons that the the developer is modifying the bot configuration on the backside. Usually, this won't take a long time. Detailed update information are always announced in the Qiqi support server.

3. I forgot my bot custom prefix?

   You could always @ the bot in the text channel, then bot will return the current custom prefix that your server set. Also, you can always use / for slash command.

4. Why Qiqi told me that I sent commands too fast?

   Qiqi will detect the frequency of a user entering commands. If the user sends it too fast, Qiqi will set a cooldown for him to cool him down! Normal uses will mostly not be affected by Qiqi's cooldown.

5. Why Qiqi sometimes failed to play my music?

   Qiqi could experience that fails to play music from YouTube. But this is mostly a YouTube side problem, bot developer still trying to find another way out.

   If the music is still in the queue (you could check it by /queue) and the music doesn't automatically play, try /unpause the music. This might happen due to a network connection problem on Discord.

6. Why tempmute doesn't automatically unmute the user?

   This could happen if Qiqi Bot restarts by update restarts. If this happens to you, you can manually unmute the person by /unmute @user. Developer is seeking for a better way to solve this. Also, it would be a good suggestion to join the Qiqi Bot Support Server since all the updates and Bot restarts will be told in the "Updates announcements channel" in the support server.

7. Why my admin commands are not working for some members?

   This is because you need to change the role hierarchy level of Qiqi to higher level. This is not a complicated setup, only with 3 steps in the picture below! You must at least have a manage_roles permissions to do this (admin is recommended). Here are the picture!

   

8. Why translate command never translate to the language that I specified?

   This is because you need to specify the target language before your text. And don't forget to mention it first and then followed by your text. Example(translate to spanish): /translate es hello!

9. Why mystb.in doesn't give me the permanent link / How should I save my custom playlist?

   When you finish designing custom playlist, you should click the "Save Paste" button on the top right position of the webpage.

   

   After clicking the "Save Paste" button, you could now see the link is automatically copied to your clipboard, which means you could ctrl+v to paste it to anywhere you want.

   

   You could take this url and interact with Qiqi. For example: the playcp command.

   

10. Why I cannot see the DM invitation link Qiqi sent me?

    This is because you turned off the "direct message from server member" permission under your "privacy & safety" category. You can turn it on and type invite again to receive latest invitation link.

    

11. How to enable slash command in my server?

    It is really simple to enable the slash command by only 1 command /enableslash (You only need to use this command for once) and follows the instruction by the response. If you invite Qiqi after 06/15/2022, slash is automatically enabled.

12. Why my actions about favorite list (except playfavorite) can still be seen by other members in the server?

    It is because you need to use slash command prefix / to call these commands instead of server custom prefix. (Discord does not support "only you can see this" for commands that are called without slash command prefix).

13. Why am I getting [Err:403] when playing a song?

    There is a small chance of countering 403 error while trying to play music. And this is not part of error or code bug of Qiqi Bot. It is an error on YouTube side. If you encountered this error and wanted to play it again, the fastest way is to use /playhistory 1 to make Qiqi load the song again.

14. Why am I getting [Err:400] when playing Netease music?

    For now, Nearly all [Err:400] error happens when you try to play a Netease playlist or Spotify playlist/album. Don't worry about this error. It mostly means the specified music cannot be played on Netease/Spotify side due to copyrights issue. If the song can actually be played in your Netease/Spotify Music app, you are welcomed to contact developer for a quick fix.

15. How can I view the playlists of the netease user that I set?

    Simply by /mynetease without any other input. Then Qiqi will show you the netease user "linked" to you if applicable.

16. I got so confused on the new play/bilibili/netease/spotify commands.

    Basically Qiqi keeps the functionality of play command as it was (before v1.4) and added three new commands: bilibili, netease, and spotify. See this table below for knowing what they can do.

    	play	bilibili	netease	spotify
    YouTube video by url	Yes	No	No	No
    YouTube video by keywords	Yes	No	No	No
    Bilibili video by url/avid/bvid	Yes	Yes	No	No
    Bilibili video by keywords	No	Yes	No	No
    Netease music by url	Yes	No	Yes	No
    Netease music by keywords	No	No	Yes	No
    Spotify track by url	Yes	No	No	Yes
    Spotify track by keywords	No	No	No	Yes

17. Why Qiqi can play songs by URL but fail to respond for searching keywords?

    (This should not happen after 01/31/2023). Simply because Qiqi doesn't have the permission manage_messages. (This is included in the default invite url). But if you want to modify invite url, please make sure Qiqi has manage_messages permission.

18. Why my custom playlist does not load the track(song)s' name correctly but showing "A song from ..."?

    This is because of the Qiqi Bot updates on 1.4.9.0. The track will still be all loaded to the queue with correct order. But if you want to have a name for them, you need to add a short name after your url in your custom playlist. Here are the line of example showing the changes.

    Before (still work, but no detailed name for each track): https://www.youtube.com/watch?v=3WPl7p-EVHg

    After (strongly suggested): https://www.youtube.com/watch?v=3WPl7p-EVHg 璃月云海

19. How can I know the latest update and new features?

    You could join the Qiqi Bot Support Server. Here is the link

    Bubu Pharmacy - Qiqi support server

Aliases

    Aliases is for users who would like to call the command differently than the primary one. For example, you could call command "play" with /play. But Qiqi also supports you to call this command by /p, /listen for your convenience. (They are the same. Just a command with different alias). If you would like to add an alias for a command, feel free to contact developer.

    Important Note!!!: slash command only supports primary name version of the command name. (discord limitation). You can only call command use aliases by server custom prefix.

    Another Important Note: Due to Discord limit of 100 slash commands, Qiqi has no choice but to remove slash access for some commands. (they can still be called by custom prefix). Check the column 'Slash Command?' for slash command availability.

• • If yes, it means you could call this command by slash / (with primary name) or custom server prefix (with primary name or aliases).
• • If no, it means you could only call this command by custom server prefix (with primary name or aliases).
• • Just as a reminder, default custom server prefix is q!. You can change it by changeprefix command. And @Qiqi if you forget about the custom server prefix.

• Genshin Impact Section

  Command Primary Name (English)	Command Primary Name (Chinese)	Available Aliases	Slash Command?
  character	角色	character |  role | char | charinfo |  roleinfo | characterinfo | 角色信息 | 角色基础信息 | 人物 | 人物信息 | 人物基础信息	Yes
  talents	天赋	talent| skills| skill| 角色技能| 技能| 人物技能| 角色天赋| 人物天赋| 天赋技能| 技能天赋	Yes
  cons	命之座	con| consts| const| constellations| constellation| 命座| 星之座| 星座	Yes
  rolecalc	角色计算	girole| rcalc| genshinimpactrole| 原神角色计算	Yes
  weaponcalc	武器计算	giweapon| genshinimpactweapon| wcalc| 原神武器计算	Yes
  talentcalc	天赋计算	gitalent| genshinimpacttalent| tcalc | 原神天赋计算	Yes
  material	材料	mat| gimaterial| genshinimpactmaterial | 材料计算| 材料查询| 原神材料计算| 原神材料查询| 原神材料	Yes
  allroles	所有角色	roles| allrole| allchar| allchars| allcharacters | 支持角色| 全角色| 全部角色| 所有的角色| 支持的角色| 全部的角色	Yes
  allweapons	所有武器	weapons| allweapon | 支持武器| 全武器| 全部武器| 所有的武器| 支持的武器| 全部的武器	Yes
  allmaterials	所有材料	materials| allmaterial | 支持材料| 全材料| 全部材料| 所有的材料| 支持的材料| 全部的材料	Yes
  wishes	祈愿	wish| currentwish| currentwishes| allwishes| allwish | 所有祈愿| 当前祈愿	Yes
  dbupdate	数据库更新	genshinupdate| giupdate | 原神数据库更新	Yes

• Music Section

  Command Primary Name	Available Aliases	Slash Command?
  play	p| listen	Yes
  bilibili	bili | b | b站	Yes
  netease	neteasecloudmusic | neteasemusic | music163 | wangyi | wangyiyun | 网易 | 网易云 | n	Yes
  neteaseplaylist	npl | neteasep | nplaylist | 网易云歌单	Yes
  neteaseuser	usernetease | nuser | neteasemusicuser | 网易云用户	Yes
  mynetease	mn | myneteaseuser | 我的网易云	Yes
  playmynetease	pmn | pmynetease | pmyn | 播放我的网易云	Yes
  newsongs	neteasenewsongs | newsong | newsongs163 | newsongsnetease | ns | 新歌速递 | 新歌推荐	Yes
  spotify	spot | sp | spt | sptf	Yes
  spotifyplaylist	spotpl | sppl | sptpl | sptfpl | spotifypl | spotplaylist | spplaylist | sptplaylist | sptfplaylist	Yes
  spotifyalbum	spotalbum | spalbum | sptalbum | sptfalbum	Yes
  spotifyartist	spotartist | spartist | sptartist | sptfartist | spotifyartists | spart	Yes
  join	j	Yes
  leave	l	Yes
  pause	suspend	Yes
  unpause	resume	Yes
  stop	terminate| skipall	Yes
  skip	playnext| skipover	Yes
  queue	allsongs| songs	Yes
  jump	jump to queue| jumptoqueue	Yes
  shuffle	mix| intermix	Yes
  repeat	rep|loop | loop playback | loopplayback	Yes
  nowplaying	playingnow| currentlyplaying| currentplaying| now-playing| playing-now| nowplay | np	Yes
  history	allhistory| historysongs| pasttracks| histories| musichistory| musichistories	Yes
  playhistory	playprevious| playprevioussong| playbefore | ph	Yes
  voteskip	votetoskip| skipvote| vote2skip	Yes
  export	exportplaylist| exportqueue| exporthistory| exportsongs| exportallsongs	Yes
  reset	destroy | resetmusic	Yes
  playcp	playcustomqueue| playcustom| playcustomplaylist| customplaylistplay| playmystbinplaylist| playcustomlist| pcp	Yes
  savecp	savedplaylist| savedqueue| savequeue| storeplaylist| storequeue| savecustomplaylist| scp| saveplaylist	Yes
  viewcp	viewcustomplaylist| customplaylist| viewplaylistcustom| showcustomplaylist| showplaylistcustom| vcp	Yes
  deletecp	deletecustomplaylist| deleteplaylistcustom| removecustomplaylist| removeplaylistcustom| removecp| rcp| dcp	Yes
  addfavorite	addf | af | favoriteadd | addfavourite | favouriteadd	Yes
  viewfavorite	viewf | vf | viewfavourite | favoriteview | favouriteview	Yes
  deletefavorite	deletef | df | deletefavourite | favoritedelete | favouritedelete	Yes
  playfavorite	playf | pf | playfavourite | favoriteplay | favouriteplay	Yes
  exportfavorite	exportf | ef | exportfavourite | favoriteexport | favouriteexport	Yes
  restart	replay | startover	Yes
  seek	locatemusic | lm	Yes
  forward	onward | ahead	Yes
  rewind	windback | backtrack	Yes
  volume	sonority | strength	Yes
  sleep	sleeptimer | exittimer	Yes

• Fun Section

  Command Primary Name	Available Aliases	Slash Command?
  eightball	8ball| _8ball	No
  choose	No aliases	No
  ping	No aliases	Yes
  say	echo	No
  calcgpa	calculategpa| gpacalc	No
  gpascale	scalegpa| scaleofgpa	No
  bmi	bmicalc| bmiget	No
  roll	random| rolladice| rolldice	No
  rollrepeat	randomrepeat| rolladicerepeat| rolldicerepeat| repeatroll| rollrepeats	No
  fortune	luck| lucky	Yes
  translate	trans| 翻译| translation	Yes
  time	realtime| exacttime| timenow| nowtime| 当前时间| 现在时间	Yes
  weather	currentweather| weathercurrent| climate| currentclimate| climatecurrent	Yes
  wolfram	question| wolframalpha| wolfram_alpha	Yes
  pat	pats	Yes
  hug	hugs	Yes
  cry	cries	Yes
  cuddle	cuddles	Yes
  vote	upvote	Yes
  rps	rockpaperscissors| rpsgame| rockpaperstone	Yes
  magic	paimon| 派蒙	Yes

• Admin Section

  Command Primary Name	Available Aliases	Slash Command?
  ban	No aliases	Yes
  unban	No aliases	Yes
  clear	purge	Yes
  changeprefix	No aliases	Yes
  kick	No aliases	Yes
  mute	No aliases	Yes
  unmute	No aliases	Yes
  tempmute	No aliases	Yes
  deafen	deaf| strictdeafen| muteall	Yes
  undeafen	undeaf| unstrictdeafen| unmuteall	Yes
  al	audit| log| auditlog| audits| als| logs	Yes

• Utility Section

  Command Primary Name	Available Aliases	Slash Command?
  invite	inviteqiqi| 邀请| 邀请七七	Yes
  userinfo	user| userinformation	Yes
  update	No aliases	Yes
  qiqi	qiqiinfo| botinfo| qiqibot| 七七| 七七信息| 机器人信息	Yes
  policy	No aliases	Yes
  credit	credits	Yes
  feedback	report| assessment| evaluation	Yes
  doc	document | documentation	Yes

Policy Statement

• General Policy

  • Due to privacy importance and corresponding concerns, Qiqi Bot (later in the text as "Bot") is designed with the theme of protecting user personal information.
  • Bot will record following information, but user/member information will delete periodically and never sell to others. (Check next one for more explanations). The information that bot will collect and store will be:
    • Bot custom command prefix for this server. (Key-pair with server guild id)
    • User who got temporarily muted. (Tempmute command also records guild and channel information for providing better user-experience and reactions)
    • Music related data. (queue/history/customplaylist/music favorites). This can be deleted on user's side by their choice.
  • Bot will NEVER re-use (for other purposes) or sell any data from any user to any person/company/platform. Bot will strictly follow the rules and community guidelines of discord. The data collected will be secured.
  • Bot needs to have access to users' messages content in order to provide better services for users. But Bot will not store any messages from users.
  • IMPORTANT: Bot will NEVER ask you about payments, credit card information, social security number, and other financial information. Beware of the fraud. Again, Bot will NEVER ask you anything about your financial info of any kind.
  • About Netease Music command mynetease: This only tells Bot the netease user you selected. This doesn't mean the Bot needs to login to your netease account. Do not share any Netease account password to anyone. The Bot will NEVER ask you for password. Currently, Bot doesn't have a delete command to delete the "linked" netease user information. But you can always contact the developer (direct message/support server/email) to delete your information.

• Possible Data Privacy Exposure

  • For Qiqi Bot (Later as "Bot"), it is possible to have privacy leak by using fun commands: bmi and calcgpa though the chance is extremely low.
  • After user sending the input, bot will immediately delete the input message by its message ID. Therefore, the message will be deleted for sure. (Unless Qiqi does not have manage_messages permission).
  • But, there is still chance that "someone with concealed intentions" records the channel, then they could find that message by searching specific frame of screen-recording.
  • By warning this in here, Bot, also developer, will not be responsible for any personal information leak by above circumstance.
  • In a short word, BEWARE of USING FUN COMMANDS bmi and calcgpa
  • Though the Bot has a Netease Music account to make all these commands function properly. Playing Netease Music through the Bot will NOT leave any history or related data on the Bot's Netease account. Therefore, Netease Music related commands have no known possible privacy exposure currently.

Terms and Services

• General Terms and Agreement

  • Once you invited Qiqi Bot to your server or use Qiqi Bot in any server, you need to agree with this user terms and agreement. (By default). Please read carefully for following terms in order to not violate Qiqi Bot terms and services.
  • User MUST NOT process with any illegal affairs by Qiqi Bot. Qiqi Bot will preserve rights and use any illegal activity by user to proceed to lawsuit. Please use Qiqi Bot in legitimate ways.
  • No spamming intentions with Qiqi Bot is allowed. Also, Qiqi has built-in cooldown function that can detect and stop any spamming to the bot.
  • Bot will never ask you to pay or charge any payments at this point.
  • Bot does NOT have any NSFW contents involved.
  • Qiqi Bot does NOT support self-host at this moment.
  • Please check out and carefully read the privacy contents.
  • The intention of making YouTube, Bilibili, Netease Music, and Spotify music is to let more people know about these well-built software and to improve cultural communications among people from different regions.
  • Updates related info (e.g. time, content) will be posted in Qiqi Bot support server, also documentation site.
  • If user has experience with bugs, lags, or Qiqi side issues, user is welcomed to join the Qiqi Bot support server or send email to Qiqi Bot official email. (In Contact section)
  • This user agreement is effective as long as Qiqi Bot is online. (Maintenance and version update will still make this user agreement effective).

• Final Explanation

  • Developer Master_30#0361 has reserved all the right for the final interpretation of Qiqi Bot.

Version Tracker

​ Version tracker will display all the versions of Qiqi Bot except minor/bug fixes update before Version Beta 0.3.0.0.

    P.S: Version Tracker will not include all the versions during development stage. It will record the stable release version only.

Contact

• Email (developer): qiqibot77@gmail.com
• Discord Bot Support Server: https://discord.gg/gbv6TveBRX
• Discord ID (Developer): Master_30#0361