BLOXAR Script Engine

Официальная документация по скриптовому движку BLOXAR. Пишите логику миров, анимации, механики и мини-игры прямо в браузере — без сборщиков и фреймворков.

🚀 Первый скрипт

1. Откройте проект в Studio Mode.
2. В панели Explorer нажмите ➕ и выберите 📜 Script.
3. Перетащите скрипт внутрь любого блока 📦 Part.
4. Кликните по скрипту — откроется редактор кода.
5. Напишите код и нажмите Save & Close.

🧬 Системные переменные

4 переменные доступны в каждом скрипте без объявления.

🛠️ Манипуляции с объектами

Команды для изменения внешнего вида и положения блоков. Вызываются через BLOXAR.*

❤️ Игрок и Здоровье

🔊 Аудио и UI

🧱 Создание и удаление блоков

// Создаём красный куб и удаляем через 3 секунды
const cube = BLOXAR.createPart(0, 5, 0, 0xFF3B3B, 1, 1, 1, false);

if (!script.userData.timer) script.userData.timer = time;
if (time - script.userData.timer > 3) {
    BLOXAR.destroyPart(cube);
}

✨ Эффекты и Частицы

// Эффект взрыва на позиции блока при приближении игрока
const dist = parent.position.distanceTo(player.position);
if (dist < 2 && !script.userData.exploded) {
    script.userData.exploded = true;
    BLOXAR.spawnEffect(parent.position.x, parent.position.y, parent.position.z, 0xFF6600, 25);
    BLOXAR.playSound('land');
}

🗡️ Инструменты (Weapons & Items)

Система для создания оружия, предметов и экипировки в руки персонажа.

// Создаём меч в слоте 1 при старте
if (!script.userData.ready) {
    script.userData.ready = true;
    const sword = BLOXAR.createTool('box', 0xC0C0C0, 0.1, 1.2, 0.1);
    BLOXAR.equipTool(sword, 1);
    BLOXAR.setToolName(1, 'Меч');
}

// Удар при нажатии E
if (BLOXAR.isKeyPressed('e')) {
    BLOXAR.playAnimation('swing');
    BLOXAR.spawnEffect(player.position.x, player.position.y + 1, player.position.z, 0xffffff, 8);
}

💪 Анимации рук

Быстрые одноразовые анимации правой руки. Идеальны для атак, броска, взаимодействий.

Доступные пресеты рук

// Атака при нажатии ЛКМ (клавиша 'f' как замена)
if (BLOXAR.isKeyPressed('f')) {
    if (!script.userData.attacking) {
        script.userData.attacking = true;
        BLOXAR.playAnimation('swing');
        BLOXAR.damagePlayer(-10); // Лечим как пример логики
    }
} else {
    script.userData.attacking = false;
}

🕺 Анимации тела

Полные анимации персонажа: все конечности одновременно. Два подхода: пресеты и ручное управление.

Доступные пресеты тела

// Танцевать при нажатии G, остановить при отпускании
if (BLOXAR.isKeyPressed('g')) {
    BLOXAR.playBodyAnim('dance');
} else {
    BLOXAR.stopBodyAnim();
}

// Кастомная анимация через setLimb — кивание головой
BLOXAR.setLimb('head', Math.sin(time * 3) * 0.4, 0, 0);

// Поднять левую руку синусоидой
BLOXAR.setLimb('lArm', Math.sin(time * 2) * 1.2, 0, Math.cos(time) * 0.3);

💾 DataStore (Сохранения)

Сохраняй прогресс игрока между сессиями. Данные привязаны к конкретному плейсу и конкретному игроку.

// Счётчик посещений — увеличивается каждый заход
if (!script.userData.loaded) {
    script.userData.loaded = true;

    let visits = BLOXAR.loadData('visits') || 0;
    visits += 1;
    BLOXAR.saveData('visits', visits);
    BLOXAR.showText('Ты здесь уже ' + visits + ' раз!');

    // Через 3 секунды скрыть текст
    script.userData.showUntil = time + 3;
}

if (script.userData.showUntil && time > script.userData.showUntil) {
    BLOXAR.showText('');
    script.userData.showUntil = null;
}

🔗 SharedData (Общая память)

Общая память между всеми скриптами в плейсе. Идеальна для передачи состояния от одного скрипта к другому — например, "кнопка нажата" → "дверь открыта".

// === Скрипт 1: Кнопка-триггер ===
const dist = parent.position.distanceTo(player.position);
if (dist < 2 && BLOXAR.isKeyPressed('e')) {
    BLOXAR.set('doorOpen', true);
    BLOXAR.setColor(parent, 0x2EE6A6); // Кнопка зеленеет
}

// === Скрипт 2: Дверь (в другом блоке) ===
if (BLOXAR.get('doorOpen', false)) {
    parent.position.y += 0.05; // Поднимается вверх
    if (parent.position.y > 5) BLOXAR.delete('doorOpen');
}

