Wood League announcer enhancements

.gitignore

@@ -0,0 +1,4 @@
+/.idea/
+/.gradle/
+/testbed/
+/build/

README.md

@@ -1,13 +1,126 @@
-# EliteMobs
+Thank you for using EliteMobs!
 
-This is the GitHub project for the Minecraft plugin EliteMobs (Spigot page can be seen here: https://www.spigotmc.org/resources/elitemobs.40090/)
+This plugin is made to both work from the very start with no additional config work and to be highly customizable.
 
-Feel free to check the source code and do any edits you might deem necessary for your own servers.
+If you want to make some deep configuration changes to the plugin, try to read the GitHub wiki I've created ahead of time or as you're making the changes so you know what the options are doing. https://github.com/MagmaGuy/EliteMobs
 
-At this time, I am not interested in accepting contributions to the code. This is my first project of this dimension, and I'd like to have all components of it be written by me.
+If you need support with this plugin, you can reach me at my discord support channel: https://discord.gg/QSA2wgh
 
-That being said, I am deeply interested in any suggestions, be they for improving existing features or creating new ones.
+For all things EliteMobs related, you can go to my website to find all resources I've made available, such as the github page, the wiki, the custom loot maker, so on.
 
-# There's a wiki, it has a few entries, if you want more info maybe try reading it.
+Hope you enjoy! If you do, leave rating on the resource page and / or buy me a coffee ! (paypal links can be found in the spigot resource page)
 
-# //TODO: add description of features and how they work, some day, maybe
+
+# Dev notes:
+
+## API
+
+EliteMobs has a few basic APIs to interface with in the `com.magmaguy.elitemobs.api` package. Here's the breakdown:
+
+### DamageEliteMob
+
+Used for applying custom damage to Elite Mobs. Uses:
+- Bypass EliteMobs' custom damage system for a specific damage event
+- Apply an automatically recommended custom amount of damage which varies based on the tier of the boss.
+
+*Note:* the variable damage takes the elite's tier into account and deals more damage to higher tiers. It does not take the health multiplier into account for custom bosses for balance reasons.
+
+### EliteMobDamagedByEliteMobEvent
+
+Used for listening to moments when one Elite damages another Elite. Uses:
+- Same as Bukkit's EntityDamagedByEntity event but for elites specifically
+- Cancelling it might not work. Report if it doesn't.
+
+### EliteMobDamagedByPlayerAntiExploit
+Used for listening to events which trigger an antiexploit **check** - doesn't necessarily mean that it detected an exploit. Uses:
+- Same as Bukkit's EntityDamagedByEntity event but for elites specifically
+- Can be cancelled
+
+### EliteMobDamagedByPlayerEvent:
+Used for listening to moments when a player damages an Elite. Uses:
+
+- Same as Bukkit's EntityDamagedByEntity event but for players damaging elites specifically
+- ***Important:*** can't be cancelled as it only fires after applying the damage
+
+### EliteMobDamagedEvent:
+Used for listening to moments when an elite is damaged in general. Uses:
+
+- Same as Bukkit's EntityDamageEvent
+- ***Important*** Cancelling this event might not 100% work, report if it doesn't
+
+### EliteMobDeathEvent:
+Used to listening to moments when an elite is killed. Uses:
+
+- Same as Bukkit's EntityDeathEvent.
+
+### EliteMobEnterCombatEvent:
+Used for listening to moments when an elite enters combat against a player. Uses:
+
+- Get the target (player only) of the Elite
+- Get the elite which entered in combat
+
+#### EliteMobExitCombatEvent:
+Used for listening to moments when an elite leaves combat against a player. Uses:
+
+- Get the elite which just let combat.
+
+### EliteMobsItemDetector:
+Used for detecting whether an ItemStack is an EliteMobs ItemStack (like a custom item or a procedurally generated item). Uses:
+
+- Detect if an ItemStack is an EliteMobs custom or dynamic item.
+
+### EliteMobSpawnEvent:
+Used for detecting when an Elite spawns. USes:
+
+- Detect when an Elite spawns
+- Detect which Elite spawned
+
+### EliteMobTargetPlayerEvent:
+Used for detecting when an Elite has targetted a player. Uses:
+
+- Detect when an Elite targets a player.
+- Cancel an Elite's detection of a player.
+
+### GenericAntiExploitEvent
+
+Used for listening to moments when the antiexploit runs a check but no players damaged it. Uses:
+
+- Detect when the antiexploit is doing a non-player based exploit check
+- Cancel an antiexploit check
+
+### PlayerDamagedByEliteMobEvent
+
+Used for listening to moments when players are damaged by an Elite. Uses:
+
+- Same as Bukkit's EntityDamageEvent
+
+---
+
+
+## To add new item enchantments:
+1) Add new enchantment class to the `com.magmaguy.elitemobs.config.enchantments.premade` **extending** `EnchantmentsConfigFields` to initialize create its config file (naming convention: [EnchantmentName]Config)
+2) Initialize enchantment in `CustomEnchantment` to initialize the config file
+3) Add enchantment class to `com.magmaguy.elitemobs.items.customenchantments` **extending** `CustomEnchantment` to write the logic for the enchantment (naming convention [EnchantmentName]Enchantment)
+4) Add a public static String called "key" to register using the ItemTagger class for persistent enchantment tracking
+5) Add an customLootEntry to the parseEnchantments() method in `CustomItem` so custom items detect it correctly
+6) (Alternative) Add an customLootEntry to `generateCustomEnchantments()` method in `EnchantmentGenerator` if the enchantment should appear in procedurally generated items
+
+Note:
+- Don't forget to register events in `EventsRegistrer` if the part with logic in it requires events.
+- Don't forget to use the damage bypass if the power is supposed to deal custom damage. Damage dealt by the player to an elite can be overwritten in `CombatSystem` through the static "bypass" boolean field - it makes the next damage dealt to the elite use the raw damage value. For correctly assigning damage, use Bukkit's `Damageable#damage(double amount, Entity source)` and assign the source to your player.
+
+## To add new powers to elites:
+
+to be documented
+
+## To add new events:
+
+to be documented
+
+## To add new default NPCs:
+
+to be documented
+
+## To add new mob types:
+
+to be documented

build.gradle

@@ -0,0 +1,166 @@
+plugins {
+    id 'java-library'
+    id 'idea'
+    id 'maven-publish'
+    id "com.github.johnrengelman.shadow" version "7.0.0"
+}
+
+//Fixes issues related to special characters being used
+compileJava.options.encoding = "UTF-8"
+compileTestJava.options.encoding = "UTF-8"
+
+group 'com.magmaguy'
+version '7.3.15-SNAPSHOT-5'
+
+repositories {
+    maven {
+        url = 'https://hub.spigotmc.org/nexus/content/repositories/snapshots/'
+
+        // As of Gradle 5.1, you can limit this to only those
+        // dependencies you expect from it
+        content {
+            includeGroup 'org.bukkit'
+            includeGroup 'org.spigotmc'
+        }
+    }
+
+    mavenCentral()
+    jcenter()
+    mavenLocal()
+
+    //Spigot API & CloudCommands
+    maven { url = 'https://oss.sonatype.org/content/repositories/snapshots' }
+    maven { url = 'https://oss.sonatype.org/content/repositories/central' }
+
+    maven { url "https://hub.spigotmc.org/nexus/content/repositories/snapshots" }
+
+    //Bstats API
+    maven { url = 'https://repo.codemc.org/repository/maven-public' }
+    //CloudCommands
+    maven { url = 'https://oss.sonatype.org/content/repositories/snapshots' }
+    //Vault
+    maven { url = 'https://jitpack.io' }
+    //DiscordSRV
+    maven { url = 'https://m2.dv8tion.net/releases/' }
+    maven { url = 'https://nexus.scarsz.me/content/groups/public/' }
+    //LibsDisguises
+    maven { url = 'https://repo.md-5.net/content/groups/public/' }
+    //PlaceholderAPI
+    maven { url = 'https://repo.extendedclip.com/content/repositories/placeholderapi/' }
+
+    //WorldGuard API
+    maven { url = 'https://maven.enginehub.org/repo/' }
+
+    //Model Engine
+    maven {
+        url = 'https://mvn.lumine.io/repository/maven-public/'
+        metadataSources {
+            artifact()
+        }
+    }
+
+    //Geyser
+    maven { url = 'https://repo.opencollab.dev/main/' }
+
+}
+
+dependencies {
+    //Spigot API
+    compileOnly "org.spigotmc:spigot-api:1.18-R0.1-SNAPSHOT"
+
+    //compileOnly 'org.spigotmc:spigot:1.17-R0.1-SNAPSHOT'
+    // The full CraftBukkit server with no shadowing. Requires mavenLocal.
+    //BStats API
+    implementation group: 'org.bstats', name: 'bstats-bukkit', version: '2.2.1'
+    //WorldGuard API
+    compileOnly group: 'com.sk89q.worldguard', name: 'worldguard-bukkit', version: '7.0.0'
+    //CloudCommands
+    implementation group: 'cloud.commandframework', name: 'cloud-paper', version: '1.5.0'
+    //CloudCommands Minecraft Extras module
+    implementation group: 'cloud.commandframework', name: 'cloud-minecraft-extras', version: '1.5.0'
+    //CloudCommands Adventure Platform module
+    implementation("net.kyori:adventure-platform-bukkit:4.0.0")
+    //I can't remember what this was for but it's in CloudCommands
+    implementation group: 'io.leangen.geantyref', name: 'geantyref', version: '1.3.4'
+    //Vault
+    //compileOnly group: 'com.github.MilkBowl', name: 'VaultAPI', version: '1.7'
+    compileOnly("com.github.MilkBowl:VaultAPI:1.7") {
+        exclude group: 'org.bukkit', module: 'bukkit'
+    }
+    //DiscordSRV
+    //compileOnly 'net.dv8tion:JDA:4.2.1_262'
+    compileOnly 'com.discordsrv:discordsrv:1.24.0'
+    //SQLite
+    compileOnly group: 'org.xerial', name: 'sqlite-jdbc', version: '3.32.3'
+    //LibsDisguises
+    compileOnly group: 'com.comphenix.protocol', name: 'ProtocolLib', version: '4.7.0';
+    compileOnly group: 'LibsDisguises', name: 'LibsDisguises', version: '10.0.26'
+    //PlaceholderAPI
+    compileOnly group: 'me.clip', name: 'placeholderapi', version: '2.10.9'
+
+    implementation group: 'commons-io', name: 'commons-io', version: '2.6'
+
+    //reflections - used for config initialization
+    implementation group: 'org.reflections', name: 'reflections', version: '0.9.12'
+
+    //lombok
+    compileOnly 'org.projectlombok:lombok:1.18.22'
+    annotationProcessor 'org.projectlombok:lombok:1.18.22'
+
+    //Model Engine
+    compileOnly "com.ticxo.modelengine:api:R2.5.0"
+
+    testCompileOnly 'org.projectlombok:lombok:1.18.20'
+    testAnnotationProcessor 'org.projectlombok:lombok:1.18.20'
+
+    //Geyser for bedrock player detection
+    //This needs java 16 to work so you will want to change gradle.properties to match your directory for it
+    //compileOnly("org.geysermc:geyser-api:2.0.2-SNAPSHOT") disabled because I couldn't find an easy way to see if a player is using geyser through their api due to the bungeecord / waterfall specific implementations
+
+}
+
+/*
+java {
+    toolchain {
+        languageVersion.set(JavaLanguageVersion.of(16))
+    }
+}
+ */
+
+artifacts { // task 'build' runs generates uberjar
+    archives shadowJar
+}
+
+jar {
+    archiveClassifier.set('min') // we want the Uberjar to be distributed, this is the minified version
+}
+
+String packagePath = 'com.magmaguy.shaded'
+
+// Relocating a Package
+shadowJar {
+    dependencies {
+        relocate('org.bstats', packagePath + '.bstats')
+        relocate('cloud.commandframework', packagePath + '.cloud')
+        relocate('net.kyori', packagePath + '.adventure-platform-bukkit')
+        relocate('io.leangen.geantyref', packagePath + '.geantyref')
+        relocate('org.reflections', packagePath + '.reflections')
+    }
+    archiveClassifier.set(null)
+    archiveFileName.set(project.name + ".jar")
+    destinationDirectory.set(new File("testbed/plugins"))
+}
+
+tasks.withType(JavaCompile) {
+    options.encoding = 'UTF-8'
+}
+
+ext {
+    resourceTokens = [
+            'Version': version
+    ]
+}
+
+processResources {
+    filter org.apache.tools.ant.filters.ReplaceTokens, tokens: resourceTokens
+}

gradle.properties

@@ -0,0 +1,5 @@
+projectName=EliteMobs
+group=com.magmaguy.elitemobs
+version=7.2.33
+author=MagmaGuy
+mainClass=EliteMobs

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,5 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-7.0-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists