Advanced MBII Features with Ilyssa Hosting

Standard MBII hosting gets you a server. But what about combating cheaters? Detecting impostors? Managing troublemakers? Monitoring your server from Discord? These features require custom solutions.

Ilyssa Hosting includes Yoda, our custom-built server management bot with anti-cheat, automated moderation, Discord integration, and intelligent player management. This guide covers what makes these servers different.

Meet Yoda: Your Server Guardian

Yoda is a custom bot that runs alongside your MBII server, monitoring player behaviour, detecting threats, and taking automated action. Think of it as an always-on admin who never sleeps.

Discord Integration

One of Yoda's most powerful features is comprehensive Discord integration. Monitor and manage your server without being in-game.

What Gets Logged to Discord

Setting Up Discord Integration

Here's how to connect your server to Discord:

# Discord Configuration
server_id: 123456789012345678
channels:
  admin: 987654321098765432      # Staff-only channel for admin actions
  chat: 876543210987654321       # General in-game chat mirror
  joins: 765432109876543210      # Player connections
  kills: 654321098765432109      # Kill logs
  reports: 543210987654321098    # Player reports
  bans: 432109876543210987       # Ban attempts and actions

Smart Impostor Detection

A common problem in MBII: players impersonate others using visually similar characters. For example, using "I" (capital i) instead of "l" (lowercase L) to impersonate "Player" as "PIayer". These look identical in the game font.

How It Works

Yoda automatically detects impostor attempts by:

• Analysing name similarity using character-matching algorithms
• Tracking known player names and comparing new connections
• Detecting unicode tricks and zero-width characters
• Identifying empty or invisible names

When detected, Yoda automatically renames the player to User[clientID] and logs the action to Discord.

Configuration

Edit judgment.yml to control impostor detection:

# Impostor and Empty Name Detection
renameImpostorsAndEmptyNames: true   # Enable automatic renaming

VPN Detection and Management

VPNs are commonly used by banned players to evade bans. Yoda uses dual-provider VPN detection to identify suspicious connections with high accuracy.

VPN Detection Features

• Dual Provider Verification: Cross-checks IPs against two different VPN databases
• Automatic Warnings: Warns players using VPNs with countdown before kick
• Optional Auto-Kick: Automatically disconnects VPN users after warning period
• Whitelist Support: Allow trusted players to use VPNs
• Discord Logging: All VPN detections logged to staff channels

Configuration Options

Edit judgment.yml to control VPN management:

# VPN Detection Settings
warnAndKickVpnUsers: true          # Enable VPN warnings and kicks
vpnKickCountdown: 20               # Seconds before kicking (warning time)
muteVpnUsers: false                # Mute VPN users during warning
renameVpnUsers: false              # Rename VPN users to "VPN User"

# Whitelist trusted IPs (won't be kicked even if VPN detected)
allowedVpnIps:
  - "123.456.789.012"
  - "98.765.43.210"

Intelligent Anti-Spam

Standard anti-spam just limits messages per second. Yoda uses pattern analysis to catch spam while allowing rapid legitimate communication.

How It Works

• Pattern Detection: Identifies repeated messages, character spam, and flooding
• Context Awareness: Allows rapid chat during intense moments (doesn't limit normal play)
• Auto-Mute: Temporarily mutes detected spammers
• Escalation: Repeated spam offenses lead to kicks or temp bans

This means players can type quickly during gameplay without false positives, but actual spammers get caught and muted automatically.

Advanced Ban System

Yoda's ban system goes beyond standard JKJA bans with UID tracking, IP bans, and flexible ban management.

Enhanced Ban Commands

# Ban by partial name match (recommended)
/rcon !ban PlayerName

# Ban by IP address
/rcon !banip 123.456.789.012

# Ban by client ID (from /rcon status)
/rcon !banid 5

# Ban by unique ID
/rcon !banuid 1234567890

# Ban by exact name (⚠️ use carefully!)
/rcon !bann "ExactNameHere"

# Temporary bans (20 rounds by default)
/rcon !tempban PlayerName
/rcon !tempbanid 5
/rcon !tempbanip 123.456.789.012

# Unban an IP
/rcon !unban 123.456.789.012

Why This System is Better

• Tracks both IP and UID: Harder for players to evade bans
• Partial name matching: Ban "Play" matches "PlayerName"
• Centralized management: All bans stored in bans.yml
• Discord alerts: Notified when banned players attempt to reconnect
• Flexible unbanning: Edit bans.yml directly for complex cases

Managing Bans

For simple unbans, use /rcon !unban <IP>. For UID or name bans:

1. Open bans.yml via SFTP
2. Find and remove the banned entry
3. Save and run /rcon !rehash

Automated Server Messages

Keep players informed with automated welcome messages, tips, and warnings.

Message Types

# messages.yml configuration
welcome:
  common:
    - 'Welcome to our server! Have fun!'
    - 'Check our Discord: discord.gg/example'
  duel:
    - 'No laming! Only fight willing opponents.'

tips:
  common:
    - 'Assign keys to class special 1 & 2 in controls'
    - 'Type !rtv to vote for a map change'

warnings:
  common:
    - 'No intentional team killing!'
  duel:
    - 'Defense 2 is required for faster BP regeneration'

Messages are shown automatically at intervals, with mode-specific messages for duel vs open mode.

Configuration Management

The !rehash Command

Whenever you modify Yoda configuration files, reload them with:

/rcon !rehash

This reloads all .yml files without restarting the server. Note: running !rehash may cancel active map votes.

Restoring Defaults

If you break something, default configurations are stored in /server/defaults:

1. Download the default file from /server/defaults
2. Upload it to /server (overwrite existing)
3. Run /rcon !rehash

Validating YAML Files

YAML is sensitive to formatting. If Yoda stops working after config changes, validate your files at YAML Lint.

How Ilyssa Hosting Differs

Standard MBII hosting vs Ilyssa Hosting with Yoda:

Getting Started

Ilyssa Hosting servers come with Yoda pre-installed and pre-configured. You just need to connect your Discord server and customise settings to your preference.

Complete documentation, including the Yoda Discord bot invite link and detailed setup instructions, is provided in your server files at /server/README.md. Access this file via SFTP from your server dashboard.

Related Guides

• MBII Server Setup Guide - Basic server installation and setup
• Server Configuration and RCON - Configure server.cfg and learn RCON commands
• RTVRTM Map Voting Guide - Set up player-driven map voting