⚡ Система событий (Events)

Регистрируй колбеки (функции), и движок сам вызовет их в нужный момент.

BLOXAR.onTouched(() => {
    BLOXAR.setColor(parent, 0x2EE6A6);
    BLOXAR.playSound('pickup');
});

BLOXAR.onKeyDown('f', () => {
    BLOXAR.showText("Нажата клавиша F!");
});

👾 Система NPC и Врагов

Спавн и управление мобами.

BLOXAR.onStart(() => {
    const boss = BLOXAR.spawnNPC({
        x: parent.position.x, y: parent.position.y + 2, z: parent.position.z,
        name: "Босс Охраны", color: 0xFF0000, hp: 300, attackDamage: 25
    });
    
    BLOXAR.setNPCOnDeath(boss, () => {
        BLOXAR.showText("Босс повержен!");
        BLOXAR.playSound3D(parent.position.x, parent.position.y, parent.position.z, 'explosion');
    });
});

🎒 Инвентарь и Предметы

🖥️ GUI Builder (Интерфейс)

Создание кастомных 2D-интерфейсов на экране игрока. Все элементы отрисовываются поверх игры.

BLOXAR.onStart(() => {
    // Создаем окно по центру
    BLOXAR.gui.createFrame('shop', { width: 250, height: 120, anchor: 'center' });
    BLOXAR.gui.createLabel('shop_title', 'shop', { text: 'Магазин', bold: true, align: 'center' });
    
    // Кнопка покупки
    BLOXAR.gui.createButton('buy_sword', 'shop', { 
        text: 'Купить меч (100 🟡)', 
        onClick: () => {
            BLOXAR.giveItem({ id: 'sword', name: 'Меч', icon: '🗡️' });
            BLOXAR.gui.destroy('shop'); // Закрываем магазин
        }
    });
});

🌍 Окружение и Свет

Управление погодой, небом и динамическим освещением.

🏃 Физика и Движение

Управление скоростью, прыжками и положением игрока.

💬 Уведомления и Очки

🎬 Плавные анимации (Tweens)

Встроенная система для плавного перемещения и изменения блоков без ручного расчета.

⏱ Таймеры и Лучи

💡 Готовые примеры (Copy & Paste)

Парящий блок-хамелеон

// Вращение
BLOXAR.rotate(parent, 0, 0.05, 0.02);

// Парение
parent.position.y += Math.sin(time * 5) * 0.005;

// Смена цвета по клавише F
if (BLOXAR.isKeyPressed('f')) {
    BLOXAR.setColor(parent, 0xFFD700);
} else {
    BLOXAR.setColor(parent, 0x1A2639);
}

Интерактивная кнопка

const dist = parent.position.distanceTo(player.position);

if (!script.userData.isPressed) {
    if (dist < 3) {
        BLOXAR.showText('Нажми [E] чтобы активировать');
        if (BLOXAR.isKeyPressed('e')) {
            script.userData.isPressed = true;
            BLOXAR.playSound('jump');
            BLOXAR.setColor(parent, 0x2EE6A6);
            BLOXAR.showText('');
        }
    } else {
        BLOXAR.showText('');
    }
}

Ловушка-шипы (урон при касании)

const dist = parent.position.distanceTo(player.position);

if (dist < 1.2) {
    if (!script.userData.cooldown || time - script.userData.cooldown > 1.5) {
        script.userData.cooldown = time;
        BLOXAR.damagePlayer(20);
        BLOXAR.playSound('land');
        BLOXAR.spawnEffect(player.position.x, player.position.y, player.position.z, 0xFF3B3B, 15);
    }
}

Танцевальная зона

const dist = parent.position.distanceTo(player.position);

if (dist < 3) {
    if (!script.userData.dancing) {
        script.userData.dancing = true;
        BLOXAR.playBodyAnim('dance');
        BLOXAR.showText('🎵 Танцевальная зона!');
    }
} else {
    if (script.userData.dancing) {
        script.userData.dancing = false;
        BLOXAR.stopBodyAnim();
        BLOXAR.showText('');
    }
}

Портал с эффектом вращения

// Постоянное вращение блока
BLOXAR.rotate(parent, 0.02, 0.04, 0.01);

// Пульсация частицами
if (Math.floor(time * 4) % 2 === 0 && !script.userData.lastPulse) {
    script.userData.lastPulse = true;
    BLOXAR.spawnEffect(parent.position.x, parent.position.y, parent.position.z, 0x2F6BFF, 5);
} else if (Math.floor(time * 4) % 2 !== 0) {
    script.userData.lastPulse = false;
}

// Телепорт при касании
const dist = parent.position.distanceTo(player.position);
if (dist < 1.5) {
    BLOXAR.showText('⚡ Телепорт активен');
} else {
    BLOXAR.showText('');
}