Added /fly command and adjusted sleep requirement.

build.gradle.kts

@@ -10,6 +10,8 @@ dependencies {
 
 java {
 	toolchain.languageVersion.set(JavaLanguageVersion.of(21))
+	sourceCompatibility = JavaVersion.VERSION_21
+	targetCompatibility = JavaVersion.VERSION_21
 }
 
 // We don't need to generate an empty `vane.jar`
@@ -40,9 +42,15 @@ subprojects {
 		maven("https://repo.bluecolored.de/releases")
 	}
 
+	java {
+		sourceCompatibility = JavaVersion.VERSION_21
+		targetCompatibility = JavaVersion.VERSION_21
+	}
+
 	tasks.withType<JavaCompile> {
 		options.compilerArgs.addAll(arrayOf("-Xlint:all", "-Xlint:-processing", "-Xdiags:verbose"))
 		options.encoding = "UTF-8"
+		options.release.set(21)
 	}
 
 	dependencies {

docs/index.html

@@ -2159,6 +2159,15 @@ <h2>Portals &amp; Regions</h2>
 <ul>
 <li>Admins of the region can change the portal settings</li>
 <li>The visibility of the portal can be restricted to either players that have the portal permission or other portals that are in a region with the same region group.</li>
+</ul>
+<h2>Flight in Regions</h2>
+<p>Players with admin or friend roles in a region can fly within their claims using the <code>/fly</code> command.</p>
+<ul>
+<li>Upon entering a region where you have permissions, flight is automatically enabled—just double-jump to start flying.</li>
+<li>Use <code>/fly</code> to manually toggle flight on/off with visual feedback.</li>
+<li>Particle visualization shows region boundaries while flying, automatically updating when moving between regions.</li>
+<li>Fall damage protection is provided when exiting a region while airborne.</li>
+<li>Flight automatically disables when leaving the region or entering an area without permissions.</li>
 </ul></div>
 		<div class="clear-right"><!-- spacer --></div>
 	</div>
@@ -2440,7 +2449,7 @@ <h2 id="feature-vane-admin--graylist">
 </h2>
 <div id="body-feature-vane-admin--graylist" class="hidden">
 	<div class="p-5 border border-b-0 border-gray-200 dark:border-gray-700 dark:bg-gray-900">
-		<div class="prose prose-slate prose-img:rounded-xl prose-img:w-1/3 prose-img:sm:m-4 prose-img:w-full prose-img:sm:w-1/2 prose-img:lg:w-2/5 prose-img:min-w-32 prose-img:max-w-full prose-img:float-right prose-img:clear-right prose-h1:clear-right prose-h2:clear-right prose-img:float-right dark:prose-invert max-w-none"><h2>Graylist</h2>
+        <div class="prose prose-slate prose-img:rounded-xl prose-img:w-1/3 prose-img:sm:m-4 prose-img:w-full prose-img:sm:w-1/2 prose-img:lg:w-2/5 prose-img:min-w-32 prose-img:max-w-full prose-img:float-right prose-img:clear-right prose-h1:clear-right prose-h2:clear-right prose-img:float-right dark:prose-invert max-w-none"><h2>Graylist</h2>
 <p>Vane provides a feature similar to a graylist.
 This allows anyone to connect to your server but in a <em>no touch, only look!</em> kind of way.
 To modify anything about the world, a player must either be oped,
@@ -2451,6 +2460,12 @@ <h2 id="feature-vane-admin--graylist">
 <p>Why can't I build anything?</p>
 </blockquote>
 <p>This feature is <strong>disabled</strong> by default, as it often caused confusion.</p>
+<h3>Quick start</h3>
+<ul>
+<li>Enable in <code>vane-admin</code> config: set <code>world_protection.enabled: true</code>, then restart the server.</li>
+<li>Grant a newcomer build rights with <code>/perm add &lt;player&gt; user</code>.</li>
+<li>Or allow trusted members to vouch: give them <code>verified</code> via <code>/perm add &lt;player&gt; verified</code>, then they can <code>/vouch &lt;other_player&gt;</code>.</li>
+</ul>
 <h2>Vouching</h2>
 <p>When using <code>vane-permissions</code>, you can also allow trusted members of your community to vouch for other players.
 This allows them to lift a new user into the <code>users</code> group,

documentation/content/vane-admin/graylist.md

@@ -18,6 +18,18 @@ you can assign a new player to the `user` group by executing `perm add player_na
 
 This feature is **disabled** by default, as it often caused confusion.
 
+### Quick start
+
+- Enable in `vane-admin` config: set `world_protection.enabled: true`, then restart the server.
+- Grant a newcomer build rights with `/perm add <player> user`.
+- Or allow trusted members to vouch: give them `verified` via `/perm add <player> verified`, then they can `/vouch <other_player>`.
+
+### Commands
+
+- `/perm add <player> user` — allow building (bypasses graylist).
+- `/perm add <player> verified` — let a player vouch others.
+- `/vouch <player>` — move a player to the `user` group.
+
 ## Vouching
 
 When using `vane-permissions`, you can also allow trusted members of your community to vouch for other players.

documentation/content/vane-regions/regions.md

@@ -38,3 +38,13 @@ If a portal is inside a region, some additional things apply:
 
 - Admins of the region can change the portal settings
 - The visibility of the portal can be restricted to either players that have the portal permission or other portals that are in a region with the same region group.
+
+## Flight in Regions
+
+Players with admin or friend roles in a region can fly within their claims using the `/fly` command.
+
+- Upon entering a region where you have permissions, flight is automatically enabled—just double-jump to start flying.
+- Use `/fly` to manually toggle flight on/off with visual feedback.
+- Particle visualization shows region boundaries while flying, automatically updating when moving between regions.
+- Fall damage protection is provided when exiting a region while airborne.
+- Flight automatically disables when leaving the region or entering an area without permissions.

vane-core/build.gradle.kts

@@ -45,7 +45,7 @@ tasks {
             include(dependency("org.bstats:bstats-bukkit"))
             include(dependency("org.reflections:reflections"))
             include(dependency("org.json:json"))
-            include(dependency(":vane-annotations"))
+            include(project(":vane-annotations"))
             include(dependency("org.apache.commons:commons-lang3"))
             include(dependency("org.apache.commons:commons-text"))
         }

vane-portals/build.gradle.kts

@@ -7,8 +7,7 @@ dependencies {
 }
 
 tasks {
-    shadowJar {
-        configurations = listOf()
-        relocate("org.json", "org.oddlama.vane.external.json")
-    }
+	shadowJar {
+		// No special configuration needed
+	}
 }

vane-regions/build.gradle.kts

@@ -10,7 +10,8 @@ dependencies {
 
 tasks {
     shadowJar {
-        configurations = listOf()
-        relocate("org.json", "org.oddlama.vane.external.json")
+        dependencies {
+            include(dependency(":vane-portals"))
+        }
     }
 }