merge: integrate feature/strong-shield-brick with latest power-up system

Author: ManhTanTran

build.gradle

@@ -23,6 +23,7 @@ dependencies {
 	implementation 'com.github.almasb:fxgl:21.1'
 	implementation 'com.google.guava:guava:33.5.0-jre'
 	implementation 'com.moandjiezana.toml:toml4j:0.7.2'
+	implementation 'com.google.guava:guava:33.5.0-jre'
 	implementation 'com.google.auto.service:auto-service-annotations:1.1.1'
 	annotationProcessor 'com.google.auto.service:auto-service:1.1.1'
 }

docs/dev/guide.md

@@ -48,3 +48,6 @@ Chi tiết: [Spotless Gradle Plugin](https://github.com/diffplug/spotless/tree/m
 * **Commits:** [Conventional Commits](https://www.conventionalcommits.org/) (và viết message bằng **Tiếng Anh**)
 * **Files Structure:**
   [Gradle project Structure](https://docs.gradle.org/current/userguide/organizing_gradle_projects.html)
+
+Ngoài ra:
+* [Hướng dẫn viết javadoc](javadoc.md)

docs/dev/javadoc.md

@@ -0,0 +1,55 @@
+# 📄 Viết Javadoc
+
+### 💾 Format
+
+Javadoc được viết tuân theo các quy tắc javadoc cơ bản và viết trên format HTML.
+
+### 🏗️ Cấu trúc
+
+Trên IDE, khi bạn di chuyển lên trên đầu lớp/method và viết `/**` rồi Enter, IDE sẽ tự sinh ra cho bạn khung để bạn viết
+javadoc. Cấu trúc của dự án chúng ta sẽ là:
+
+- Đối với Lớp:
+
+```java
+/**
+ *
+ *
+ * <h1>?{@link Tên Lớp}</h1>
+ *
+ * Mô tả lớp... Có thể sử dụng {@link Class nào đó#TP trong class} để liên kết <br>
+ * <b>Chú ý: Sử dụng thẻ br để xuống dòng</b> <br>
+ * <i>Plot Twist: tui cũng ko bt viết gì ở đây nữa</i>
+ *
+ * @see ...
+ */
+
+```
+
+trong đó `?` ở Tên lớp sẽ là:
+
+| Loại lớp | 📚 Class | 📱Interface | 🔢 Enum | ❗ Exception | 📍 Annotation | 📝 Record |
+|----------|----------|-------------|---------|-------------|---------------|-----------|
+| Kí hiệu  |          | %           | #       | !           | @             | $         |
+
+**VD:** `ThisIsClass`, `%Interface`, `!StackoverflowException`, `#EntityType`
+
+- Đối với method:
+
+```java
+/**
+ * Hàm này thực hiện chức năng gì... .
+ *
+ * @params Input1 Đầu vào 1
+ * @params Input2 Đầu vào 2
+ * @return Kết quả của hàm
+ * @throws Exception nếu có lỗi xảy ra...
+ */
+
+```
+
+### ❗Chú ý
+
+- Formating docs sau khi viết code xong. (Phím tắt thường là `Alt` + `Shift` + `F`)
+
+### Bạn có thể xem source code trong dự án để xem ví dụ.

settings.ADMIN.toml

@@ -0,0 +1,7 @@
+[video]
+width = 1280.0
+height = 960.0
+fullscreen = false
+[audio]
+music = 1.0
+sound = 1.0

src/main/java/com/github/codestorm/bounceverse/Bounceverse.java

@@ -4,8 +4,9 @@
 
 import com.almasb.fxgl.app.GameApplication;
 import com.almasb.fxgl.app.GameSettings;
-import com.github.codestorm.bounceverse.core.LaunchOptions;
-import com.github.codestorm.bounceverse.core.SettingsManager;
+import com.github.codestorm.bounceverse.core.settings.GameSettingsManager;
+import com.github.codestorm.bounceverse.core.settings.LaunchOptionsManager;
+import com.github.codestorm.bounceverse.core.systems.AppEventSystem;
 import com.github.codestorm.bounceverse.core.systems.GameSystem;
 import com.github.codestorm.bounceverse.core.systems.InputSystem;
 import com.github.codestorm.bounceverse.core.systems.PhysicSystem;
@@ -28,27 +29,32 @@
 public final class Bounceverse extends GameApplication {
 
     public static void main(String[] args) {
-        LaunchOptions.load(args);
+        LaunchOptionsManager.load(args);
         launch(args);
     }
 
     @Override
     protected void initSettings(GameSettings settings) {
         try {
-            SettingsManager.load(settings);
+            GameSettingsManager.loadTo(settings);
         } catch (IOException e) {
             throw new BounceverseException(e);
         }
     }
 
     @Override
-    protected void initGame() {
-        GameSystem.getInstance().apply();
+    protected void initInput() {
+        InputSystem.getInstance().apply();
     }
 
     @Override
-    protected void initInput() {
-        InputSystem.getInstance().apply();
+    protected void onPreInit() {
+        AppEventSystem.getInstance().apply();
+    }
+
+    @Override
+    protected void initGame() {
+        GameSystem.getInstance().apply();
     }
 
     @Override

src/main/java/com/github/codestorm/bounceverse/Utilities.java

@@ -291,16 +291,17 @@ public static final class Compatibility {
         public static void throwIfNotCompatible(EntityType onlyFor, Component... params) {
             for (var param : params) {
                 final var annotation = param.getClass().getAnnotation(ForEntity.class);
-                if (annotation != null) {
-                    final var paramSet = EnumSet.copyOf(Arrays.asList(annotation.value()));
-                    if (paramSet.isEmpty() || paramSet.contains(onlyFor)) {
-                        continue;
-                    }
+                if (annotation == null) {
+                    continue;
+                }
+
+                final var paramEntityTypeSet = EnumSet.copyOf(Arrays.asList(annotation.value()));
+                if (!paramEntityTypeSet.contains(onlyFor)) {
+                    throw new IllegalArgumentException(
+                            String.format(
+                                    "Class '%s' does not compatible for entity has '%s' type.",
+                                    param.getClass().getSimpleName(), onlyFor.name()));
                 }
-                throw new IllegalArgumentException(
-                        String.format(
-                                "Class '%s' does not compatible for entity has '%s' type.",
-                                param.getClass().getSimpleName(), onlyFor.name()));
             }
         }
 

src/main/java/com/github/codestorm/bounceverse/components/behaviors/Attack.java

@@ -3,7 +3,6 @@
 import com.almasb.fxgl.dsl.components.HealthIntComponent;
 import com.almasb.fxgl.entity.Entity;
 import com.github.codestorm.bounceverse.components.properties.Attributes;
-import com.github.codestorm.bounceverse.typing.annotations.ForEntity;
 import java.util.List;
 
 /**
@@ -13,7 +12,6 @@
  *
  * Hành động tấn công/gây sát thương của {@link Entity}. <br>
  */
-@ForEntity({})
 public class Attack extends Behavior {
     public static final int DEFAULT_DAMAGE = 1;
     private int damage = DEFAULT_DAMAGE;

src/main/java/com/github/codestorm/bounceverse/components/behaviors/HealthDeath.java

@@ -3,7 +3,6 @@
 import com.almasb.fxgl.dsl.components.HealthIntComponent;
 import com.almasb.fxgl.entity.component.Required;
 import com.github.codestorm.bounceverse.core.BackgroundColorManager;
-import com.github.codestorm.bounceverse.typing.annotations.ForEntity;
 import com.github.codestorm.bounceverse.typing.enums.EntityType;
 
 import java.util.List;
@@ -17,7 +16,6 @@
  * <b>Yêu cầu entity có {@link HealthIntComponent} trước.</b>
  */
 @Required(HealthIntComponent.class)
-@ForEntity({})
 public class HealthDeath extends Behavior {
     @Override
     public void execute(List<Object> data) {

src/main/java/com/github/codestorm/bounceverse/components/behaviors/ScaleChange.java

@@ -2,9 +2,9 @@
 
 import com.almasb.fxgl.entity.Entity;
 import com.almasb.fxgl.entity.components.TransformComponent;
-import com.github.codestorm.bounceverse.typing.annotations.ForEntity;
 import java.util.ArrayList;
 import java.util.List;
+import javafx.util.Duration;
 
 /**
  *
@@ -18,7 +18,6 @@
  *
  * @see TransformComponent
  */
-@ForEntity({})
 public class ScaleChange extends UndoableBehavior {
     public static final double DONT_CHANGE = 1;
     private double scaleWidth = DONT_CHANGE;
@@ -61,4 +60,8 @@ public double getScaleHeight() {
     public void setScaleHeight(double scaleHeight) {
         this.scaleHeight = scaleHeight;
     }
+
+    public ScaleChange(Duration duration) {
+        super(duration, true);
+    }
 }

src/main/java/com/github/codestorm/bounceverse/components/behaviors/Special.java

@@ -13,6 +13,8 @@ public class Special extends Component {
 
     @Override
     public void onRemoved() {
-        FXGL.spawn("powerUp", getEntity().getCenter());
+        if (Math.random() < 0.3) { // 30% tỉ lệ rơi PowerUp
+            FXGL.spawn("powerUp", getEntity().getCenter());
+        }
     }
 }