+ * Examples:
+ * accessible class net/minecraft/server/level/ServerPlayer
+ * accessible method net/minecraft/server/level/ServerPlayer getStats ()V
+ * mutable field net/minecraft/world/entity/Entity id I
+ * extendable class net/minecraft/world/level/chunk/LevelChunk
+ */
+public record AccessWidenerEntry(
+ /** accessible | mutable | extendable (may have "transitive-" prefix) */
+ String directive,
+ /** class | method | field */
+ String memberType,
+ /** Internal class name, e.g. net/minecraft/server/level/ServerPlayer */
+ String target,
+ /** Method/field name, null for class entries */
+ String name,
+ /** Descriptor, null for class entries */
+ String descriptor) {
+ /**
+ * Returns true if this entry targets the class with the given internal name.
+ */
+ public boolean targets(String internalName) {
+ return target.equals(internalName);
+ }
+}
+
diff --git a/AccessWidener/src/main/java/de/steamwar/AccessWidenerParser.java b/AccessWidener/src/main/java/de/steamwar/AccessWidenerParser.java
new file mode 100644
index 00000000..d962e0dc
--- /dev/null
+++ b/AccessWidener/src/main/java/de/steamwar/AccessWidenerParser.java
@@ -0,0 +1,104 @@
+/*
+ * This file is a part of the SteamWar software.
+ *
+ * Copyright (C) 2026 SteamWar.de-Serverteam
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU Affero General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU Affero General Public License for more details.
+ *
+ * You should have received a copy of the GNU Affero General Public License
+ * along with this program. If not, see
+ * Supported format: + *
+ * accessWidener v2 named + * + * # comments are supported + * accessible class net/minecraft/Foo + * accessible method net/minecraft/Foo someMethod ()V + * accessible field net/minecraft/Foo someField I + * mutable field net/minecraft/Foo someField I + * extendable class net/minecraft/Foo + * extendable method net/minecraft/Foo someMethod ()V + * + * # transitive variants (expose widening to dependents) + * transitive-accessible class net/minecraft/Foo + *+ */ +public final class AccessWidenerParser { + + private AccessWidenerParser() { + } + + public static List
+ * Also monitors for new plugin ClassLoaders appearing (when plugins load after
+ * the agent attaches) and automatically picks up their .accesswidener files.
+ */
+public class WideningTransformer implements ClassFileTransformer {
+
+ private static final Logger LOG = Logger.getLogger("WidenerTransformer");
+
+ private final Instrumentation instrumentation;
+
+ /**
+ * All entries collected across all plugins. Thread-safe for concurrent plugin loads.
+ */
+ private final ListUsage
+ * Call {@link #ensureAttached(Path)} from your plugin's {@code onLoad()} method
+ * (not {@code onEnable()} — onLoad fires before classes start loading):
+ *
+ * {@code
+ * public class MyPlugin extends JavaPlugin {
+ * @Override
+ * public void onLoad() {
+ * try {
+ * AccessWidenerAttacher.ensureAttached(getDataFolder());
+ * } catch (Exception e) {
+ * getSLF4JLogger().error("Failed to attach access widener agent", e);
+ * }
+ * }
+ * }
+ * }
+ *
+ * Resource file
+ * Drop a {@code plugin.accesswidener} file in your plugin's resources:
+ *
+ *
+ * accessWidener v2 named
+ *
+ * accessible method net/minecraft/server/level/ServerPlayer getStats ()V
+ * mutable field net/minecraft/world/entity/Entity id I
+ *
+ *
+ * The agent discovers it automatically via your plugin's ClassLoader.
+ */
+public final class AccessWidenerAttacher {
+
+ private static final Logger LOG = Logger.getLogger("AccessWidenerAttacher");
+ private static final Object LOCK = new Object();
+
+ private static volatile boolean attached = false;
+
+ private AccessWidenerAttacher() {}
+
+ /**
+ * Attaches the access widener agent to the running JVM if it has not already
+ * been attached. Safe to call from multiple plugins — the agent is only
+ * attached once.
+ *
+ * @param agentJar the agentJar
+ * @throws AccessWidenerException if the agent could not be attached
+ */
+ public static void ensureAttached(Path agentJar) throws AccessWidenerException {
+ if (attached) return; // fast path — no locking needed after first attach
+
+ synchronized (LOCK) {
+ if (attached) return; // double-checked
+
+ try {
+ attachAgent(agentJar);
+ attached = true;
+ LOG.info("[AccessWidener] Agent attached successfully.");
+ } catch (Exception e) {
+ throw new AccessWidenerException("Failed to attach access widener agent", e);
+ }
+ }
+ }
+
+ /** Returns true if the agent has been successfully attached. */
+ public static boolean isAttached() {
+ return attached;
+ }
+
+ private static void attachAgent(Path agentJar) throws Exception {
+ // Verify the Attach API is available before trying
+ try {
+ Class.forName("com.sun.tools.attach.VirtualMachine");
+ } catch (ClassNotFoundException e) {
+ throw new AccessWidenerException(
+ "The JDK Attach API is not available. "
+ + "Make sure you are running on a JDK (not a JRE) "
+ + "and add '--add-opens jdk.attach/sun.tools.attach=ALL-UNNAMED' "
+ + "to your JVM flags if on Java 9+.", e);
+ }
+
+ String pid = String.valueOf(ProcessHandle.current().pid());
+
+ // Use reflection so the Attach API is not a hard compile-time dependency
+ Class vmClass = Class.forName("com.sun.tools.attach.VirtualMachine");
+ Method attachMethod = vmClass.getMethod("attach", String.class);
+ Method loadAgentMethod = vmClass.getMethod("loadAgent", String.class);
+ Method detachMethod = vmClass.getMethod("detach");
+
+ Object vm = attachMethod.invoke(null, pid);
+ try {
+ loadAgentMethod.invoke(vm, agentJar.toAbsolutePath().toString());
+ } finally {
+ detachMethod.invoke(vm);
+ }
+ }
+
+ // -------------------------------------------------------------------------
+ // Exception type
+ // -------------------------------------------------------------------------
+
+ public static class AccessWidenerException extends Exception {
+ public AccessWidenerException(String message, Throwable cause) {
+ super(message, cause);
+ }
+ public AccessWidenerException(String message) {
+ super(message);
+ }
+ }
+}
diff --git a/buildSrc/src/steamwar.devserver.gradle b/buildSrc/src/steamwar.devserver.gradle
index 59e6cfbb..af6d224e 100644
--- a/buildSrc/src/steamwar.devserver.gradle
+++ b/buildSrc/src/steamwar.devserver.gradle
@@ -27,7 +27,6 @@ plugins {
class DevServer extends DefaultTask {
@Input
- @Optional
boolean debug = false
@Input
diff --git a/settings.gradle.kts b/settings.gradle.kts
index b84535d4..c3da5d8d 100644
--- a/settings.gradle.kts
+++ b/settings.gradle.kts
@@ -162,6 +162,10 @@ dependencyResolutionManagement {
}
}
+include(
+ "AccessWidener"
+)
+
include(
"BauSystem",
"BauSystem:BauSystem_Main",