![Main Characters](https://raw.githubusercontent.com/juanlumediterrani/RoleAgentBot/main/banners/maincharacters.png)

## ✨ How it works

### The included role system allows for different kinds of bot and agent actions (News alerts, rune reading, music bot)

### 🎭 Multi-Personality System
#### Multiple Personalities: Switch between different AI personalities (Putre, Kronk, Rab, Yuki, and more)
#### Server-Specific Selection: Configure different personalities per Discord server via Canvas UI or commands
#### Character Voice: Each personality has unique speech patterns, vocabulary, and behavioral traits
#### Dynamic Responses: AI maintains character consistency across all interactions
#### Multi-Language Support: Personalities available in multiple languages (English, Spanish, Chinese)
#### Per-Server Personality configuration: Select preferred personality for each server independently

### 🧠 Advanced Memory Architecture
#### Four-Layer Memory System:
##### Daily Memory: Synthesizes important events every 24 hours
##### Recent Memory: Rolling window of interactions (4-hour synthesis)
##### Relationship Memory: Per-user relationship summaries refreshed hourly
##### Recent Dialogue: Direct message window for ongoing conversations
#### "Remember That?": Detects when users ask about past events and retrieves relevant memories
#### Notable Recollections: Stores significant events for future reference

### 🎮 Modular Role System
#### News Watcher: RSS feed monitoring with AI-powered content filtering
#### Treasure Hunter: Path of Exile item price tracking and market analysis
#### Trickster: Minigames with virtual currency (dice, ring)
#### Banker: Virtual wallet management and transaction processing
#### Music Controller: YouTube music playback in voice channels
#### Shaman: Predictions, rites, rune reading.

### 🎨 Canvas UI System
#### Interactive Interface: Button-based navigation for complex configurations
#### Role-Specific Views: Customized UI for each role's capabilities
#### Admin Panels: Advanced configuration views for administrators
#### DM/Channel Fallback: Respects user privacy preferences

### 🛡️ Safety & Rate Limiting
#### Fatigue Limit System: Configurable rate limits (burst, hourly, daily) with intelligent exemptions
#### Permission Controls: Admin-only commands and restricted operations
#### Graceful Degradation: Fallback mechanisms for service failures
#### Server-Specific Logging: Isolated log directories per Discord server for better debugging and privacy

### 🔄 Reactive Behaviors
#### Presence Greetings: Proactive DMs when users come online
#### Welcome Messages: Contextual greetings for new server members
#### Commentary System: Character-driven reactions to events
#### Cross-Server Coordination: Consistent behavior across multiple servers

RoleAgentBot

A customizable personality that evolves over time. Load your preferred character into this agent and let it live on your server. 

Voting for RoleAgentBot

Do you want to support us?