Initial commit: Naddie Jump — Monad Edition

This commit is contained in:
2026-05-23 15:33:42 +07:00
commit 7439f8f267
57 changed files with 2765 additions and 0 deletions

65
AGENTS.md Normal file
View File

@@ -0,0 +1,65 @@
# 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/` при сборке.