# 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/)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hellobot.globalfurry.tv/hello.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.