Skip to content

Latest commit

 

History

History
158 lines (109 loc) · 8.36 KB

File metadata and controls

158 lines (109 loc) · 8.36 KB

English | Русский

CaveDroid

Build Android Build Desktop Build Web Ktlint GitHub Release

CaveDroid — это 2D-игра в стиле Minecraft для Android, Desktop (Windows, Linux, macOS), Web (браузер) и потенциально iOS. Исследуйте, добывайте и стройте в зацикленном мире.

Скриншоты

Скриншот 1 Скриншот 2 Скриншот 3 Скриншот 4 Скриншот 5 Скриншот 6 Скриншот 7


Возможности

  • 2D-мир, зацикленный по горизонтали
  • Крафт, добыча ресурсов и исследование
  • Процедурно-генерируемый мир
  • Кроссплатформенность: Android, Desktop (Windows/Linux/macOS), Web (браузер, через TeaVM), iOS (не тестировалось)
  • Однопользовательский режим (мультиплеер пока не доступен)

Управление

Действие Сенсор / Мобильное Клавиатура / Мышь
Движение влево/вправо Тянуть джойстик на левой половине экрана A / D
Прыжок Нажать на левую часть или кнопку прыжка Пробел (прыжок в воздухе в творческом режиме = полёт)
Движение курсора / прицеливание Тянуть на правой стороне Двигать мышь
Ломать блок Удерживать на правой стороне ЛКМ при наведении на блок
Разместить блок (задний слой) Удерживать справа при наведении на пустую ячейку ПКМ при наведении на пустое место
Активировать / Использовать / Разместить активный блок Нажать справа ПКМ
Атака моба Нажать при наведении на моба ЛКМ
Открыть инвентарь Кнопка сундука E
Инвентарь: взять / переместить Drag-n-drop, нажатие Клик для взять, ПКМ для половины стака или размещения по одному предмету
Инвентарь: переместить один предмет (сенсор) Удерживать предмет одним пальцем + тапнуть по ячейке другим Н/Д

Готовые сборки

Доступно в Google Play
Доступно в RuStore

APK и JAR сборки также можно скачать на странице релизов. Или поиграть прямо в браузере на GitHub Pages.


Инструкции по сборке

Android

./gradlew android:assembleFossDebug

Desktop

./gradlew desktop:dist

В Windows используйте gradlew.bat вместо ./gradlew, но сборка может упасть из-за симлинков для ассетов, потребуется небольшая доработка.

Web (браузер)

CaveDroid компилируется в JavaScript через gdx-teavm. Освещение в веб-сборке использует упрощённый день/ночь tint-шейдер (без точечных источников света от блоков) — в остальном геймплей соответствует desktop-сборке.

# Запуск локально со встроенным dev-сервером Jetty (с source maps, без обфускации)
./gradlew html:runWeb

# Сборка dev-бандла без запуска сервера
./gradlew html:buildJs

# Сборка релизного бандла (обфускация, полная оптимизация)
./gradlew html:buildJsRelease

# Упаковать релизный бандл (build/dist/cavedroid-web-<version>.zip) для статического хостинга
./gradlew html:packageWebDist

Релизный zip можно распаковать на любом статическом веб-хостинге (GitHub Pages, S3, Netlify, …) — серверная часть не требуется.

Старые Android-устройства (API 16/17 — Jelly Bean)

Нестабильные экспериментальные APK для Android 4.1/4.2 публикуются на странице релизов — ищите сборки с меткой legacy (или похожей). Выкладываются «как есть», вне обычного QA.

Настройка keystore для подписывания

Чтобы собрать релиз Android и включить задачу desktop:generateSignedJar, необходим файл keystore.properties в корне проекта.

Создайте файл keystore.properties со следующим содержимым:

# Путь к вашему Java keystore
releaseKeystorePath=/path/to/your/keystore.jks

# Пароль от keystore
releaseKeystorePassword=yourKeystorePassword

# Алиас ключа
releaseKeyAlias=yourKeyAlias

# Пароль для ключа
releaseKeyPassword=yourKeyPassword

Лицензия

Код

CaveDroid распространяется под лицензией MIT. Подробнее см. LICENSE.

Ассеты

  • Текстуры: Pixel Perfection от XSSheep, лицензия CC BY-SA 4.0
  • Экранный джойстик: CC-0 с OpenGameArt.org
  • Шрифт: LanaPixel от eishiya, лицензия CC BY 4.0
  • Скрипты: Разные скрипты с Stack Overflow, распространяются под соответствующими лицензиями

Лицензированные ассеты содержат файл attribution.txt с нужными упоминаниями.


Вклад в проект

Мы приветствуем вклад в проект! Пожалуйста, создавайте issues или pull requests для предложений, исправлений ошибок или улучшений.