Merge pull request #1364 from AlmasB/dev

Release 21.1

.LICENSE_3RD_PARTY/README.md

@@ -0,0 +1,6 @@
+### 3rd-party Licenses
+
+This file lists major codebases from which some of the code in this project originated. You may wish to inspect each file to trace its origin and authors. Please contact the project maintainer to inform of a missing license or header, so they can be restored as appropriate.
+
+- The code from jbox2d is used under the BSD 2-clause "Simplified" License (see [LICENSE](jbox2d-LICENSE))
+- The code from libGDX is used under Apache 2.0 (see [LICENSE](libGDX-LICENSE)).

README.md

@@ -6,6 +6,8 @@
 
   [简体中文](https://github.com/AlmasB/FXGL/blob/dev/README_CN.md)
 
+  [Русский](https://github.com/AlmasB/FXGL/blob/dev/README_RU.md)
+
 ## About
 
 <img src="https://raw.githubusercontent.com/AlmasB/git-server/master/storage/images/fxgl_logo.png" width="128" />
@@ -77,7 +79,7 @@ Otherwise, see:
 <dependency>
     <groupId>com.github.almasb</groupId>
     <artifactId>fxgl</artifactId>
-    <version>21</version>
+    <version>21.1</version>
 </dependency>
 ```
 
@@ -93,7 +95,7 @@ repositories {
 }
 
 dependencies {
-    compile 'com.github.almasb:fxgl:21'
+    compile 'com.github.almasb:fxgl:21.1'
 }
 ```
 
@@ -124,7 +126,7 @@ Download the latest uber jar from [Releases](https://github.com/AlmasB/FXGL/rele
 * FHNW School of Engineering / Computer Science, Switzerland
 * Johann-Andreas-Schmeller-Gymnasium Nabburg, Germany
 
-If your institution wants to use or is using FXGL, add a note in the [Chat](https://gitter.im/AlmasB/FXGL) to be added to the list.
+If your institution wants to use or is using FXGL, add a note via [GitHub Discussions](https://github.com/AlmasB/FXGL/discussions) to be added to the list.
 
 Community tutorials:
 
@@ -138,7 +140,7 @@ Community projects (identified using `fxgl` topic):
 - [Consume](https://ergoscrit.itch.io/consume)
 - [FXGL Sliding Puzzle](https://github.com/beryx/fxgl-sliding-puzzle)
 
-If you'd like your project featured here, just add a note in the [Chat](https://gitter.im/AlmasB/FXGL).
+If you'd like your project featured here, just add a note via [GitHub Discussions](https://github.com/AlmasB/FXGL/discussions).
 
 ### Development Team
 

README_CN.md

@@ -6,6 +6,8 @@
 
   简体中文
 
+  [Русский](https://github.com/AlmasB/FXGL/blob/dev/README_RU.md)
+
 ## 关于
 
 <img src="https://raw.githubusercontent.com/AlmasB/git-server/master/storage/images/fxgl_logo.png" width="128" />
@@ -72,7 +74,7 @@ public class BasicGameApp extends GameApplication {
 <dependency>
     <groupId>com.github.almasb</groupId>
     <artifactId>fxgl</artifactId>
-    <version>21</version>
+    <version>21.1</version>
 </dependency>
 ```
 
@@ -88,7 +90,7 @@ repositories {
 }
 
 dependencies {
-    compile 'com.github.almasb:fxgl:21'
+    compile 'com.github.almasb:fxgl:21.1'
 }
 ```
 
@@ -118,7 +120,7 @@ open module app.name {
 - 巴西南里奥格兰德联邦教育、科学和技术学院
 - 瑞士西北高等专业学院 工程/计算机科学学院
 
-如果您的机构想要使用或正在使用 FXGL，请在[Chat](https://gitter.im/AlmasB/FXGL)中添加注释以添加到列表中。
+如果您的机构想要使用或正在使用 FXGL，请在[Discussions](https://github.com/AlmasB/FXGL/discussions)中添加注释以添加到列表中。
 
 社区教程：
 
@@ -132,7 +134,7 @@ open module app.name {
 - [消耗](https://ergoscrit.itch.io/consume)
 - [FXGL 滑动拼图](https://github.com/beryx/fxgl-sliding-puzzle)
 
-如果您希望在此处展示您的项目，只需在[Chat](https://gitter.im/AlmasB/FXGL)中添加注释即可。
+如果您希望在此处展示您的项目，只需在[Discussions](https://github.com/AlmasB/FXGL/discussions)中添加注释即可。
 
 ### 开发团队
 

README_RU.md

@@ -0,0 +1,192 @@
+![promo](https://raw.githubusercontent.com/AlmasB/git-server/master/storage/images/fxgl_promo.jpg)
+
+## Языки
+
+  [English](https://github.com/AlmasB/FXGL/blob/dev/README.md)
+
+  [简体中文](https://github.com/AlmasB/FXGL/blob/dev/README_CN.md)
+
+  Русский
+
+## О фреймворке
+
+<img src="https://raw.githubusercontent.com/AlmasB/git-server/master/storage/images/fxgl_logo.png" width="128" />
+
+Фреймворк для разработки игр на основе JavaFX
+
+[![Maven Central](https://img.shields.io/maven-central/v/com.github.almasb/fxgl.svg)]()
+[![Build Status](https://github.com/AlmasB/FXGL/workflows/Java%20CI%20with%20Maven/badge.svg)](https://github.com/AlmasB/FXGL/actions)
+[![codecov](https://codecov.io/gh/AlmasB/FXGL/branch/dev/graph/badge.svg)](https://codecov.io/gh/AlmasB/FXGL)
+[![sponsor](https://img.shields.io/badge/sponsor-%241-brightgreen)](https://github.com/sponsors/AlmasB)
+[![JFXCentral](https://img.shields.io/badge/Find_me_on-JFXCentral-blue?logo=googlechrome&logoColor=white)](https://www.jfx-central.com/libraries/fxgl)
+
+### Почему FXGL?
+
+* Не требуется установка или настройка
+* "Из коробки": Java 8-21, Win/Mac/Linux/Android 8+/iOS 11.0+/Web
+* Простой и чистый API, более высокого уровня по сравнению с другими движками
+* Расширение JavaFX: нет необходимости изучать новый API пользовательского интерфейса
+* Реальные методы разработки игр: Entity-Component, интерполированная анимация, частицы и [многое другое](https://github.com/AlmasB/FXGL/wiki/Core-Features)
+* Игры легко упаковываются в один исполняемый файл .jar или нативные образы
+
+### Хорошо подходит для:
+
+* Любой 2D игры (сайд-скроллер/платформер/аркада/РПГ)
+* Любого бизнес-приложения со сложными элементами управления/анимацией пользовательского интерфейса
+* Экспериментального 3D
+* Хобби/академических/коммерческих проектов
+* Преподавания/обучения/совершенствования навыков разработки игр
+* Быстрого прототипирования идей приложений
+
+### Пример кода
+
+```java
+public class BasicGameApp extends GameApplication {
+
+    @Override
+    protected void initSettings(GameSettings settings) {
+        settings.setWidth(800);
+        settings.setHeight(600);
+        settings.setTitle("Basic Game App");
+    }
+
+    public static void main(String[] args) {
+        launch(args);
+    }
+}
+```
+
+## Начало работы
+
+Для быстрого погружения в код, ознакомьтесь с [базовыми примерами](https://github.com/AlmasB/FXGL/tree/dev/fxgl-samples/src/main/java/basics).
+
+Или смотрите:
+
+* [Книга по FXGL](https://link.springer.com/book/10.1007/978-1-4842-8625-8?sap-outbound-id=3352BB472E8E602B4B29844F1A86CCC4374DDF6E)
+* [Видеообзор возможностей](https://youtu.be/fuDQg7W0v4g)
+* [Использование FXGL с IntelliJ](https://youtu.be/LhmlFC6KE2Q)
+* [Вики и написанные руководства](https://github.com/AlmasB/FXGL/wiki)
+* [Руководства на YouTube](https://www.youtube.com/playlist?list=PL4h6ypqTi3RTiTuAQFKE6xwflnPKyFuPp)
+* [Демонстрационный код](fxgl-samples)
+* [Игры на FXGL](https://github.com/AlmasB/FXGLGames) (с исходным кодом)
+* [Опубликованные демо](https://fxgl.itch.io/) на itch.io
+
+### Maven
+
+* Шаблон проекта [Maven](https://github.com/AlmasB/FXGL-MavenGradle), если вы используете Java и/или Kotlin
+
+```xml
+<dependency>
+    <groupId>com.github.almasb</groupId>
+    <artifactId>fxgl</artifactId>
+    <version>21.1</version>
+</dependency>
+```
+
+### Gradle
+
+* Шаблон проекта [Gradle](https://github.com/AlmasB/FXGL-MavenGradle), если вы используете Java и/или Kotlin
+
+Пожалуйста, обратитесь к шаблону в случае возникновения ошибок.
+
+```gradle
+repositories {
+    jcenter()
+}
+
+dependencies {
+    compile 'com.github.almasb:fxgl:21.1'
+}
+```
+
+### Modularity
+
+Если вы хотите разработать модульное приложение, вот полный пример вашего `module-info.java`:
+
+```java
+open module app.name {
+    requires com.almasb.fxgl.all;
+}
+```
+
+### Uber jar
+
+Скачайте последний uber jar из раздела [Релизы](https://github.com/AlmasB/FXGL/releases)
+
+## Сообщество
+
+* Университет Брайтона, Великобритания
+* Университет Ноттингема, Великобритания
+* Технологический институт Джорджии, США
+* kidOYO, США
+* Средняя школа Уолтона, США
+* Средняя школа Конанта, США
+* Институт бизнеса и технологий Зеландии, Дания
+* Федеральный институт образования, науки и технологий Рио-Гранде-ду-Сул, Бразилия
+* Школа инженерии / информатики FHNW, Швейцария
+* Гимназия Иоганна-Андреаса-Шмеллера, Наббург, Германия
+
+Если ваше учебное заведение хочет использовать FXGL или уже использует его, оставьте заметку в [чате](https://github.com/AlmasB/FXGL/discussions), чтобы мы могли внести его в список.
+
+Руководства сообщества:
+
+- [Space Ranger](https://www.journaldev.com/40219/space-rangers-game-java-fxgl) на journaldev
+- [Geometry Wars](https://webtechie.be/post/2020-05-07-getting-started-with-fxgl/) на webtechie
+- [Mazela-Man](https://dykstrom.github.io/mazela-man-web/home/) от dykstrom
+
+Проекты сообщества (помеченные тегом `fxgl`): 
+
+- [SOFTKNK.IO](https://github.com/softknk/softknk.io)
+- [Consume](https://ergoscrit.itch.io/consume)
+- [FXGL Sliding Puzzle](https://github.com/beryx/fxgl-sliding-puzzle)
+
+Если вы хотите, чтобы ваш проект был представлен здесь, просто добавьте заметку в [чате](https://github.com/AlmasB/FXGL/discussions).
+
+### Команда разработчиков
+
+Описание ролей представлено в [Руководстве по внесению вклада](CONTRIBUTING.md).
+
+Поддерживающие (Соавторы):
+
+* [Almas Baimagambetov](https://github.com/AlmasB)
+
+Координаторы:
+
+* [Chengen Zhao](https://github.com/chengenzhao)
+
+Тестировщики:
+
+* [Carl Dea](https://github.com/carldea)
+* [Frank Delporte](https://github.com/FDelporte)
+
+### Внесение вклада и поддержка
+
+Если вы хотите собрать FXGL из исходного кода или внести свой вклад,
+пожалуйста, ознакомьтесь с [Руководством по внесению вклада](CONTRIBUTING.md) (включая не-кодовые аспекты).
+FXGL полностью модульный, поэтому новым участникам не обязательно понимать весь код, только тот модуль, в которой делается вклад.
+Внесенные изменения будут рассмотрены в соответствии с [Кодексом поведения](CODE_OF_CONDUCT.md).
+
+Вы можете поддержать разработку FXGL или показать интерес, просто добавив репозиторий в избранное или став [спонсором](https://github.com/sponsors/AlmasB).
+
+### Спонсоры
+
+Пользователи:
+
+* @Marsl10
+* @SergeMerzliakov
+* @mbains
+* @sabit86
+* @hendrikebbers
+* @ImperaEtConquer
+* @thejeed
+* @chikega
+
+Компании:
+
+* @karakun
+
+### Обратная связь
+
+* Задавайте вопросы через [Обсуждения GitHub](https://github.com/AlmasB/FXGL/discussions) 
+* Задавайте вопросы на [StackOverflow](https://stackoverflow.com/search?q=fxgl) с тегами `javafx` и `fxgl`
+* Пишите твит с хештегом [#fxgl](https://twitter.com/search?src=typd&q=%23fxgl)