It's finally time for an alpha release!

.github/ISSUE_TEMPLATE/ISSUE-REPORT.yml

@@ -9,7 +9,7 @@ body:
     attributes:
       label: "Bug Description"
       description: "A brief overview/description of what this bug is and when it occurs."
-      placeholder: "ex. In these circumstances, StarGate breaks by doing this instead of this!"
+      placeholder: "ex. In these circumstances, Stargate breaks by doing this instead of this!"
     validations:
       required: true
   - type: textarea

CHANGELOG.md

@@ -1,9 +1,92 @@
 # Changes
 
+#### [Version 1.0.0.16] Stargate-Rewritten
+
+- Added full support for MineCraft 1.20.X; fixed related bugs introduced by double sided and editable signs.
+- Majorly refactored internal metadata storage to allow for better persistence of features implemented in modules.
+- Fixed an issue wherein networked A gates could close between server restarts.
+- Fixed an issue wherein invalid stargates could be created in such a way as to lead to a plugin crash.
+- Implemented full folia support; switched numerous methods to their folia counterparts.
+- Made numerous things asynchronous in consequence to the need to support Folia.
+- Fixed a litany of numerous folia-specific bugs introduced in consequence to the above.
+- Fixed an issue wherein synchronous queries to an API could lead to a main thread stall.
+- Complete refactor on internal task handling, as to better accommodate module use cases.
+- Fixed some race condition scenarios caused by certain tasks.
+- Majorly simplified several sections of the API pertaining to portal position storage; expanded some methods.
+- Corrected thousands of codestyle nitpicks.
+- Added tracking of portal presence in chunks as to prevent unwanted behaviour resulting from chunk unloading.
+- Modified the `checkPortalValidity` algorithm to prevent several issues resulting from improper verification.
+- Adds detection of mass api-detached world changes as to mitigate portal breakage resultant to NMS mass editing.
+- Fixed countless problems with the migrator as to ensure a seamless importation.
+- Improved storage of worlds as to prevent some crashes associated with multiverse.
+- Fixed some problems related to SQL and SQLite query storage.
+- Improved the garbage collection process to prevent unnecessary storage of some non-existent stargates.
+- Added consideration for control surfaces (including multiples thereof) in portal validity detection and verification.
+- Added an automated continuous integration pipeline to help with distribution of testing and development jars.
+- Clarified numerous console-specific and debug warning messages.
+- Fixed an issue wherein gates without control surfaces could be accidently created.
+- Moved some overly cumbersome code to new classes.
+- Removed some unnecessary debug printouts.
+- Added an event to the API for detecting and analysing a portal before it has been initialised.
+- Renamed some classes for clarity.
+- Optimised performance by reducing reliance on certain unnecessarily heavy interfaces.
+- Added a system to ensure that blocks generated by addons do not drop their items (configurable).
+- Improved logic for networked A gates as to prevent a possible crash related to accessing invalid destinations.
+- Improved piston protection for block irises to prevent certain edge cases.
+- Improved sign updating to eliminate certain startup rendering problems.
+- Made a bunch of components null-safe to prevent various crashes.
+- Fixed some problems leading to failed migration of pre-legacy builds.
+- Majorly refactored stargate's scheduler to facilitate some addon behaviour.
+- Fixed several bugs preventing interserver networking from functioning in certain cases.
+- Fixed a hang caused by infinite addition of tasks.
+- Fixed a possible crash related to invalid metadata added through the API.
+- Fixed numerous small issues involving portal sign formatting logic.
+- Renamed some internal enumerations for certain things to increase code clarity.
+- Fixed an issue wherein portal networking could cause sign drawing errors.
+- Changed the format of custom flags as to avoid some storage problems.
+- Prevented certain situations wherein fixed portals would improperly save their destination.
+- Added an API for specifying custom portal behaviours.
+- Improved translation handling and added a tr-TR translation by axolotlagatsuma
+- Fixed a bunch of portal builder edgecases.
+- Updated dependencies to resolve some upstream issues.
+- Fixed some issues caused by the presence of OfflinePlayers
+- Fixed certain circumstances wherein gates failed to close after their destruction.
+- Fixed a crash related to migration of invalid gate files.
+- Fixed an issue that caused some commands to improperly register.
+- Fixed a problem with migrating R gates under an asynchronous implementation.
+- Fixed a problem wherein non-A portals would in certain circumstances fail to close.
+- Added support for block id change resolution to the migrator.
+- Fixed several substitution problems pertaining debug messages.
+- Prevented invalid behaviour from arising resultant to the presence of unregistered flags.
+- Fixed some potential null pointers related to the presence of unregistered flags.
+- Resolved some MySQL-specific (i.e. remote) query problems.
+- Added light to the list of air-like blocks within which portals may be constructed.
+- Fixed some persistence problems related to legacy interserver portals.
+- Fixed a potential portal frame protection failure resulting from anvils.
+- Fixed a potential portal frame protection failure resulting from respawn anchors.
+- Fixed a problem involving liquid containment in portal irises.
+- Fixed a crash caused by migrating invalid gate files.
+- Fixed several implementation problems leading to instability on spigot.
+- Corrected some incorrect behaviour involving the `P` flag.
+- Fixed a potential portal loop resulting from entity collisions at destination portals.
+- Clarified some error messages.
+- Fixed some permission preset inconsistencies.
+- Fixed some cases wherein duplicate error messages would be printed.
+- Fixed a feedback problem involving accessing free destinations.
+- Fixed some API problems leading to incorrect behaviour on modules.
+- Modified some build scripts to add commit IDs to development builds.
+- Prevents an assortment of crashes related to legacy stargate components.
+- Significant updates to API and public method documentation.
+- Fixed several migration crashes related to unexpected portal name and network lengths.
+- Ensured personal network migration is preformed case agnostically.
+- Added full support for Minecraft 1.21
+- Bumped minimum supported version to Minecraft 1.20
+- And fixed hundreds, if not thousands, of other random miscellaneous bugs too specific to specify above.
+
 #### [Version 1.0.0.15] Stargate-Rewritten
 
 - Added a trace command to improve UX for bug reporting
