# Hello! 👋

## Welcome to the ***HelloBot Usage Documentation***!

### What is HelloBot?

HelloBot is a powerful all-in-one Discord bot built for community engagement, entertainment, moderation, and creativity. Whether you're running a small server or a large community, HelloBot brings you a rich set of slash commands to manage, interact, and have fun — all without leaving Discord.

***

### 🔧 What Can HelloBot Do?

Here’s a quick overview of what HelloBot brings to your server:

#### 🎮 Games

Enjoy interactive multiplayer games right in Discord:

* Tic-Tac-Toe
* Connect 4
* Chess
* Hangman
* Wordle
* Trivia
* Flag Match
* UNO
* Battle mode

#### 🎉 Fun Commands

Keep things light-hearted with:

* `/8ball` – Ask the magic 8-ball anything!
* `/coin` – Flip a coin (with guess option!)
* `/cat`, `/dog`, `/fox` – Get random cute animal pics!

#### 🔊 Voice & Music

Play audio in voice channels:

* `/play` – Stream from YouTube or links
* `/join` & `/leave` – Voice channel control
* `/queue`, `/loop`, `/skip` – Full queue control

#### 🌍 Utility Tools

Handy tools for everyone:

* `/randnum` – Generate random numbers
* `/math` – Solve math expressions
* `/roll` – Dice rolls (XdY)
* `/translate` – Translate any text with voice playback
* Country checklist tracker

#### 🛡 Moderation

Keep your server safe and orderly:

* `/kick`, `/ban`, `/mute`, `/timeout`, and more
* `/purge` – Bulk delete messages
* `/thread` – Manage thread settings

#### 🖼️ Generative Art

Create custom images:

* `/dots` – Generate random dot patterns
* `/waves` – Render colourful sine wave patterns

#### 📊 Info & Stats

* `/ping` – Check bot latency
* `/hello` – Introduce the bot in multiple languages
* List known users, channels, and guilds (admin only)

#### ⚙️ Developer Tools

Restricted to bot owner:

* `/dev restart`, `/dev stats`, `/dev reload` – Internal bot maintenance
* Evaluate code and inspect sessions

***

### 🧠 Powered by

* `discord.py` with slash command support
* Built-in views and buttons for rich UI

***

### ✨ Let’s Get Started

Use `/hello` to say hi in your preferred language, or type `/help` to explore all available commands.

Welcome aboard, and have fun with HelloBot! 😄

### Need Help?

* Browse through the **commands sections** for detailed explanations.
* Check the **FAQ & Troubleshooting** page for common issues.
* Join the **support community** for additional assistance.

🚀 Enjoy using HelloBot!

***

## Commands

