+ Лидерборд — таблица очков игроков справа-сверху (как + в Roblox). Объяви стат и меняй значение: +
+{`game.leaderstats.define('Монеты', { initial: 0, icon: 'coin' });
+game.leaderstats.define('Уровень', { initial: 1 });
+
+game.leaderstats.me.add('Монеты', 5); // +5 текущему игроку
+game.leaderstats.me.set('Уровень', 2); // задать значение
+const c = game.leaderstats.me.get('Монеты');`}
+ + Достижения — всплывающие ачивки с редкостью и звуком: +
+{`game.achievements.define([
+ { id: 'first_coin', name: 'Первая монетка', description: 'Собери монету', icon: 'coin', rarity: 'common' },
+ { id: 'rich', name: 'Богач', description: '100 монет', icon: 'trophy', rarity: 'legendary' }
+]);
+game.achievements.unlock('first_coin');
+// или авто-разблокировка по статy:
+game.achievements.bindToStat('rich', 'Монеты', 100);`}
+ + Всплывающие цифры урона над врагом — как в RPG. Самый + простой способ — авто-режим (цифры над всеми мобами при уроне): +
+{`game.fx.autoMobFloaters(true);`}
+ Ручной вызов в нужный момент:
+{`game.fx.damageFloater(enemy.position, 25); // обычный урон
+game.fx.damageFloater(enemy.position, 100, { isCrit: true }); // крит — крупно, жёлтый
+game.fx.damageFloater('player', 30, { isHeal: true }); // лечение, зелёный
+game.fx.damageFloater(pos, 0, { isMiss: true }); // промах MISS`}
+
+ ),
+ },
+ {
+ id: 'items-inventory',
+ title: 'G9. Предметы и инвентарь с редкостями',
+ body: (
+ <>
+ + Полноценный инвентарь (сетка + хотбар, стаки, редкости). + Сначала опиши предметы, потом выдавай: +
+{`game.items.define([
+ { id: 'berry', name: 'Ягоды', emoji: '🍓', rarity: 'common', maxStack: 16 },
+ { id: 'potion', name: 'Зелье', emoji: '🧪', rarity: 'rare', maxStack: 8, onUseEffect: 'heal:50' },
+ { id: 'sword', name: 'Меч', emoji: '⚔️', rarity: 'legendary', maxStack: 1 },
+]);
+
+game.inventory.give('sword', 1);
+game.inventory.give('berry', 5); // стак`}
+ Сбор предмета с земли (скрипт на предмете):
+{`game.self.onInteract(() => {
+ game.inventory.give('berry', 2);
+ game.self.delete();
+}, { text: 'Собрать', key: 'e', distance: 3 });`}
+ Кастомное небо одной строкой — пресеты:
+{`game.scene.setSkybox({ preset: 'sunset' });
+// пресеты: clear-summer-day | lowpoly-roblox | cloudy | sunset | starry-night | space`}
+ Облака, туман и плавный переход:
+{`game.scene.setClouds({ enabled: true, cover: 0.5, speed: 0.02 });
+game.scene.setFog({ color: '#dddddd', density: 0.006 });
+game.scene.skybox.fadeTo({ preset: 'starry-night' }, 3); // плавно за 3 сек`}
+ Простое управление цветом неба и временем суток:
+{`game.environment.setSkyColor('#0a1024'); // тёмное небо
+game.environment.setTimeOfDay(0); // ночь (0..24)
+game.environment.setTimeOfDay(12); // полдень`}
+
+ ),
+ },
+ {
+ id: 'modal-menu-loading',
+ title: 'G11. Диалоги, меню, экран загрузки',
+ body: (
+ <>
+ Диалог NPC построчно:
+{`game.modal.dialog('Староста', [
+ 'Привет, путник!',
+ 'Собери 10 монет и возвращайся.',
+], () => game.ui.showText('Квест начат!', 2));`}
+ Окно Да/Нет и лутбокс:
+{`game.modal.confirmation('Выход', 'Точно выйти?', () => game.player.respawn(), null);
+
+game.modal.lootbox([
+ { name: 'Меч', color: '#f0ad4e', rarity: 'legendary' },
+ { name: 'Щит', color: '#5bc0de', rarity: 'rare' },
+], (item) => game.ui.showText('Выпал: ' + item.name, 3));`}
+ Экран загрузки при переходе между уровнями:
+{`game.loading.show({
+ style: 'ken-burns',
+ placeName: 'Глава 2 — Шахта',
+ studioName: 'Моя студия',
+ duration: 2
+});
+game.loading.onHide(() => game.ui.showText('Добро пожаловать!', 2));`}
+ + Машина, на которой можно ездить (вход hold-F, WASD руль): +
+{`game.scene.spawn('vehicle:car', { x: 0, y: 1, z: 0, name: 'Тачка' });
+game.onVehicleEnter(() => game.ui.showText('За рулём! WASD — ехать', 2));
+game.onVehicleExit(() => game.ui.showText('Вышел', 1));`}
+ Главное меню игры с живой камерой и кнопкой ИГРАТЬ:
+{`game.mainMenu.show({
+ title: 'МОЯ ИГРА',
+ camera: 'orbit',
+ playButtonText: 'ИГРАТЬ',
+ patchNotes: { title: 'Что нового', items: ['Добавлены машины', 'Новая карта'] },
+ onPlay: () => game.ui.showText('Поехали!', 2)
});`}
),
@@ -2398,4 +2676,632 @@ game.onTick(() => {
},
],
},
+
+ // ════════════════════════════════════════════════════
+ // РАЗДЕЛ — СКРИПТЫ: ГОТОВЫЕ РЕЦЕПТЫ
+ // ════════════════════════════════════════════════════
+ {
+ id: 'recipes',
+ icon: 'code',
+ title: 'Скрипты: рецепты',
+ summary: 'Готовые мини-скрипты, которые можно скопировать и вставить: килблок, сбор предметов, исчезновение и телепорт при касании, кнопки, таймеры, все свойства примитивов.',
+ sections: [
+ {
+ id: 'recipes-howto',
+ title: 'S1. Куда писать скрипты',
+ body: (
+ <>
+ В Рублоксе есть два вида скриптов:
+ game.scene, game.player, game.ui.game.self — это сам объект-носитель.
+ Удобно для «этот блок убивает», «этот сундук открывается».
+ Полезное: game.log(...) печатает в консоль (значок
+ «Консоль» внизу) — для отладки. game.player.position
+ — где сейчас игрок ({'{x, y, z}'}).
+
+ Самое частое событие — игрок коснулся объекта. Вешаем
+ скрипт на объект и подписываемся через game.self.onTouch.
+
{`// Игрок наступил на объект — показать надпись и звук
+game.self.onTouch(() => {
+ game.ui.showText('Ты коснулся плиты!', 2);
+ game.sound.play('click');
+});
+
+// Когда игрок ушёл с объекта
+game.self.onUntouch(() => {
+ game.ui.showText('Отошёл', 1);
+});`}
+ + Можно подписаться и на чужой объект из глобального + скрипта — найди его по имени: +
+{`const trap = game.scene.findOne('Ловушка');
+trap.onTouch(() => game.player.damage(20));`}
+
+ ),
+ },
+ {
+ id: 'recipes-killblock',
+ title: 'S3. Килблок — урон и смерть при касании',
+ body: (
+ <>
+ + Килблок — объект, который наносит урон или мгновенно + убивает, когда игрок его коснулся (лава, шипы, кислота). +
+{`// Мгновенная смерть при касании
+game.self.onTouch(() => {
+ game.player.kill();
+ game.ui.showText('💀 Ты сгорел в лаве!', 2);
+});`}
+ Если хочешь не убивать сразу, а наносить урон:
+{`// Урон 25 при касании (учитывает кадры неуязвимости)
+game.self.onTouch(() => {
+ game.player.damage(25);
+ game.camera.shake(0.2, 0.3); // лёгкая тряска
+});`}
+ + Постоянный урон, пока игрок стоит в зоне (например, + ядовитое облако) — урон каждые 0.5 сек, пока касается: +
+{`let inside = false;
+game.self.onTouch(() => { inside = true; });
+game.self.onUntouch(() => { inside = false; });
+game.every(0.5, () => {
+ if (inside) game.player.damage(5);
+});`}
+ + Предмет исчезает, когда игрок его коснулся — основа + сбора монеток, ключей, бонусов. +
+{`// Простое исчезновение + звук
+game.self.onTouch(() => {
+ game.sound.play('coin');
+ game.self.delete();
+});`}
+ + Со счётчиком: предмет сообщает глобальному скрипту, + тот считает. На монетке: +
+{`game.self.onTouch(() => {
+ game.broadcast('coin'); // сообщить всем скриптам
+ game.self.delete();
+});`}
+ В глобальном скрипте — приём и счёт:
+{`let score = 0;
+game.ui.score = 0;
+game.onMessage('coin', () => {
+ score = score + 1;
+ game.ui.score = score; // обновить счётчик в углу
+ if (score >= 10) game.ui.showText('🏆 Собрал все!', 3);
+});`}
+ game.broadcast.
+ + При касании переместить игрока (портал) или + сдвинуть сам объект (движущаяся платформа). +
+Портал — телепорт игрока в точку:
+{`game.self.onTouch(() => {
+ game.player.teleport(0, 20, 50); // x, y, z назначения
+ game.sound.play('win');
+ game.camera.shake(0.15, 0.2);
+});`}
+
+ Сдвинуть сам объект при касании (например, опустить
+ мост). game.self.move ставит новую позицию:
+
{`let opened = false;
+game.self.onTouch(() => {
+ if (opened) return;
+ opened = true;
+ const p = game.self.position;
+ game.self.move(p.x, p.y - 3, p.z); // уехал вниз на 3 м
+});`}
+
+ Плавно сдвинуть — через game.tween (анимация):
+
{`// дверь уезжает вбок за 1 секунду
+const p = game.self.position;
+game.self.onTouch(() => {
+ game.tween(game.self.ref, { x: p.x + 4 }, { duration: 1, easing: 'ease' });
+});`}
+
+ ),
+ },
+ {
+ id: 'recipes-primitive-props',
+ title: 'S6. Все свойства примитивов из скрипта',
+ body: (
+ <>
+ + Любой примитив можно создать и менять из + скрипта. Вот все свойства и как их задать. +
+Создать примитив со всеми свойствами:
+{`const box = game.scene.spawn('cube', {
+ x: 0, y: 2, z: 0, // позиция
+ sx: 2, sy: 1, sz: 3, // размер по осям (ширина/высота/глубина)
+ rotationX: 0, rotationY: 0.8, rotationZ: 0, // поворот в радианах
+ color: '#ff5533', // цвет (hex)
+ material: 'neon', // matte | neon | metal | glass | studs
+ name: 'МойКуб',
+ anchored: true, // true = висит на месте; false = падает (физика)
+ canCollide: true, // false = игрок проходит насквозь
+ visible: true,
+ mass: 5, // масса (если anchored:false)
+});`}
+ Типы примитивов для spawn:
{`'cube' 'sphere' 'cylinder' 'cone' 'pyramid' 'torus' 'wedge' 'cornerwedge' 'plane'`}
+ Менять свойства уже существующего объекта:
+{`game.scene.setColor(box, '#00ff88'); // цвет
+game.scene.setMaterial(box, 'glass'); // материал
+game.scene.setVisible(box, false); // спрятать
+game.scene.setCollide(box, false); // сделать проходимым
+game.scene.setOpacity(box, 0.4); // полупрозрачность (1=видно, 0=невидимо)
+game.scene.setScale(box, 3, 1, 1); // новый размер
+game.scene.move(box, 5, 2, 0); // переместить
+game.scene.setRotation(box, 0, 1.57, 0); // повернуть (радианы)
+game.scene.setLabel(box, 'Привет!', { color:'#fff', height: 2.5 });`}
+ + Удобнее — через объект-прокси (присваивание свойств): +
+{`const obj = game.scene.findOne('МойКуб');
+obj.color = '#ffd700';
+obj.material = 'metal';
+obj.scale = 2; // равномерный масштаб
+obj.opacity = 0.5;
+obj.visible = false;
+obj.canCollide = false;
+obj.position = { x: 0, y: 10, z: 0 };
+obj.rotateY(1.57);
+obj.destroy(); // удалить`}
+ Math.PI/2 ≈ 1.57, 180° = Math.PI ≈ 3.14.
+
+ Вращающийся объект (монета, портал) — крутим каждый
+ кадр через game.onTick (dt = время кадра):
+
{`let angle = 0;
+game.onTick((dt) => {
+ angle = angle + dt * 2; // скорость вращения
+ game.self.rotateY(angle);
+});`}
+ Парение вверх-вниз (плавно качается):
+{`const start = game.self.position;
+let t = 0;
+game.onTick((dt) => {
+ t = t + dt;
+ const dy = Math.sin(t * 2) * 0.4; // амплитуда 0.4 м
+ game.self.move(start.x, start.y + dy, start.z);
+});`}
+ Пульсация размера через tween (бесконечно туда-обратно):
+{`game.tween(game.self.ref, { sy: 1.4 }, {
+ duration: 0.6, easing: 'ease', yoyo: true, repeat: -1
+});`}
+ Мигание цветом каждые полсекунды:
+{`let on = false;
+game.every(0.5, () => {
+ on = !on;
+ game.self.setColor(on ? '#ff0000' : '#330000');
+});`}
+
+ ),
+ },
+ {
+ id: 'recipes-button-door',
+ title: 'S8. Кнопка по E и дверь',
+ body: (
+ <>
+
+ Взаимодействие по клавише E (как в Roblox ProximityPrompt)
+ — через game.self.onInteract. Появляется подсказка
+ «[E] …» когда игрок рядом.
+
{`game.self.onInteract(() => {
+ game.ui.showText('Открыто!', 2);
+ game.broadcast('open-door');
+}, { text: 'Открыть', key: 'e', distance: 4 });`}
+ На двери — глобальный/объектный скрипт, который её открывает:
+{`const closed = game.self.position;
+game.onMessage('open-door', () => {
+ // плавно уехать вверх (открыться)
+ game.tween(game.self.ref, { y: closed.y + 4 }, { duration: 1, easing: 'ease' });
+ game.self.setCollide(false); // через неё можно пройти
+});`}
+ holdDuration: 1 в опциях onInteract — держать E
+ 1 секунду (для важных действий). distance —
+ с какого расстояния появляется подсказка.
+ HUD-надписи в углу и по центру:
+{`game.ui.score = 0; // счётчик «Очки: 0» в углу
+game.ui.score = 50; // обновить
+game.ui.timer = 60; // таймер mm:ss в углу
+game.ui.showText('Старт!', 2); // крупно по центру на 2 сек
+game.ui.set('hp', 'Жизни: 3', { x: 50, y: 90, color: '#fff' }); // своя метка
+game.ui.remove('hp'); // убрать метку`}
+ Обратный отсчёт и проигрыш по времени:
+{`let time = 30;
+game.ui.timer = time;
+const id = game.every(1, () => {
+ time = time - 1;
+ game.ui.timer = time;
+ if (time <= 0) {
+ game.cancel(id);
+ game.ui.showText('Время вышло!', 3);
+ game.player.kill();
+ }
+});`}
+ Кнопка на экране (GUI) и обработка клика:
+{`const btn = game.gui.create('button', {
+ name: 'start', text: 'НАЧАТЬ', x: 50, y: 80,
+ w: 20, h: 8, bg: '#3a6ee0', color: '#fff', fontSize: 18, borderRadius: 12
+});
+game.gui.onClick(btn, () => {
+ game.ui.showText('Поехали!', 2);
+ game.gui.hide(btn);
+});`}
+
+ ),
+ },
+ {
+ id: 'recipes-spawn-fall',
+ title: 'S10. Спавн, падение, проверка падения вниз',
+ body: (
+ <>
+ Спавнить объекты с неба каждую секунду (ловилка):
+{`game.every(1, () => {
+ const x = game.random(-10, 10);
+ game.scene.spawn('sphere', {
+ x: x, y: 20, z: 0,
+ color: '#ffd700', material: 'neon',
+ anchored: false, // будет падать (физика)
+ lifetime: 8 // само исчезнет через 8 сек
+ });
+});`}
+ + Игрок упал вниз (за карту) — вернуть на спавн. Проверяем + высоту каждый кадр: +
+{`game.onTick(() => {
+ if (game.player.position.y < -10) {
+ game.player.respawn();
+ game.ui.showText('Упал! Назад на старт.', 2);
+ }
+});`}
+ Финиш — дошёл до зоны, победа:
+{`game.self.onTouch(() => {
+ game.ui.showText('🏁 ПОБЕДА!', 4);
+ game.sound.play('win');
+ game.player.setInputBlocked(true); // заморозить управление
+});`}
+
+ ),
+ },
+ {
+ id: 'recipes-npc-enemy',
+ title: 'S11. Враг, который идёт за игроком',
+ body: (
+ <>
+ + NPC/враг, который преследует игрока и наносит урон. +
+{`const enemy = game.scene.spawnNpc('zombie', {
+ x: 10, y: 0, z: 10,
+ hp: 100, name: 'Зомби', speed: 3
+});
+enemy.follow('player'); // идти за игроком
+enemy.say('Хочу тебя поймать!', 3);
+
+enemy.onDeath(() => {
+ game.ui.showText('Враг повержен!', 2);
+ game.fx.damageFloater(enemy.position, 0, { isHeal: true });
+});`}
+ Урон игроку, когда враг близко:
+{`game.every(0.5, () => {
+ const d = game.distance(enemy.position, game.player.position);
+ if (d < 2) game.player.damage(10);
+});`}
+ game.fx.autoMobFloaters(true).
+ + Лидерборд (таблица очков справа) — объяви стат и + прибавляй: +
+{`game.leaderstats.define('Монеты', { initial: 0 });
+// прибавить текущему игроку:
+game.leaderstats.me.add('Монеты', 1);`}
+ + Сохранение между сессиями (прогресс не теряется после + выхода): +
+{`// записать
+game.save.merge('progress', {
+ patch: { level: 3 }, // обычные поля
+ increment: { coins: 10 }, // атомарно прибавить
+ max: { bestScore: 5000 } // запишется только если больше старого
+});
+
+// прочитать при старте
+game.save.get('progress', (data) => {
+ if (data) {
+ game.ui.showText('С возвращением! Уровень ' + data.level, 3);
+ }
+});`}
+ + Совместное редактирование (Team Create) — это когда + одну игру в студии редактируют несколько человек + одновременно. Ты строишь дом, друг в это же время + ставит деревья — и каждый видит правки другого + вживую, без перезагрузки страницы. +
+Что синхронизируется в реальном времени:
++ Открой свою игру в студии и перейди на вкладку + Игра в верхней панели. Там, в + группе «Вместе», есть кнопка + Пригласить. +
++ Блокировка объекта. Пока один соавтор выделил объект + и двигает его — этот объект заблокирован для других + (никто другой не сможет его двигать одновременно). Так + правки не конфликтуют. Как только выделение снято — объект + снова свободен. +
++ Кто сохраняет. Игру в базу сохраняет автор + (владелец проекта). Приглашённые друзья видят пометку + «Совместное редактирование» вместо кнопок Сохранить и + Опубликовать — это правильно: они помогают строить, а + управляет игрой автор. +
++ Цвета. У каждого соавтора свой цвет — им подсвечены + его курсор и аватарка, чтобы было понятно, кто что делает. +
++ Совет: договоритесь заранее, кто какую часть карты + делает (например, один — здания, другой — ландшафт и + декор) — так работать вместе быстрее и без накладок. +
+ + ), + }, + ], + }, + + // ════════════════════════════════════════════════════ + // РАЗДЕЛ — КОНТЕКСТ ДЛЯ НЕЙРОНКИ (AI) + // ════════════════════════════════════════════════════ + { + id: 'ai-context', + icon: 'lightbulb', + title: 'Контекст для нейронки', + summary: 'Готовый текст со всем API скриптов Рублокса. Скопируй его целиком, вставь в ChatGPT/нейросеть — и она будет писать тебе рабочие скрипты под твою задачу.', + sections: [ + { + id: 'ai-howto', + title: 'AI1. Как писать скрипты с нейросетью', + body: ( + <> ++ Хочешь, чтобы скрипт написала нейросеть (ChatGPT, + DeepSeek, Claude и т.п.)? Проблема в том, что нейросеть не + знает устройство Рублокса — придумает несуществующие + команды. Решение простое: +
++ Выдели весь текст ниже и скопируй (Ctrl+A внутри блока + или мышью), затем вставь в нейросеть перед своим вопросом: +
+{AI_CONTEXT}
+
+ ),
+ },
+ ],
+ },
];
+
+
diff --git a/src/community/docsIcons.jsx b/src/community/docsIcons.jsx
index 5de69c8..f802298 100644
--- a/src/community/docsIcons.jsx
+++ b/src/community/docsIcons.jsx
@@ -21,6 +21,14 @@ const F = { fill: 'currentColor', stroke: 'none' };
const ICONS = {
// ── разделы вики ──────────────────────────────────────────
+ users: () => (
+ <>
+