Skip to content

A Discord Bot Written in Discord.py for Fetching Information Related to VisualNovels.

License

Notifications You must be signed in to change notification settings

StyingDev/Styings-VisualNovel-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

20 Commits
 
 
 
 
 
 
 
 

Repository files navigation

VNDB Discord Bot 🎮📚

A Discord bot that interacts with the VNDB API to search for visual novels and characters, providing detailed information in informative embeds. The bot includes a variety of commands to enhance your server's experience with visual novel related content. Invite the Bot!

Credits

  • Stying - Creator & Developer
    • Contact me through my Discord: @Stying
    • Linktree

Features

  • Visual Novel Search (/vn): Search for visual novels by name. Select from a list of results and receive detailed information, including the original name, alternate names, playtime, languages, platforms, related media, and more.
  • Character Search (/character): Search for characters by name. View detailed information including aliases, measurements, birthday, blood type, gender, and roles in associated visual novels.
  • Random Visual Novel (/randomvn): Fetch a random visual novel from VNDB and view its detailed information.
  • Multilingual Support: The bot displays country flags based on the language of the visual novel.
  • Clean UI: All commands feature dropdown menus and buttons for a seamless user experience.

Commands

Character Information

  • /character: Search for a character by name. Returns a dropdown menu of results from which you can select one to view detailed information.

    Usage: /character name:<character name>

Visual Novel Information

  • /vn: Search for a visual novel by name. Returns a dropdown menu of results from which you can select one to view detailed information.

    Usage: /vn name:<visual novel name>

RandomVN

  • /randomvn: Fetch a random visual novel and display its information.

Cover

  • /cover Fetch the cover image of selected visual novel.

    Usage: /cover name:<visual novel name>

Installation

  1. Clone the repository:
git clone https://github.com/StyingDev/Styings-VisualNovel-Bot.git
  1. Navigate to the project directory:
cd Styings-VisualNovel-Bot
  1. Install the required Python packages:
pip install -r requirements.txt
  1. Create a '.env' file in the project directory and add your Discord Bot Token:
TOKEN=your_discord_bot_token_here

Environment Variables

  • TOKEN: Your Discord bot token, which can be obtained from the Discord Developer Portal.

Contributing

Contributions are welcome! If you'd like to contribute, please fork the repository, create a new branch, and submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

  • This bot utilizes the VNDB API for fetching visual novel and character data.
  • Built using Discord.py library.

About

A Discord Bot Written in Discord.py for Fetching Information Related to VisualNovels.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages