From 79f79239e42981cecfa00c9ed51a28afa0ee649e Mon Sep 17 00:00:00 2001
From: Glease <4586901+Glease@users.noreply.github.com>
Date: Sun, 14 Jun 2026 10:36:01 +0800
Subject: [PATCH 1/3] enable javadoc build

Signed-off-by: Glease <4586901+Glease@users.noreply.github.com>
---
 .github/workflows/publish-javadoc.yaml | 9 +++++----
 addon.gradle                           | 2 +-
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/.github/workflows/publish-javadoc.yaml b/.github/workflows/publish-javadoc.yaml
index d4ab5d71..e06abc95 100644
--- a/.github/workflows/publish-javadoc.yaml
+++ b/.github/workflows/publish-javadoc.yaml
@@ -5,6 +5,7 @@ on:
     branches:
       - master
       - feature/doc
+      - '**/*-javadoc'
     tags:
       - '*'
   delete:
@@ -26,7 +27,7 @@ jobs:
         with:
           fetch-depth: 0
           ref: gh-pages
-    
+
       - name: Deploy 🚀
         id: deploy
         shell: bash
@@ -34,17 +35,17 @@ jobs:
           if git rm -r $TARGET_FOLDER ; then
             echo Nothing to clean up
           fi
-          
+
           find . -name javadoc -type d -print | sed 's#^\./\(.*\)/javadoc$#\1#' | sort --version-sort --reverse > index.txt
           git add index.txt
           git config user.name "${GITHUB_ACTOR}"
           git config user.email "${GITHUB_ACTOR_ID}-${GITHUB_ACTOR}@users.noreply.github.com"
           git commit -m "Clean up javadoc after ref $TARGET_FOLDER is deleted"
           git push
-          echo "hash=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT            
+          echo "hash=$(git rev-parse HEAD)" >> $GITHUB_OUTPUT
         env:
           TARGET_FOLDER: ${{ github.ref_name }}
-          
+
   javadoc:
     if: github.event_name == 'push'
     concurrency: javadoc-publish
diff --git a/addon.gradle b/addon.gradle
index 32cd6394..bdacc614 100644
--- a/addon.gradle
+++ b/addon.gradle
@@ -1,7 +1,7 @@
 javadoc {
     javadocTool = javaToolchains.javadocToolFor {
         // Last version with frames, but it also has search
-        languageVersion = JavaLanguageVersion.of(11)
+        languageVersion = JavaLanguageVersion.of(25)
         vendor = JvmVendorSpec.ADOPTIUM
     }
 

From 04aee4e007ea3c0abeb19d8a49a21d13af3e4400 Mon Sep 17 00:00:00 2001
From: Glease <4586901+Glease@users.noreply.github.com>
Date: Sun, 14 Jun 2026 10:43:34 +0800
Subject: [PATCH 2/3] drop frames :fail:

Signed-off-by: Glease <4586901+Glease@users.noreply.github.com>
---
 addon.gradle | 1 -
 1 file changed, 1 deletion(-)

diff --git a/addon.gradle b/addon.gradle
index bdacc614..681af746 100644
--- a/addon.gradle
+++ b/addon.gradle
@@ -20,7 +20,6 @@ javadoc {
         overview "src/main/javadoc/overview.html"
         links 'https://docs.oracle.com/javase/8/docs/api/'
         links 'https://skmedix.github.io/ForgeJavaDocs/javadoc/forge/1.7.10-10.13.4.1614/'
-        addBooleanOption("-frames", true)
     }
 }
 

From f59265c6efa61dee8cc394adf350975743a61186 Mon Sep 17 00:00:00 2001
From: Glease <4586901+Glease@users.noreply.github.com>
Date: Sun, 14 Jun 2026 11:07:05 +0800
Subject: [PATCH 3/3] fix javadoc

Signed-off-by: Glease <4586901+Glease@users.noreply.github.com>
---
 addon.gradle                                                  | 2 +-
 .../gtnewhorizon/structurelib/structure/StructureUtility.java | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/addon.gradle b/addon.gradle
index 681af746..84129c33 100644
--- a/addon.gradle
+++ b/addon.gradle
@@ -18,7 +18,7 @@ javadoc {
 
     options {
         overview "src/main/javadoc/overview.html"
-        links 'https://docs.oracle.com/javase/8/docs/api/'
+        links 'https://docs.oracle.com/en/java/javase/25/docs/api/'
         links 'https://skmedix.github.io/ForgeJavaDocs/javadoc/forge/1.7.10-10.13.4.1614/'
     }
 }
diff --git a/src/main/java/com/gtnewhorizon/structurelib/structure/StructureUtility.java b/src/main/java/com/gtnewhorizon/structurelib/structure/StructureUtility.java
index 631b54d2..67bad619 100644
--- a/src/main/java/com/gtnewhorizon/structurelib/structure/StructureUtility.java
+++ b/src/main/java/com/gtnewhorizon/structurelib/structure/StructureUtility.java
@@ -637,7 +637,7 @@ public static <T, TIER> IStructureElementCheckOnly<T> ofBlocksTiered(ITierConver
      * given tier, then player will be allowed to use multiple kinds of blocks, but their tier is guaranteed to be the
      * same.
      * <p>
-     * <h3>WARNING</h3> <b>You SHOULD NOT return notSet from your tierExtractor.</b> If you do so, we will have this
+     * <h4>WARNING</h4> <b>You SHOULD NOT return notSet from your tierExtractor.</b> If you do so, we will have this
      * chain of events:
      * <ul>
      * <li>at check start, tier is reset to notSet
@@ -650,7 +650,7 @@ public static <T, TIER> IStructureElementCheckOnly<T> ofBlocksTiered(ITierConver
      * doing its business
      * <li>Player enjoy a (probably) hilariously shaped multi and (probably) reduced build cost.
      * </ul>
-     * <h3>Example Implementation</h3>
+     * <h4>Example Implementation</h4>
      * <p>
      * Assume you have 16 tier, each map to one particular block's 16 different meta. You will usually want something
      * like this