-- Changed to new package name (org.sgrewitten)
+- Changed to new package name (org.sgrewritten)
 - Moved low-usage flags to the SG-Mechanics module (`Q`, `H`, `N`, `S`)
 - Updated localisation targets and pulled most recent translations from crowdin.
 - Added default detections for sublanguage specifications based on parent locales.

README.md

@@ -1,9 +1,11 @@
-> ### **Support Discord** __**[Link](https://sgrewitten.org/discord)**__
+> ### **Support Discord** __**[Link](https://sgrewritten.org/discord)**__
 
 # Stargate-Bukkit
 
-`Supporting MC 1.18+ in the Bukkit Ecosystem`
+`Supporting MC 1.20+ in the Bukkit Ecosystem`
 
+> [!WARNING]
+>
 > **THIS IS A TESTING BUILD FROM THE ALPHA CHANNEL!**<br>
 > <br>
 > **FOR**: Addon developers, early adopters, and adventure seekers.<br>
@@ -13,6 +15,7 @@
 > **THIS BUILD IS NOT YET SUITABLE FOR USE AT SCALE OR ON MOST PRODUCTION SERVERS**<BR>
 > **Use at your own risk, remember to make backups, and please report the bugs you will find!**
 
+
 ![Stargate Banner](https://i.imgur.com/7Ji4jrr.png)
 
 ## Description
@@ -25,11 +28,11 @@
 
 |                                                     **Immersive**                                                      |                                                                    **User-Oriented**                                                                    |                                                           **Capable**                                                           |
 |:----------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------------:|
-| Stargate's interface is integrated within gameplay; players can create, use, and destroy portals without any commands! | All of StarGate's features are designed to allow for non-admin users to create and manage their own portal networks in a balanced and risk free manner. | By default, StarGate boasts a comprehensive network system, dozens of portal types (flags), and highly configurable behaviours. |
+| Stargate's interface is integrated within gameplay; players can create, use, and destroy portals without any commands! | All of Stargate's features are designed to allow for non-admin users to create and manage their own portal networks in a balanced and risk free manner. | By default, Stargate boasts a comprehensive network system, dozens of portal types (flags), and highly configurable behaviours. |
 
 |                                              **Configurable**                                               |                                                                                   **Expandable**                                                                                   |                                                     **Customizable**                                                      |
 |:-----------------------------------------------------------------------------------------------------------:|:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------------:|
-| Stargate has a comprehensive and intuitive config, highly granular permissions, and multi-language support! | The StarGate community has developed an ecosystem of [add-ons](https://sgrewritten.org/addons), which collectively add integration and design-philosophy expansions to the plugin. | Stargate supports numerous customizations; from sign formatting to gate designs, all user-facing details can be modified! |
+| Stargate has a comprehensive and intuitive config, highly granular permissions, and multi-language support! | The Stargate community has developed an ecosystem of [add-ons](https://sgrewritten.org/addons), which collectively add integration and design-philosophy expansions to the plugin. | Stargate supports numerous customizations; from sign formatting to gate designs, all user-facing details can be modified! |
 
 ------
 

nb-configuration.xml

@@ -0,0 +1,20 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<project-shared-configuration>
+    <!--
+This file contains additional configuration written by modules in the NetBeans IDE.
+The configuration is intended to be shared among all the users of project and
+therefore it is assumed to be part of version control checkout.
+Without this configuration present, some functionality in the IDE may be limited or fail altogether.
+-->
+    <properties xmlns="http://www.netbeans.org/ns/maven-properties-data/1">
+        <!--
+Properties that influence various parts of the IDE, especially code formatting and the like. 
+You can copy and paste the single properties, into the pom.xml file and the IDE will pick them up.
+That way multiple projects can share the same settings (useful for formatting rules for example).
+Any value defined here will override the pom.xml file value but is only applicable to the current project.
+-->
+        <netbeans.hint.license>gpl30</netbeans.hint.license>
+        <com-github-philippefichet-sonarlint4netbeans.sonarlint-preference-scope>global</com-github-philippefichet-sonarlint4netbeans.sonarlint-preference-scope>
+        <com-github-philippefichet-sonarlint4netbeans.extraProperties>{}</com-github-philippefichet-sonarlint4netbeans.extraProperties>
+    </properties>
+</project-shared-configuration>

pom.xml

@@ -4,13 +4,13 @@
 
     <groupId>org.sgrewritten</groupId>
     <artifactId>stargate</artifactId>
-    <version>1.0.0.15-ALPHA</version>
-    <name>StarGate</name>
+    <version>1.0.0.16-ALPHA</version>
+    <name>Stargate</name>
     <description>The original, and still the best, transportation plugin for the Bukkit Ecosystem.</description>
-    <url>https://sgrewitten.org</url>
+    <url>https://sgrewritten.org</url>
     <organization>
-        <name>Stargate Rewitten</name>
-        <url>https://sgrewitten.org</url>
+        <name>Stargate Rewritten</name>
+        <url>https://sgrewritten.org</url>
     </organization>
     <developers>
         <developer>
@@ -25,7 +25,7 @@
     <contributors>
         <contributor>
             <name>The contributors of the SGR Project</name>
-            <url>https://sgrewitten.org/credits</url>
+            <url>https://sgrewritten.org/credits</url>
         </contributor>
     </contributors>
 
@@ -60,19 +60,23 @@
             <id>papermc</id>
             <url>https://repo.papermc.io/repository/maven-public/</url>
         </repository>
+        <repository>
+            <id>MG-Dev Jenkins CI Maven Repository</id>
+            <url>https://ci.mg-dev.eu/plugin/repository/everything</url>
+        </repository>
     </repositories>
 
     <dependencies>
         <dependency>
             <groupId>io.papermc.paper</groupId>
             <artifactId>paper-api</artifactId>
-            <version>1.20.2-R0.1-SNAPSHOT</version>
+            <version>1.20.4-R0.1-SNAPSHOT</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
             <groupId>com.github.MilkBowl</groupId>
             <artifactId>VaultAPI</artifactId>
-            <version>1.7</version>
+            <version>1.7.1</version>
             <scope>provided</scope>
         </dependency>
         <dependency>
@@ -96,43 +100,49 @@
         <dependency>
             <groupId>org.xerial</groupId>
             <artifactId>sqlite-jdbc</artifactId>
-            <version>3.44.1.0</version>
+            <version>3.45.3.0</version>
             <scope>compile</scope>
         </dependency>
         <dependency>
             <groupId>com.mysql</groupId>
             <artifactId>mysql-connector-j</artifactId>
             <scope>runtime</scope>
-            <version>8.2.0</version>
+            <version>8.4.0</version>
         </dependency>
         <dependency>
             <groupId>org.junit.jupiter</groupId>
             <artifactId>junit-jupiter-api</artifactId>
-            <version>5.10.0</version>
+            <version>5.10.2</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>net.joshka</groupId>
             <artifactId>junit-json-params</artifactId>
-            <version>5.9.3-r0</version>
+            <version>5.10.2-r0</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.eclipse.parsson</groupId>
+            <artifactId>parsson</artifactId>
+            <version>1.1.6</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>org.slf4j</groupId>
             <artifactId>slf4j-api</artifactId>
-            <version>2.0.9</version>
+            <version>2.0.13</version>
             <scope>compile</scope>
         </dependency>
         <dependency>
             <groupId>com.github.seeseemelk</groupId>
             <artifactId>MockBukkit-v1.20</artifactId>
-            <version>3.58.0</version>
+            <version>3.86.0</version>
             <scope>test</scope>
         </dependency>
         <dependency>
             <groupId>com.github.cryptomorin</groupId>
             <artifactId>XSeries</artifactId>
-            <version>9.8.0</version>
+            <version>10.0.0</version>
         </dependency>
         <dependency>
             <groupId>net.coreprotect</groupId>
@@ -152,22 +162,40 @@
             <version>5.2.5</version>
             <scope>compile</scope>
         </dependency>
+        <dependency>
+            <groupId>com.bergerkiller.bukkit</groupId>
+            <artifactId>BKCommonLib</artifactId>
+            <version>1.20.4-v1</version>
+            <scope>provided</scope>
+        </dependency>
+        <dependency>
+            <groupId>org.slf4j</groupId>
+            <artifactId>slf4j-simple</artifactId>
+            <version>2.0.13</version>
+            <scope>test</scope>
+        </dependency>
+        <dependency>
+            <groupId>com.github.Thorinwasher</groupId>
+            <artifactId>BlockUtil</artifactId>
+            <version>v1.0.0</version>
+            <scope>provided</scope>
+        </dependency>
     </dependencies>
     <build>
         <finalName>Stargate-${project.version}</finalName>
         <plugins>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-compiler-plugin</artifactId>
-                <version>3.12.1</version>
+                <version>3.13.0</version>
                 <configuration>
                     <release>17</release>
                 </configuration>
             </plugin>
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-shade-plugin</artifactId>
-                <version>3.5.1</version>
+                <version>3.5.3</version>
                 <configuration>
                     <createDependencyReducedPom>false</createDependencyReducedPom>
                     <artifactSet>
@@ -271,7 +299,29 @@
             <plugin>
                 <groupId>org.apache.maven.plugins</groupId>
                 <artifactId>maven-surefire-plugin</artifactId>
-                <version>3.2.3</version>
+                <version>3.2.5</version>
+            </plugin>
+            <plugin>
+                <groupId>io.github.git-commit-id</groupId>
+                <artifactId>git-commit-id-maven-plugin</artifactId>
+                <version>9.0.0</version>
+                <executions>
+                    <execution>
+                        <id>get-the-git-infos</id>
+                        <goals>
+                            <goal>revision</goal>
+                        </goals>
+                        <phase>initialize</phase>
+                    </execution>
+                </executions>
+                <configuration>
+                    <generateGitPropertiesFile>true</generateGitPropertiesFile>
+                    <generateGitPropertiesFilename>${project.build.outputDirectory}/git.properties</generateGitPropertiesFilename>
+                    <includeOnlyProperties>
+                        <includeOnlyProperty>^git.commit.id.abbrev</includeOnlyProperty>
+                    </includeOnlyProperties>
+                    <commitIdGenerationMode>full</commitIdGenerationMode>
+                </configuration>
             </plugin>
         </plugins>
         <resources>
@@ -280,6 +330,8 @@
                 <filtering>true</filtering>
                 <includes>
                     <include>**</include>
+                    <include>**/*.properties</include>
+                    <include>**/*.xml</include>
                 </includes>
             </resource>
         </resources>