feat: add in a new event for players joining a war

Author: darbyjack

src/main/kotlin/me/glaremasters/guilds/api/events/challenges/GuildWarPlayerJoinEvent.kt

@@ -0,0 +1,35 @@
+package me.glaremasters.guilds.api.events.challenges
+
+import me.glaremasters.guilds.guild.Guild
+import org.bukkit.entity.Player
+import org.bukkit.event.Event
+import org.bukkit.event.HandlerList
+
+/**
+ * An event that is called when a player joins a guild war.
+ *
+ * @property challenger the guild who initiated the request
+ * @property defender the guild who the request is sent to
+ * @property player the player who joined the war
+ * @property side the side the player joined
+ */
+class GuildWarPlayerJoinEvent(val challenger: Guild, val defender: Guild, val player: Player, val side: String): Event() {
+
+    /**
+     * The handlers for the event.
+     *
+     * @return the handlers for the event
+     */
+    override fun getHandlers(): HandlerList {
+        return handlerList
+    }
+
+    companion object {
+
+        /**
+         * The static list of event handlers for this event type.
+         */
+        @JvmStatic
+        val handlerList = HandlerList()
+    }
+}

src/main/kotlin/me/glaremasters/guilds/commands/war/CommandWar.kt

@@ -40,6 +40,7 @@ import me.glaremasters.guilds.Guilds
 import me.glaremasters.guilds.api.events.challenges.GuildWarAcceptEvent
 import me.glaremasters.guilds.api.events.challenges.GuildWarChallengeEvent
 import me.glaremasters.guilds.api.events.challenges.GuildWarDeclineEvent
+import me.glaremasters.guilds.api.events.challenges.GuildWarPlayerJoinEvent
 import me.glaremasters.guilds.arena.ArenaHandler
 import me.glaremasters.guilds.challenges.ChallengeHandler
 import me.glaremasters.guilds.configuration.sections.WarSettings
@@ -198,6 +199,8 @@ internal class CommandWar : BaseCommand() {
             throw ExpectationNotMet(Messages.WAR__NOT_JOINABLE)
         }
 
+        var side = ""
+
         if (challenge.defender == guild) {
             if (challenge.defendPlayers.contains(player.uniqueId)) {
                 throw ExpectationNotMet(Messages.WAR__ALREADY_JOINED)
@@ -206,6 +209,7 @@ internal class CommandWar : BaseCommand() {
                 throw ExpectationNotMet(Messages.WAR__ALREADY_AT_MAX)
             }
             challenge.defendPlayers.add(player.uniqueId)
+            side = "challenger"
         } else {
             if (challenge.challengePlayers.contains(player.uniqueId)) {
                 throw ExpectationNotMet(Messages.WAR__ALREADY_JOINED)
@@ -214,8 +218,12 @@ internal class CommandWar : BaseCommand() {
                 throw ExpectationNotMet(Messages.WAR__ALREADY_AT_MAX)
             }
             challenge.challengePlayers.add(player.uniqueId)
+            side = "defender"
         }
 
+        val event = GuildWarPlayerJoinEvent(challenge.challenger, challenge.defender, player, side)
+        Bukkit.getPluginManager().callEvent(event)
+
         guild.sendMessage(currentCommandManager, Messages.WAR__WAR_JOINED, "{player}", player.name)
     }
 }