diff --git a/src/community/docsGames.js b/src/community/docsGames.js index 40a4d65..1923434 100644 --- a/src/community/docsGames.js +++ b/src/community/docsGames.js @@ -368,4 +368,9 @@ export const GAMES = [ desc: 'Шутер: волны зомби бегут к игроку, бластер их отстреливает, над целью всплывают облачка урона. Авто-floater над любым мобом одной строкой + ручной game.fx.damageFloater (крит/хил/мана/промах/стек/комикс).', mechanics: ['game.fx.damageFloater(pos, value, opts)', 'game.fx.autoMobFloaters(true) — облачко над NPC при уроне', 'game.player.giveTool(\'blaster-...\') — бластер', 'бластер от 3-го лица — в точку клика', 'spawnNpc + follow(\'player\') — зомби-волны', 'isCrit/isHeal/isMana/isMiss, стек ×N, комикс', 'object pool 30 планов (без лагов)'], previewShot: 'guide-floaters-scene.png', openProjectId: 2676, ready: true }, + { id: 'guide-inventory', num: 65, group: 'g5', stars: 2, icon: 'box', + title: 'Сбор и сортировка — инвентарь с drag-drop', + desc: 'Полный инвентарь как в Minecraft/RPG: сетка 8×5 + хотбар 9, стаки, 5 редкостей (цвет рамки), перетаскивание мышью, ПКМ-меню, tooltip, сортировка. Собираешь предметы — стаки растут.', + mechanics: ['game.items.define([...]) — предметы (редкость/стак/иконка)', 'game.inventory.give / take', 'окно по I — сетка 8×5 + хотбар 9 (1-9)', 'drag-drop между слотами (swap + merge)', 'стаки с maxStack, 5 редкостей', 'ПКМ-меню: использовать / разделить / выбросить', 'tooltip + сортировка по редкости'], + previewShot: 'guide-inventory-scene.png', openProjectId: 2685, ready: true }, ]; diff --git a/src/community/docsLessons.jsx b/src/community/docsLessons.jsx index 9aa1c79..a4c85a8 100644 --- a/src/community/docsLessons.jsx +++ b/src/community/docsLessons.jsx @@ -8867,6 +8867,89 @@ game.fx.damageFloater(pos, 120, { comicStyle: true });`} ), }, + 'guide-inventory': { + body: ( + <> +

Что получится

+

+ Полноценный инвентарь как в Minecraft и RPG: сетка 8×5 + + хотбар на 9 слотов, предметы со стаками и + редкостями, перетаскивание мышью, ПКМ-меню, всплывающие + подсказки. Собираешь предметы на поляне — стаки растут, открываешь + инвентарь клавишей I и раскладываешь добычу. +

+ + + +

Шаг 1. Определи предметы

+

+ Каждый предмет описывается один раз: имя, иконка-эмодзи, редкость, + размер стака, эффект использования. +

+ + {`game.items.define([ + { id:'berry', name:'Ягоды', emoji:'🍓', rarity:'common', maxStack:16, value:2 }, + { id:'iron', name:'Руда', emoji:'⛏️', rarity:'uncommon', maxStack:16, value:8 }, + { id:'potion', name:'Зелье', emoji:'🧪', rarity:'rare', maxStack:8, onUseEffect:'heal:50' }, + { id:'sword', name:'Меч', emoji:'⚔️', rarity:'legendary', maxStack:1, value:500 }, +]);`} +

+ Редкости: common (серый), uncommon + (зелёный), rare (голубой), epic + (фиолетовый), legendary (золотой) — это цвет рамки слота. +

+ +

Шаг 2. Выдавай и собирай предметы

+ {`game.inventory.give('sword', 1); // в стартовый набор +game.inventory.give('berry', 5); // стак до maxStack, дальше — новый слот + +// сбор предмета с земли (на объекте-ягоде): +game.self.onInteract(() => { + game.inventory.give('berry', 2); + game.self.delete(); // убрать собранный предмет +}, { text:'Собрать', key:'e', distance:3 });`} +

+ Собранное попадает сначала в хотбар (виден внизу экрана), + одинаковые предметы складываются в стак с учётом maxStack. +

+ + + +

Шаг 3. Окно инвентаря

+
    +
  • I — открыть/закрыть окно (Esc тоже закрывает);
  • +
  • Перетаскивание мышью — поменять слоты местами или + слить стаки;
  • +
  • ПКМ по слоту — меню: использовать / разделить / выбросить;
  • +
  • Наведение — tooltip (название цветом редкости, описание, цена);
  • +
  • Сорт. — расставить по редкости;
  • +
  • 1-9 — выбрать активный слот хотбара.
  • +
+ + + Всё хранится в движке и сериализуется в проект автоматически — + дописывать сохранение не нужно. Предметы с тегом + 'quest' нельзя выбросить. + + +

Почему это важно

+

+ Инвентарь — несущая конструкция RPG, выживания и симуляторов. + Сетка + хотбар + стаки + редкости — стандарт, который игроки + узнают мгновенно. Сочетается с крафтом, квестами и магазином. +

+ + + Добавь предмет 'apple' с + onUseEffect:'heal:15', положи в хотбар и нажми ПКМ → + «Использовать» — HP восстановится, яблоко убавится на 1. + + + ), + }, + }; /** Есть ли готовый текст урока для игры с таким id. */