EveCogs/newhelpmenu/README.md

60 lines
1.9 KiB
Markdown
Raw Normal View History

# NewHelpMenu
Components V2 help menu + global embed/menu override for Red-DiscordBot.
## Features
- **Components V2 Help** — Replaces Red's entire help system with Discord's Components V2 (containers, sections, text displays, thumbnails, media galleries, separators)
- **Global Embed Override** — Optionally converts ALL bot embeds and menus into Components V2 layouts
- **Categories** — Group cogs into custom categories for organized help pages
- **Accent Colours** — Customizable colour scheme per-server
- **Layout Modes** — Multiple layout styles for help pages
- **Paginated Navigation** — Interactive buttons for browsing commands
- **Select Menus** — Quick-jump to any cog or command
## Requirements
- Red-DiscordBot >= 3.5.21
- Python >= 3.9
## Installation
```
[p]repo add EveCogs https://github.com/everestmcarthur/EveCogs
[p]cog install EveCogs newhelpmenu
[p]load newhelpmenu
```
> ⚠️ This cog replaces Red's built-in `help` command. The original is restored on unload.
## Quick Start
```
[p]cv2 toggle # Enable Components V2 (off by default)
[p]cv2 settings # View all current settings
[p]cv2 color <hex> # Set accent colour
[p]cv2 category add <name> <cog1> <cog2>... # Group cogs into categories
```
## Commands
| Command | Description |
|---------|-------------|
| `[p]cv2 toggle` | Enable/disable Components V2 mode |
| `[p]cv2 settings` | View current configuration |
| `[p]cv2 color <hex>` | Set accent colour |
| `[p]cv2 category add <name> <cogs...>` | Create a cog category |
| `[p]cv2 category remove <name>` | Remove a category |
| `[p]cv2 category list` | List all categories |
| `[p]help` | Show the help menu (replaced) |
| `[p]help <command>` | Show help for a specific command |
| `[p]help <cog>` | Show help for a specific cog |
## Data Statement
This cog stores per-guild configuration. No personal user data is stored.
## License
MIT