Files
naddie-jump/AGENTS.md

3.2 KiB
Raw Blame History

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         # Экран поражения

Команды разработки

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/ при сборке.