[1.13.0.1]新增Particle模块,用于粒子特效渲染

Author: YufiriaMazenta

build.gradle.kts

@@ -1,7 +1,7 @@
 java.sourceCompatibility = JavaVersion.VERSION_1_8
 java.targetCompatibility = JavaVersion.VERSION_1_8
 rootProject.group = "com.crypticlib"
-rootProject.version = "1.12.3.5"
+rootProject.version = "1.13.0.1"
 //当全项目重构时更新大版本号,当添加模块或有较大更改时更新子版本号,当bug修复和功能补充时更新小版本号
 
 var repositoryUrl = "https://repo.crypticlib.com:8081/repository/"

module/bukkit/particle/src/main/java/com/crypticlib/particle/pobject/ParticleObject.java

@@ -19,32 +19,32 @@
  */
 public abstract class ParticleObject {
 
-    private Location origin;
-
-    private ShowType showType = ShowType.NONE;
-    private TaskWrapper task;
-    private long period;
-    private boolean running = false;
-
-    private Particle particle = Particle.VILLAGER_HAPPY;
-    private int count = 1;
-    private double offsetX = 0;
-    private double offsetY = 0;
-    private double offsetZ = 0;
-    private double extra = 0;
-    private Object data = null;
-    private Color color;
-    private Entity entity;
+    protected Location origin;
+
+    protected ShowType showType = ShowType.NONE;
+    protected TaskWrapper showTask;
+    protected long period;
+    protected boolean running = false;
+
+    protected Particle particle = Particle.VILLAGER_HAPPY;
+    protected int count = 1;
+    protected double offsetX = 0;
+    protected double offsetY = 0;
+    protected double offsetZ = 0;
+    protected double extra = 0;
+    protected Object data = null;
+    protected Color color;
+    protected Entity entity;
     /**
      * X的变化量
      */
-    private double incrementX;
-    private double incrementY;
-    private double incrementZ;
+    protected double incrementX;
+    protected double incrementY;
+    protected double incrementZ;
     /**
      * 表示该特效对象所拥有的矩阵
      */
-    private Matrix matrix;
+    protected Matrix matrix;
 
     /**
      * 将计算好的粒子展示位置以列表的方式返回
@@ -67,7 +67,7 @@ public void alwaysShow() {
         // 此处的延迟 2tick 是为了防止turnOffTask还没把特效给关闭时的缓冲
         CrypticLibBukkit.scheduler().syncLater(() -> {
             running = true;
-            task = CrypticLibBukkit.scheduler().syncTimer(() -> {
+            showTask = CrypticLibBukkit.scheduler().syncTimer(() -> {
                 if (!running) {
                     return;
                 }
@@ -86,7 +86,7 @@ public void alwaysShowAsync() {
         // 此处的延迟 2tick 是为了防止turnOffTask还没把特效给关闭时的缓冲
         CrypticLibBukkit.scheduler().syncLater(() -> {
             running = true;
-            task = CrypticLibBukkit.scheduler().asyncTimer(() -> {
+            showTask = CrypticLibBukkit.scheduler().asyncTimer(() -> {
                 if (!running) {
                     return;
                 }
@@ -115,7 +115,7 @@ public void alwaysPlay() {
         // 此处的延迟 2tick 是为了防止turnOffTask还没把特效给关闭时的缓冲
         CrypticLibBukkit.scheduler().syncLater(() -> {
             running = true;
-            task = CrypticLibBukkit.scheduler().syncTimer(() -> {
+            showTask = CrypticLibBukkit.scheduler().syncTimer(() -> {
                 if (!running) {
                     return;
                 }
@@ -143,7 +143,7 @@ public void alwaysPlayAsync() {
         // 此处的延迟 2tick 是为了防止turnOffTask还没把特效给关闭时的缓冲
         CrypticLibBukkit.scheduler().syncLater(() -> {
             running = true;
-            task = CrypticLibBukkit.scheduler().asyncTimer(() -> {
+            showTask = CrypticLibBukkit.scheduler().asyncTimer(() -> {
                 if (!running) {
                     return;
                 }
@@ -157,9 +157,9 @@ public void alwaysPlayAsync() {
      * 将正在展示或播放的特效关闭
      */
     public void turnOffTask() {
-        if (task != null) {
+        if (showTask != null) {
             running = false;
-            task.cancel();
+            showTask.cancel();
             setShowType(ShowType.NONE);
         }
     }

module/bukkit/particle/src/main/java/com/crypticlib/particle/pobject/Point.java

@@ -0,0 +1,31 @@
+package com.crypticlib.particle.pobject;
+
+import org.bukkit.Location;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.Collections;
+import java.util.List;
+
+public class Point extends ParticleObject {
+
+    /**
+     * 构造一个点
+     * @param origin 点的原始坐标
+     */
+    public Point(@NotNull Location origin) {
+        this.origin = origin;
+    }
+
+    @Override
+    public List<Location> calculateLocations() {
+        Location loc = getOrigin().clone();
+        loc.add(getIncrementX(), getIncrementY(), getIncrementZ());
+        return Collections.singletonList(loc);
+    }
+
+    @Override
+    public void show() {
+        spawnParticle(getOrigin().clone());
+    }
+
+}