![[IMG]](//proxy.spigotmc.org/efd7ba55c2d097c4a1f1df9f1e8e187a1f5dea89/68747470733a2f2f692e696d6775722e636f6d2f7a4861324b437a2e6a706567)
AI Assistant
- Intelligent Responses: Context-aware AI assistant using Google Gemini
- Command Execution: AI can execute Minecraft commands with proper permission controls
- Server Integration: Provides real-time server information and player context
- WorldEdit Integration: AI can help with building and world editing tasks
- Multiverse Support: AI understands world management and teleportation
Management Interface
- Interactive GUI: Comprehensive dashboard for all VoxelAI features
- Real-time Monitoring: Live statistics and system health monitoring
- Admin Tools: Easy management of violations, punishments, and system configuration
How ChatWarden Works
ChatWarden uses a
simple, predictable punishment system:
- AI Analysis: AI evaluates each message and assigns a severity score (1–5)
- Weighted Scoring: Score = AI Severity × Violation Weight × Escalation Multiplier
- Action Determination: Score determines punishment based on configurable thresholds
Violation Weights
- Hate Speech: 2.0× (most serious)
- Harassment: 1.5× (50% more severe)
- Toxicity: 1.0× (standard)
- Profanity: 0.8× (slightly less severe)
- Spam: 0.5× (least severe)
Punishment Thresholds (Configurable)
- Warning: 1.0 points
- Mute: 2.5 points
- Tempban: 6.0 points
- Ban: 12.0 points
Escalation System
- First-time offenders: 1.0× multiplier
- Each previous violation adds +0.1× to the multiplier
- Violations automatically expire after 24 hours (configurable)
Commands
Main Commands
Code (Text):
/voxelai - Open main VoxelAI control panel
/voxelai gui - Open main GUI interface
/voxelai ai - Open AI Assistant interface
/voxelai server - View server information
/voxelai assist - Get AI assistance
/ai - Quick AI assistant access
/ai toggle - Enable/disable AI assistant
/ai status - Check AI assistant status
/ai clear - Clear conversation history
ChatWarden Commands
Code (Text):
/voxelai chatwarden - Open ChatWarden dashboard
/voxelai lookup - Open punishment lookup
/voxelai stats - View ChatWarden statistics
/voxelai checkviolations - Check player violations
/voxelai approve - Approve pending punishment
/voxelai deny - Deny pending punishment
/voxelai pending - View pending approvals
Admin Commands
Code (Text):
/voxelai reload - Reload plugin configuration
/voxelai clearviolations [player] - Clear violations
/voxelai emergency-stop - Emergency stop ChatWarden
/voxelai escalation [player] - View escalation info
/voxelai failed - View failed commands
/voxelai clearfailed - Clear failed commands log
/voxelai hybrid-status - View hybrid model status
Permissions
Core Permissions
Code (Text):
voxelai.use - Basic access to VoxelAI system (default: false)
voxelai.admin - Full administrative access (default: op)
AI Assistant Permissions
Code (Text):
voxelai.assistant.use - Use the AI assistant (default: false)
voxelai.command.execute - Allow AI to execute commands (default: op)
ChatWarden Permissions
Code (Text):
voxelai.chatwarden.exempt - Exempt from chat analysis (default: op)
voxelai.chatwarden.notify - Receive violation notifications (default: op)
voxelai.chatwarden.approve - Approve/deny punishments (default: op)
voxelai.chatwarden.admin - Full ChatWarden administration (default: op)
Plugin Integration
ChatWarden automatically discovers and integrates with popular punishment plugins:
- LiteBans - Full integration with all punishment types
- AdvancedBan - Complete punishment suite
- BanManager - Standard and custom ban commands
- UltraPunishments - Comprehensive moderation tools
- EssentialsX - Ban, kick, mute, warn commands
- Punishments - Basic punishment functionality
AI Command Validation
- Confirms commands actually perform expected functions
- Identifies when /w is whisper, not warn
- Prioritizes commands from trusted plugins
- Finds better alternatives when conflicts exist
⚙️ Configuration Highlights
ChatWarden Settings
Code (YAML):
chatwarden:
enabled
: true
batch_processing:
enabled
: true
chunk_size
: 50
process_interval_seconds
: 15
analysis:
enabled_modules:
toxicity
: true
harassment
: true
hate_speech
: true
spam
: true
profanity
: true
confidence_thresholds:
toxicity
: 0.8
harassment
: 0.85
hate_speech
: 0.9
spam
: 0.8
profanity
: 0.75
AI Assistant Settings
Code (YAML):
assistant:
enabled
: true
max-tokens
: 2048
temperature
: 0.7
command-execution
: true
blocked-commands
:
-
"stop"
-
"restart"
-
"ban"
-
"op"
Punishment Configuration
Code (YAML):
punishments:
punishment_score_thresholds:
warn
: 1.0
mute
: 2.5
tempban
: 6.0
ban
: 12.0
punishment_escalation:
mute
:
[
"10m",
"30m",
"1h",
"3h",
"6h"
]
tempban
:
[
"1h",
"6h",
"12h",
"1d",
"3d",
"7d"
]
This is not the entire config, just some highlights.
Requirements
- Minecraft Server: Spigot/Paper 1.21+ (PaperMC recommended)
- Java 21+
- API Key: Google Gemini API key (Get free key here)