Check Module

The Check Module provides a comprehensive alt check system with detailed player information and visual status indicators.

🚀 Features

Core Functionality

Alt Check - Check for alt accounts linked by IP address
Player Status - Show banned, muted, warn status
History Count - Display total history entries
Interactive UI - Click for more information

Advanced Features

Status Colors - Visual indicators for player status
Hover Information - Detailed player info on hover
Legend Display - Color-coded status guide
Accuracy Display - Shows detection accuracy percentage
Multiple Alts - Shows all alt accounts for a player

📋 Commands

`/check <player>`

Check player status and alt accounts.

Permission: zenith.check

Parameters:

player - Player name or UUID

Examples:

/check Player123
/check 12345678-1234-1234-1234-123456789012

⚙️ Configuration

Module Settings

enabled: true

check:
  messages:
    header: "{prefix}&#FFAA00Alt Check for &#FFFF00{player}"
    footer: "{prefix}&#7F7F7FClick on usernames for more information"
    no_alts: "{prefix}&#FFAA00No alt accounts found for &#FFFF00{player}"
    player_not_found: "{prefix}&#FF0000Player &#FFFF00{player} &#FF0000not found!"
    no_permission: "{prefix}&#FF0000You don't have permission to use this command!"
    error: "{prefix}&#FF0000An error occurred while checking alt accounts!"

Player Information Display

check:
  player_info:
    enabled: true

    format:
      - "&#FFAA00Player Status:"
      - "-"
      - "&#FFFFFFBanned: &#FFFF00{banned}"
      - "&#FFFFFFMuted: &#FFFF00{muted}"
      - "-"
      - "&#FFFFFFTotal Warns: &#FFFF00{total_warns}"
      - "&#FFFFFFTotal History Entries: &#FFFF00{total_history}"
      - "-"

    position: "top"  # "top" or "bottom"

Status Colors

alt_display:
  status_colors:
    online: "&#00FF00"      # Green
    muted: "&#FFAA00"       # Orange
    banned: "&#FF0000"      # Red
    offline: "&#7F7F7F"     # Gray
    unknown: "&#FFFFFF"     # White

  status_text:
    online: "Online"
    muted: "Muted"
    banned: "Banned"
    offline: "Offline"
    unknown: "Unknown"

Hover Information

hover:
  enabled: true

  text:
    - "&#FFAA00Player Information"
    - " "
    - "&#FFFFFFName: &#FFFF00{username}"
    - "&#FFFFFFUUID: &#FFFF00{uuid}"
    - "&#FFFFFFIP: &#FFFF00{ip}"
    - " "
    - "&#FFFFFFStatus: &#FFFF00{status}"
    - "&#FFFFFFLast Seen: &#FFFF00{last_seen}"
    - "&#FFFFFFFirst Seen: &#FFFF00{first_seen}"
    - "&#FFFFFFShared IPs: &#FFFF00{shared_ips}"
    - " "
    - "&#FFAA00Actions"
    - "&#FFFFFFClick for History: &#FFFF00/history {username}"
    - "&#FFFFFFClick for Notes: &#FFFF00/notes {username}"

📊 Available Variables

Player Status Variables

Variable	Description	Example
`{banned}`	Is player banned	`Yes` or `No`
`{muted}`	Is player muted	`Yes` or `No`
`{total_warns}`	Total warnings	`3`
`{total_history}`	Total history entries	`15`

Alt Display Variables

Variable	Description	Example
`{username}`	Alt account name	`AltAccount1`
`{status_color}`	Status color code	`&#FF0000`
`{status_text}`	Status text	`Banned`
`{last_seen}`	Last seen timestamp	`2025-01-14 15:30`
`{ip}`	Alt IP address	`192.168.1.1`
`{shared_ips}`	Shared IP addresses	`192.168.1.1, 10.0.0.1`

Hover Variables

Variable	Description	Example
`{username}`	Player name	`Player123`
`{uuid}`	Player UUID	`12345...`
`{ip}`	IP address	`192.168.1.1`
`{status}`	Current status	`Online`
`{last_seen}`	Last seen time	`2 hours ago`
`{first_seen}`	First seen time	`2025-01-10`
`{shared_ips}`	Shared IPs	`192.168.1.1, 10.0.0.1`

🎨 Display Examples

No Alts Found

┌──────────────────────────────────┐
│ Alt Check for Player123          │
│                                  │
│ No alt accounts found.           │
└──────────────────────────────────┘

Alts Found

┌──────────────────────────────────┐
│ Alt Check for Player123          │
│                                  │
│ Player Status:                   │
│ - Banned: No                     │
│ - Muted: No                     │
│ - Total Warns: 2                │
│ - Total History: 5               │
│                                  │
│ Alts:                            │
│ ● AltAccount1 (Online)           │
│ ● AltAccount2 (Muted)            │
│ ● AltAccount3 (Banned)           │
│                                  │
│ Legend:                           │
│ Green=Online | Orange=Muted     │
│ Red=Banned | Gray=Offline       │
│                                  │
│ Accuracy: 95% (IP Analysis)      │
│                                  │
│ Click for more info              │
└──────────────────────────────────┘

🔐 Permissions

Required Permissions

Permission	Description
`zenith.check`	Use check command
`zenith.check.bypass`	Bypass check restrictions

🛠️ Troubleshooting

Common Issues

Issue: “No alts found” when alts exist

Check database connection
Verify player has alt accounts in database
Check IP address tracking is enabled

Issue: No player information displayed

Check player_info.enabled is true
Verify player info format configuration
Check for syntax errors

Issue: Hover information not showing

Check if hover is enabled
Verify hover text configuration
Check for correct variable names

Issue: Wrong status colors

Verify status color configuration
Check status detection logic
Review player status in database

Debug Mode

Enable debug mode for detailed logging:

debug:
  enabled: true
  console: true
  file: true

Need help with the Check Module? Join our Discord: https://discord.gg/2qCMn6KHj4