Qiqi Bot

If you need a beginner guide, click here

Docs for other languages:

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

Qiqi supports multi-language! All translations will be based on your Discord client language by default. The language is user-based, which means Qiqi can respond to members in the server with different languages. Also, you could manually switch the language of the bot by settings command. Qiqi currently supports:

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:

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.

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.

Warning

The Genshin Impact database for Qiqi is currently outdated. Developer has currently working on this but this requires a lot of work.

Click here for detailed Genshin Impact related commands docs

 

Music Commands


Qiqi loves playing music for you! It can play the music by Soundcloud video by url/keywords, Bilibili video by url/keywords, Netease music by url/keywords, Pengu 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 Soundcloud, Bilibili, Netease, and Pengu 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)

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 (Soundcloud, Netease, Bilibili, Pengu) are supported and you can mix them in one playlist!

    Example of a line (suggested): https://soundcloud.com/user-235352228/let-the-wind-blow-to-you let the wind blow to you

    Example of a line (works, but not suggested): https://soundcloud.com/user-235352228/let-the-wind-blow-to-you

    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

Music Favorites

    Qiqi Bot can remember your own favorite tracks and you could play them cross-server. There's a 300 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 /

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!

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.

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.

FAQ

Aliases

Policy Statement


Terms and Services


Version Tracker


Note

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 the development stage. It will record the stable release version only.

