- Expand .gitignore with secret/IDE/log patterns - Add .vercelignore to keep dev artifacts out of future deploys - Remove test-game.py, test-screenshots/, preview_*.png, rocket_preview.png - Update AGENTS.md remote (stale GitHub link -> Gitea)
3.3 KiB
3.3 KiB
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://гитея.рф/git/AnRil/naddie-jump.git(Gitea, не GitHub) - Ветка по умолчанию:
main - Репозиторий
.git/находится в корне проектаnaddie-jump/
Зависимости
phaser— игровой движокvite— сборщик (devDependency)typescript— типизация (devDependency)
Ассеты
Статические ресурсы (спрайты, звуки) хранятся в public/assets/ и копируются в dist/ при сборке.