Ignore JVM segfault log files

This commit changes the following things inside the logging infrastructure:
- passing issuerClass, issuerOrigin and issuerMetadata is no longer required, relevant information is now being pulled from the stack
- split huge classes into multiple smaller ones
- separated "normal" and asynchronous logging classes
- simplified logging
- improved performance
- more detailed crash reporting
- regex-based filtering
- internal placeholders have been replaced with more lightweight method calls
- much more changes

.gitignore

@@ -42,3 +42,6 @@ bin/
 
 ### Mac OS ###
 .DS_Store
+
+### Java ###
+hs_err_pid*.log

.idea/copyright/sos_engine.xml

@@ -1,7 +1,7 @@
 <component name="CopyrightManager">
   <copyright>
-    <option name="allowReplaceRegexp" value="Copyright .* The StarOpenSource Engine Contributors" />
+    <option name="allowReplaceRegexp" value="Copyright .* The StarOpenSource Engine Authors" />
     <option name="notice" value="STAROPENSOURCE ENGINE SOURCE FILE&#10;Copyright (c) &amp;#36;today.year The StarOpenSource Engine Authors&#10;Licensed under the GNU Affero General Public License v3&#10;&#10;This program is free software: you can redistribute it and/or modify&#10;it under the terms of the GNU Affero General Public License as&#10;published by the Free Software Foundation, either version 3 of the&#10;License, or (at your option) any later version.&#10;&#10;This program is distributed in the hope that it will be useful,&#10;but WITHOUT ANY WARRANTY; without even the implied warranty of&#10;MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the&#10;GNU Affero General Public License for more details.&#10;&#10;You should have received a copy of the GNU Affero General Public License&#10;along with this program.  If not, see &lt;https://www.gnu.org/licenses/&gt;." />
     <option name="myName" value="sos!engine" />
   </copyright>
-</component>
+</component>

ansi/build.gradle

@@ -1,6 +1,6 @@
 /*
  * STAROPENSOURCE ENGINE SOURCE FILE
- * Copyright (c) 2024 The StarOpenSource Engine Contributors
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
  * Licensed under the GNU Affero General Public License v3
  *
  * This program is free software: you can redistribute it and/or modify
@@ -16,6 +16,7 @@
  * You should have received a copy of the GNU Affero General Public License
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
+
 // Plugins
 plugins {
     id("java")
@@ -23,9 +24,8 @@ plugins {
     id("maven-publish")
 }
 
-// Project dependencies
+// Dependencies
 dependencies {
-    // -> Runtime <-
     // Lombok
     compileOnly("org.projectlombok:lombok:${dependencyLombok}")
     annotationProcessor("org.projectlombok:lombok:${dependencyLombok}")
@@ -33,36 +33,11 @@ dependencies {
     // JetBrains Annotations
     compileOnly("org.jetbrains:annotations:${dependencyJetbrainsAnnotations}")
 
-    // ANSI support
+    // Jansi
     implementation("org.fusesource.jansi:jansi:${dependencyJansi}")
 
     // Project
     implementation(project(":base"))
-
-    // -> Testing <-
-    // Jetbrains Annotations
-    testCompileOnly("org.jetbrains:annotations:${dependencyJetbrainsAnnotations}")
-
-    // JUnit
-    testImplementation(platform("org.junit:junit-bom:${dependencyJunit}"))
-    testImplementation("org.junit.jupiter:junit-jupiter")
-    testRuntimeOnly("org.junit.platform:junit-platform-launcher")
-}
-
-// Fix delombok task
-delombok.doFirst {
-    File target = file("${project.projectDir}/src/main/module-info.java")
-    File source = file("${project.projectDir}/src/main/java/module-info.java")
-
-    target.delete()
-    source.renameTo(target)
-}
-delombok.doLast {
-    File target = file("${project.projectDir}/src/main/java/module-info.java")
-    File source = file("${project.projectDir}/src/main/module-info.java")
-
-    target.delete()
-    source.renameTo(target)
 }
 
 // Javadoc configuration
@@ -88,26 +63,6 @@ javadoc {
     }
 }
 
-// Unit testing configuration
-test {
-    useJUnitPlatform()
-
-    // Pass test configuration to test VMs
-    Map<String, String> testConfiguration = new HashMap<>();
-    for (String property : project.properties.keySet())
-        if (property.startsWith("test."))
-            testConfiguration.put(property, project.properties.get(property).toString())
-    systemProperties(testConfiguration)
-
-    setMaxParallelForks(project.hasProperty("jobs") ? Integer.parseInt((String) project.property("jobs")) : 8)
-    setForkEvery(1)
-    setFailFast(true)
-
-    testLogging {
-        events("passed", "skipped", "failed")
-    }
-}
-
 // Include javadoc and source jar during publishing
 java {
     withJavadocJar()
@@ -120,7 +75,7 @@ publishing {
     repositories {
         maven {
             name = "staropensource"
-            url = uri("https://mvn.staropensource.de/sosengine")
+            url = uri("https://mvn.staropensource.de/engine")
             credentials(org.gradle.api.credentials.PasswordCredentials)
             authentication {
                 //noinspection GroovyAssignabilityCheck
@@ -139,3 +94,19 @@ publishing {
         }
     }
 }
+
+// Fix delombok task
+delombok.doFirst {
+    File target = file("${project.projectDir}/src/main/module-info.java")
+    File source = file("${project.projectDir}/src/main/java/module-info.java")
+
+    target.delete()
+    source.renameTo(target)
+}
+delombok.doLast {
+    File target = file("${project.projectDir}/src/main/java/module-info.java")
+    File source = file("${project.projectDir}/src/main/module-info.java")
+
+    target.delete()
+    source.renameTo(target)
+}

ansi/src/main/java/de/staropensource/engine/ansi/AnsiLoggingAdapter.java

@@ -17,16 +17,15 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.ansi;
+package de.staropensource.engine.ansi;
 
-import de.staropensource.sosengine.base.EngineConfiguration;
-import de.staropensource.sosengine.base.implementable.LoggingAdapter;
-import de.staropensource.sosengine.base.logging.Logger;
-import de.staropensource.sosengine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.EngineConfiguration;
+import de.staropensource.engine.base.implementable.LoggingAdapter;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.logging.LogLevel;
 import org.fusesource.jansi.Ansi;
 import org.fusesource.jansi.AnsiConsole;
 import org.jetbrains.annotations.NotNull;
-import org.jetbrains.annotations.Nullable;
 
 /**
  * Prints colored log output using the Jansi library.
@@ -37,34 +36,22 @@ import org.jetbrains.annotations.Nullable;
  */
 public class AnsiLoggingAdapter implements LoggingAdapter {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this class.
      *
      * @since v1-alpha2
      */
     public AnsiLoggingAdapter() {}
 
-    /** {@inheritDoc} */
-    @Override
-    public @NotNull String prePlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return format;  // No modifications necessary
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public @NotNull String postPlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return format;  // No modifications necessary
-    }
-
     /** {@inheritDoc} */
     @Override
     @SuppressWarnings({ "resource" })  // Using try-with-resources will cause issues here
