AI-Powered Multiplayer Text Adventure

class SocketHandler {
    constructor(io, gameEngine, commandParser) {
        this.io = io;
        this.gameEngine = gameEngine;
        this.commandParser = commandParser;
        this.socketToPlayer = new Map();
        this.commandRateLimits = new Map();
        this.maxCommandsPerMinute = 60;

        this.setupGameEngineListeners();
    }

    setupGameEngineListeners() {
        // Broadcast player movements to all players in affected rooms
        this.gameEngine.on('playerMoved', ({ player, from, to, direction }) => {
            this.gameEngine.broadcastToRoom(from.id,
                `${player.name} leaves ${direction}.`, player.id);
            this.gameEngine.broadcastToRoom(to.id,
                `${player.name} arrives.`, player.id);
        });

        // Push real-time stat updates to individual players
        this.gameEngine.on('playerUpdate', (player) => {
            const socket = this.getSocketByPlayerId(player.id);
            if (socket) socket.emit('playerUpdate', {
                hp: player.currentHp, maxHp: player.maxHp,
                level: player.level, experience: player.experience
            });
        });
    }

    async handleAuthenticate(socket, { token, playerId, guest }) {
        // Validate JWT, check blacklist, load player from DB
        const decoded = jwt.verify(token, process.env.JWT_SECRET);
        if (decoded.jti && tokenBlacklist.isBlacklisted(decoded.jti)) {
            socket.emit('authError', { message: 'Token revoked' });
            return;
        }
        const player = new Player(await db.loadPlayer(decoded.id));
        this.socketToPlayer.set(socket.id, player);
        this.gameEngine.addPlayer(player);
        socket.emit('authenticated', { player: player.toJSON() });
    }
}

calculateDamage(attacker, defender) {
    // Base damage: STR scaling + level bonus
    const attackPower = attacker.stats.str || 5;
    const baseDamage = attackPower * 2 + (attacker.level * 3);

    // Defense with diminishing returns (soft cap formula)
    const defense = defender.stats.vit + Math.floor(defender.stats.agi * 0.3);
    const damageReduction = defense / (defense + 50);

    // Critical hit: DEX + LUK based, capped at 50%
    const critChance = Math.min(0.5,
        (attacker.stats.dex + attacker.stats.luk) / 100);
    const isCritical = Math.random() < critChance;
    const critMultiplier = isCritical ? 1.5 : 1.0;

    // Dodge chance based on agility difference
    const dodgeChance = Math.min(0.3,
        Math.max(0, (defender.stats.agi - attacker.stats.dex) * 0.02));
    if (Math.random() < dodgeChance)
        return { damage: 0, dodged: true };

    // Final: apply reduction, crit, and 85-115% variance
    const variance = Math.random() * 0.3 + 0.85;
    const final = Math.max(1,
        Math.floor(baseDamage * (1 - damageReduction) * critMultiplier * variance));

    return { damage: final, critical: isCritical, dodged: false };
}

initializeCommands() {
    return {
        // Movement - full names and shortcuts
        north: this.handleMove.bind(this, 'north'),
        n:     this.handleMove.bind(this, 'north'),
        ne:    this.handleMove.bind(this, 'northeast'),

        // Combat - multiple natural verbs
        attack: this.handleAttack.bind(this),
        kill:   this.handleAttack.bind(this),
        fight:  this.handleAttack.bind(this),
        slay:   this.handleAttack.bind(this),

        // Social - talk to NPCs with any verb
        talk:     this.handleTalk.bind(this),
        speak:    this.handleTalk.bind(this),
        converse: this.handleTalk.bind(this),
        ask:      this.handleAsk.bind(this),

        // Crafting - thematic aliases
        craft:   this.handleCraft.bind(this),
        forge:   this.handleCraft.bind(this),
        brew:    this.handleCraft.bind(this),
        enchant: this.handleCraft.bind(this),

        // Punctuation shortcuts
        "'": this.handleSay.bind(this),    // 'hello => say hello
        '"': this.handleSay.bind(this),
        '!': this.handleYell.bind(this),

        // D&D dice rolling
        roll: this.handleRoll.bind(this),       // roll 2d6+3
        advantage: this.handleAdvantage.bind(this),
        // ...80+ total commands
    };
}