VoxelAI Logo

Punishment System

Enforcement

VoxelAI's ChatWarden uses a sophisticated punishment system that automatically handles chat violations with appropriate and escalating consequences.

Punishment Types

Warning

• First level of punishment

• No gameplay restriction

• Clear message to player

• Logged for escalation

Mute

• Prevents chat usage

• Temporary duration

• Escalating lengths

• Can be reviewed by staff

Temporary Ban

• Server access blocked

• Fixed duration

• Escalating lengths

• Staff review available

Permanent Ban

• Complete server ban

• No automatic expiry

• Requires manual unban

• Highest punishment level

Punishment Thresholds

Score-Based Thresholds

Violation scores determine punishment levels

punishment_score_thresholds:
  warn: 1.0     # Low threshold - even minor violations
  mute: 3.0     # Medium - repeated or moderate violations
  tempban: 8.0  # High - serious or repeated violations
  ban: 20.0     # Very high - extreme or persistent violations

Duration Configuration

Mute Escalation Schedule

Progressive mute durations for repeat offenses

punishment_escalation:
  mute:
    - "10m"  # First mute
    - "30m"  # Second mute
    - "1h"   # Third mute
    - "3h"   # Fourth mute
    - "6h"   # Fifth+ mute
1st Offense

10 minutes

2nd Offense

30 minutes

3rd Offense

1 hour

4th Offense

3 hours

5th+ Offense

6 hours

Punishment Messages

Message Configuration

Customize punishment messages by violation type

punishment_messages:
  spam:
    warn: "Please do not spam the chat."
    mute: "You have been muted for spamming."
    tempban: "You have been temporarily banned for persistent spam."
    ban: "You have been permanently banned for excessive spam."
  
  toxicity:
    warn: "Please maintain a respectful chat environment."
    mute: "You have been muted for toxic behavior."
    tempban: "You have been temporarily banned for severe toxicity."
    ban: "You have been permanently banned for extreme toxic behavior."

Message Variables

Available variables for dynamic messages

{player}

Player name

{duration}

Punishment duration

{reason}

Violation reason

{id}

Unique punishment ID

{date}

Punishment date

Punishment Processing

1. Score Calculation

Final Score = Base Score × Escalation Multiplier

Combines violation severity, weights, and escalation factors.

2. Threshold Check

if (score >= banThreshold) return BAN;
if (score >= tempbanThreshold) return TEMPBAN;
if (score >= muteThreshold) return MUTE;
if (score >= warnThreshold) return WARN;
return NONE;

3. Duration Selection

• Based on violation count

• Uses escalation table

• Considers violation type

• Accounts for history

Staff Commands

Management Commands

Commands for managing violations and punishments

/voxelai checkviolations [player]

Check player's violation history

/voxelai clearviolations

Clear all violation history (DANGEROUS)

/voxelai lookup <id>

Look up punishment details by ID

Logging & Tracking

Log Files

plugins/VoxelAI/logs/violations.log

All detected violations

plugins/VoxelAI/logs/punishments.log

All issued punishments

Database Storage

• Player history

• Violation records

• Punishment details

• Punishment history

Best Practices

Configuration

• Start with default thresholds

• Monitor effectiveness

• Adjust gradually

• Document changes

Staff Training

• Understand system logic

• Know override commands

• Review punishments fairly

• Monitor for abuse

Player Communication

• Clear violation messages

• Appeal instructions

• Punishment reasons

• Reform guidance