Grasscutter/README_ru-RU.md

EN | 简中 | 繁中 | FR | HE | RU | PL | ID | KR | FIL/PH | NL | JP

Внимание: Мы всегда рады новому вкладу в проект. Однако, перед тем, как сделать свой вклад, пожалуйста, прочтите наш кодекс делового поведения.

Реализованные функции

• Авторизация
• Система боя
• Список друзей
• Телепортация
• Гача-система
• Кооп работает частично
• Спавн монстров через консоль
• Функции инвентаря (получение предметов/персонажей, улучшение предметов/персонажей, и т.п.)

Краткое руководство по установке

Заметка: Если вам требуется помощь, присоединитесь к нашему серверу Discord (На Английском).

Зависимости

• Java SE - 17 (link)

  Заметка: Для того, чтобы просто запустить сервер, достаточно только jre.

• MongoDB (рекомендуются версии 4.0+)

• Прокси: mitmdump (рекомендуется), mitmproxy, Fiddler Classic и т.п.

Запуск

Заметка: Для обновления с более старой версии, удалите файл config.json, чтобы сгенерировать его заново.

1. Получите файл grasscutter.jar одним из следующих способов:
   • Скачайте напрямую со вкладки Actions
   • Соберите самостоятельно
2. Создайте папку resources в той же директории, что и grasscutter.jar, и переместите туда свои папки BinOutput и ExcelBinOutput (Посетите вики для получения более подробной информации о том, где их найти.)
3. Запустите Grasscutter с помощью команды java -jar grasscutter.jar. Убедитесь, что в этот момент запущен сервер mongodb.

Соединение с клиентом

½. Создайте аккаунт, введя соответствующую команду в консоли сервера.

1. Перенаправьте трафик: (воспользуйтесь одиним из способов)

   • mitmdump: mitmdump -s proxy.py -k

     Доверьтесь сертификату CA:

     ​ Заметка: Обычно, сертификат CA хранится в папке %USERPROFILE%\ .mitmproxy. Также, вы можете скачать его с http://mitm.it

     ​ Дважды нажмите для установки, или же ...

     • С помощью командной строки

       certutil -addstore root %USERPROFILE%\.mitmproxy\mitmproxy-ca-cert.cer
       

   • Fiddler Classic: Запустите Fiddler Classic, включите настройку Decrypt https traffic в опциях и измените порт по умолчанию (Меню -> Tools -> Options -> Connections) на что-то не равное 8888, после чего запустите этот скрипт во вкладке FiddlerSrcipt.

   • Файл hosts

2. Установите прокси сети в 127.0.0.1:8080, либо в тот порт прокси, который вы задали.

Также, вы можете использовать start.cmd для автоматического запуска прокси и серверов, но для этого необходимо задать переменную среды JAVA_HOME

Сборка

Для сборки и решения проблем с зависимостями, Grasscutter использует Gradle.

Требуется:

• Java SE Development Kits - 17
• Git

Windows

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
.\gradlew.bat # Setting up environments
.\gradlew jar # Compile

Linux

git clone https://github.com/Grasscutters/Grasscutter.git
cd Grasscutter
chmod +x gradlew
./gradlew jar # Compile

Получившийся файл .jar можно найти в корневой папке проекта.

Команды были перемещены на вики!

Краткое руководство по решению проблем

• Если скомпилировать не удается, то проверьте установку своего JDK (JDK 17 и валидность переменных JDK, bin, PATH)
• Клиент не подключается, не входит, выдаёт ошибку 4206 и т.д. - Скорее всего, проблема в том, как именно вы настроили прокси. При использовании Fiddler убедитесь, что он запущен на любом порте, кроме 8888
• Порядок запуска: MongoDB > Grasscutter > Прокси (mitmdump, fiddler и т.д.) > Игра