https://github.com/warriordog/discord-uwu-bot

UwU!
https://github.com/warriordog/discord-uwu-bot

bot discord discord-bot dotnet owo uwu

Last synced: 3 months ago
JSON representation

UwU!

• Host: GitHub
• URL: https://github.com/warriordog/discord-uwu-bot
• Owner: warriordog
• License: mit
• Created: 2021-02-27T21:48:19.000Z (over 5 years ago)
• Default Branch: main
• Last Pushed: 2023-09-24T17:04:31.000Z (almost 3 years ago)
• Last Synced: 2025-01-25T17:33:12.980Z (over 1 year ago)
• Topics: bot, discord, discord-bot, dotnet, owo, uwu
• Language: C#
• Homepage:
• Size: 92.8 KB
• Stars: 1
• Watchers: 3
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# discord-uwu-bot

A Discord bot that translates regular text into UwU-speak.

### Examples

| English                                                          | UwU                                                                       |

|------------------------------------------------------------------|---------------------------------------------------------------------------|

| Hello, world!                                                    | Hewlo, wowld! UwU!                                                        |

| Lorem ipsum dolar sit amet                                       | Lowem ipsum dolaw sit amet UwU!                                           |

| I'll have you know I graduated top of my class in the Navy Seals | I'wl have you knyow I gwawduatewd top of my class in dwe Nyavy Seals UwU! |

### Commands

* `uwu*that` - Uwuify a message in chat. Reply to a message to uwuifiy it.

* `uwu*this` - Uwuify text. The rest of the message will be uwuified.

* `uwu*me` - Follow the sender and translate everything that they say in the current channel.

* `uwu*stop [where]` - Stop following the sender. Optionally set `where` to "channel", "server", or "everywhere" to stop following in the current channel, current server, or in all of Discord, respectively. Defaults to "channel".

* `uwu*stop_everyone [where]` - Stop following everyone in the current channel or server. Optionally set `where` to "channel" or "server" to specify where to stop following. Defaults to "channel". Requires "Manage Messages" permission.

* `uwu*them ` - Follow a specified user and translate everything that they say in the current channel. Requires "Manage Messages" permission. Use the command again to stop following.

### Configuration

The bot can be configured through a JSON configuration file, located at `/opt/UwuBot/appsettings.Production.json` by default.

You must add your Discord token here before using the bot.

If you are using the the install script, then a default configuration file will be provided for you.

To create a configuration file manually, start with this template:

    {

      "DiscordAuth": {

        "DiscordToken": "YOUR DISCORD TOKEN HERE",

      },

      "BotOptions": {

        "CommandPrefixes": [ "uwu*" ]

      },

      "UwuOptions": {

        "AppendUwu": true,

        "MakeCuteCurses": true

      }

    }

The following options are available to customize the bot behavior:

| Option                     | Description                                         | Default      |

|----------------------------|-----------------------------------------------------|--------------|

| BotOptions:CommandPrefixes | List of command prefixes to respond to.             | `[ "uwu*" ]` |

| UwuOptions:AppendUwu       | Appends a trailing "UwU!" to the text.              | `true`       |

| UwuOptions:MakeCuteCurses  | Replaces curse words with cuter, more UwU versions. | `true`       |

### Discord Requirements (OAuth2)

To join the bot to a server, you must grant permissions integer `2048`. This consists of:

* `bot` scope

* `Send Messages` permission

You must also grant the "Message Content" intent in the Discord Developer Portal.

### System Requirements

* .NET 6+

* Windows, Linux, or MacOS. A version of Linux with SystemD (such as Ubuntu) is required to use the built-in install script and service definition.

### Setup

Before you can run discord-uwu-bot, you need a Discord API Token.

You can get this token by creating and registering a bot at the [Discord Developer Portal](https://discord.com/developers/docs/intro).

You can use any name or profile picture for your bot.

Once you have registered the bot, generate and save a Token.

#### Ubuntu / SystemD Linux

For Ubuntu (or other SystemD-based Linux systems), an install script and service definition are provided.

This install script will create a service account (default `uwubot`), a working directory (default `/opt/UwuBot`), and a SystemD service (default `uwubot`).

This script can update an existing installation and will preserve the `appsettings.Production.json` file containing your Discord Token and other configuration values.

1. Compile the bot or download pre-built binaries.

2. Run `sudo ./install.sh`.

3. \[First install only] Edit `/opt/UwuBot/appsettings.Production.json` and add your Discord token.

4. Run `sudo systemctl start uwubot` to start the bot.

#### Other OS

For non-Ubuntu systems, manual setup is required.

The steps below are the bare minimum to run the bot, and do not include steps needed to create a persistent service.

1. Compile the bot or download pre-built binaries.

2. Edit `appsettings.Production.json` and add your Discord token.

3. Run `dotnet DiscordUwuBot.Main.dll` to start the bot.