{% content-ref url="general" %}
[general](https://hellobot.globalfurry.tv/general)
{% endcontent-ref %}

{% content-ref url="info" %}
[info](https://hellobot.globalfurry.tv/info)
{% endcontent-ref %}

{% content-ref url="utility" %}
[utility](https://hellobot.globalfurry.tv/utility)
{% endcontent-ref %}

{% content-ref url="voice" %}
[voice](https://hellobot.globalfurry.tv/voice)
{% endcontent-ref %}

{% content-ref url="mod" %}
[mod](https://hellobot.globalfurry.tv/mod)
{% endcontent-ref %}

{% content-ref url="games" %}
[games](https://hellobot.globalfurry.tv/games)
{% endcontent-ref %}

{% content-ref url="fun" %}
[fun](https://hellobot.globalfurry.tv/fun)
{% endcontent-ref %}

{% content-ref url="generative" %}
[generative](https://hellobot.globalfurry.tv/generative)
{% endcontent-ref %}

{% content-ref url="profile-beta" %}
[profile-beta](https://hellobot.globalfurry.tv/profile-beta)
{% endcontent-ref %}

{% content-ref url="admin" %}
[admin](https://hellobot.globalfurry.tv/admin)
{% endcontent-ref %}

***

## Known Issues ⚠️

Below is a list of **currently known issues** in HelloBot. These are **actively being worked on** or have **workarounds**.

### 🛠️ **General Issues**

#### **Issue: Bot does not respond to commands**

**Status:** Investigating\
**Workaround:**

* Ensure the bot has the correct permissions.
* Try **re-inviting** the bot.
* If `/help` does not work, the bot may be experiencing downtime.

#### **Issue: Some commands do not autocomplete**

**Status:** Known limitation in Discord API\
**Workaround:** Manually type out the command parameters.

### 🎶 **Voice & Music Issues**

#### **Issue: Bot disconnects randomly from voice channels**

**Status:** Being monitored\
**Workaround:** The bot may disconnect due to inactivity. Use `/join` again to reconnect.

#### **Issue: Cannot play YouTube videos**

**Status:** **Not supported**\
**Workaround:** Use a **SoundCloud link**, **Bilibili link** or **Discord-hosted audio files** instead.

### 🎉 **Fun Commands Issues**

#### **Issue: /cat, /dog, or /fox commands fail to fetch images**

**Status:** External API issue\
**Workaround:** These commands rely on third-party APIs. If they are down, wait and try again later.

### 🔨 **Moderation Issues**

#### **Issue: Cannot kick/ban users even with permissions**

**Status:** Under review\
**Workaround:** Ensure HelloBot’s role is **above** the user’s highest role in the role hierarchy.

#### **Issue: /purge does not delete some messages**

**Status:** Discord limitation\
**Workaround:** The bot **cannot delete messages older than 14 days**.

### 🖼️ **Profile & Generative Issues**

#### **Issue: /profile command takes too long to generate an image**

**Status:** Being optimized\
**Workaround:** If it takes too long, try again with a **smaller font** or **simpler profile image**.

#### **Issue: /waves and /dots commands fail with large images**

**Status:** Performance limitation\
**Workaround:** Keep dimensions under **4096x4096 pixels**.

### 📝 **Bug Reporting**

If you encounter an issue **not listed here**, please check:

* The [**support community**](https://discord.globalfurry.tv/) for recent updates.

***

## FAQs ❓

Here are some frequently asked questions about **HelloBot**.

### General Questions

#### **Q: How do I add HelloBot to my server?**

A: You can add HelloBot by clicking on the invite link provided in the `/hello` command or visit [this page](https://hello.globalfurry.tv/).

#### **Q: What prefix does HelloBot use?**

A: HelloBot primarily uses **slash commands (`/`)** instead of traditional prefixes.

#### **Q: Can I use HelloBot in DMs?**

A: Yes, but HelloBot's voice commands only function inside servers where it has been invited.

#### **Q: How do I see a list of available commands?**

A: Use `/help` to view all available commands categorized by functionality.

### Moderation & Permissions

#### **Q: Why can't I use moderation commands like /kick or /ban?**

A: You need to have the correct Discord permissions (`Kick Members`, `Ban Members`, etc.) to execute these commands.

#### **Q: Does HelloBot support auto-moderation?**

A: No, HelloBot does not currently support automatic moderation. All moderation actions must be manually executed.

### Fun & Utility Commands

#### **Q: Why is the `/cat`, `/fox` or `/dog` command not working?**

A: Sometimes, the external API providing images may be down. Try again later.

### Voice & Music

#### **Q: How do I make HelloBot join a voice channel?**

A: Use `/join` while being in a voice channel.

#### **Q: What audio sources does HelloBot support?**

A: HelloBot only supports **Discord audio file links**, **SoundCloud** and **Bilibili** tracks.

#### **Q: Why can't HelloBot play music?**

A: Possible reasons:

* The bot is not in a voice channel (`/join` to add it).
* The provided link is not from a supported source.
* The bot lacks `Connect` and `Speak` permissions.

### Customization

#### **Q: Can I change the bot’s profile font?**

A: Yes! When using `/profile`, you can specify a `font_url` pointing to a `.ttf` file. This feature is currently under maintenance.

### Troubleshooting

#### **Q: The bot is not responding to my commands. What should I do?**

A: Check the following:

1. Make sure HelloBot has **the necessary permissions**.
2. Make sure HelloBot is **online**.
3. Ensure HelloBot is **not muted** or has **no role restrictions**.
4. Try **re-inviting** the bot if the issue persists.

#### **Q: How do I report a bug or suggest a feature?**

A: Contact us using the email addresses below, or submit a report via the provided `/hello` links.

## Contact Us

Email <augy@augystudios.com> to report any bugs or send feedback.

Email <globalfurrytv@gmail.com> to let us know what you think!

{% hint style="success" %}
​[Buy Augy a Coffee](https://donate.stripe.com/28o2akeAr3hv0DK6oo) or [Support Augy Monthly](https://donate.stripe.com/6oEbKUdwn9FTgCI7st)!
{% endhint %}

{% hint style="warning" %}
Is the bot not responding? Check its status [here](https://pages.statusbot.us/id/873989298507120690)!
{% endhint %}

***

*Made with ❤️ by GFTV Intl © 2025 All Rights Sniffed •* [*GFTV*](https://globalfurry.tv/)