Version No.Updated Time (MM/DD/YYYY)Update Detailed Info
2.0.0.010/19/2026Click here for details
1.7.1.204/15/2025Fix the error that Bilibili FavoriteList extraction will load the first song twice to the queue
1.7.1.103/23/2025Update fortune ranking season to S5
1.7.1.003/17/2025Add support to play or delete multiple songs in your favorite playlist by positive integer or ranges, separated by commas | Add support to play Bilibili user's favorite videos list | Improve extraction performance and fix various bugs about extractions
1.7.0.102/17/2025Fixed the bug that some netease playlists cannot be played correctly
1.7.0.002/04/2025Rewrite music internals to improve performance. Add support to Soundcloud music | Add Support to Pengu music source | Add pengu, pengualbum, penguplaylist music commands
1.6.3.003/30/2024Refresh fortune-ranking to start season 1
1.6.2.603/14/2024Fixed the saving issue of custom user language | Fixed interaction not respond of "first time accomplish" in fortune-ranking
1.6.2.303/13/2024Add different ranking (including personal best) for fortune-ranking and fixed minor issues
1.6.2.002/29/2024Add skip laterfunctionality
1.6.1.002/07/2024Improve fortune command mechanism
1.6.0.512/24/2023Change the check of #/ and /home optional for Netease Music url
1.6.0.212/05/2023Corrected several typos in zh-CN (simplified Chinese) translation files.
1.6.0.111/24/2023Fixed the remaining time for records of the queue to 2 hours instead of 30 seconds | Fixed the incorrect message of setlang command | Some minor bugs/typos
1.6.0.011/19/2023Rewrite music internals, especially queue mechanism which significantly improve performance | Add translations to support multi-language and setlang for user to manually set the language | Add blacklist, nekogirl commands | Reconstructure roll command and removebmi, calcgpa, gpascale | playhistory now supports a range of tracks | Fixed bugs/typos
1.5.4.209/30/2023Fixed RuntimeError related to prefixes and music
1.5.4.108/15/2023Fixed the bug of 403 from various music sources
1.5.4.007/31/2023Updated Genshin DB to be compatible with second half game ver 3.8 (Sangonomiya Kokomi | Wanderer) | Fixed the issue of frequent 403 Forbidden from Bilibili | Added developer tools
1.5.3.007/08/2023Added outfits for characters (small chance to be picked) | Update Genshin DB to be compatible with first half game ver 3.8 (Eula | Klee) | Added developer tools
1.5.2.206/22/2023Fixed various bugs about clear and bilibili <keyword> | Improve bilibili search speed by keywords.
1.5.2.006/21/2023Added weapon commandto check basic weapon info | Updated Genshin DB to be compatible with second half game ver 3.7 (Alhaitham | Kaedehara Kazuha) | Added developer tools | Corrected typos and fixed bugs
1.5.1.005/23/2023Updated Genshin DB to be compatible with first half game ver 3.7 (Yoimiya | Yae Miko) | Fixed various bugs
1.5.0.805/22/2023Improved Qiqi performance | Temporarily removed volume command
1.5.0.605/20/2023Fixed various bugs | Improved Qiqi performance | Added developer tools
1.5.0.005/18/2023Added Spotify Music as new music source. Supports multiple commands for Spotify track/playlist/album/artist: spotify, spotifyplaylist, spotifyalbum, spotifyartist | Added volume command for all music | Update Genshin DB to be compatible with second half game ver 3.6 (Baizhu | Ganyu) | Added developer tools to better monitor Qiqi | Optimized code improvement for better performance | Fixed bugs and typos
1.4.10.204/29/2023Added display-preference for exportfavorite | Updated help commands
1.4.10.104/26/2023Added display-preference for playfavorite, addfavorite, and deletefavorite command
1.4.10.004/16/2023Added chronological sort option for viewfavorite command | Improved export command output by splitting queue and history to two playlists | Improved export and exportfavorite commands to export with both url and name | Dramatically improved the performance for commands called by custom prefix | Improved bot stat collection | Improved description of some commands and fixed typos | Updated Genshin DB to be compatible with first half game ver 3.6 (Nahida | Nilou)
1.4.9.103/02/2023Added custom playlist's tracks number position info for the queue
1.4.9.003/02/2023Updated custom playlist logic and lift the maximum to 100 tracks, and allowed to add a short name to each url (recommended) | Updated Genshin DB to be compatible with first half game ver 3.5 (Dehya | Cyno) | Improve reset command functionality | Fixed various bugs
1.4.8.002/13/2023Updated Genshin DB to be compatible with second half game ver 3.4 (Hu Tao | Yelan) | Updated dev tools
1.4.7.001/31/2023Updated bot's logic to ignore "manage_messages" permission | Escape characters for spoiler msg on discord | Updated on_voice_state_update logic and remove prompt message | Updated Genshin DB to be compatible with first half game ver 3.4 (Alhaitham | Xiao) | Fixed minor bugs
1.4.6.012/29/2022Updated Genshin DB to be compatible with second half game version 3.3 (Raiden Shogun | Kamisato Ayato) | Fixed typos and added glossaries to Genshin DB
1.4.5.412/22/2022Fix various bugs over command "mynetease", "viewfavorite", and "help".
1.4.5.012/21/2022Expanded music favorite maximum songs from 30 to 100 | Change the loading logic for music favorite | Lower the command cooldown of playfavorite | Fix various bugs over voteskip, favorite, auditlog ...etc and remove blockings | Updated Genshin_DB weapon entry | Improve safety of database
1.4.4.012/12/2022Added "jump to specific page?" button option for command queue/history
1.4.3.012/08/2022Updated Genshin DB to be compatible with first half game version 3.3 (Wanderer | Arataki Itto)
1.4.2.011/19/2022Updated Genshin DB to be compatible with second half game version 3.2 (Yae Miko | Tartaglia) | Fixed custom prefix bugs | Fixed Genshin DB typos and bugs | Update backend-services
1.4.1.011/09/2022Added position searching in the queue for track by keywords | Added cancellation feature for sleep command | Restore top.gg autoposting | Fixed bugs | Enhanced user experience
1.4.0.011/03/2022Added Netease Music as new music source. Supports multiple commands for netease music/playlist/user: netease,  neteaseplaylist, neteaseuser, mynetease, playmynetease, newsongs | Added keywords search for Bilibili video | Added sleep command for sleep timer | Updated Genshin DB to be compatible with first half game version 3.2 (Nahida | Yoimiya) | Fixed bugs | Enhanced user experience
1.3.10.010/15/2022Updated Genshin DB to be compatible with second half game version 3.1 (Nilou | Albedo) | Fixed reversed translation issue of genshin weapon calculation
1.3.9.110/11/2022Fixed keep alive error/unavailable connection reuse bug for streaming live music
1.3.9.010/10/2022Added functionality to post server count on top.gg | Fixed music command bugs | Fixed typos | Added alias
1.3.8.009/28/2022Updated Genshin DB to be compatible with first half game version 3.1(Cyno | Venti)
1.3.7.109/15/2022rollback the talent-calc exception handler
1.3.7.009/09/2022Updated Genshin DB to be compatible with second half game version 3.0 (Ganyu | Sangonomiya Kokomi) | Updated images for weapon calculation | Fixed typos
1.3.6.008/31/2022Updated the functionalities of command savecp
1.3.5.008/29/2022Updated the functionalities of commands export | playcp | exportfavorite
1.3.2.008/28/2022Updated Genshin DB to be compatible with first half game version 3.0 (Tighnari | Zhongli) | Improve results about traveler in Genshin DB | Fixed typos
1.3.1.108/13/2022Temporarily updated mystb.in python API wrapper (old version)
1.3.1.008/03/2022Updated Genshin DB to be compatible with second half game version 2.8 (Yoimiya) | Updated GenshinDB fuzzy words
1.3.0.007/29/2022Added the favorite playlist for user to manage their own favorite songs (cross-server) | Added more music commands restart, seek, forward, rewind | Improved voteskip vote-pass logic | Fixed bugs | Enhanced user experience
1.2.3.107/18/2022Fix the bug of stop command for newly added server
1.2.3.007/13/2022Update Genshin DB to be compatible with first half game version 2.8 (Kaedehara Kazuha | Klee)
1.2.2.007/09/2022Add reset command for music (admin) | Fix ClientException for joining failure if manually disconnected by user previously | Fix voice state update message if the bot itself disconnects
1.2.1.507/01/2022Improve the bot to re-achieve expired music url if 403 error is detected.
1.2.1.406/26/2022Fixed the error for only loading first song in the custom playlist if called playcp by slash
1.2.1.306/25/2022Fixed repeat single command for newly added song | Improve play command user experience on mobile side (application not responds) | Enhanced Qiqi Bot service
1.2.1.006/24/2022Updated Genshin DB to second half game version 2.7 (Arataki Itto) | Enhanced user experience
1.2.0.006/15/2022Supports slash commands for all existing commands (hybrid) | Improve ui from reaction to buttons | Custom help page | Add fun command, fix bugs, enhanced user experience
1.1.3.106/02/2022Added logging for discord to monitor bot performance and errors | Fixed custom playlist bugs
1.1.2.005/31/2022Updated Genshin DB to first half game version 2.7 (Yelan)
1.1.1.004/20/2022Updated Genshin DB to second half game version 2.6 (Kamisato Ayaka)
1.1.0.004/10/2022Added custom playlist from mystb.in support with series of command(playcp, savecp, viewcp, deletecp) | Added gif picture commands for fun (pat, hug, cry, cuddle) | Fixed severe bugs noticed and enhance user experience
1.0.0.004/02/2022Apply professional database for its data | Added nowplaying, repeat all, history, playhistory, voteskip, export for music commands | Added weather, qiqi, time, wolfram, translate for fun commands | Enhanced User Experience
0.6.11.004/01/2022Updated Genshin DB to first half game version 2.6 (Kamisato Ayato | Venti)
0.6.8.003/08/2022Added roll, rollrepeat commands | Updated Genshin DB to second half of game version 2.5 (Raiden Shogun)
0.6.5.102/21/2022Updated Genshin DB to first half game version 2.5 (Yae Miko)
0.6.4.1201/26/2022Optimize user-experience with commands: mute, unmute, tempmute | Fixed minor bugs (Now mute commands can still work without admin perms)
0.6.4.901/25/2022Newly added admin commands: deafen, undeafen, audit | Update Genshin Impact database to second half of game version 2.4 (Zhongli | Ganyu) | Fixed minor bugs | Enhanced User experiences
0.6.0.001/24/2022New added Genshin Impact command: char (check character basic info), talents (check all talents for character), cons (check all constellations for character) | Added admin commands: mute (mute a user in both text and voice channels), unmute, tempmute (temporarily mute by specific time period)
0.5.4.301/06/2022Updated Genshin DB to first half game version 2.4 (Shenhe) | Added new commands fortune and userinfo | Fixed minor bugs and data missing in Genshin DB.
0.5.1.012/19/2021Heading to 1.0.0.0. Migrating to new cloud service | Added userinfo function
0.4.1.412/18/2021Updated site-packages info | Added response message for repeat function | Fixed counting error in jump function response message
0.4.1.112/18/2021Updated Genshin DB to second half game version 2.3 (Arataki Itto) | Fixed @ bug on error handler
0.4.0.012/17/2021Added music repeat (single only), policy, credits | Enhanced user experience and lower down spamming possibilities | Fixed minor bugs
0.3.3.212/16/2021Fixed typos of Bot responses
0.3.3.112/16/2021Added developer functions
0.3.3.012/16/2021Added support to website Bilibili for music
0.3.2.712/15/2021Updated prefixes not found with default prefix setting
0.3.2.512/15/2021Stop responding with error message if command not found
0.3.2.412/13/2021Added music jump and shuffle
0.3.0.112/12/2021Fixed incorrect message response if timeout
0.3.0.012/11/2021Genshin Impact / Music function published
0.2.0.011/20/2021Genshin Impact function completed. not published
0.1.6.009/27/2021Cog Restructure completed. not published
0.1.0.005/13/2021Initial combined version. not published

Special Thanks

Qiqi will never forget those who have helped her.

Contact