From 980f73e7d285e78836227ac135b30816e67624a3 Mon Sep 17 00:00:00 2001 From: Michael Burgess Date: Sun, 9 Aug 2026 12:03:56 -0400 Subject: [PATCH] Narrow default frame-materials to just obsidian GOLD_BLOCK/GILDED_BLACKSTONE/BIRCH_PLANKS/OAK_PLANKS were also present on a nearby backdrop wall in the user's build, so even with the plane-locked diagonal fix (which only stops leaks through the ring's thickness), the flood-fill could still sweep in decorative use of the same materials sitting in-plane with the ring, putting chevrons on unrelated blocks. Default is now just OBSIDIAN; anyone mixing materials should keep the list to ring-only blocks per the updated config.yml/README guidance. --- README.md | 16 +++++++++++----- stargate-paper/src/main/resources/config.yml | 19 ++++++++----------- 2 files changed, 19 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index b5d309e..2ba6256 100644 --- a/README.md +++ b/README.md @@ -17,11 +17,17 @@ Build everything with `./gradlew build`. Jars land in each module's `build/libs/ ## Building a gate There's no fixed size or shape - build any single connected ring out of -`gate.frame-materials` (default: obsidian, gold block, gilded blackstone, birch/oak -planks) with a fully sealed hollow interior. No gaps; the interior must be enclosed. -"Connected" includes the usual diagonal stepping a round/octagonal ring needs at its -corners (blocks touching only edge-to-edge or corner-to-corner still count), so a -circular build doesn't need every block to share a full face with the next. +`gate.frame-materials` (default: just obsidian) with a fully sealed hollow interior. +No gaps; the interior must be enclosed. "Connected" includes the usual diagonal +stepping a round/octagonal ring needs at its corners (blocks touching only +edge-to-edge or corner-to-corner still count), so a circular build doesn't need every +block to share a full face with the next. + +Add more materials to `gate.frame-materials` if your ring mixes blocks, but keep the +list to materials used *only* for the ring - anything also used decoratively nearby +(a backdrop wall, a matching accent elsewhere) risks getting swept into the frame if +it touches the ring anywhere in the same plane, which is also where stray chevrons +would show up. Build it free-standing, one block thick, in a single flat plane (a vertical ring facing a direction, like all the examples above) - the plugin figures out which axis diff --git a/stargate-paper/src/main/resources/config.yml b/stargate-paper/src/main/resources/config.yml index de88596..2650ba5 100644 --- a/stargate-paper/src/main/resources/config.yml +++ b/stargate-paper/src/main/resources/config.yml @@ -28,19 +28,16 @@ cross-server: gate: # Any of these materials count as the ring's frame (and count as a valid chevron # material too, since chevrons are just frame blocks the plugin temporarily swaps). - # Mix and match to match your build (the default matches an obsidian/gilded-blackstone - # ring). The ring can be any size or shape, as long as it's a single connected loop - # made only of these materials with a fully sealed hollow interior - no fixed template - # or size is required. "Connected" includes diagonal stepping (round rings need that - # at their corners), but only within the ring's own flat plane - a nearby structure - # built from the same materials won't get pulled in just because it touches the ring - # through its thickness. + # Add to this list to match your build - but keep it to materials that are ONLY + # used for the ring itself. Anything also used decoratively nearby (a backdrop + # wall, a matching accent block elsewhere) risks the flood-fill picking up that + # unrelated structure as part of the frame if it touches the ring anywhere in the + # same plane. The ring can be any size or shape, as long as it's a single connected + # loop with a fully sealed hollow interior - no fixed template or size is required. + # "Connected" includes diagonal stepping (round rings need that at their corners), + # but only within the ring's own flat plane. frame-materials: - OBSIDIAN - - GOLD_BLOCK - - GILDED_BLACKSTONE - - BIRCH_PLANKS - - OAK_PLANKS # Chevrons aren't a separate material you place. The plugin flood-fills the ring, # walks it in geometric order, and picks this many blocks, evenly spaced around the # ring's actual perimeter (not raw scan order) - then swaps just those to