-    public void print(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
+    public void print(@NotNull LogLevel level, @NotNull StackTraceElement issuer, @NotNull String message, @NotNull String format) {
         // Convert to Ansi
-        Ansi output = new AnsiShortcodeConverter(format, true).getAnsi();
+        Ansi output = new AnsiShortcodeParser(format, true).getAnsi();
 
         // Print message
         if (level == LogLevel.ERROR || level == LogLevel.CRASH)
-            if (EngineConfiguration.getInstance().isLoggerForceStandardOutput())
+            if (EngineConfiguration.getInstance().isLogForceStandardOutput())
                 AnsiConsole.out().println(output);
             else
                 AnsiConsole.err().println(output);

ansi/src/main/java/de/staropensource/engine/ansi/AnsiShortcodeParser.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.ansi;
+package de.staropensource.engine.ansi;
 
-import de.staropensource.sosengine.base.implementable.ShortcodeParser;
-import de.staropensource.sosengine.base.exception.ParserException;
+import de.staropensource.engine.base.implementable.ShortcodeParser;
+import de.staropensource.engine.base.exception.ParserException;
 import org.fusesource.jansi.Ansi;
 import org.jetbrains.annotations.NotNull;
 
@@ -28,21 +28,22 @@ import java.util.HashSet;
 import java.util.Set;
 
 /**
- * Converts shortcodes such as {@code <bold>} or {@code <blink>} into a usable {@link Ansi} escape sequence.
+ * Implementation of the {@link ShortcodeParser} class
+ * with ANSI support using the Jansi library.
  *
  * @see ShortcodeParser
- * @since v1-alpha2
+ * @since v1-alpha8
  */
-public final class AnsiShortcodeConverter extends ShortcodeParser {
+public final class AnsiShortcodeParser extends ShortcodeParser {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this class.
      *
      * @param string               string to convert
      * @param ignoreInvalidEscapes will ignore invalid escapes and print treat them like regular text
      * @throws ParserException when parsing failed
      * @since v1-alpha2
      */
-    public AnsiShortcodeConverter(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
+    public AnsiShortcodeParser(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
         super(string, ignoreInvalidEscapes);
     }
 

ansi/src/main/java/de/staropensource/engine/ansi/AnsiSubsystem.java

@@ -17,19 +17,19 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.ansi;
+package de.staropensource.engine.ansi;
 
-import de.staropensource.sosengine.base.annotation.EngineSubsystem;
-import de.staropensource.sosengine.base.implementable.SubsystemClass;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
-import de.staropensource.sosengine.base.implementation.versioning.StarOpenSourceVersioningSystem;
-import de.staropensource.sosengine.base.logging.Logger;
-import de.staropensource.sosengine.base.type.DependencyVector;
+import de.staropensource.engine.base.annotation.EngineSubsystem;
+import de.staropensource.engine.base.implementable.SubsystemClass;
+import de.staropensource.engine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementation.versioning.StarOpenSourceVersioningSystem;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.DependencyVector;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Main object for the ANSI Compatibility subsystem.
+ * Main class of the ANSI Compatibility subsystem.
  *
  * @since v1-alpha2
  */
@@ -50,7 +50,7 @@ public final class AnsiSubsystem extends SubsystemClass {
     private static AnsiSubsystem instance = null;
 
     /**
-     * Constructs this subsystem.
+     * Initializes this subsystem.
      *
      * @since v1-alpha2
      */
@@ -59,7 +59,7 @@ public final class AnsiSubsystem extends SubsystemClass {
         if (instance == null)
             instance = this;
         else
-            logger.crash("Only one instance of this class is allowed, use getInstance() instead of creating a new instance");
+            Logger.crash("Only one instance of this class is allowed, use getInstance() instead of creating a new instance");
     }
 
     /** {@inheritDoc} */

ansi/src/main/java/de/staropensource/engine/ansi/package-info.java

@@ -20,4 +20,4 @@
 /**
  * Contains the ANSI subsystem code.
  */
-package de.staropensource.sosengine.ansi;
+package de.staropensource.engine.ansi;

ansi/src/main/java/module-info.java

@@ -6,22 +6,18 @@
  */
 module sosengine.ansi {
     // Dependencies
-    // -> Java <-
+    // -> Java
     requires transitive java.management;
-
-    // -> Engine <-
+    // -> Engine
     requires transitive sosengine.base;
-
-    // -> Common stuff <-
+    // -> Libraries
     requires transitive static lombok;
     requires transitive org.jetbrains.annotations;
-
-    // -> Subystem-specific dependencies <-
     requires org.fusesource.jansi;
 
     // API access
-    exports de.staropensource.sosengine.ansi;
+    exports de.staropensource.engine.ansi;
 
     // Reflection access
-    opens de.staropensource.sosengine.ansi;
+    opens de.staropensource.engine.ansi;
 }

ansi/src/main/javadoc/overview.html

@@ -1,6 +1,6 @@
 <!--
   ~ STAROPENSOURCE ENGINE SOURCE FILE
-  ~ Copyright (c) 2024 The StarOpenSource Engine Contributors
+  ~ Copyright (c) 2024 The StarOpenSource Engine Authors
   ~ Licensed under the GNU Affero General Public License v3
   ~
   ~ This program is free software: you can redistribute it and/or modify

base/build.gradle

@@ -1,6 +1,6 @@
 /*
  * STAROPENSOURCE ENGINE SOURCE FILE
- * Copyright (c) 2024 The StarOpenSource Engine Contributors
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
  * Licensed under the GNU Affero General Public License v3
  *
  * This program is free software: you can redistribute it and/or modify
@@ -26,9 +26,9 @@ plugins {
     id("maven-publish")
 }
 
-// Project dependencies
+// Dependencies
 dependencies {
-    // -> Runtime <-
+    // -> Runtime
     // Lombok
     compileOnly("org.projectlombok:lombok:${dependencyLombok}")
     annotationProcessor("org.projectlombok:lombok:${dependencyLombok}")
@@ -39,7 +39,7 @@ dependencies {
     // Reflections
     implementation("org.reflections:reflections:${dependencyReflections}")
 
-    // -> Testing <-
+    // -> Testing
     // Jetbrains Annotations
     testCompileOnly("org.jetbrains:annotations:${dependencyJetbrainsAnnotations}")
 
@@ -48,65 +48,10 @@ dependencies {
     testImplementation("org.junit.jupiter:junit-jupiter")
     testRuntimeOnly("org.junit.platform:junit-platform-launcher")
 
-    // -> Project <-
+    // Project
     testImplementation(project(":testing"))
 }
 
-// Fix delombok task
-delombok.doFirst {
-    File target = file("${project.projectDir}/src/main/module-info.java")
-    File source = file("${project.projectDir}/src/main/java/module-info.java")
-
-    target.delete()
-    source.renameTo(target)
-}
-delombok.doLast {
-    File target = file("${project.projectDir}/src/main/java/module-info.java")
-    File source = file("${project.projectDir}/src/main/module-info.java")
-
-    target.delete()
-    source.renameTo(target)
-}
-
-// Copy gradle.properties file
-// for inclusion in final build
-tasks.register("copyGradleProperties") {
-    doFirst {
-        File target = file("${project.projectDir}/src/main/resources/sosengine-gradle.properties")
-        File source = file(project(":").projectDir.getPath() + "/gradle.properties")
-        target.delete()
-        Files.copy(source.toPath(), target.toPath())
-    }
-
-    outputs.upToDateWhen({ false })  // Force task execution
-}
-processResources.dependsOn(copyGradleProperties)
-
-// Git properties configuration
-// Allows us to embed git commit information in the engine build
-gitProperties {
-    dotGitDirectory = file("${rootProject.rootDir}/.git")
-    failOnNoGitDirectory = false  // Allow continuing if .git directory is missing for the few who use tarballs
-    extProperty = "gitProps"
-
-    dateFormat = "yyyy-MM-dd'T'HH:mmZ"
-    dateFormatTimeZone = "UTC"
-}
-
-tasks.register("writeGitProperties") {  // This task's only purpose is to copy the git.properties from our git properties plugin to the resources directory so it's included in the final build
-    doLast {
-        File target = file("${project.projectDir}/src/main/resources/sosengine-git.properties")
-        File source = file("${project.projectDir}/build/resources/main/git.properties")
-
-        target.delete()
-        source.renameTo(target)
-    }
-
-    outputs.upToDateWhen({ false })  // Force task execution
-}
-generateGitProperties.outputs.upToDateWhen({ false })  // Force task execution
-processResources.dependsOn(writeGitProperties)  // Ensure git.properties file is present
-
 // Javadoc configuration
 javadoc {
     outputs.upToDateWhen { false }  // Force task execution
@@ -162,7 +107,7 @@ publishing {
     repositories {
         maven {
             name = "staropensource"
-            url = uri("https://mvn.staropensource.de/sosengine")
+            url = uri("https://mvn.staropensource.de/engine")
             credentials(org.gradle.api.credentials.PasswordCredentials)
             authentication {
                 //noinspection GroovyAssignabilityCheck
@@ -181,3 +126,58 @@ publishing {
         }
     }
 }
+
+// Copy gradle.properties file
+// for inclusion in final build
+tasks.register("copyGradleProperties") {
+    doFirst {
+        File target = file("${project.projectDir}/src/main/resources/sosengine-gradle.properties")
+        File source = file(project(":").projectDir.getPath() + "/gradle.properties")
+        target.delete()
+        Files.copy(source.toPath(), target.toPath())
+    }
+
+    outputs.upToDateWhen({ false })  // Force task execution
+}
+processResources.dependsOn(copyGradleProperties)
+
+// Git properties configuration
+// Allows us to embed git commit information in the engine build
+gitProperties {
+    dotGitDirectory = file("${rootProject.rootDir}/.git")
+    failOnNoGitDirectory = false  // Allow continuing if .git directory is missing for the few who use tarballs
+    extProperty = "gitProps"
+
+    dateFormat = "yyyy-MM-dd'T'HH:mmZ"
+    dateFormatTimeZone = "UTC"
+}
+
+tasks.register("writeGitProperties") {  // This task's only purpose is to copy the git.properties from our git properties plugin to the resources directory so it's included in the final build
+    doLast {
+        File target = file("${project.projectDir}/src/main/resources/sosengine-git.properties")
+        File source = file("${project.projectDir}/build/resources/main/git.properties")
+
+        target.delete()
+        source.renameTo(target)
+    }
+
+    outputs.upToDateWhen({ false })  // Force task execution
+}
+generateGitProperties.outputs.upToDateWhen({ false })  // Force task execution
+processResources.dependsOn(writeGitProperties)  // Ensure git.properties file is present
+
+// Fix delombok task
+delombok.doFirst {
+    File target = file("${project.projectDir}/src/main/module-info.java")
+    File source = file("${project.projectDir}/src/main/java/module-info.java")
+
+    target.delete()
+    source.renameTo(target)
+}
+delombok.doLast {
+    File target = file("${project.projectDir}/src/main/java/module-info.java")
+    File source = file("${project.projectDir}/src/main/module-info.java")
+
+    target.delete()
+    source.renameTo(target)
+}

base/src/main/java/de/staropensource/engine/base/Engine.java

@@ -17,27 +17,31 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base;
+package de.staropensource.engine.base;
 
-import de.staropensource.sosengine.base.annotation.EngineSubsystem;
-import de.staropensource.sosengine.base.implementable.ShutdownHandler;
-import de.staropensource.sosengine.base.implementable.SubsystemClass;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
-import de.staropensource.sosengine.base.utility.information.JvmInformation;
-import de.staropensource.sosengine.base.implementation.versioning.StarOpenSourceVersioningSystem;
-import de.staropensource.sosengine.base.event.*;
-import de.staropensource.sosengine.base.exception.IllegalAccessException;
-import de.staropensource.sosengine.base.exception.dependency.UnmetDependenciesException;
-import de.staropensource.sosengine.base.internal.event.InternalEngineShutdownEvent;
-import de.staropensource.sosengine.base.internal.type.DependencySubsystemVector;
-import de.staropensource.sosengine.base.logging.*;
-import de.staropensource.sosengine.base.type.DependencyVector;
-import de.staropensource.sosengine.base.type.EngineState;
-import de.staropensource.sosengine.base.type.immutable.ImmutableLinkedList;
-import de.staropensource.sosengine.base.utility.DependencyResolver;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
-import de.staropensource.sosengine.base.utility.PlaceholderEngine;
+import de.staropensource.engine.base.annotation.EngineSubsystem;
+import de.staropensource.engine.base.event.*;
+import de.staropensource.engine.base.exception.IllegalAccessException;
+import de.staropensource.engine.base.exception.dependency.UnmetDependenciesException;
+import de.staropensource.engine.base.implementable.ShutdownHandler;
+import de.staropensource.engine.base.implementable.SubsystemClass;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementation.versioning.StarOpenSourceVersioningSystem;
+import de.staropensource.engine.base.event.InternalEngineShutdownEvent;
+import de.staropensource.engine.base.internal.type.DependencySubsystemVector;
+import de.staropensource.engine.base.logging.PrintStreamService;
+import de.staropensource.engine.base.logging.*;
+import de.staropensource.engine.base.logging.backend.async.LoggingQueue;
+import de.staropensource.engine.base.logging.backend.async.LoggingThread;
+import de.staropensource.engine.base.type.DependencyVector;
+import de.staropensource.engine.base.type.EngineState;
+import de.staropensource.engine.base.type.immutable.ImmutableLinkedList;
+import de.staropensource.engine.base.utility.DependencyResolver;
+import de.staropensource.engine.base.utility.FileAccess;
+import de.staropensource.engine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.utility.PlaceholderEngine;
+import de.staropensource.engine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.utility.information.JvmInformation;
 import lombok.AccessLevel;
 import lombok.Getter;
 import lombok.Setter;
@@ -56,7 +60,6 @@ import java.util.*;
  * @see EngineConfiguration
  * @since v1-alpha0
  */
-@EngineSubsystem
 @SuppressWarnings({ "JavadocDeclaration" })
 public final class Engine extends SubsystemClass {
     /**
@@ -85,14 +88,6 @@ public final class Engine extends SubsystemClass {
     @Getter
     private static final ThreadGroup threadGroup = new ThreadGroup("sos!engine");
 
-    /**
-     * Contains the {@link LoggerInstance} for this instance.
-     *
-     * @see LoggerInstance
-     * @since v1-alpha0
-     */
-    private static final LoggerInstance logger = new LoggerInstance.Builder().setClazz(Engine.class).setOrigin("ENGINE").setMetadata(EngineInformation.getVersioningCodename()).build();
-
     /**
      * Contains the engine state.
      *
@@ -104,7 +99,7 @@ public final class Engine extends SubsystemClass {
      * @since v1-alpha2
      */
     @Getter
-    private @NotNull EngineState state = EngineState.UNKNOWN;
+    private @NotNull EngineState state;
 
     /**
      * Contains a list of all registered subsystems.
@@ -170,151 +165,194 @@ public final class Engine extends SubsystemClass {
                 }
 
                 // Print warning about shutdown
-                logger.warn("Trying to shut down engine using shutdown hook.\nThis approach to shutting down the engine and JVM is NOT RECOMMENDED, please use Engine#shutdown() instead.");
+                Logger.warn("Trying to shut down engine using shutdown hook.\nThis approach to shutting down the engine and JVM is NOT RECOMMENDED, please use Engine#shutdown() instead.");
 
                 // Shutdown
                 Engine.getInstance().shutdown();
 
                 // Print last message
-                InitLogger.warn(getClass(), "ENGINE", EngineInformation.getVersioningCodename(), "Engine successfully shut down using shutdown hook. PLEASE USE Engine#shutdown() INSTEAD OF System#exit() or Runtime#exit()!");
+                Logger.warn("Engine successfully shut down using shutdown hook. PLEASE USE Engine#shutdown() INSTEAD OF System#exit() or Runtime#exit()!");
             });
 
     /**
      * Initializes the StarOpenSource Engine.
      *
-     * @throws IllegalStateException when running in an incompatible environment
-     * @since v1-alpha0
+     * @throws RuntimeException for all exceptions thrown by this constructor
+     * @since v1-alpha8
      */
-    public Engine() throws IllegalStateException {
-        if (instance == null)
+    private Engine() throws RuntimeException {
+        try {
             instance = this;
-        else
-            return;
-
-        long initTime = Miscellaneous.measureExecutionTime(() -> {
             state = EngineState.EARLY_STARTUP;
 
+            // For measuring the initialization time
+            long initTimeEarly = System.currentTimeMillis();
+            long initTimeLate = initTimeEarly;
+
+            // Check for incompatible JVM implementations
+            checkJvmIncompatibilities();
+
+            // Display that the engine is initializing
+            Logger.verb("Initializing engine");
+
+            // Start the logging thread
+            Logger.diag("Starting logging infrastructure");
+            LoggingThread.startThread(false);
+            PrintStreamService.initializeStreams();
+
+            // Initialize EngineInternals
+            Logger.diag("Initializing EngineInternals class");
+            new EngineInternals();
+
+            // Load engine configuration
+            Logger.diag("Loading engine configuration");
             new EngineConfiguration();
             EngineConfiguration.getInstance().loadConfiguration();
 
-            logger.info("Initializing engine");
-            initializeClasses();         // Initialize classes
-            if (checkEnvironment())      // Check environment
-                throw new IllegalStateException("Running in an incompatible environment");
-            ensureEnvironment();         // Prepare the environment and ensure safety
-            populateCrashContent();      // Populate crash content
-            cacheEvents();               // Cache event listeners
-            startThreads();              // Start threads
+            // Load engine build information
+            Logger.diag("Loading engine build information");
+            EngineInformation.update();
 
-            logger.verb("Completing early initialization stage");
+            // Check for reflective classpath scanning compatibility
+            checkReflectiveClasspathScanningCompatibility();
+
+            // Check for Java version incompatibilities
+            checkJavaVersion();
+
+            // Initialize PlaceholderEngine
+            Logger.diag("Initializing PlaceholderEngine");
+            PlaceholderEngine.initialize();
+
+            // Initialize static FileAccess instances
+            Logger.diag("Initializing static FileAccess instances");
+            FileAccess.initializeInstances();
+
+            // Install the safety shutdown hook
+            Logger.diag("Installing safety shutdown hook");
+            EngineInternals.getInstance().installSafetyShutdownHook(true);
+
+            // Cache events
+            Logger.diag("Caching event listeners");
+            cacheEvents();
+
+            // Complete early initialization stage
+            Logger.verb("Completing early initialization stage");
             state = EngineState.STARTUP;
+            initTimeEarly = System.currentTimeMillis() - initTimeEarly;
 
             // Perform automatic subsystem initialization
-            if (EngineConfiguration.getInstance().isOptimizeSubsystemInitialization()) {
-                collectSubsystems();  // Collect subsystems
+            if (EngineConfiguration.getInstance().isInitialPerformSubsystemInitialization()) {
+                // Collect all subsystems
+                Logger.diag("Collecting subsystems");
+                collectSubsystems();
 
                 // Initialize subsystems
                 try {
                     initializeSubsystems();
                 } catch (Exception exception) {
-                    logger.crash("Subsystem dependency resolution failed", exception);
+                    Logger.error("Subsystem dependency resolution failed");
                 }
             }
-        });
 
-        logger.verb("Completing late initialization stage");
-        state = EngineState.RUNNING;
-        logger.info("Initialized sos!engine %engine_version% (commit %engine_git_commit_id_long%-%engine_git_branch%, dirty %engine_git_dirty%) in " + initTime + "ms\nThe StarOpenSource Engine is licensed under the GNU AGPL v3. Copyright (c) 2024 The StarOpenSource Engine Authors.");
+            // Complete late initialization stage
+            Logger.verb("Completing late initialization stage");
+            state = EngineState.RUNNING;
+            initTimeLate = System.currentTimeMillis() - initTimeLate;
+
+            // Print welcome message
+            Logger.info(
+                    """
+                    Welcome to the StarOpenSource Engine "%engine_version_codename%" %engine_version%!
+                    Running commit %engine_git_commit_id_long% (dirty %engine_git_dirty%).
+                    Initialization took %init_time_total%ms (early %init_time_early%ms, late %init_time_late%ms).
+                    
+                    Copyright (c) 2024 The StarOpenSource Engine Authors
+                    Licensed under the GNU Affero General Public License v3"""
+                            .replace("%init_time_total%", String.valueOf(initTimeEarly + initTimeLate))
+                            .replace("%init_time_early%", String.valueOf(initTimeEarly))
+                            .replace("%init_time_late%", String.valueOf(initTimeLate))
+            );
+        } catch (Exception exception) {
+            throw new RuntimeException(exception);
+        }
     }
 
     /**
-     * Initializes all classes.
+     * Initializes the StarOpenSource
+     * Engine, if it isn't already.
      *
-     * @since v1-alpha0
+     * @throws IllegalStateException when running in an incompatible environment
+     * @throws RuntimeException      on engine initialization failure
+     * @since v1-alpha6
      */
-    private void initializeClasses() {
-        logger.verb("Initializing engine classes");
-        new EngineInternals();
-        new PlaceholderEngine();
+    public static void initialize() throws RuntimeException {
+        try {
+            if (instance == null)
+                new Engine();
+        } catch (RuntimeException exception) {
+            Logger.error("Engine initialization failed");
+            Logger.error(Miscellaneous.getStackTraceHeader(exception.getCause()));
+            for (String line : Miscellaneous.getStackTraceAsString(exception.getCause(), true).split("\n"))
+                Logger.error(line);
 
-        EngineInformation.update();
-        PrintStreamService.initializeStreams();
+            throw new RuntimeException("Engine initialization failed", exception.getCause());
+        }
     }
 
     /**
-     * Checks if the environment is compatible with the engine build.
+     * Checks if the running JVM implementation is not supported by the engine.
      *
-     * @since v1-alpha4
+     * @since v1-alpha8
      */
-    private boolean checkEnvironment() {
-        logger.diag("Checking environment");
+    private void checkJvmIncompatibilities() {
+        if (System.getProperties().getProperty("sosengine.base.allowUnsupportedJVMInitialization", "false").equals("true")) {
+            Logger.warn("Skipping JVM implementation incompatibilities check");
+            return;
+        }
 
+        // Substrate VM (GraalVM Community)
+        if (JvmInformation.getImplementationName().equals("Substrate VM") && JvmInformation.getImplementationVendor().equals("GraalVM Community")) {
+            Logger.error("##############################################################################################");
+            Logger.error("## Running in Substrate VM, which is the name of the JVM used by GraalVM native-image.      ##");
+            Logger.error("## The StarOpenSource Engine does not support native-image as using reflection in a certain ##");
+            Logger.error("## way seems to cause the Substrate JVM to crash. Workarounds have failed.                  ##");
+            Logger.error("## This has already been noted in issue #3, which you can view here:                        ##");
+            Logger.error("## https://git.staropensource.de/StarOpenSource/Engine/issues/3                             ##");
+            Logger.error("##                                                                                          ##");
+            Logger.error("## While this is sad, we unfortunately can't do anything against it unless we introduce     ##");
+            Logger.error("## annoying and stupid changes into the engine, which we don't want to do.                  ##");
+            Logger.error("##                                                                                          ##");
+            Logger.error("## We're truly sorry for this inconvenience. The sos!engine will now terminate.             ##");
+            Logger.error("##############################################################################################");
+            Runtime.getRuntime().exit(255);
+        }
+    }
+
+    /**
+     * Checks if reflective classpath scanning is supported.
+     *
+     * @since v1-alpha8
+     */
+    private void checkReflectiveClasspathScanningCompatibility() {
+        // Check if reflective classpath scanning is supported
+        if (System.getProperties().getProperty("sosengine.base.considerEnvironmentUnfriendlyToClasspathScanning", "false").equals("true")) {
+            Logger.warn("Running in an classpath scanning-unfriendly environment, disabling classpath scanning support.");
+            Logger.warn("If shit doesn't work and is expected to be discovered by annotations, you'll need to");
+            Logger.warn("either register it first or have to update some engine configuration setting.");
+            Logger.warn("Please consult sos!engine's documentation for more information about this issue.");
+            EngineInternals.getInstance().overrideReflectiveClasspathScanning(false);
+        }
+    }
+
+    /**
+     * Checks and warns if the Java version of the
+     * running JVM is higher than the engine supports.
+     *
+     * @since v1-alpha8
+     */
+    private void checkJavaVersion() {
         if (JvmInformation.getJavaVersion() > EngineInformation.getJavaSource())
-            logger.warn("The StarOpenSource Engine is running on an untested Java version.\nThings may not work as expected or features which can improve performance, stability, compatibility or ease of use may be missing.\nIf you encounter issues, try running a JVM implementing Java " + EngineInformation.getJavaSource());
-
-        return false;
-    }
-
-    /**
-     * Ensures the execution safety of the environment.
-     *
-     * @since v1-alpha4
-     */
-    private void ensureEnvironment() {
-        EngineInternals.getInstance().installSafetyShutdownHook(true);
-    }
-
-    /**
-     * This method populates {@link CrashHandler#crashContent} with content.
-     *
-     * @see CrashHandler#getCrashContent()
-     * @since v1-alpha0
-     */
-    @SuppressWarnings({ "ExtractMethodRecommender" })
-    private void populateCrashContent() {
-        logger.diag("Populating crash content");
-
-        // Issuer
-        Map<@NotNull String, @NotNull String> crashContentIssuer = new LinkedHashMap<>();
-        crashContentIssuer.put("Code part", "%issuer_origin%");
-        crashContentIssuer.put("Classpath", "%issuer_path%");
-        crashContentIssuer.put("Additional information", "%issuer_metadata%");
-        crashContentIssuer.put("Message", "%crash_message%");
-
-        // Engine -> Dependencies
-        LinkedList<@NotNull String> crashContentEngineDependencies = new LinkedList<>();
-        crashContentEngineDependencies.add("Subsystem  'base': Reflections: %engine_dependency_reflections%");
-        crashContentEngineDependencies.add("Subsystem  'ansi': Jansi: %engine_dependency_jansi%");
-        crashContentEngineDependencies.add("Subsystem  'slf4j-compat': SLF4J: %engine_dependency_slf4j%");
-        crashContentEngineDependencies.add("Subsystems 'glfw', 'opengl' & 'vulkan': LWJGL: %engine_dependency_lwjgl%");
-        // Engine -> *
-        Map<@NotNull String, @NotNull Object> crashContentEngine = new LinkedHashMap<>();
-        crashContentEngine.put("Version", "%engine_version%");
-        crashContentEngine.put("Dependencies", crashContentEngineDependencies);
-
-        // JVM -> Implementation
-        Map<@NotNull String, @NotNull String> crashContentJvmImplementation = new LinkedHashMap<>();
-        crashContentJvmImplementation.put("Name", "%jvm_implementation_name%");
-        crashContentJvmImplementation.put("Version", "%jvm_implementation_version%");
-        crashContentJvmImplementation.put("Vendor", "%jvm_implementation_vendor%");
-        // JVM -> *
-        Map<@NotNull String, @NotNull Object> crashContentJvm = new LinkedHashMap<>();
-        crashContentJvm.put("Java Version", "%jvm_java%");
-        crashContentJvm.put("Implementation", crashContentJvmImplementation);
-        crashContentJvm.put("Arguments", JvmInformation.getArguments());
-
-        // Operating system
-        Map<@NotNull String, @NotNull String> crashContentOS = new LinkedHashMap<>();
-        crashContentOS.put("Time", "%time_hour%:%time_minute%:%time_second% (%time_zone%, UNIX Epoch: %time_epoch%)");
-        crashContentOS.put("Date", "%date_day%.%date_month%.%date_year%");
-
-        // Add to crash handler
-        CrashHandler.getCrashContent().put("Issuer", crashContentIssuer);
-        CrashHandler.getCrashContent().put("Engine", crashContentEngine);
-        CrashHandler.getCrashContent().put("Java Virtual Machine", crashContentJvm);
-        CrashHandler.getCrashContent().put("Operating system", crashContentOS);
-        CrashHandler.getCrashContent().put("Stacktrace", "\n%stacktrace%");
-        CrashHandler.getCrashContent().put("Stacktrace for all threads", "\n%stacktrace_all%");
+            Logger.warn("The StarOpenSource Engine is running on an untested Java version.\nThings may not work as expected or features which can improve performance, stability, compatibility or ease of use may be missing.\nIf you encounter issues, try running a JVM implementing Java " + EngineInformation.getJavaSource());
     }
 
     /**
@@ -323,30 +361,14 @@ public final class Engine extends SubsystemClass {
      * @since v1-alpha0
      */
     private void cacheEvents() {
-        logger.diag("Caching events");
-
-        // Internal events
-        EventHelper.cacheEvent(InternalEngineShutdownEvent.class);
-
-        // General events
         EventHelper.cacheEvent(EngineCrashEvent.class);
         EventHelper.cacheEvent(EngineShutdownEvent.class);
         EventHelper.cacheEvent(EngineSoftCrashEvent.class);
+        EventHelper.cacheEvent(InternalEngineShutdownEvent.class);
         EventHelper.cacheEvent(LogEvent.class);
         EventHelper.cacheEvent(ThrowableCatchEvent.class);
     }
 
-    /**
-     * Starts engine threads.
-     *
-     * @since v1-alpha1
-     */
-    public void startThreads() {
-        logger.diag("Starting threads");
-
-        LoggingThread.startThread();
-    }
-
     /**
      * Collects all subsystems by their {@link EngineSubsystem} annotation.
      *
@@ -354,21 +376,11 @@ public final class Engine extends SubsystemClass {
      */
     private void collectSubsystems() {
         ArrayList<@NotNull DependencySubsystemVector> subsystemsMutable = new ArrayList<>();
-
-        // Scan entire classpath using the Reflections library
-        Reflections reflections = new Reflections(
-                new ConfigurationBuilder()
-                        .setUrls(ClasspathHelper.forJavaClassPath())
-                        .setScanners(Scanners.TypesAnnotated)
-        );
-
-        // Get annotated methods
-        Set<@NotNull Class<?>> annotatedClasses = reflections.getTypesAnnotatedWith(EngineSubsystem.class);
-
-        // Initialize classes, get dependency vector and add to 'subsystemsMutable'
         Object initializedClassRaw;
         SubsystemClass initializedClass;
-        for (Class<?> clazz : annotatedClasses) {
+
+        // Check and initialize all classes, get dependency vector and check version, then add to 'subsystemsMutable'
+        for (Class<?> clazz : getRawSubsystemClasses())
             try {
                 // Create new instance
                 initializedClassRaw = clazz.getDeclaredConstructor().newInstance();
@@ -378,21 +390,52 @@ public final class Engine extends SubsystemClass {
                 if (initializedClassRaw instanceof SubsystemClass)
                     initializedClass = (SubsystemClass) initializedClassRaw;
                 else
-                    logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Does not implement " + SubsystemClass.class.getName());
+                    Logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Does not implement " + SubsystemClass.class.getName());
 
                 //noinspection DataFlowIssue // the crash call will prevent a NullPointerException
                 subsystemsMutable.add(new DependencySubsystemVector(initializedClass.getDependencyVector(), initializedClass));
             } catch (Exception exception) {
                 if (exception.getClass() == IllegalStateException.class && exception.getMessage().startsWith("The version string is invalid: "))
-                    logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Invalid version string: " + exception.getMessage().replace("The version string is invalid: ", ""));
-                logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Method invocation error", exception);
+                    Logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Invalid version string: " + exception.getMessage().replace("The version string is invalid: ", ""));
+                Logger.crash("Failed to initialize subsystem " + clazz.getName() + ": Method invocation error", exception);
             }
-        }
 
         // Update 'subsystems'
         subsystems = new ImmutableLinkedList<>(subsystemsMutable);
     }
 
+    /**
+     * Returns a list of classes which are potentially
+     * eligible for subsystem initialization.
+     *
+     * @return potential subsystem classes
+     * @since v1-alpha5
+     */
+    private Set<@NotNull Class<?>> getRawSubsystemClasses() {
+        Set<@NotNull Class<?>> classes = new HashSet<>();
+
+        if (EngineInternals.getInstance().getReflectiveClasspathScanning()) {
+            // Scan entire classpath using the Reflections library
+            Reflections reflections = new Reflections(
+                    new ConfigurationBuilder()
+                            .setUrls(ClasspathHelper.forJavaClassPath())
+                            .setScanners(Scanners.TypesAnnotated)
+            );
+
+            // Get annotated methods
+            classes = reflections.getTypesAnnotatedWith(EngineSubsystem.class);
+        } else
+            for (String path : EngineConfiguration.getInstance().getInitialIncludeSubsystemClasses())
+                try {
+                    Logger.diag("Resolving class " + path);
+                    classes.add(Class.forName(path));
+                } catch (ClassNotFoundException exception) {
+                    Logger.error("Failed loading subsystem class " + path + ": Class not found");
+                }
+
+        return classes;
+    }
+
     /**
      * Initializes all subsystems.
      *
@@ -404,10 +447,11 @@ public final class Engine extends SubsystemClass {
         LinkedList<DependencySubsystemVector> order = new LinkedList<>();
 
         // Add vectors
+        resolver.addVector(getDependencyVector());
         resolver.addVectors(subsystems);
 
         // Resolve dependencies and get order
-        logger.verb("Resolving subsystem dependencies");
+        Logger.diag("Resolving subsystem dependencies");
         try {
             for (DependencyVector vector : resolver.resolve().getOrder())  // smol workaround
                 order.add((DependencySubsystemVector) vector);
@@ -422,25 +466,25 @@ public final class Engine extends SubsystemClass {
                             .append("- ")
                             .append(error);
 
-                logger.crash("Found unresolved dependencies:" + list, throwable);
+                Logger.crash("Found unresolved dependencies:" + list, throwable);
                 return;
             }
-            logger.crash("An error occurred trying to resolve subsystem dependencies: " + throwable.getClass().getName() + (throwable.getMessage() == null ? "" : ": " + throwable.getMessage()));
+            Logger.crash("An error occurred trying to resolve subsystem dependencies: " + throwable.getClass().getName() + (throwable.getMessage() == null ? "" : ": " + throwable.getMessage()));
             throw throwable;
         }
 
         // Initialize subsystems
-        logger.verb("Initializing engine subsystems");
+        Logger.diag("Initializing engine subsystems");
         long initTime;
         for (DependencySubsystemVector vector : subsystems) {
-            logger.diag("Initializing subsystem " + vector.getSubsystemClass().getName() + " (" + vector.getSubsystemClass().getClass().getName() + ")");
+            Logger.diag("Initializing subsystem '" + vector.getSubsystemClass().getName() + "' (" + vector.getSubsystemClass().getClass().getName() + ")");
             try {
                 initTime = Miscellaneous.measureExecutionTime(() -> vector.getSubsystemClass().initializeSubsystem());
             } catch (Throwable throwable) {
-                logger.crash("An error occurred trying to initialize subsystem " + vector.getSubsystemClass().getName() + " (" + vector.getSubsystemClass().getClass().getName() + "): " + throwable.getClass().getName() + (throwable.getMessage() == null ? "" : ": " + throwable.getMessage()));
+                Logger.crash("An error occurred trying to initialize subsystem " + vector.getSubsystemClass().getName() + " (" + vector.getSubsystemClass().getClass().getName() + "): " + throwable.getClass().getName() + (throwable.getMessage() == null ? "" : ": " + throwable.getMessage()));
                 throw throwable;
             }
-            logger.diag("Initialized subsystem " + vector.getSubsystemClass().getName() + " (" + vector.getSubsystemClass().getClass().getName() + ") in " + initTime + "ms");
+            Logger.diag("Initialized subsystem '" + vector.getSubsystemClass().getName() + "' (" + vector.getSubsystemClass().getClass().getName() + ") in " + initTime + "ms");
         }
 
         // Update 'subsystems'
@@ -454,13 +498,10 @@ public final class Engine extends SubsystemClass {
      * @since v1-alpha0
      */
     public synchronized void shutdown(@Range(from = 0, to = 255) int exitCode) {
-        switch (state) {
-            case UNKNOWN, SHUTDOWN, CRASHED -> {
-                return;
-            }
-        }
+        if (state == EngineState.UNKNOWN || state == EngineState.SHUTDOWN)
+            return;
 
-        logger.info("Shutting engine down");
+        Logger.info("Shutting engine down");
         if (state != EngineState.CRASHED)
             state = EngineState.SHUTDOWN;
 
@@ -471,7 +512,7 @@ public final class Engine extends SubsystemClass {
         EngineConfiguration.getInstance().loadConfiguration(properties);
 
         // Flush log messages
-        Logger.flushLogMessages();
+        LoggingQueue.flush();
 
         // Disable safety shutdown hook
         try {
@@ -479,14 +520,17 @@ public final class Engine extends SubsystemClass {
         } catch (Exception ignored) {}
 
         // Send events
-        logger.verb("Notifying classes about shutdown");
+        Logger.verb("Notifying classes about shutdown");
         new EngineShutdownEvent().callEvent();
 
-        logger.verb("Notifying subsystems about shutdown");
+        Logger.verb("Notifying subsystems about shutdown");
         new InternalEngineShutdownEvent().callEvent();
 
+        // Delete scheduled files
+        FileAccess.deleteScheduled();
+
         // Invoke shutdown handler
-        logger.verb("Invoking shutdown handler (code " + exitCode + ")");
+        Logger.verb("Invoking shutdown handler (code " + exitCode + ")");
         shutdownHandler.shutdown((short) exitCode);
     }
 
@@ -506,7 +550,11 @@ public final class Engine extends SubsystemClass {
         return "base";
     }
 
-    /** {@inheritDoc} */
+    /**
+     * This method does nothing.
+     *
+     * @since v1-alpha1
+     */
     @Override
     public void initializeSubsystem() {}
 
@@ -528,8 +576,8 @@ public final class Engine extends SubsystemClass {
      * @since v1-alpha2
      */
     public void setState(@NotNull EngineState state) throws IllegalAccessException {
-        if (!Thread.currentThread().getStackTrace()[2].getClassName().startsWith("de.staropensource.sosengine.base."))
-            throw new IllegalAccessException("Only classes inside the \"de.staropensource.sosengine.base\" package are allowed to call this method.");
+        if (!Thread.currentThread().getStackTrace()[2].getClassName().startsWith("de.staropensource.engine.base."))
+            throw new IllegalAccessException("Only classes inside the \"de.staropensource.engine.base\" package are allowed to call this method.");
 
         this.state = state;
     }
@@ -559,12 +607,12 @@ public final class Engine extends SubsystemClass {
                 Runtime.getRuntime().addShutdownHook(thread);
                 Runtime.getRuntime().removeShutdownHook(thread);
             } catch (IllegalStateException exception) {
-                logger.warn("Terminating JVM: Already shutting down, skipping");
+                Logger.warn("Terminating JVM: Already shutting down, skipping");
                 return;
             }
 
-            logger.warn("Terminating JVM");
-            System.exit(exitCode);
+            Logger.warn("Terminating JVM");
+            Runtime.getRuntime().exit(exitCode);
         }
     }
 }

base/src/main/java/de/staropensource/engine/base/EngineConfiguration.java

@@ -0,0 +1,524 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+package de.staropensource.engine.base;
+
+import de.staropensource.engine.base.annotation.EngineSubsystem;
+import de.staropensource.engine.base.event.LogEvent;
+import de.staropensource.engine.base.implementable.Configuration;
+import de.staropensource.engine.base.implementable.ShortcodeParser;
+import de.staropensource.engine.base.implementable.SubsystemClass;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.logging.backend.async.LoggingThread;
+import de.staropensource.engine.base.type.EngineState;
+import de.staropensource.engine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.type.vector.Vec2f;
+import de.staropensource.engine.base.type.vector.Vec2i;
+import de.staropensource.engine.base.utility.PropertiesReader;
+import lombok.Getter;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.*;
+
+/**
+ * Provides the base engine configuration.
+ * <p>
+ * This class does not only provide engine settings but is also
+ * responsible for loading them into memory from {@link Properties} objects.
+ * <p>
+ * Now you might ask why we didn't go with the string-based approach.
+ * The answer is simple: It's a maintenance burden.
+ * Having various settings strings scattered across many classes will cause
+ * trouble at some point, which will cause some strings to be undocumented
+ * or have an inconsistent naming scheme. Containing settings as variables in
+ * one centralized place mitigates this.
+ *
+ * @since v1-alpha0
+ */
+@Getter
+@SuppressWarnings({ "JavadocDeclaration" })
+public final class EngineConfiguration extends Configuration {
+    /**
+     * Contains the class instance.
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns the class instance.
+     *
+     * @return class instance unless {@link Engine} is uninitialized
+     * @since v1-alpha0
+     */
+    @Getter
+    private static EngineConfiguration instance;
+
+    /**
+     * Contains the configuration prefix.
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns the configuration prefix.
+     *
+     * @return property group
+     * @since v1-alpha0
+     */
+    private final @NotNull String group = "sosengine.base.";
+
+
+    /**
+     * Contains if debugging options should be allowed.
+     * All debugging options will be forcefully set to
+     * {@code false} if this option is set to {@code false}.
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns if debugging options should be allowed.
+     * All debugging options will be forcefully set to
+     * {@code false} if this option is set to {@code false}.
+     *
+     * @return debugging enabled?
+     * @since v1-alpha0
+     */
+    private boolean debug;
+
+    /**
+     * Contains whether or not to log
+     * events being emitted.
+     * <p>
+     * This will cause all events to
+     * be logged, with the exception
+     * of the {@link LogEvent}.
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns whether or not to log
+     * events being emitted.
+     * <p>
+     * This will cause all events to
+     * be logged, with the exception
+     * of the {@link LogEvent}.
+     *
+     * @return detailed event logging enabled?
+     * @since v1-alpha0
+     */
+    private boolean debugEvents;
+
+
+    /**
+     * Contains whether or not to automatically discover
+     * and initialize any class extending {@link SubsystemClass}
+     * whilst being annotated with {@link EngineSubsystem}.
+     * <p>
+     * This mechanism may fail in certain situations, where
+     * manual subsystem initialization may be desired. Make
+     * sure to disable this setting before engine startup
+     * and then initialize all subsystems manually.
+     *
+     * @see Engine
+     * @since v1-alpha5
+     * -- GETTER --
+     * Returns whether or not to automatically discover
+     * and initialize any class extending {@link SubsystemClass}
+     * whilst being annotated with {@link EngineSubsystem}.
+     * <p>
+     * This mechanism may fail in certain situations, where
+     * manual subsystem initialization may be desired. Make
+     * sure to disable this setting before engine startup
+     * and then initialize all subsystems manually.
+     *
+     * @return automatically discover and initialize subsystems?
+     * @since v1-alpha5
+     */
+    private boolean initialPerformSubsystemInitialization;
+
+    /**
+     * Contains a set of class names to try to load
+     * and initialize as subsystems. Will only take effect
+     * if {@link #initialPerformSubsystemInitialization} is
+     * turned off.
+     *
+     * @since v1-alpha5
+     * -- GETTER --
+     * Returns a set of class names to try to load
+     * and initialize as subsystems. Will only take effect
+     * if {@link #getInitialIncludeSubsystemClasses()} is
+     * turned off.
+     *
+     * @return set of class names to try and initialize as subsystems
+     * @since v1-alpha5
+     */
+    private Set<@NotNull String> initialIncludeSubsystemClasses;
+
+
+    /**
+     * Contains whether or not to complain about invalid
+     * shortcodes.
+     * <p>
+     * Requires the active log level to be set at least
+     * to {@link LogLevel#SILENT_WARNING} to have effect.
+     *
+     * @see #logLevel
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns whether or not to complain about invalid
+     * shortcodes.
+     * <p>
+     * Requires the active log level to be set at least
+     * to {@link LogLevel#SILENT_WARNING} to have effect.
+     *
+     * @return complain about invalid shortcodes?
+     * @see #getLogLevel()
+     * @since v1-alpha0
+     */
+    private boolean errorShortcodeParser;
+
+
+    /**
+     * Contains if to log asynchronously.
+     * <p>
+     * If enabled, will cause a logging thread
+     * to spawn. All log messages will be queued
+     * and printed after a set delay
+     * ({@link #logPollingSpeed}).
+     * Highly recommended to keep enabled, or
+     * the performance of your application will
+     * very likely suffer.
+     *
+     * @see #logPollingSpeed
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns if to log asynchronously.
+     * <p>
+     * If enabled, will cause a logging thread
+     * to spawn. All log messages will be queued
+     * and printed after a set delay
+     * ({@link #getLogPollingSpeed()}).
+     * Highly recommended to keep enabled, or
+     * the performance of your application will
+     * very likely suffer.
+     *
+     * @return log asynchronously?
+     * @see #getLogPollingSpeed()
+     * @since v1-alpha0
+     */
+    private boolean optimizeLogging;
+
+    /**
+     * Contains whether or not to emit events
+     * asynchronously.
+     * <p>
+     * This will cause a
+     * <a href="https://openjdk.org/jeps/444">VirtualThread</a>
+     * to spawn every time an event is emitted.
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Contains whether or not to emit events
+     * asynchronously.
+     * <p>
+     * This will cause a
+     * <a href="https://openjdk.org/jeps/444">VirtualThread</a>
+     * to spawn every time an event is emitted.
+     *
+     * @return emit events asynchronously?
+     * @since v1-alpha0
+     */
+    private boolean optimizeEvents;
+
+
+    /**
+     * Contains the minimum allowed log level.
+     * <p>
+     * The priority list is as follows (from high to low priority):
+     * <ul>
+     *     <li>{@link LogLevel#CRASH}</li>
+     *     <li>{@link LogLevel#ERROR}</li>
+     *     <li>{@link LogLevel#WARNING}</li>
+     *     <li>{@link LogLevel#INFORMATIONAL}</li>
+     *     <li>{@link LogLevel#SILENT_WARNING}</li>
+     *     <li>{@link LogLevel#VERBOSE}</li>
+     *     <li>{@link LogLevel#DIAGNOSTIC}</li>
+     * </ul>
+     *
+     * @since v1-alpha0
+     * -- GETTER --
+     * Returns the minimum allowed log level.
+     * <p>
+     * The priority list is as follows (from high to low priority):
+     * <ul>
+     *     <li>{@link LogLevel#CRASH}</li>
+     *     <li>{@link LogLevel#ERROR}</li>
+     *     <li>{@link LogLevel#WARNING}</li>
+     *     <li>{@link LogLevel#INFORMATIONAL}</li>
+     *     <li>{@link LogLevel#SILENT_WARNING}</li>
+     *     <li>{@link LogLevel#VERBOSE}</li>
+     *     <li>{@link LogLevel#DIAGNOSTIC}</li>
+     * </ul>
+     *
+     * @return minimum allowed log level
+     * @since v1-alpha0
+     */
+    private LogLevel logLevel;
+
+    /**
+     * Contains a comma-separated list of optional
+     * features to add to the final log output.
+     * <p>
+     * Available features (in order of appearance):
+     * <ul>
+     *     <li><code>formatting</code></li>
+     *     <li><code>runtime</code></li>
+     *     <li><code>date</code></li>
+     *     <li><code>time</code></li>
+     *     <li><code>shortIssuerClass</code></li>
+     *     <li><code>moduleName</code></li>
+     *     <li><code>moduleVersion</code> (requires <code>moduleName</code>)</li>
+     *     <li><code>methodName</code></li>
+     *     <li><code>lineNumber</code></li>
+     * </ul>
+     *
+     * @since v1-alpha8
+     * -- GETTER --
+     * Returns a comma-separated list of optional
+     * features to add to the final log output.
+     * <p>
+     * Available features (in order of appearance):
+     * <ul>
+     *     <li><code>formatting</code></li>
+     *     <li><code>runtime</code></li>
+     *     <li><code>date</code></li>
+     *     <li><code>time</code></li>
+     *     <li><code>shortIssuerClass</code></li>
+     *     <li><code>moduleName</code></li>
+     *     <li><code>moduleVersion</code> (requires <code>moduleName</code>)</li>
+     *     <li><code>methodName</code></li>
+     *     <li><code>lineNumber</code></li>
+     * </ul>
+     *
+     * @return optional features to enable
+     * @since v1-alpha8
+     */
+    private Set<@NotNull String> logFeatures;
+
+    /**
+     * Contains how fast the logging thread will
+     * poll for queued messages in milliseconds.
+     * This also causes messages to be buffered.
+     * <p>
+     * Only applies if {@code optimizeLogging} is turned on.
+     * Values below {@code 1} will poll for queued messages
+     * as fast as it can. This however has pretty much no
+     * benefit. Leave it at {@code 5}, it works quite well.
+     *
+     * @see #optimizeLogging
+     * @since v1-alpha4
+     * -- GETTER --
+     * Contains how fast the logging thread will
+     * poll for queued messages, in milliseconds.
+     * This also causes messages to be buffered.
+     * <p>
+     * Only applies if {@code optimizeLogging} is turned on.
+     * Values below {@code 1} will poll for queued messages
+     * as fast as it can. This however has pretty much no
+     * benefit. Leave it at {@code 5}, it works quite well.
+     *
+     * @return logging thread polling speed in milliseconds
+     * @see #isOptimizeLogging()
+     * @since v1-alpha4
+     */
+    private int logPollingSpeed;
+
+    /**
+     * Contains whether or not to forcefully write
+     * to the standard output instead of the
+     * standard error stream.
+     * <p>
+     * This only applies to the {@link LogLevel#ERROR} and
+     * {@link LogLevel#CRASH} log levels, as these use
+     * the standard error stream by default.
+     *
+     * @see <a href="https://man7.org/linux/man-pages/man3/stderr.3.html">man page about standard streams</a>
+     * @since v1-alpha0
+     * -- GETTER --
+     * Contains whether or not to forcefully write
+     * to the standard output instead of the
+     * standard error stream.
+     * <p>
+     * This only applies to the {@link LogLevel#ERROR} and
+     * {@link LogLevel#CRASH} log levels, as these use
+     * the standard error stream by default.
+     *
+     * @return force use stdout?
+     * @see <a href="https://man7.org/linux/man-pages/man3/stderr.3.html">man page about standard streams</a>
+     * @since v1-alpha0
+     */
+    private boolean logForceStandardOutput;
+
+
+    /**
+     * Contains if to truncate the full path
+     * of a class when invoking using their
+     * {@link #toString()} method.
+     * <p>
+     * Here's an example: Lets say that you have a
+     * {@link Vec2f} instance and want to convert
+     * it to a String. You can do that by using
+     * {@link Vec2f}'s {@link Vec2f#toString()}
+     * method. With this flag disabled it will
+     * return
+     * {@code de.staropensource.engine.base.types.vectors.}{@link Vec2i}{@code (x=64 y=64)}.
+     * With this flag enabled however the method will return
+     * {@link Vec2i}{@code (x=64 y=64)},
+     * which is much smaller.
+     *
+     * @since v1-alpha2
+     * -- GETTER --
+     * Returns if to truncate the full path
+     * of a class when invoking using their
+     * {@link #toString()} method.
+     * <p>
+     * Here's an example: Lets say that you have a
+     * {@link Vec2f} instance and want to convert
+     * it to a String. You can do that by using
+     * {@link Vec2f}'s {@link Vec2f#toString()}
+     * method. With this flag disabled it will
+     * return
+     * {@code de.staropensource.engine.base.types.vectors.}{@link Vec2i}{@code (x=64 y=64)}.
+     * With this flag enabled however the method will return
+     * {@link Vec2i}{@code (x=64 y=64)},
+     * which is much smaller.
+     *
+     * @return truncate class paths?
+     * @since v1-alpha2
+     */
+    private boolean hideFullTypePath;
+
+    /**
+     * Constructs this class.
+     *
+     * @see Engine
+     * @since v1-alpha6
+     */
+    EngineConfiguration() {
+        super();
+
+        instance = this;
+
+        // Load default configuration
+        loadDefaultConfiguration();
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    protected void matchProperty(@NotNull PropertiesReader parser, @NotNull String property) {
+        try {
+            switch (property) {
+                case "debug" -> debug = parser.getBoolean(group + property);
+                case "debugEvents" -> debugEvents = parser.getBoolean(group + property);
+
+                case "initialPerformSubsystemInitialization" -> initialPerformSubsystemInitialization = parser.getBoolean(group + property);
+                case "initialIncludeSubsystemClasses" -> {
+                    initialIncludeSubsystemClasses = new HashSet<>();
+                    initialIncludeSubsystemClasses.addAll(Arrays.stream(parser.getString(group + property).split(",")).toList());
+                }
+
+                case "errorShortcodeParser" -> errorShortcodeParser = parser.getBoolean(group + property);
+
+                case "optimizeLogging" -> {
+                    optimizeLogging = parser.getBoolean(group + property);
+
+                    // Start logging thread automatically
+                    if (optimizeLogging && Engine.getInstance().getState() == EngineState.RUNNING) {
+                        LoggingThread.startThread(false);
+                    }
+                }
+                case "optimizeEvents" -> optimizeEvents = parser.getBoolean(group + property);
+
+                case "logLevel" -> {
+                    try {
+                        logLevel = LogLevel.valueOf(parser.getString(group + property).toUpperCase());
+                    } catch (IllegalArgumentException ignored) {
+                        Logger.error("The log level '" + parser.getString(group + property) + "' is not valid");
+                    }
+                }
+                case "logFeatures" -> logFeatures = Set.copyOf(Arrays.stream(parser.getString(group + property).split(",")).toList());
+                case "logPollingSpeed" -> logPollingSpeed = parser.getInteger(group + property, true);
+                case "logForceStandardOutput" -> logForceStandardOutput = parser.getBoolean(group + property);
+
+                case "hideFullTypePath" -> hideFullTypePath = parser.getBoolean(group + property);
+            }
+        } catch (NullPointerException ignored) {}
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    protected void processSettings(@NotNull PropertiesReader parser) {
+        // Disable all debugging switches if 'debug' is disabled
+        if (!debug) {
+            debugEvents = false;
+        }
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public void loadDefaultConfiguration() {
+        debug = false;
+        debugEvents = false;
+
+        initialPerformSubsystemInitialization = true;
+        initialIncludeSubsystemClasses = new HashSet<>();
+
+        errorShortcodeParser = true;
+
+        optimizeLogging = true;
+        optimizeEvents = true;
+
+        logLevel = LogLevel.INFORMATIONAL;
+        logFeatures = Set.of("formatting", "time", "methodName", "lineNumber");
+        logPollingSpeed = 5;
+        logForceStandardOutput = false;
+
+        hideFullTypePath = false;
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public @Nullable Object getSetting(@NotNull String setting) {
+        return switch (setting) {
+            case "debug" -> debug;
+            case "debugEvents" -> debugEvents;
+
+            case "initialPerformSubsystemInitialization" -> initialPerformSubsystemInitialization;
+            case "initialIncludeSubsystemClasses" -> initialIncludeSubsystemClasses;
+
+            case "errorShortcodeParser" -> errorShortcodeParser;
+
+            case "optimizeLogging" -> optimizeLogging;
+            case "optimizeEvents" -> optimizeEvents;
+
+            case "logLevel" -> logLevel;
+            case "logFeatures" -> logFeatures;
+            case "logPollingSpeed" -> logPollingSpeed;
+            case "logForceStandardOutput" -> logForceStandardOutput;
+
+            case "hideFullTypePath" -> hideFullTypePath;
+            default -> null;
+        };
+    }
+}

base/src/main/java/de/staropensource/engine/base/EngineInternals.java

@@ -17,12 +17,15 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base;
+package de.staropensource.engine.base;
 
-import de.staropensource.sosengine.base.implementable.ShutdownHandler;
-import de.staropensource.sosengine.base.exception.IllegalAccessException;
-import de.staropensource.sosengine.base.logging.LoggerInstance;
-import de.staropensource.sosengine.base.type.InternalAccessArea;
+import de.staropensource.engine.base.exception.IllegalAccessException;
+import de.staropensource.engine.base.implementable.EventListenerCode;
+import de.staropensource.engine.base.implementable.ShutdownHandler;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.EventPriority;
+import de.staropensource.engine.base.type.InternalAccessArea;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 
@@ -51,14 +54,6 @@ public final class EngineInternals {
     @Getter
     private static EngineInternals instance;
 
-    /**
-     * Contains the {@link LoggerInstance} for this instance.
-     *
-     * @see LoggerInstance
-     * @since v1-alpha4
-     */
-    private static final LoggerInstance logger = new LoggerInstance.Builder().setClazz(EngineInternals.class).setOrigin("ENGINE").build();
-
     /**
      * Contains all disabled internal access areas.
      *
@@ -73,16 +68,31 @@ public final class EngineInternals {
     private final @NotNull List<@NotNull InternalAccessArea> restrictedAreas = new ArrayList<>();
 
     /**
-     * Constructs this class.
+     * Contains whether the engine should reflectively
+     * search the classpath for events or other annotations.
+     * <p>
+     * If disabled, code will either have to manually call
+     * registration methods or certain classes have to
+     * be created in a certain package, depending on the
+     * use case and application.
      *
-     * @since v1-alpha4
+     * @see EventHelper#registerEvent(Class, EventListenerCode)
+     * @see EventHelper#registerEvent(Class, EventListenerCode, EventPriority)
+     * @since v1-alpha5
      */
-     public EngineInternals() {
+    private boolean reflectiveClasspathScanning = true;
+
+    /**
+     * Creates and initializes an instance of this class.
+     *
+     * @since v1-alpha6
+     */
+     EngineInternals() {
          // Only allow one instance
          if (instance == null && Engine.getInstance() != null)
              instance = this;
          else
-             logger.crash("Only one instance of this class is allowed, use getInstance() instead of creating a new instance");
+             Logger.crash("Only one instance of this class is allowed, use getInstance() instead of creating a new instance");
     }
 
     /**
@@ -110,10 +120,12 @@ public final class EngineInternals {
                 areas.remove(InternalAccessArea.ALL);
                 areas.remove(InternalAccessArea.ALL_READ);
                 areas.remove(InternalAccessArea.ALL_WRITE);
+                areas.remove(InternalAccessArea.ALL_READ_ESSENTIAL);
                 restrictedAreas.addAll(areas);
             }
-            case ALL_READ -> restrictedAreas.addAll(Arrays.stream(InternalAccessArea.valuesReadOnly()).toList());
             case ALL_WRITE -> restrictedAreas.addAll(Arrays.stream(InternalAccessArea.valuesWriteOnly()).toList());
+            case ALL_READ -> restrictedAreas.addAll(Arrays.stream(InternalAccessArea.valuesReadOnly()).toList());
+            case ALL_READ_ESSENTIAL -> restrictedAreas.addAll(Arrays.stream(InternalAccessArea.valuesEssentialReadOnly()).toList());
             default -> restrictedAreas.add(area);
         }
     }
@@ -125,11 +137,11 @@ public final class EngineInternals {
      * Highly recommended to keep enabled.
      *
      * @param status {@code true} to install, {@code false} otherwise
-     * @throws IllegalAccessException when restricted
+     * @throws IllegalAccessException when restricted ({@link InternalAccessArea#SAFETY_SHUTDOWN_HOOK_UPDATE})
      * @since v1-alpha4
      */
     public void installSafetyShutdownHook(boolean status) throws IllegalAccessException {
-        isRestricted(InternalAccessArea.SAFETY_SHUTDOWN_HOOK);
+        isRestricted(InternalAccessArea.SAFETY_SHUTDOWN_HOOK_UPDATE);
 
         try {
             if (status)
@@ -139,13 +151,27 @@ public final class EngineInternals {
         } catch (IllegalArgumentException | IllegalStateException ignored) {}
     }
 
+    /**
+     * Gets the engine's shutdown handler.
+     * The shutdown handler is responsible for
+     * shutting down the JVM safely.
+     *
+     * @return shutdown handler
+     * @throws IllegalAccessException when restricted ({@link InternalAccessArea#SHUTDOWN_HANDLER_GET})
+     * @since v1-alpha4
+     */
+    public @NotNull ShutdownHandler getShutdownHandler() throws IllegalAccessException {
+        isRestricted(InternalAccessArea.SHUTDOWN_HANDLER_GET);
+        return Engine.getInstance().getShutdownHandler();
+    }
+
     /**
      * Sets the engine's shutdown handler.
      * The shutdown handler is responsible for
      * shutting down the JVM safely.
      *
      * @param shutdownHandler new shutdown handler
-     * @throws IllegalAccessException when restricted
+     * @throws IllegalAccessException when restricted ({@link InternalAccessArea#SHUTDOWN_HANDLER_UPDATE})
      * @since v1-alpha4
      */
     public void setShutdownHandler(@NotNull ShutdownHandler shutdownHandler) throws IllegalAccessException {
@@ -154,16 +180,47 @@ public final class EngineInternals {
     }
 
     /**
-     * Gets the engine's shutdown handler.
-     * The shutdown handler is responsible for
-     * shutting down the JVM safely.
+     * Returns whether the engine should reflectively
+     * search the classpath for events or other annotations.
+     * <p>
+     * If disabled, code will either have to manually call
+     * registration methods or certain classes have to
+     * be created in a certain package, depending on the
+     * use case and application.
      *
-     * @return shutdown handler
-     * @throws IllegalAccessException when restricted
-     * @since v1-alpha4
+     * @return reflective classpath scanning flag state
+     * @throws IllegalAccessException when restricted ({@link InternalAccessArea#REFLECTIVE_CLASSPATH_SCANNING_GET})
+     * @see EventHelper#registerEvent(Class, EventListenerCode)
+     * @see EventHelper#registerEvent(Class, EventListenerCode, EventPriority)
+     * @since v1-alpha5
      */
-    public @NotNull ShutdownHandler getShutdownHandler() throws IllegalAccessException {
-        isRestricted(InternalAccessArea.SHUTDOWN_HANDLER_GET);
-        return Engine.getInstance().getShutdownHandler();
+    public boolean getReflectiveClasspathScanning() throws IllegalAccessException {
+        isRestricted(InternalAccessArea.REFLECTIVE_CLASSPATH_SCANNING_GET);
+        return reflectiveClasspathScanning;
+    }
+
+    /**
+     * Overrides whether the engine should reflectively
+     * search the classpath for events or other annotations.
+     * <p>
+     * If disabled, code will either have to manually call
+     * registration methods or certain classes have to
+     * be created in a certain package, depending on the
+     * use case and application.
+     * <p>
+     * Enabling reflective classpath scanning in an unsupported
+     * environment may cause minor to extreme side effects,
+     * including but not limited to <b>bugs, exceptions, engine
+     * or even whole JVM crashes</b>. <i>You have been warned!</i>
+     *
+     * @param reflectiveClasspathScanning new reflective classpath scanning
+     * @throws IllegalAccessException when restricted ({@link InternalAccessArea#REFLECTIVE_CLASSPATH_SCANNING_OVERRIDE})
+     * @see EventHelper#registerEvent(Class, EventListenerCode)
+     * @see EventHelper#registerEvent(Class, EventListenerCode, EventPriority)
+     * @since v1-alpha5
+     */
+    public void overrideReflectiveClasspathScanning(boolean reflectiveClasspathScanning) throws IllegalAccessException {
+        isRestricted(InternalAccessArea.REFLECTIVE_CLASSPATH_SCANNING_OVERRIDE);
+        this.reflectiveClasspathScanning = reflectiveClasspathScanning;
     }
 }

base/src/main/java/de/staropensource/engine/base/annotation/EngineSubsystem.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.annotation;
+package de.staropensource.engine.base.annotation;
 
-import de.staropensource.sosengine.base.implementable.SubsystemClass;
+import de.staropensource.engine.base.implementable.SubsystemClass;
 
 import java.lang.annotation.*;
 

base/src/main/java/de/staropensource/engine/base/annotation/EventListener.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.annotation;
+package de.staropensource.engine.base.annotation;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.type.EventPriority;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.type.EventPriority;
 import org.jetbrains.annotations.NotNull;
 
 import java.lang.annotation.*;

base/src/main/java/de/staropensource/engine/base/annotation/package-info.java

@@ -23,4 +23,4 @@
  *
  * @since v1-alpha0
  */
-package de.staropensource.sosengine.base.annotation;
+package de.staropensource.engine.base.annotation;

base/src/main/java/de/staropensource/engine/base/event/EngineCrashEvent.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
 
 /**
  * Called in the event of an engine crash.
@@ -29,7 +29,7 @@ import de.staropensource.sosengine.base.implementable.helper.EventHelper;
  */
 public final class EngineCrashEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/EngineShutdownEvent.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
 
 /**
  * Called when the engine is about to shutdown.
@@ -29,7 +29,7 @@ import de.staropensource.sosengine.base.implementable.helper.EventHelper;
  */
 public final class EngineShutdownEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/EngineSoftCrashEvent.java

@@ -17,11 +17,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
-import de.staropensource.sosengine.base.logging.Logger;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.logging.Logger;
 
 /**
  * Called in the event of a soft engine crash
@@ -33,7 +33,7 @@ import de.staropensource.sosengine.base.logging.Logger;
  */
 public final class EngineSoftCrashEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/InternalEngineShutdownEvent.java

@@ -17,13 +17,13 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
 
 /**
- * Called when the engine is about to shutdown, after {@link de.staropensource.sosengine.base.event.EngineShutdownEvent}.
+ * Called when the engine is about to shutdown, after {@link de.staropensource.engine.base.event.EngineShutdownEvent}.
  * <p>
  * Meant for subsystems to perform cleanup and shutdown routines, not for applications.
  *
@@ -31,7 +31,7 @@ import de.staropensource.sosengine.base.implementable.helper.EventHelper;
  */
 public final class InternalEngineShutdownEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/LogEvent.java

@@ -17,11 +17,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
-import de.staropensource.sosengine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.type.logging.LogLevel;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.Nullable;
  */
 public final class LogEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/ThrowableCatchEvent.java

@@ -17,11 +17,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.utility.Miscellaneous;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public final class ThrowableCatchEvent implements Event {
     /**
-     * Constructs this event.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/event/package-info.java

@@ -22,4 +22,4 @@
  *
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.event;
+package de.staropensource.engine.base.event;

base/src/main/java/de/staropensource/engine/base/exception/IllegalAccessException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception;
+package de.staropensource.engine.base.exception;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -28,14 +28,14 @@ import org.jetbrains.annotations.NotNull;
  */
 public class IllegalAccessException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @since v1-alpha2
      */
     public IllegalAccessException() {}
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param message message
      * @since v1-alpha2

base/src/main/java/de/staropensource/engine/base/exception/ParserException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception;
+package de.staropensource.engine.base.exception;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -28,7 +28,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class ParserException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param message parsing error
      * @since v1-alpha2

base/src/main/java/de/staropensource/engine/base/exception/TristateConversionException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception;
+package de.staropensource.engine.base.exception;
 
-import de.staropensource.sosengine.base.type.Tristate;
+import de.staropensource.engine.base.type.Tristate;
 
 /**
  * Thrown when converting a {@link Tristate} into a {@link Boolean} fails.
@@ -32,7 +32,7 @@ import de.staropensource.sosengine.base.type.Tristate;
  */
 public class TristateConversionException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @since v1-alpha2
      */

base/src/main/java/de/staropensource/engine/base/exception/UnexpectedCheckEndException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception;
+package de.staropensource.engine.base.exception;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -28,7 +28,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class UnexpectedCheckEndException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param checkOccurrence the sequence of checks that failed
      * @since v1-alpha2
@@ -38,7 +38,7 @@ public class UnexpectedCheckEndException extends RuntimeException {
     }
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @since v1-alpha2
      */

base/src/main/java/de/staropensource/engine/base/exception/dependency/DependencyCycleException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.dependency;
+package de.staropensource.engine.base.exception.dependency;
 
-import de.staropensource.sosengine.base.utility.DependencyResolver;
+import de.staropensource.engine.base.utility.DependencyResolver;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -29,7 +29,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class DependencyCycleException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param path cycle path
      * @since v1-alpha1

base/src/main/java/de/staropensource/engine/base/exception/dependency/UnmetDependenciesException.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.dependency;
+package de.staropensource.engine.base.exception.dependency;
 
-import de.staropensource.sosengine.base.type.DependencyVector;
-import de.staropensource.sosengine.base.utility.DependencyResolver;
+import de.staropensource.engine.base.type.DependencyVector;
+import de.staropensource.engine.base.utility.DependencyResolver;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 
@@ -48,7 +48,7 @@ public class UnmetDependenciesException extends Exception {
     private final @NotNull List<@NotNull String> unmetDependencies;
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this event.
      *
      * @param unmetDependencies map of all unmet dependencies
      * @see #unmetDependencies

base/src/main/java/de/staropensource/engine/base/exception/dependency/package-info.java

@@ -20,7 +20,7 @@
 /**
  * Exceptions related to dependency resolving.
  *
- * @see de.staropensource.sosengine.base.utility.DependencyResolver
+ * @see de.staropensource.engine.base.utility.DependencyResolver
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.exception.dependency;
+package de.staropensource.engine.base.exception.dependency;

base/src/main/java/de/staropensource/engine/base/exception/package-info.java

@@ -22,4 +22,4 @@
  *
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.exception;
+package de.staropensource.engine.base.exception;

base/src/main/java/de/staropensource/engine/base/exception/reflection/IncompatibleTypeException.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
-import de.staropensource.sosengine.base.type.reflection.ClassType;
-import de.staropensource.sosengine.base.utility.ListFormatter;
+import de.staropensource.engine.base.type.reflection.ClassType;
+import de.staropensource.engine.base.utility.ListFormatter;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -30,18 +30,18 @@ import org.jetbrains.annotations.NotNull;
  */
 public class IncompatibleTypeException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param methodName        name of the method that failed
      * @param requiredClassType class type received by the method
      * @param compatibleTypes   class types the method is compatible with
      */
-    public IncompatibleTypeException(@NotNull String methodName, @NotNull ClassType requiredClassType, @NotNull ClassType[] compatibleTypes) {
+    public IncompatibleTypeException(@NotNull String methodName, @NotNull ClassType requiredClassType, @NotNull ClassType @NotNull [] compatibleTypes) {
         super("The method ReflectionClass#" + methodName + " only applies to type(s) " + ListFormatter.formatArray(compatibleTypes) + ", not " + requiredClassType.name());
     }
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param methodName        name of the method that failed
      * @param requiredClassType class type received by the method

base/src/main/java/de/staropensource/engine/base/exception/reflection/InstanceMethodFromStaticContextException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -28,7 +28,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class InstanceMethodFromStaticContextException extends Exception {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param methodName name of the method
      * @since v1-alpha2

base/src/main/java/de/staropensource/engine/base/exception/reflection/InvalidFieldException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
-import de.staropensource.sosengine.base.reflection.ReflectionClass;
+import de.staropensource.engine.base.reflection.ReflectionClass;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -29,7 +29,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class InvalidFieldException extends Exception {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param clazz     caller {@link ReflectionClass}
      * @param fieldName name of the invalid field

base/src/main/java/de/staropensource/engine/base/exception/reflection/InvalidMethodException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
-import de.staropensource.sosengine.base.reflection.ReflectionClass;
+import de.staropensource.engine.base.reflection.ReflectionClass;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -29,7 +29,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class InvalidMethodException extends Exception {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param clazz     caller {@link ReflectionClass}
      * @param fieldName name of the invalid method

base/src/main/java/de/staropensource/engine/base/exception/reflection/InvalidMethodSignatureException.java

@@ -17,22 +17,23 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
 import org.jetbrains.annotations.NotNull;
 
 /**
  * Thrown when a method could not be found due to an invalid method signature.
  *
- * @since v1-alpha2
+ * @since v1-alpha5
  */
-public class InvalidMethodSignature extends Exception {
+public class InvalidMethodSignatureException extends Exception {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param methodName method name
+     * @since v1-alpha5
      */
-    public InvalidMethodSignature(@NotNull String methodName) {
+    public InvalidMethodSignatureException(@NotNull String methodName) {
         super("Method " + methodName + " has a different method signature");
     }
 }

base/src/main/java/de/staropensource/engine/base/exception/reflection/NoAccessException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
 import org.jetbrains.annotations.NotNull;
 
@@ -28,7 +28,7 @@ import org.jetbrains.annotations.NotNull;
  */
 public class NoAccessException extends Exception {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param type {@code class}, {@code method} or {@code field}
      * @param name class, method or field name

base/src/main/java/de/staropensource/engine/base/exception/reflection/StaticInitializerException.java

@@ -17,7 +17,7 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;
 
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
@@ -43,7 +43,7 @@ public class StaticInitializerException extends Exception {
     private final @NotNull Throwable throwable;
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param throwable throwable thrown by the static initializer
      * @since v1-alpha2

base/src/main/java/de/staropensource/engine/base/exception/reflection/package-info.java

@@ -20,7 +20,7 @@
 /**
  * Exceptions related to reflection.
  *
- * @see de.staropensource.sosengine.base.reflection
+ * @see de.staropensource.engine.base.reflection
  * @since v1-alpha2
  */
-package de.staropensource.sosengine.base.exception.reflection;
+package de.staropensource.engine.base.exception.reflection;

base/src/main/java/de/staropensource/engine/base/exception/versioning/IncompatibleVersioningSystemException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.versioning;
+package de.staropensource.engine.base.exception.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.implementable.VersioningSystem;
 
 /**
  * Thrown when trying to compare a {@link VersioningSystem} against another
@@ -29,7 +29,7 @@ import de.staropensource.sosengine.base.implementable.VersioningSystem;
  */
 public class IncompatibleVersioningSystemException extends RuntimeException {
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param required required versioning system ie. the versioning system throwing this error
      * @param found    found versioning system ie. the incompatible one

base/src/main/java/de/staropensource/engine/base/exception/versioning/InvalidVersionStringException.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.exception.versioning;
+package de.staropensource.engine.base.exception.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.implementable.VersioningSystem;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -51,7 +51,7 @@ public class InvalidVersionStringException extends Exception {
     private final @Nullable Throwable throwable;
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param versioningSystem versioning system that is unable to parse version strings
      * @param versionString    version string {@code a}
@@ -65,7 +65,7 @@ public class InvalidVersionStringException extends Exception {
     }
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param versioningSystem versioning system that is unable to parse version strings
      * @param versionString   version string {@code a}
@@ -78,7 +78,7 @@ public class InvalidVersionStringException extends Exception {
     }
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param versioningSystem versioning system that is unable to parse version strings
      * @param versionString   version string {@code a}
@@ -91,7 +91,7 @@ public class InvalidVersionStringException extends Exception {
     }
 
     /**
-     * Constructs this exception.
+     * Creates and initializes an instance of this exception.
      *
      * @param versioningSystem versioning system that is unable to parse version strings
      * @param versionString   version string {@code a}

base/src/main/java/de/staropensource/engine/base/exception/versioning/package-info.java

@@ -18,9 +18,9 @@
  */
 
 /**
- * Exceptions thrown by implementations of {@link de.staropensource.sosengine.base.implementable.VersioningSystem}s.
+ * Exceptions thrown by implementations of {@link de.staropensource.engine.base.implementable.VersioningSystem}s.
  *
- * @see de.staropensource.sosengine.base.implementable.VersioningSystem
+ * @see de.staropensource.engine.base.implementable.VersioningSystem
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.exception.versioning;
+package de.staropensource.engine.base.exception.versioning;

base/src/main/java/de/staropensource/engine/base/implementable/Configuration.java

@@ -17,10 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.logging.LoggerInstance;
-import de.staropensource.sosengine.base.utility.PropertiesReader;
+import de.staropensource.engine.base.utility.PropertiesReader;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -37,23 +36,11 @@ import java.util.Properties;
  */
 public abstract class Configuration {
     /**
-     * Contains the {@link LoggerInstance} for this instance.
+     * Creates and initializes an instance of this abstract class.
      *
-     * @see LoggerInstance
-     * @since v1-alpha1
-     */
-    protected final @NotNull LoggerInstance logger;
-
-    /**
-     * Constructs this class.
-     *
-     * @param origin see {@link LoggerInstance.Builder#setOrigin(String)}
      * @since v1-alpha2
      */
-    public Configuration(@NotNull String origin) {
-        // Set logger instance
-        logger = new LoggerInstance.Builder().setClazz(getClass()).setOrigin(origin).build();
-
+    protected Configuration() {
         // Load default configuration
         loadDefaultConfiguration();
     }
@@ -100,7 +87,7 @@ public abstract class Configuration {
     }
 
     /**
-     * Returns the group in which setting overrides must begin with.
+     * Returns prefix properties must begin with.
      *
      * @return property group
      * @since v1-alpha2

base/src/main/java/de/staropensource/engine/base/implementable/Event.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
 
 /**
  * Represents an event.

base/src/main/java/de/staropensource/engine/base/implementable/EventListenerCode.java

@@ -17,42 +17,43 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.windowing.event;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.implementable.Event;
-import de.staropensource.sosengine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.implementable.helper.EventHelper;
+import de.staropensource.engine.base.type.EventPriority;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Called when an error occurs in the windowing API.
+ * Used by {@link EventHelper} to execute event listeners.
  *
- * @since v1-alpha0
+ * @see Runnable
+ * @since v1-alpha5
  */
-public final class WindowingErrorEvent implements Event {
+public abstract class EventListenerCode {
     /**
-     * Constructs this class.
+     * Contains the priority of this
+     * event listener.
+     * <p>
+     * Set automatically by {@link EventHelper},
+     * do not change this manually.
      *
-     * @since v1-alpha0
+     * @since v1-alpha5
      */
-    public WindowingErrorEvent() {}
+    public @NotNull EventPriority priority = EventPriority.DEFAULT;
 
     /**
-     * {@inheritDoc}
+     * Creates and initializes an instance of this abstract class.
      *
-     * @deprecated use the {@code callEvent} method with arguments
-     * @see #callEvent(String) 
+     * @since v1-alpha5
      */
-    @Deprecated
-    @Override
-    public void callEvent() {}
+    protected EventListenerCode() {}
 
     /**
-     * Emits the event and calls all event listeners.
+     * Invokes the event listener.
      *
-     * @param error error description
-     * @since v1-alpha0
+     * @param arguments arguments passed along by the event
+     * @throws Exception exceptions thrown
+     * @since v1-alpha5
      */
-    public void callEvent(@NotNull String error) {
-        EventHelper.invokeAnnotatedMethods(getClass(), error);
-    }
+    public abstract void run(Object... arguments) throws Exception;
 }

base/src/main/java/de/staropensource/engine/base/implementable/LoggingAdapter.java

@@ -17,39 +17,27 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder.crashhandler;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.logging.LogLevel;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Implements the {@code issuer_path} placeholder.
+ * Interface for implementing custom logger implementations.
  *
- * @see Placeholder
+ * @see Logger#setLoggingAdapter(LoggingAdapter)
  * @since v1-alpha0
  */
-@SuppressWarnings({ "unused" })
-public final class IssuerPath implements Placeholder {
+public interface LoggingAdapter {
     /**
-     * Issuer class to use.
+     * Prints a log message.
      *
+     * @param level   level of the log call
+     * @param issuer  {@link StackTraceElement} of the issuer
+     * @param message raw message
+     * @param format  processed log call output (print this!)
      * @since v1-alpha2
      */
-    private final @NotNull Class<?> issuerClass;
-
-    /**
-     * Constructs this class.
-     *
-     * @param issuerClass issuer class to use
-     * @since v1-alpha0
-     */
-    public IssuerPath(@NotNull Class<?> issuerClass) {
-        this.issuerClass = issuerClass;
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public @NotNull String replace(@NotNull String text) {
-        return text.replace("%issuer_path%", issuerClass.getName());
-    }
+    void print(@NotNull LogLevel level, @NotNull StackTraceElement issuer, @NotNull String message, @NotNull String format);
 }

base/src/main/java/de/staropensource/engine/base/implementable/Placeholder.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.utility.PlaceholderEngine;
+import de.staropensource.engine.base.utility.PlaceholderEngine;
 import org.jetbrains.annotations.NotNull;
 
 /**

base/src/main/java/de/staropensource/engine/base/implementable/ShortcodeParser.java

@@ -17,11 +17,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.EngineConfiguration;
-import de.staropensource.sosengine.base.exception.ParserException;
-import de.staropensource.sosengine.base.logging.LoggerInstance;
+import de.staropensource.engine.base.EngineConfiguration;
+import de.staropensource.engine.base.exception.ParserException;
+import de.staropensource.engine.base.logging.Logger;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 
@@ -29,7 +29,7 @@ import java.util.LinkedList;
 import java.util.Locale;
 
 /**
- * Base class for implementing a shortcode converter.
+ * Base class for implementing a shortcode parser.
  * <p>
  * This class parses a string and converts it into a list of
  * components, which can then be in turn be converted to something
@@ -48,16 +48,9 @@ import java.util.Locale;
  *
  * @since v1-alpha1
  */
+@Getter
 @SuppressWarnings({ "JavadocDeclaration" })
 public abstract class ShortcodeParser {
-    /**
-     * Contains the {@link LoggerInstance} for this instance.
-     *
-     * @see LoggerInstance
-     * @since v1-alpha1
-     */
-    protected final @NotNull LoggerInstance logger;
-
     /**
      * Contains a list of components the parsed text is made out of.
      *
@@ -68,19 +61,17 @@ public abstract class ShortcodeParser {
      * @return component list
      * @since v1-alpha1
      */
-    @Getter
     protected final @NotNull LinkedList<String> components;
 
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this abstract class.
      *
      * @param string               string to parse
      * @param ignoreInvalidEscapes if {@code true}, will ignore and treat invalid escapes as text
      * @throws ParserException on error
      * @since v1-alpha2
      */
-    public ShortcodeParser(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
-        logger = new LoggerInstance.Builder().setClazz(getClass()).setOrigin("ENGINE").build();
+    protected ShortcodeParser(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
         components = parse(string, ignoreInvalidEscapes);
     }
 
@@ -92,7 +83,7 @@ public abstract class ShortcodeParser {
      * @param ignoreInvalidEscapes if {@code true}, will ignore and treat invalid escapes as text
      * @return list of components
      * @throws ParserException on error
-     * @see EngineConfiguration#errorShortcodeConverter
+     * @see EngineConfiguration#errorShortcodeParser
      * @since v1-alpha2
      */
     protected @NotNull LinkedList<@NotNull String> parse(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
@@ -128,110 +119,53 @@ public abstract class ShortcodeParser {
                     tagActive = false;
 
                     // fg:*
-                    if (part.toString().startsWith("fg:")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=fg data=" + part.substring(3).toUpperCase());
-
+                    if (part.toString().startsWith("fg:"))
                         if (isValidColor(part.substring(3).toUpperCase()))
                             components.add("COLOR:FOREGROUND:" + part.substring(3).toUpperCase());
                         else {
                             // Complain about invalid shortcode
-                            if (EngineConfiguration.getInstance().isErrorShortcodeConverter())
-                                logger.sarn("Invalid shortcode: " + part);
+                            if (EngineConfiguration.getInstance() != null && EngineConfiguration.getInstance().isErrorShortcodeParser())
+                                Logger.sarn("Invalid shortcode: " + part);
 
                             // Convert tag regular text
                             components.add("TEXT:" + "<" + part + ">");
                         }
-                    }
-
                     // bg:*
-                    else if (part.toString().startsWith("bg:")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=bg data=" + part.substring(3).toUpperCase());
-
+                    else if (part.toString().startsWith("bg:"))
                         if (isValidColor(part.substring(3).toUpperCase()))
                             components.add("COLOR:BACKGROUND:" + part.substring(3).toUpperCase());
                         else {
                             // Complain about invalid shortcode
-                            if (EngineConfiguration.getInstance().isErrorShortcodeConverter())
-                                logger.sarn("Invalid shortcode: " + part);
+                            if (EngineConfiguration.getInstance() != null && EngineConfiguration.getInstance().isErrorShortcodeParser())
+                                Logger.sarn("Invalid shortcode: " + part);
 
                             // Convert tag regular text
                             components.add("TEXT:" + "<" + part + ">");
                         }
-                    }
-
                     // bold
-                    else if (part.toString().equals("bold")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=bold");
-
-                        // Insert attribute
+                    else if (part.toString().equals("bold"))
                         components.add("ATTRIBUTE:BOLD");
-                    }
-
                     // italic
-                    else if (part.toString().equals("italic")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=italic");
-
-                        // Insert attribute
+                    else if (part.toString().equals("italic"))
                         components.add("ATTRIBUTE:ITALIC");
-                    }
-
                     // strikethrough
-                    else if (part.toString().equals("strikethrough")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=strikethrough");
-
-                        // Insert attribute
+                    else if (part.toString().equals("strikethrough"))
                         components.add("ATTRIBUTE:STRIKETHROUGH");
-                    }
-
                     // underline
-                    else if (part.toString().equals("underline")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=underline");
-
-                        // Insert attribute
+                    else if (part.toString().equals("underline"))
                         components.add("ATTRIBUTE:UNDERLINE");
-                    }
-
-                    // underline
-                    else if (part.toString().equals("blink")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=blink");
-
-                        // Insert attribute
+                    // blink
+                    else if (part.toString().equals("blink"))
                         components.add("ATTRIBUTE:BLINK");
-                    }
-
                     // reset
-                    else if (part.toString().equals("reset")) {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " tag=reset");
-
-                        // Insert reset
+                    else if (part.toString().equals("reset"))
                         components.add("RESET");
-                    }
 
                     // error case
                     else {
-                        // Print debug message
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " invalidtag=" + part);
-
                         // Complain about invalid shortcode
-                        if (EngineConfiguration.getInstance().isErrorShortcodeConverter())
-                            logger.sarn("Invalid shortcode: " + part);
+                        if (EngineConfiguration.getInstance() != null && EngineConfiguration.getInstance().isErrorShortcodeParser())
+                            Logger.sarn("Invalid shortcode: " + part);
 
                         // Convert tag regular text
                         components.add("TEXT:" + "<" + part + ">");
@@ -248,9 +182,6 @@ public abstract class ShortcodeParser {
                 if (character == '<') {
                     if (!part.isEmpty()) {
                         // Tag is starting, insert previous text
-                        if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                            System.out.println(getClass().getName() + "#" + string.hashCode() + " text=" + part);
-
                         components.add("TEXT:" + part);
                         part = new StringBuilder();
                     }
@@ -264,12 +195,8 @@ public abstract class ShortcodeParser {
         }
 
         // Processing ended, insert leftover text
-        if (!part.isEmpty()) {
-            if (EngineConfiguration.getInstance().isDebugShortcodeConverter())
-                System.out.println(getClass().getName() + "#" + string.hashCode() + " endtext=" + part);
-
+        if (!part.isEmpty())
             components.add("TEXT:" + part);
-        }
 
         return components;
     }

base/src/main/java/de/staropensource/engine/base/implementable/ShutdownHandler.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.Engine;
+import de.staropensource.engine.base.Engine;
 import org.jetbrains.annotations.Range;
 
 /**

base/src/main/java/de/staropensource/engine/base/implementable/SubsystemClass.java

@@ -17,37 +17,28 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.Engine;
-import de.staropensource.sosengine.base.annotation.EngineSubsystem;
-import de.staropensource.sosengine.base.annotation.EventListener;
-import de.staropensource.sosengine.base.internal.event.InternalEngineShutdownEvent;
-import de.staropensource.sosengine.base.logging.LoggerInstance;
-import de.staropensource.sosengine.base.type.DependencyVector;
+import de.staropensource.engine.base.Engine;
+import de.staropensource.engine.base.annotation.EngineSubsystem;
+import de.staropensource.engine.base.annotation.EventListener;
+import de.staropensource.engine.base.event.InternalEngineShutdownEvent;
+import de.staropensource.engine.base.type.DependencyVector;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Interface for building subsystem main classes.
+ * Abstract class for building subsystem main classes.
  *
  * @see EngineSubsystem
  * @since v1-alpha0
  */
 public abstract class SubsystemClass {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this abstract class.
      *
      * @since v1-alpha2
      */
-    public SubsystemClass() {}
-
-    /**
-     * Contains the {@link LoggerInstance} for this instance.
-     *
-     * @see LoggerInstance
-     * @since v1-alpha0
-     */
-    public final LoggerInstance logger = new LoggerInstance.Builder().setClazz(getClass()).setOrigin("ENGINE").build();
+    protected SubsystemClass() {}
 
     /**
      * Returns the name of the subsystem.

base/src/main/java/de/staropensource/engine/base/implementable/VersioningSystem.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementable;
+package de.staropensource.engine.base.implementable;
 
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;
 

base/src/main/java/de/staropensource/engine/base/implementable/helper/EventHelper.java

@@ -0,0 +1,257 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+package de.staropensource.engine.base.implementable.helper;
+
+import de.staropensource.engine.base.EngineConfiguration;
+import de.staropensource.engine.base.EngineInternals;
+import de.staropensource.engine.base.annotation.EventListener;
+import de.staropensource.engine.base.event.LogEvent;
+import de.staropensource.engine.base.exception.reflection.InstanceMethodFromStaticContextException;
+import de.staropensource.engine.base.exception.reflection.InvalidMethodSignatureException;
+import de.staropensource.engine.base.exception.reflection.NoAccessException;
+import de.staropensource.engine.base.exception.reflection.StaticInitializerException;
+import de.staropensource.engine.base.implementable.Event;
+import de.staropensource.engine.base.implementable.EventListenerCode;
+import de.staropensource.engine.base.internal.implementation.EventListenerMethod;
+
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.EventPriority;
+import de.staropensource.engine.base.utility.ListFormatter;
+import lombok.Getter;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+import org.reflections.Reflections;
+import org.reflections.scanners.Scanners;
+import org.reflections.util.ClasspathHelper;
+import org.reflections.util.ConfigurationBuilder;
+
+import java.lang.reflect.InvocationTargetException;
+import java.lang.reflect.Method;
+import java.util.*;
+
+/**
+ * Simplifies event logging and calling.
+ *
+ * @since v1-alpha0
+ */
+@Getter
+public final class EventHelper {
+    /**
+     * Holds all cached events.
+     *
+     * @since v1-alpha5
+     */
+    private static final @NotNull Map<@NotNull Class<? extends Event>, LinkedList<@NotNull EventListenerCode>> cachedEventListeners = new HashMap<>();
+
+    /**
+     * Creates and initializes an instance of this class.
+     *
+     * @since v1-alpha0
+     */
+    private EventHelper() {}
+
+    /**
+     * Registers a new {@link Event}.
+     * <p>
+     * This method does nothing if classpath searching is disabled.
+     *
+     * @param event         {@link Event} to register for
+     * @param eventListener {@link EventListenerCode} to register
+     * @param priority      priority of the listener
+     * @see EngineInternals#getReflectiveClasspathScanning()
+     * @since v1-alpha5
+     */
+    public static synchronized void registerEvent(@NotNull Class<? extends Event> event, @NotNull EventListenerCode eventListener, @NotNull EventPriority priority) {
+        if (EngineInternals.getInstance().getReflectiveClasspathScanning())
+            return;
+
+        // Update 'eventListener' priority
+        eventListener.priority = priority;
+
+        // Check if event already exists in map
+        // If not, create entry with a LinkedList
+        if (cachedEventListeners.containsKey(event))
+            if (cachedEventListeners.get(event).contains(eventListener))
+                return;
+            else
+                cachedEventListeners.get(event).add(eventListener);
+        else {
+            LinkedList<@NotNull EventListenerCode> list = new LinkedList<>();
+            list.add(eventListener);
+            cachedEventListeners.put(event, list);
+        }
+
+        Logger.diag("Registered event listener " + eventListener + " for event " + event + " with priority " + priority.name());
+    }
+
+    /**
+     * Registers a new {@link Event}.
+     * <p>
+     * This method does nothing if classpath searching is disabled.
+     *
+     * @param event         {@link Event} to register for
+     * @param eventListener {@link EventListenerCode} to register
+     * @see EngineInternals#getReflectiveClasspathScanning()
+     * @since v1-alpha5
+     */
+    public static void registerEvent(@NotNull Class<? extends Event> event, @NotNull EventListenerCode eventListener) {
+        registerEvent(event, eventListener, EventPriority.DEFAULT);
+    }
+
+    /**
+     * (Re-)Caches all event listeners for some {@link Event}.
+     * <p>
+     * This method does nothing if classpath searching is enabled.
+     *
+     * @param event event to (re-)cache. Set to {@code null} to recompute all cached events
+     * @see EngineInternals#getReflectiveClasspathScanning()
+     * @since v1-alpha5
+     */
+    public static synchronized void cacheEvent(@Nullable Class<? extends Event> event) {
+        if (!EngineInternals.getInstance().getReflectiveClasspathScanning())
+            return;
+
+        if (event == null)
+            for (Class<? extends Event> cachedEvent : cachedEventListeners.keySet())
+                cacheEvent(cachedEvent);
+        else {
+            LinkedList<@NotNull EventListenerCode> annotatedMethods = getAnnotatedMethods(event);
+
+            if (cachedEventListeners.containsKey(event))
+                cachedEventListeners.replace(event, annotatedMethods);
+            else
+                cachedEventListeners.put(event, annotatedMethods);
+        }
+    }
+
+    /**
+     * Removes an event from the event listener cache.
+     * <p>
+     * This method does nothing if classpath searching is enabled.
+     *
+     * @param event event to uncache. Set to {@code null} to clear the entire cache
+     * @see EngineInternals#getReflectiveClasspathScanning()
+     * @since v1-alpha5
+     */
+    public static synchronized void uncacheEvent(@Nullable Class<? extends Event> event) {
+        if (!EngineInternals.getInstance().getReflectiveClasspathScanning())
+            return;
+
+        if (event == null)
+            cachedEventListeners.clear();
+        else
+            cachedEventListeners.remove(event);
+    }
+
+    /**
+     * Invokes all event listeners.
+     *
+     * @param event event class
+     * @param arguments arguments to pass to event listeners
+     * @since v1-alpha5
+     */
+    public static void invokeAnnotatedMethods(@NotNull Class<? extends Event> event, Object... arguments) {
+        if (event != LogEvent.class && EngineConfiguration.getInstance().isDebugEvents())
+            if (arguments.length == 0)
+                Logger.diag("Event " + event.getName() + " was emitted");
+            else
+                Logger.diag("Event " + event.getName() + " was emitted, passing arguments " + ListFormatter.formatArray(arguments));
+
+        Runnable eventCode = () -> {
+            for (EventListenerCode eventListener : getAnnotatedMethods(event)) {
+                try {
+                    eventListener.run(arguments);
+                } catch (NoAccessException exception) {
+                    Logger.warn("Event listener " + eventListener + " could not be called as the method could not be accessed");
+                } catch (InvalidMethodSignatureException exception) {
+                    Logger.warn("Event listener " + eventListener + " has an invalid method signature");
+                } catch (InvocationTargetException exception) {
+                    Logger.crash("Event listener " + eventListener + " threw a throwable", exception.getTargetException(), true);
+                } catch (InstanceMethodFromStaticContextException exception) {
+                    Logger.warn("Event listener " + eventListener + " is not static. Event listener methods must be static for them to be called.");
+                } catch (StaticInitializerException exception) {
+                    Logger.crash("Event listener " + eventListener + " could not be called as the static initializer failed", exception.getThrowable(), true);
+                } catch (Exception exception) {
+                    Logger.crash("Event listener " + eventListener + " could not be called as an error occurred during reflection", exception, true);
+                }
+            }
+        };
+
+        if (EngineConfiguration.getInstance().isOptimizeEvents())
+            Thread
+                    .ofVirtual()
+                    .name("Event " + event.getName())
+                    .start(eventCode);
+        else
+            eventCode.run();
+    }
+
+    /**
+     * Returns all {@link EventListener}s listening on some event.
+     * The classpath will be scanned for listeners, unless cached results exist and {@code !forceScanning}.
+     *
+     * @param event         event class
+     * @param forceScanning forces scanning the classpath for listeners. not recommended due to a huge performance penalty
+     * @return list of event listeners
+     * @see #cacheEvent(Class)
+     * @since v1-alpha5
+     */
+    public static @NotNull LinkedList<EventListenerCode> getAnnotatedMethods(@NotNull Class<? extends Event> event, boolean forceScanning) {
+        LinkedList<EventListenerCode> eventListeners = new LinkedList<>();
+
+        if (!EngineInternals.getInstance().getReflectiveClasspathScanning())
+            return Objects.requireNonNullElse(cachedEventListeners.get(event), eventListeners);
+
+        if (forceScanning || !cachedEventListeners.containsKey(event)) {
+            Reflections reflections = new Reflections(
+                    new ConfigurationBuilder()
+                            .setUrls(ClasspathHelper.forJavaClassPath())
+                            .setScanners(Scanners.MethodsAnnotated)
+            );
+
+            // Get annotated methods
+            Set<@NotNull Method> annotatedMethods = reflections.getMethodsAnnotatedWith(EventListener.class);
+
+            // Sort event listeners not listening for the specified event out
+            for (Method method : annotatedMethods)
+                if (method.getAnnotation(EventListener.class).event() == event)
+                    eventListeners.add(new EventListenerMethod(method));
+
+            // Sort list after event priority
+            eventListeners.sort(Comparator.comparing(method -> Objects.requireNonNull(((EventListenerMethod) method).getAnnotation(EventListener.class)).priority()));
+        } else
+            // Event listeners are cached and !forceScanning, return cached results
+            eventListeners = cachedEventListeners.get(event);
+
+        return eventListeners;
+    }
+
+    /**
+     * Returns all {@link EventListener}s listening on some event.
+     * The classpath will be scanned for listeners, unless cached results exist.
+     *
+     * @param event event class
+     * @return list of event listeners
+     * @since v1-alpha5
+     */
+    public static @NotNull LinkedList<EventListenerCode> getAnnotatedMethods(@NotNull Class<? extends Event> event) {
+        return getAnnotatedMethods(event, false);
+    }
+}

base/src/main/java/de/staropensource/engine/base/implementable/helper/package-info.java

@@ -23,4 +23,4 @@
  *
  * @since v1-alpha0
  */
-package de.staropensource.sosengine.base.implementable.helper;
+package de.staropensource.engine.base.implementable.helper;

base/src/main/java/de/staropensource/engine/base/implementable/package-info.java

@@ -0,0 +1,25 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Interfaces and abstract classes which can be used for implementing classes.
+ *
+ * @since v1-alpha0
+ */
+package de.staropensource.engine.base.implementable;

base/src/main/java/de/staropensource/engine/base/implementation/logging/PlainLoggingAdapter.java

@@ -0,0 +1,56 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+package de.staropensource.engine.base.implementation.logging;
+
+import de.staropensource.engine.base.EngineConfiguration;
+import de.staropensource.engine.base.implementable.LoggingAdapter;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.implementation.shortcode.EmptyShortcodeParser;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Prints log messages to the console, without any fancy colors or formatting.
+ *
+ * @see Logger
+ * @see LoggingAdapter
+ * @since v1-alpha1
+ */
+public class PlainLoggingAdapter implements LoggingAdapter {
+    /**
+     * Creates and initializes an instance of this class.
+     *
+     * @since v1-alpha1
+     */
+    public PlainLoggingAdapter() {}
+
+    /** {@inheritDoc} */
+    @Override
+    public void print(@NotNull LogLevel level, @NotNull StackTraceElement issuer, @NotNull String message, @NotNull String format) {
+        format = new EmptyShortcodeParser(format, true).getClean();
+        if (level == LogLevel.ERROR || level == LogLevel.CRASH)
+            if (EngineConfiguration.getInstance() != null && EngineConfiguration.getInstance().isLogForceStandardOutput())
+                System.out.println(format);
+            else
+                System.err.println(format);
+        else
+            System.out.println(format);
+    }
+}

base/src/main/java/de/staropensource/engine/base/implementation/logging/QuietLoggingAdapter.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.logging;
+package de.staropensource.engine.base.implementation.logging;
 
-import de.staropensource.sosengine.base.implementable.LoggingAdapter;
-import de.staropensource.sosengine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.implementable.LoggingAdapter;
+import de.staropensource.engine.base.type.logging.LogLevel;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.Nullable;
  */
 public class QuietLoggingAdapter implements LoggingAdapter {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this class.
      *
      * @since v1-alpha4
      */
@@ -40,17 +40,5 @@ public class QuietLoggingAdapter implements LoggingAdapter {
 
     /** {@inheritDoc} */
     @Override
-    public @Nullable String prePlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return null;
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public @NotNull String postPlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return format;
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public void print(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {}
+    public void print(@NotNull LogLevel level, @NotNull StackTraceElement issuer, @NotNull String message, @NotNull String format) {}
 }

base/src/main/java/de/staropensource/engine/base/implementation/logging/RawLoggingAdapter.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.logging;
+package de.staropensource.engine.base.implementation.logging;
 
-import de.staropensource.sosengine.base.EngineConfiguration;
-import de.staropensource.sosengine.base.implementable.LoggingAdapter;
-import de.staropensource.sosengine.base.logging.Logger;
-import de.staropensource.sosengine.base.type.logging.LogLevel;
+import de.staropensource.engine.base.EngineConfiguration;
+import de.staropensource.engine.base.implementable.LoggingAdapter;
+import de.staropensource.engine.base.logging.Logger;
+import de.staropensource.engine.base.type.logging.LogLevel;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
 
@@ -36,7 +36,7 @@ import org.jetbrains.annotations.Nullable;
  */
 public class RawLoggingAdapter implements LoggingAdapter {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this class.
      *
      * @since v1-alpha1
      */
@@ -44,21 +44,9 @@ public class RawLoggingAdapter implements LoggingAdapter {
 
     /** {@inheritDoc} */
     @Override
-    public @Nullable String prePlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return null;  // No modifications necessary
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public @NotNull String postPlaceholder(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
-        return format;  // No modifications necessary
-    }
-
-    /** {@inheritDoc} */
-    @Override
-    public void print(@NotNull LogLevel level, @NotNull Class<?> issuerClass, @NotNull String issuerOrigin, @Nullable String issuerMetadata, @NotNull String message, @NotNull String format) {
+    public void print(@NotNull LogLevel level, @NotNull StackTraceElement issuer, @NotNull String message, @NotNull String format) {
         if (level == LogLevel.ERROR || level == LogLevel.CRASH)
-            if (EngineConfiguration.getInstance().isLoggerForceStandardOutput())
+            if (EngineConfiguration.getInstance().isLogForceStandardOutput())
                 System.out.println(format);
             else
                 System.err.println(format);

base/src/main/java/de/staropensource/engine/base/implementation/logging/package-info.java

@@ -0,0 +1,25 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * A set of built-in {@link de.staropensource.engine.base.implementable.LoggingAdapter}s.
+ *
+ * @since v1-alpha1
+ */
+package de.staropensource.engine.base.implementation.logging;

base/src/main/java/de/staropensource/engine/base/implementation/package-info.java

@@ -0,0 +1,25 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Implementations for various interfaces and abstract classes.
+ *
+ * @since v1-alpha6
+ */
+package de.staropensource.engine.base.implementation;

base/src/main/java/de/staropensource/engine/base/implementation/shortcode/EmptyShortcodeParser.java

@@ -17,28 +17,28 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.shortcode;
+package de.staropensource.engine.base.implementation.shortcode;
 
-import de.staropensource.sosengine.base.implementable.ShortcodeParser;
-import de.staropensource.sosengine.base.exception.ParserException;
+import de.staropensource.engine.base.implementable.ShortcodeParser;
+import de.staropensource.engine.base.exception.ParserException;
 import org.jetbrains.annotations.NotNull;
 
 /**
  * Cleans the string of any tags.
  *
  * @see ShortcodeParser
- * @since v1-alpha1
+ * @since v1-alpha8
  */
-public final class EmptyShortcodeConverter extends ShortcodeParser {
+public final class EmptyShortcodeParser extends ShortcodeParser {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this class.
      *
      * @param string               string to parse
      * @param ignoreInvalidEscapes if {@code true}, will ignore and treat invalid escapes as text
      * @throws ParserException on error
-     * @since v1-alpha1
+     * @since v1-alpha8
      */
-    public EmptyShortcodeConverter(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
+    public EmptyShortcodeParser(@NotNull String string, boolean ignoreInvalidEscapes) throws ParserException {
         super(string, ignoreInvalidEscapes);
     }
 
@@ -46,7 +46,7 @@ public final class EmptyShortcodeConverter extends ShortcodeParser {
      * Returns the parsed string without any tags.
      *
      * @return cleaned input string
-     * @since v1-alpha1
+     * @since v1-alpha8
      */
     public @NotNull String getClean() {
         StringBuilder output = new StringBuilder();

base/src/main/java/de/staropensource/engine/base/implementation/shortcode/package-info.java

@@ -22,4 +22,4 @@
  *
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.implementation.shortcode;
+package de.staropensource.engine.base.implementation.shortcode;

base/src/main/java/de/staropensource/engine/base/implementation/versioning/FourNumberVersioningSystem.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.utility.Miscellaneous;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;
@@ -90,7 +90,8 @@ public final class FourNumberVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a four number-based version string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/OneNumberVersioningSystem.java

@@ -17,11 +17,11 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;
@@ -53,7 +53,8 @@ public final class OneNumberVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a one number-based version string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/SemanticVersioningSystem.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.utility.Miscellaneous;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -109,7 +109,8 @@ public final class SemanticVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a semantic versioning string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/StarOpenSourceVersioningSystem.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
-import de.staropensource.sosengine.base.type.VersionType;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.type.VersionType;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Nullable;
@@ -110,7 +110,8 @@ public final class StarOpenSourceVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a StarOpenSource versioning string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/ThreeNumberVersioningSystem.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.utility.Miscellaneous;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;
@@ -78,7 +78,8 @@ public final class ThreeNumberVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a three number-based version string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/TwoNumberVersioningSystem.java

@@ -17,12 +17,12 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;
 
-import de.staropensource.sosengine.base.implementable.VersioningSystem;
-import de.staropensource.sosengine.base.exception.versioning.IncompatibleVersioningSystemException;
-import de.staropensource.sosengine.base.exception.versioning.InvalidVersionStringException;
-import de.staropensource.sosengine.base.utility.Miscellaneous;
+import de.staropensource.engine.base.implementable.VersioningSystem;
+import de.staropensource.engine.base.exception.versioning.IncompatibleVersioningSystemException;
+import de.staropensource.engine.base.exception.versioning.InvalidVersionStringException;
+import de.staropensource.engine.base.utility.Miscellaneous;
 import lombok.Getter;
 import org.jetbrains.annotations.NotNull;
 import org.jetbrains.annotations.Range;
@@ -66,7 +66,8 @@ public final class TwoNumberVersioningSystem implements VersioningSystem {
     }
 
     /**
-     * Parses a two number-based version string.
+     * Tries to parse the specified version string
+     * and if successful, return a new instance.
      *
      * @param versionString version string to parse
      * @throws InvalidVersionStringException if the version string is invalid

base/src/main/java/de/staropensource/engine/base/implementation/versioning/package-info.java

@@ -23,4 +23,4 @@
  *
  * @since v1-alpha1
  */
-package de.staropensource.sosengine.base.implementation.versioning;
+package de.staropensource.engine.base.implementation.versioning;

base/src/main/java/de/staropensource/engine/base/internal/implementation/EventListenerMethod.java

@@ -0,0 +1,83 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+package de.staropensource.engine.base.internal.implementation;
+
+import de.staropensource.engine.base.implementable.EventListenerCode;
+import de.staropensource.engine.base.reflection.Reflect;
+import de.staropensource.engine.base.reflection.ReflectionMethod;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.lang.annotation.Annotation;
+import java.lang.reflect.Method;
+
+/**
+ * Interface specifically for executing event listener methods.
+ *
+ * @since v1-alpha5
+ */
+public final class EventListenerMethod extends EventListenerCode {
+    /**
+     * Contains the method to call and get.
+     *
+     * @since v1-alpha5
+     */
+    private final @NotNull ReflectionMethod method;
+
+    /**
+     * Creates and initializes an instance of this class.
+     *
+     * @param method method to execute
+     * @since v1-alpha5
+     */
+    public EventListenerMethod(@NotNull Method method) {
+        this.method = Reflect.reflectOn(method);
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public void run(@Nullable Object @NotNull [] arguments) throws Exception {
+        method.invoke(arguments);
+    }
+
+    /**
+     * Forwards {@link ReflectionMethod#getAnnotation(Class)}
+     * to the internal {@link ReflectionMethod} instance.
+     *
+     * @param <T> annotation
+     * @param annotation annotation to get
+     * @return annotation or {@code null} on error
+     * @see ReflectionMethod#getAnnotation(Class)
+     * @since v1-alpha5
+     */
+    public <T extends Annotation> @Nullable T getAnnotation(@NotNull Class<T> annotation) {
+        try {
+            return method.getAnnotation(annotation);
+        } catch (NullPointerException exception) {
+            return null;
+        }
+    }
+
+    /** {@inheritDoc} */
+    @Override
+    public String toString() {
+        return "method " + method.getMethod().getDeclaringClass().getName() + "#" + method.getName();
+    }
+}

base/src/main/java/de/staropensource/engine/base/internal/implementation/package-info.java

@@ -0,0 +1,25 @@
+/*
+ * STAROPENSOURCE ENGINE SOURCE FILE
+ * Copyright (c) 2024 The StarOpenSource Engine Authors
+ * Licensed under the GNU Affero General Public License v3
+ *
+ * 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 <https://www.gnu.org/licenses/>.
+ */
+
+/**
+ * Interfaces and abstract classes which can be used for implementing classes.
+ *
+ * @since v1-alpha5
+ */
+package de.staropensource.engine.base.internal.implementation;

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/DateDay.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.Math;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.Math;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.Calendar;
@@ -34,7 +34,7 @@ import java.util.Calendar;
 @SuppressWarnings({ "unused" })
 public final class DateDay implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/DateMonth.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.Math;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.Math;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.Calendar;
@@ -34,7 +34,7 @@ import java.util.Calendar;
 @SuppressWarnings({ "unused" })
 public final class DateMonth implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/DateYear.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.Math;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.Math;
 import org.jetbrains.annotations.NotNull;
 
 import java.util.Calendar;
@@ -34,7 +34,7 @@ import java.util.Calendar;
 @SuppressWarnings({ "unused" })
 public final class DateYear implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineDependencyJansi.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineDependencyJansi implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineDependencyLwjgl.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineDependencyLwjgl implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineDependencyReflections.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineDependencyReflections implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineDependencySlf4j.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineDependencySlf4j implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitBranch.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitBranch implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitHeader.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitHeader implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitIdLong.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitIdLong implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitIdShort.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitIdShort implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeDay.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeDay implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeHour.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeHour implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeMinute.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeMinute implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeMonth.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeMonth implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeSecond.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeSecond implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitTimeYear.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitTimeYear implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommits.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommits implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitterEmail.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitterEmail implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitCommitterName.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitCommitterName implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineGitDirty.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineGitDirty implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersion.java

@@ -17,9 +17,9 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
+import de.staropensource.engine.base.implementable.Placeholder;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -31,7 +31,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineVersion implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersionCodename.java

@@ -17,40 +17,30 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder.crashhandler;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
- * Implements the {@code crash_message} placeholder.
+ * Implements the {@code engine_version_codename} placeholder.
  *
  * @see Placeholder
- * @since v1-alpha0
+ * @since v1-alpha8
  */
 @SuppressWarnings({ "unused" })
-public final class CrashMessage implements Placeholder {
+public final class EngineVersionCodename implements Placeholder {
     /**
-     * The message to use.
+     * Creates and initializes an instance of this event.
      *
-     * @since v1-alpha0
+     * @since v1-alpha8
      */
-    @NotNull
-    private final String message;
-
-    /**
-     * Constructs this class.
-     *
-     * @param message message to use
-     * @since v1-alpha0
-     */
-    public CrashMessage(@NotNull String message) {
-        this.message = message;
-    }
+    public EngineVersionCodename() {}
 
     /** {@inheritDoc} */
     @Override
     public @NotNull String replace(@NotNull String text) {
-        return text.replace("%crash_message%", message);
+        return text.replace("%engine_version_codename%", EngineInformation.getVersioningCodename());
     }
 }

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersionFork.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineVersionFork implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersionType.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineVersionType implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersionTyperelease.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineVersionTyperelease implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/EngineVersionVersion.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.EngineInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.EngineInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class EngineVersionVersion implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/JvmArguments.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.JvmInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.JvmInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class JvmArguments implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/JvmImplementationName.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.JvmInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.JvmInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class JvmImplementationName implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */

base/src/main/java/de/staropensource/engine/base/internal/implementation/placeholder/JvmImplementationVendor.java

@@ -17,10 +17,10 @@
  * along with this program.  If not, see <https://www.gnu.org/licenses/>.
  */
 
-package de.staropensource.sosengine.base.internal.implementation.placeholder;
+package de.staropensource.engine.base.internal.implementation.placeholder;
 
-import de.staropensource.sosengine.base.implementable.Placeholder;
-import de.staropensource.sosengine.base.utility.information.JvmInformation;
+import de.staropensource.engine.base.implementable.Placeholder;
+import de.staropensource.engine.base.utility.information.JvmInformation;
 import org.jetbrains.annotations.NotNull;
 
 /**
@@ -32,7 +32,7 @@ import org.jetbrains.annotations.NotNull;
 @SuppressWarnings({ "unused" })
 public final class JvmImplementationVendor implements Placeholder {
     /**
-     * Constructs this class.
+     * Creates and initializes an instance of this event.
      *
      * @since v1-alpha0
      */