Skip to content

Commit e89e165

Browse files
committed
add 1.6.0 content
1 parent 83b8fd8 commit e89e165

File tree

4 files changed

+174
-104
lines changed

4 files changed

+174
-104
lines changed
Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,78 @@
1+
---
2+
title: FastJ 1.6.0 Release
3+
author: Andrew Dey
4+
author_title: Creator of the FastJ Game Engine
5+
author_url: https://github.com/lucasstarsz
6+
author_image_url: https://github.com/lucasstarsz.png
7+
keywords: ["fastj", "java game engine", "fastj game engine", "fastj 1.6.0", "fastj game engine 1.6.0", "java game engine 2022", "can java be used for making games", "free java game engine", "free game engine", "game engine 2022", "kotlin game engine", "is kotlin good for making games", "kotlin game engine 2022", "groovy game engine", "groovy game engine 2022", "is groovy good for making games", "2d game engine", "java2d game engine", "java 2d game engine", "kotlin 2d game engine", "fastj 2d game engine", "groovy 2d game engine", "how to make games", "how to make game tutorial", "game making tutorial"]
8+
tags: [fastj, release, fastj-1.6.0]
9+
description: "FastJ 1.6.0 has been released, with 269 new commits since FastJ 1.5.1. This version of FastJ contains bug fixes, new features, new examples, and more! Read on to find out what's happening."
10+
image: /img/fastj/fastj_icon_wired.png
11+
hide_table_of_contents: false
12+
---
13+
14+
FastJ 1.6.0 has been released, with 80 new commits since FastJ [1.5.1][FastJ-Version-1.5.1-Release-Link]. This version of FastJ contains bug fixes, new features, new examples, and more! Read on to find out what's new.
15+
16+
17+
[FastJ-Version-1.5.1-Release-Link]: /news/2022/02/17/fastj-1-5-1-release "FastJ 1.5.1 Release"
18+
19+
<!--truncate-->
20+
21+
22+
23+
The beginnings of ideas for the next iteration of FastJ, enter 1.6.0! With almost 270 commits since 1.5.1, FastJ has been able to grow substantially! Thanks to all of our contributors this time around! ❤️
24+
25+
26+
## Examples have Moved!
27+
Examples are now visible from the root directory of the FastJ project -- the `examples` folder! [Check them out](https://github.com/fastjengine/FastJ/tree/main/examples).
28+
29+
30+
## Plans for the Future
31+
Based on the direction I'm seeing the engine's current code architecture (or lack thereof) head, it's time we hunker down and completely redesign FastJ. As a result of this and lack of time, unfortunately not much effort can be put into 1.6.0's release and information surrounding it.
32+
33+
**We're planning to rebuild FastJ from the ground up**. We would love _your_ help in bringing FastJ into a modern development setup. [Join the Discord Server](https://discord.gg/d6pneNjMaV) and help us decide the architecture and features to be brought with us into the next version of FastJ. We're doing this _right now_ (as of February 17, 2022). Bring your experience, your opinions, your ideas for the future.
34+
35+
Thank you for your time.
36+
37+
38+
## What's Changed
39+
* (#104) add X11 to list of supported hardware accelerations by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/105
40+
* Remove Translation from setMetrics by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/107
41+
* Images, Sprites, Animations, and a whole lot more by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/117
42+
* Update README for update on Animation Support. by @Sammie156 in https://github.com/fastjengine/FastJ/pull/118
43+
* [Documentation] Added package-info documentation for (most) packages by @YeffyCodeGit in https://github.com/fastjengine/FastJ/pull/112
44+
* Add set(int) method for both Point classes. by @Sammie156 in https://github.com/fastjengine/FastJ/pull/121
45+
* Update feature request issue template by @YeffyCodeGit in https://github.com/fastjengine/FastJ/pull/126
46+
* Logging Implementation for FastJ with SLF4J(Simple Logging Facade for Java) by @Sammie156 in https://github.com/fastjengine/FastJ/pull/125
47+
* Add logging (SLF4J), add engine configuration, change examples module into subproject by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/127
48+
* revamped display system by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/124
49+
* updated image support status, latest FastJ version by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/135
50+
* fixed package definitions, updated main module description by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/134
51+
* fixed display resizing by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/136
52+
* updated display event logging with formatting, migrated to debug/trace by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/137
53+
* Fix sprite2d constructor by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/140
54+
* Add dependabot to repo by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/144
55+
* Bump org.sonarqube from 3.1.1 to 3.3 by @dependabot in https://github.com/fastjengine/FastJ/pull/145
56+
* Update dialog config by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/152
57+
* updated readme project template links by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/151
58+
* Fix audio example, finish implementing logging example by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/150
59+
* Add Spotless code formatter by @YeffyCodeGit in https://github.com/fastjengine/FastJ/pull/153
60+
* Add ObjUtil and MtlUtil unit tests by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/154
61+
* add/subtract/multiply/divide overloads, origin vectors, unit vectors, and direction vector functions by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/155
62+
* remove redundant BasicStroke equals option by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/156
63+
* Patch headless errors by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/157
64+
* add distance formula to Point/Pointf by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/158
65+
* (resolves #159) move static imports in Spotless to the bottom of the list by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/160
66+
* Improved mouse events, unified input events by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/161
67+
* (#162, #163) bump slf4j and junit dependencies to latest versions by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/164
68+
* Update uses of logger to use formatted strings by @YeffyCodeGit in https://github.com/fastjengine/FastJ/pull/169
69+
* Update Project for 1.6.0 by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/171
70+
* 1.6.0 by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/128
71+
* Update contributing guidelines by @lucasstarsz in https://github.com/fastjengine/FastJ/pull/173
72+
* add addScenes function by @YeffyCodeGit in https://github.com/fastjengine/FastJ/pull/179
73+
74+
## New Contributors
75+
76+
* @dependabot made their first contribution in https://github.com/fastjengine/FastJ/pull/145
77+
78+
**Full Changelog**: https://github.com/fastjengine/FastJ/compare/1.5.1...1.6.0

wiki/intro.md

Lines changed: 70 additions & 66 deletions
Original file line numberDiff line numberDiff line change
@@ -24,8 +24,8 @@ title: Intro
2424
FastJ is an open-source, Java-based 2D game engine and framework. Originally named the FastJ Engine, it aims to provide an easy-to-use, 2D game-making library.
2525

2626

27-
## Disclaimer
28-
**This project is still under heavy development.** There is a very good chance bugs are still prevalent and untracked, as the engine is not fully covered by unit tests. Documentation is readily available, but may change over time. [If you would like to help out, all help is appreciated!](#contributing-to-fastj)
27+
### Disclaimer
28+
**This project is still under heavy development.** There is a very good chance bugs are still prevalent and untracked, as the engine is not fully covered by unit tests. Documentation is readily available, but may change over time. [Feel free to help us out by contributing to the project!](#contributing-to-fastj)
2929

3030

3131
## Projected Feature List
@@ -37,10 +37,13 @@ FastJ is an open-source, Java-based 2D game engine and framework. Originally nam
3737
| Scriptable Behaviors | Control GameObject state ||
3838
| Desktop Support | Full Compatibility on Windows, Linux, and macOS ||
3939
| Audio Engine | Loading, Playing, and Controlling .wav, .au, .aiff files ||
40-
| Image Support | Image rendering, Sprite Animation | |
41-
| Animation Support | Interpolation, Tweening Framework | |
40+
| Image Support | Image rendering, Sprite Animation | |
41+
| Animation Support | Interpolation, Tweening Framework | |
4242
| UI System | Flexible UI System to replace Swing UI ||
43-
| FastJ Model Creator | Create & Export 2D Models ||
43+
| Particle Engine | Configurable and Customizable Particle Management ||
44+
| Physics Engine | Custom 2D Physics Engine. ||
45+
| Asset Manager | Load, Unload, and Hot Reload Game Assets ||
46+
| FastJ Model Creator | Create & Export 2D Models ||
4447
| FastJ Editor | View, Run, Build, and Export FastJ programs from an editor ||
4548
| Web Support | Run FastJ Programs in a Web Browser ||
4649

@@ -53,19 +56,48 @@ FastJ is an open-source, Java-based 2D game engine and framework. Originally nam
5356
❌ is not yet implemented.
5457

5558

56-
## Adding FastJ to a Project
59+
## Get Started
60+
There are many different ways to learn FastJ -- check them out!
61+
62+
63+
### Template Projects
64+
Use a template project! It's the fastest way to jump into using FastJ.
65+
66+
Choose a programming language from the ones below. We suggest Java, as it has the most support:
67+
- Java: https://github.com/fastjengine/fastj-java-template
68+
69+
However, Kotlin and Groovy are reasonable options as well:
70+
- Kotlin: https://github.com/fastjengine/fastj-kotlin-template
71+
- Groovy: https://github.com/fastjengine/fastj-groovy-template
72+
73+
74+
### Tutorials
75+
[FastJ provides article tutorials on its website][FastJ-Tutorials] to accommodate as many types of developers as possible. From beginners to experts, the website tutorials are written to give enough information to satisfy anyone willing to learn!
76+
77+
78+
### Code Examples
79+
[Explore FastJ's code examples][FastJ-Examples] to see the different ways FastJ can be used, and all of its features. These come with in-example explanations and easy plug-and-playability to give you the best chance at understanding how FastJ works.
80+
81+
82+
### API Documentation
83+
[Check out FastJ's documentation][Javadoc] to get a better understanding of the code FastJ provides to improve your game-making experience.
84+
85+
86+
### I'll add the dependency myself!
87+
Ok, ok, I hear ya. Just follow through with these instructions below.
88+
89+
90+
#### Dependency Management
5791
This library can be found in the following places:
5892
- [jitpack.io][Jitpack.IO], as a dependency.
5993
- [Maven Central][Maven-Central], as a dependency or as a jarfile.
6094
- The [Releases][Releases] section of this repository.
6195

62-
63-
### Adding the Dependency
64-
When adding the dependency, **make sure to replace `[latest version here]` with the actual version** (you'll find this in the jitpack.io or Maven Central link up above). **The current latest version is 1.5.1**.
96+
When adding the dependency, **make sure to replace `[latest version here]` with the actual version** (you'll find this in the jitpack.io or Maven Central link up above). **The current latest version is 1.6.0**.
6597

6698
A few common dependencies are provided below:
6799

68-
- **Gradle**
100+
- **Gradle Build Script**
69101
- Groovy:
70102
```groovy
71103
repositories.maven {
@@ -82,7 +114,7 @@ A few common dependencies are provided below:
82114
83115
dependencies.implementation("com.github.fastjengine:FastJ:[latest version here]")
84116
```
85-
- **Maven**
117+
- **Maven POM**
86118
```xml
87119
<repository>
88120
<id>jitpack.io</id>
@@ -96,53 +128,41 @@ A few common dependencies are provided below:
96128
</dependency>
97129
```
98130

131+
You'll also want to make sure you add a dependency for a logging framework from [SLF4J][SLF4J], since FastJ uses it for all its logging purposes. Take your pick!
99132

100-
## Learning FastJ
101-
There are many different ways to learn FastJ -- namely the API documentation, the examples, and the tutorials on the main website.
102-
103-
104-
### Template Projects
105-
Check out these template projects for FastJ! They're the fastest way to jump right into using FastJ.
106-
107-
- Java: https://github.com/lucasstarsz/fastj-java-template
108-
- Kotlin: https://github.com/lucasstarsz/fastj-kotlin-template
109-
- Groovy: https://github.com/lucasstarsz/fastj-groovy-template
110133

134+
#### Hello World Code (Java)
111135

112-
### Tutorials
113-
[FastJ provides article tutorials][FastJ-Tutorials] on its website to accommodate as many types of developers as possible. From beginners to experts, the website tutorials are written to give enough information to satisfy anyone willing to learn!
136+
```java
137+
import tech.fastj.engine.FastJEngine;
138+
import tech.fastj.graphics.display.FastJCanvas;
139+
import tech.fastj.systems.control.SimpleManager;
114140

141+
public class HelloFastJ extends SimpleManager {
115142

116-
### Code Examples
117-
[Explore FastJ's code examples][FastJ-Examples] to see the different ways FastJ can be used, and all of its features. These come with in-example explanations and easy plug-and-playability to give you the best chance at understanding how FastJ works.
143+
@Override
144+
public void init(FastJCanvas canvas) {}
118145

146+
@Override
147+
public void update(FastJCanvas canvas) {}
119148

120-
### API Documentation
121-
[Check out FastJ's documentation][Javadoc] to get a better understanding of the code FastJ provides to improve your game-making experience.
149+
public static void main(String[] args) {
150+
// Creates an empty window titled "Hello, FastJ!"
151+
FastJEngine.init("Hello, FastJ!", new Main());
152+
FastJEngine.run();
153+
}
154+
}
155+
```
122156

123157

124-
## Contributing to FastJ
125-
Plan on contributing to the repository? Great! Be sure to read over the [contribution guidelines][Contributing-Guidelines], and read on to discover how to get started.
158+
## External Dependencies
159+
- [SLF4J][SLF4J]
126160

127161

128-
### Building FastJ
129-
You'll need a few things in order to work on the repository:
130-
- [Git][Git-Link]
131-
- [Java 11][AdoptOpenJDK-Java11-Link]
132-
- (optional, but highly recommended!) A decent understanding of how to use [Gradle][Gradle-Link].
133-
**Installation of Gradle is not required -- the project supplies the Gradle tools already.**
134-
- For reference, this project currently makes use of Gradle 7.1.1.
162+
## Contributing
163+
Plan on contributing to the repository? Awesome! We're glad to have you ❤️
135164

136-
Once you have what you need, follow these simple steps:
137-
- Clone the FastJ repository.
138-
```bash
139-
git clone https://github.com/fastjengine/FastJ.git
140-
```
141-
- Ensure that the FastJ project works on your device.
142-
```bash
143-
./gradlew check
144-
```
145-
_Having trouble using `gradlew`? Read [this][Terminals Are Different]._
165+
Please be sure to read over the [contribution guidelines][Contributing-Guidelines] so that you can get started.
146166

147167

148168
## Community
@@ -180,12 +200,14 @@ This repository is licensed under the [MIT License][MIT-License].
180200
[JavaDoc]: https://javadoc.io/doc/io.github.lucasstarsz.fastj/fastj-library "FastJ Documentation"
181201
[JavaDoc-SVG]: https://javadoc.io/badge2/io.github.lucasstarsz.fastj/fastj-library/Javadocs.svg?style=for-the-badge&color=blue&labelColor=363e45&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAEAAAABACAYAAACqaXHeAAAFEklEQVR4Xu1bbXLbNhBdgFR6mLoWSSX2AfLVnqYZKW4mR8iHPT1NIjfJTH7Gqi1Rck5TkdjOgoJCyaQIkASoicxf8hDE7j487GIfaQYHfrEDjx/uAbhnwJ4iMOn38WQ+t85Q6wbq4vtvGOGj2dS6f9YN1AVgEkZ4cg/AgTJgEoYIwOBgGUD09xiDwfTG+ha1bsA0B0yCEIExwGQJp7e31v2zbsAYgDBCesYF/cnOXgFA1HcZ/F4BoILnjMFDB3tfMXMvGKCCd736nTNgcnyM4PnrNOFq3+fzUmcMyK961cpfhxEKRDiJZ6372/qEOllfBrQaSA6UnfmvowEiYul9HVtVY5wDkF/5B5xDcHN9x4ebaIApyoJgvRw6BSAfPALC6WyT0t+CADnjTgJ3XgXywTMh4NE83gC/q0rghAEbCa8gmVHvnxHePuW3c4J1APLBlSW8NUCWMv2uRGgdgCpqd7n6Tg5CVQBU3a8qY03vO2NAWX9/MAD4jEFU0OSYnAibrnbR8w4YkMlblQnwZ60CFNeuPj+fBFVSciGHd3IQ0mUBnf9PLTQ+nWwBZfQqjJAAKGp5r4IQGdvcja5aY+s5II860Z3+LqJ4V8nQKQAUPLW4QojC3r6LkugcAAJhGg2wsCSuJHGXPUEnAFCA8eAhbmsB9EYYuAcgEE7m7as/nSZBnUMMCSEkfemWwf7oEmXuRIT4/Pdai1nroV3BBC8vkXs+JMslLC7MnLrqh3haY+UDBQQwmL1/ZhST0eCywKO/PiOKFEjnm79/3sqcOozJj/kBAsDMwIdGzoYvL5WOASkKWJz/0Wi+ncwaXWIKCLc7qK78SYWAxYWeL7UdJqpvP8wYBzJO8s7iQo8JfQIREeiNEFDXwDngWjMGoDkFCog1VjU6+4T0LNmPz/Xs1wYgv1rHwzF6XiZmSuumF2NZoLSNEGFRM6GtGWAwRysAmMZra7wCwFkOsBVInXnDs3/kVqLdE2tuP9V91rFX+kwwGlMzB3PDEtjEiSZVqNUtoJIQneRmDQHoj8bo+T2Yvnm800dl04T2ebDtALBhIUtw9NmLSBOpDKk0Sb8Z94F4K2mzvrPJhzQRsPj7blmjPU8VYt6g/LYKgHI7evUFMU1qs1qWQiFKDzSD11/l/NO3Txr733gC3SiPXoyx5zG5xoIBcGRy1ecGCUvXlsk4ZwCYOOVy7D0ANtBWZaluZrbhU9mcVhiQb5Kk4dxRlwwKpPcE9D0kZYSsShRVASEoR5i11KbgWQGAnFAnM1OHNsYzDrN3T635aOUkuB2wFEi4B6QX7L6Y7ASpIdLp/BoBm3u4FrpSfOBUxgBiQwWmLce35zkafsTvmhpA7ZNgePZJdhuIDOJzM+nJVuBqXtpys3fmPmkzIJ/Y9im7B0PSIDlMa+YKLQD6ZGSld2zQh/uQpMvaAoYpK3598QF7ngfcW+WUkiRJW9SKInQ0+ogP/F+yhJaTre4EwjjQuz5MScVTV/ZrVfiAPpOTxZCOxeoGXz1Hc28rS1RKuQ/L5L/duqDhVtBigM5KHY/GSLqenHBV96W2pyWR0Vkgc4W6O3qGPpS81Uxqvw2pz/AkqKZ5oDUAdEBqa8zRnx+w1/Oz/3ZABMa92p1hawCQEkSr2GaC7A/HyDlRn/Y8vXXItpE6OZq+BClagNYAUJNTH6B+J8sEPI8BU5/EK9EDVSg/pJG1I7QVpEROFZdU4maCRxXrWgegyuC+3f8fARJ0X9/EzrEAAAAASUVORK5CYIIA
182202

203+
[SLF4J]: https://www.slf4j.org/ "Simple Logging Facade for Java"
204+
183205
[Releases]: https://github.com/fastjengine/FastJ/releases/ "FastJ Releases"
184206

185207
[MIT-License]: https://github.com/fastjengine/FastJ/tree/main/LICENSE.txt "MIT Licensing"
186208

187-
[FastJ-Tutorials]: /wiki/fastj-basics/fastj-quick-start "FastJ Tutorials"
188-
[FastJ-Examples]: https://github.com/fastjengine/FastJ/tree/main/src/example "FastJ: Example Game"
209+
[FastJ-Tutorials]: https://fastj.tech/wiki/fastj-basics/fastj-quick-start "FastJ Tutorials"
210+
[FastJ-Examples]: https://github.com/fastjengine/FastJ/tree/main/src/example "FastJ Examples"
189211

190212
[Contributing-Guidelines]: https://github.com/fastjengine/FastJ/tree/main/.github/CONTRIBUTING.md "Contributing to FastJ"
191213

@@ -194,21 +216,3 @@ This repository is licensed under the [MIT License][MIT-License].
194216
[AdoptOpenJDK-Java11-Link]: https://adoptopenjdk.net/?variant=openjdk11&jvmVariant=hotspot "Download Java 11"
195217
[Git-Link]: https://git-scm.com/downloads "Download Git, the powerful source control management tool."
196218
[Gradle-Link]: https://gradle.org/install/ "Download Gradle, the powerful build tool."
197-
198-
199-
[FastJ-Logo]: https://raw.githubusercontent.com/fastjengine/FastJ/main/media/branding/fastj_logo.png "FastJ Logo"
200-
201-
[SonarCloud-CodeCoverage-SVG]: https://img.shields.io/sonar/coverage/fastjengine_FastJ?labelColor=363e45&logo=sonarcloud&logoColor=f3702a&server=https%3A%2F%2Fsonarcloud.io&style=for-the-badge
202-
[SonarCloud-CodeCoverage-Report]: https://sonarcloud.io/dashboard?id=fastjengine_FastJ "SonarCloud Code Coverage"
203-
204-
[Windows-Build-Action]: https://github.com/fastjengine/FastJ/actions?query=workflow%3ABuild-Windows "Windows Build Status"
205-
[Windows-Build-SVG]: https://img.shields.io/github/workflow/status/fastjengine/FastJ/Build-Windows?label=Windows%20Build&labelColor=363e45&logo=windows&logoColor=0078D6&style=for-the-badge
206-
207-
[Ubuntu-Build-Action]: https://github.com/fastjengine/FastJ/actions?query=workflow%3ABuild-Ubuntu "Ubuntu Build Status"
208-
[Ubuntu-Build-SVG]: https://img.shields.io/github/workflow/status/fastjengine/FastJ/Build-Ubuntu?label=Ubuntu%20Build&labelColor=363e45&logo=ubuntu&logoColor=E95420&style=for-the-badge
209-
210-
[MacOS-Build-Action]: https://github.com/fastjengine/FastJ/actions?query=workflow%3ABuild-MacOS "Mac OS Build Status"
211-
[MacOS-Build-SVG]: https://img.shields.io/github/workflow/status/fastjengine/FastJ/Build-MacOS?label=Mac%20OS%20Build&labelColor=363e45&logo=apple&logoColor=000000&style=for-the-badge
212-
213-
[Jitpack.IO]: https://jitpack.io/#fastjengine/FastJ "FastJ on jitpack.io"
214-
[Jitpack.IO-SVG]: https://img.shields.io/jitpack/v/github/fastjengine/FastJ?label=jitpack.io&style=for-the-badge&labelColor=363e45&color=blue&logo=jitpack

0 commit comments

Comments
 (0)