66 lines
3.2 KiB
Markdown
66 lines
3.2 KiB
Markdown
# Naddie Jump — Agent Notes
|
||
|
||
## Описание проекта
|
||
Игра на Phaser 3 (Vite-сборка), жанр "прыгалка" (doodle-jump style). Текущее издание — Monad Edition.
|
||
|
||
## Технологический стек
|
||
- **Framework:** Vite 8.x
|
||
- **Game Engine:** Phaser 3.70.0
|
||
- **Language:** TypeScript / JavaScript (ES Modules)
|
||
- **Deploy target:** Vercel (Static + Vite preset)
|
||
|
||
## Структура `src/`
|
||
```
|
||
src/
|
||
├── main.js # Точка входа
|
||
├── config/game.config.js # Глобальные настройки игры
|
||
├── entities/
|
||
│ ├── Player.js # Игрок
|
||
│ ├── Enemy.js # Враги
|
||
│ ├── Platform.js # Платформы
|
||
│ ├── PropellerHat.js # Апгрейд: пропеллер
|
||
│ ├── Rocket.js # Апгрейд: ракета
|
||
│ └── Spring.js # Апгрейд: пружина
|
||
├── managers/
|
||
│ ├── BlockchainManager.js # Web3/блокчейн интеграция
|
||
│ ├── PlatformManager.js # Генерация и управление платформами
|
||
│ └── ScoreManager.js # Учёт очков
|
||
└── scenes/
|
||
├── BootScene.js # Загрузка ассетов
|
||
├── MenuScene.js # Главное меню
|
||
├── GameScene.js # Основной игровой процесс
|
||
└── GameOverScene.js # Экран поражения
|
||
```
|
||
|
||
## Команды разработки
|
||
```bash
|
||
npm install # установка зависимостей
|
||
npm run dev # локальный dev-сервер
|
||
npm run build # production-сборка (output: dist/)
|
||
npm run preview # превью production-сборки локально
|
||
```
|
||
|
||
## Деплой на Vercel
|
||
- **Проект в Vercel:** `anrils-projects/naddie-jump`
|
||
- **Production URL:** https://naddie-jump.vercel.app
|
||
- **Конфигурация:** `vercel.json` (framework: vite, outputDirectory: dist)
|
||
- **Привязка CLI:** `.vercel/project.json` создан, `.vercel/` добавлен в `.gitignore`
|
||
|
||
### ⛔ ВАЖНОЕ ПРАВИЛО — ДЕПЛОЙ
|
||
- **Текущая версия на Vercel — это prod-альфа.** Она остаётся как есть.
|
||
- **Вся дальнейшая разработка ведётся ТОЛЬКО локально.**
|
||
- **Деплоить новую версию на Vercel можно ТОЛЬКО по явной команде пользователя.**
|
||
- Не деплоить самостоятельно, даже если есть токен/доступ.
|
||
|
||
## Git
|
||
- **Remote:** `https://github.com/anril44/sender2.git`
|
||
- Репозиторий `.git/` находится в корне проекта `naddie-jump/`
|
||
|
||
## Зависимости
|
||
- `phaser` — игровой движок
|
||
- `vite` — сборщик (devDependency)
|
||
- `typescript` — типизация (devDependency)
|
||
|
||
## Ассеты
|
||
Статические ресурсы (спрайты, звуки) хранятся в `public/assets/` и копируются в `dist/` при сборке.
|