Add ScoreCause to CompetitorScoreChangeEvent and MatchPlayerScoreEvent

core/src/main/java/tc/oc/pgm/api/party/event/CompetitorScoreChangeEvent.java

@@ -2,6 +2,7 @@
 
 import org.bukkit.event.HandlerList;
 import tc.oc.pgm.api.party.Competitor;
+import tc.oc.pgm.score.ScoreCause;
 
 /**
  * Called when the score of a {@link Competitor} changes.
@@ -12,11 +13,14 @@ public class CompetitorScoreChangeEvent extends PartyEvent {
 
   private final double oldScore;
   private final double newScore;
+  private final ScoreCause cause;
 
-  public CompetitorScoreChangeEvent(Competitor competitor, double oldScore, double newScore) {
+  public CompetitorScoreChangeEvent(
+      Competitor competitor, double oldScore, double newScore, ScoreCause cause) {
     super(competitor);
     this.oldScore = oldScore;
     this.newScore = newScore;
+    this.cause = cause;
   }
 
   /**
@@ -46,6 +50,15 @@ public double getNewScore() {
     return this.newScore;
   }
 
+  /**
+   * Get the {@link ScoreCause} of the change in score
+   *
+   * @return The cause of the score change.
+   */
+  public ScoreCause getCause() {
+    return cause;
+  }
+
   private static final HandlerList handlers = new HandlerList();
 
   @Override

core/src/main/java/tc/oc/pgm/controlpoint/ControlPoint.java

@@ -25,6 +25,7 @@
 import tc.oc.pgm.goals.SimpleGoal;
 import tc.oc.pgm.goals.events.GoalCompleteEvent;
 import tc.oc.pgm.goals.events.GoalStatusChangeEvent;
+import tc.oc.pgm.score.ScoreCause;
 import tc.oc.pgm.score.ScoreMatchModule;
 import tc.oc.pgm.teams.Team;
 import tc.oc.pgm.teams.TeamMatchModule;
@@ -275,7 +276,9 @@ protected void tickScore(Duration duration) {
         float growth = this.getDefinition().getPointsGrowth();
         float rate = (float) (initial * Math.pow(2, seconds / growth));
         scoreMatchModule.incrementScore(
-            this.getControllingTeam(), rate * duration.toMillis() / 1000);
+            this.getControllingTeam(),
+            rate * duration.toMillis() / 1000,
+            ScoreCause.CONTROL_POINT_TICK);
       }
     }
   }
@@ -373,10 +376,15 @@ private void dominateAndFireEvents(
       if (scoreMatchModule != null) {
         if (oldControllingTeam != null) {
           scoreMatchModule.incrementScore(
-              oldControllingTeam, getDefinition().getPointsOwner() * -1);
+              oldControllingTeam,
+              getDefinition().getPointsOwner() * -1,
+              ScoreCause.CONTROL_POINT_OWNED);
         }
         if (this.controllingTeam != null) {
-          scoreMatchModule.incrementScore(this.controllingTeam, getDefinition().getPointsOwner());
+          scoreMatchModule.incrementScore(
+              this.controllingTeam,
+              getDefinition().getPointsOwner(),
+              ScoreCause.CONTROL_POINT_LOST);
         }
       }
       if (this.controllingTeam == null) {

core/src/main/java/tc/oc/pgm/flag/state/Carried.java

@@ -44,6 +44,7 @@
 import tc.oc.pgm.flag.event.FlagStateChangeEvent;
 import tc.oc.pgm.goals.events.GoalEvent;
 import tc.oc.pgm.kits.Kit;
+import tc.oc.pgm.score.ScoreCause;
 import tc.oc.pgm.score.ScoreMatchModule;
 import tc.oc.pgm.scoreboard.SidebarMatchModule;
 import tc.oc.pgm.spawns.events.ParticipantDespawnEvent;
@@ -204,7 +205,8 @@ public void tickRunning() {
     if (smm != null && this.flag.getDefinition().getPointsPerSecond() != 0) {
       smm.incrementScore(
           this.getBeneficiary(this.flag.getDefinition().getOwner()),
-          this.flag.getDefinition().getPointsPerSecond() / 20D);
+          this.flag.getDefinition().getPointsPerSecond() / 20D,
+          ScoreCause.FLAG_CARRIED_TICK);
     }
   }
 
@@ -251,13 +253,17 @@ protected void captureFlag(NetDefinition net) {
     ScoreMatchModule smm = this.flag.getMatch().getModule(ScoreMatchModule.class);
     if (smm != null) {
       if (net.getPointsPerCapture() != 0) {
-        smm.incrementScore(this.getBeneficiary(net.getOwner()), net.getPointsPerCapture());
+        smm.incrementScore(
+            this.getBeneficiary(net.getOwner()),
+            net.getPointsPerCapture(),
+            ScoreCause.FLAG_CAPTURE);
       }
 
       if (this.flag.getDefinition().getPointsPerCapture() != 0) {
         smm.incrementScore(
             this.getBeneficiary(this.flag.getDefinition().getOwner()),
-            this.flag.getDefinition().getPointsPerCapture());
+            this.flag.getDefinition().getPointsPerCapture(),
+            ScoreCause.FLAG_CAPTURE);
       }
     }
 

core/src/main/java/tc/oc/pgm/flag/state/Returned.java

@@ -10,6 +10,7 @@
 import tc.oc.pgm.api.player.ParticipantState;
 import tc.oc.pgm.flag.Flag;
 import tc.oc.pgm.flag.Post;
+import tc.oc.pgm.score.ScoreCause;
 import tc.oc.pgm.score.ScoreMatchModule;
 import tc.oc.pgm.teams.TeamMatchModule;
 
@@ -45,7 +46,8 @@ public void tickRunning() {
     if (smm != null && this.post.getOwner() != null && this.post.getPointsPerSecond() != 0) {
       smm.incrementScore(
           this.flag.getMatch().needModule(TeamMatchModule.class).getTeam(this.post.getOwner()),
-          this.post.getPointsPerSecond() / 20D);
+          this.post.getPointsPerSecond() / 20D,
+          ScoreCause.FLAG_RETURNED_TICK);
     }
   }
 

core/src/main/java/tc/oc/pgm/score/MatchPlayerScoreEvent.java

@@ -9,16 +9,22 @@ public class MatchPlayerScoreEvent extends MatchPlayerEvent {
   private static final HandlerList handlers = new HandlerList();
 
   private final double score;
+  private final ScoreCause cause;
 
-  public MatchPlayerScoreEvent(MatchPlayer player, double score) {
+  public MatchPlayerScoreEvent(MatchPlayer player, double score, ScoreCause cause) {
     super(player);
     this.score = score;
+    this.cause = cause;
   }
 
   public double getScore() {
     return score;
   }
 
+  public ScoreCause getCause() {
+    return cause;
+  }
+
   @Override
   public HandlerList getHandlers() {
     return handlers;

core/src/main/java/tc/oc/pgm/score/ScoreCause.java

@@ -0,0 +1,14 @@
+package tc.oc.pgm.score;
+
+public enum ScoreCause {
+  CONTROL_POINT_LOST,
+  CONTROL_POINT_OWNED,
+  CONTROL_POINT_TICK,
+  DEATH,
+  FLAG_CAPTURE,
+  FLAG_CARRIED_TICK,
+  FLAG_RETURNED_TICK,
+  KILL,
+  SCOREBOX,
+  VARIABLE
+}

core/src/main/java/tc/oc/pgm/score/ScoreMatchModule.java

@@ -163,10 +163,16 @@ public void incrementDeath(MatchPlayerDeathEvent event) {
     // add +1 to killer's team if it was a kill, otherwise -1 to victim's team
     if (event.isChallengeKill()) {
       this.incrementScore(
-          event.getKiller().getId(), event.getKiller().getParty(), this.config.killScore());
+          event.getKiller().getId(),
+          event.getKiller().getParty(),
+          this.config.killScore(),
+          ScoreCause.KILL);
     } else {
       this.incrementScore(
-          event.getVictim().getId(), event.getVictim().getCompetitor(), -this.config.deathScore());
+          event.getVictim().getId(),
+          event.getVictim().getCompetitor(),
+          -this.config.deathScore(),
+          ScoreCause.DEATH);
     }
   }
 
@@ -261,7 +267,7 @@ private void playerScore(ScoreBox box, MatchPlayer player, double points) {
 
     if (points == 0) return;
 
-    this.incrementScore(player.getId(), player.getCompetitor(), points);
+    this.incrementScore(player.getId(), player.getCompetitor(), points, ScoreCause.SCOREBOX);
     box.setLastScoreTime(player, Instant.now());
 
     int wholePoints = (int) points;
@@ -277,15 +283,15 @@ private void playerScore(ScoreBox box, MatchPlayer player, double points) {
     player.playSound(Sounds.SCORE);
   }
 
-  public void incrementScore(UUID player, Competitor competitor, double amount) {
+  public void incrementScore(UUID player, Competitor competitor, double amount, ScoreCause cause) {
     double contribution = contributions.get(player) + amount;
     contributions.put(player, contribution);
-    incrementScore(competitor, amount);
+    incrementScore(competitor, amount, cause);
 
     MatchPlayer mp = match.getPlayer(player);
     if (mp == null) return;
 
-    match.callEvent(new MatchPlayerScoreEvent(mp, amount));
+    match.callEvent(new MatchPlayerScoreEvent(mp, amount, cause));
 
     if (contribution <= PGM.get().getConfiguration().getGriefScore()) {
       // wait until the next tick to do this so stat recording and other stuff works
@@ -298,24 +304,24 @@ public void incrementScore(UUID player, Competitor competitor, double amount) {
     }
   }
 
-  public void setScore(@NotNull Competitor competitor, double value) {
+  public void setScore(@NotNull Competitor competitor, double value, ScoreCause cause) {
     double curr = getScore(competitor);
-    if (curr != value) setScore(competitor, curr, value);
+    if (curr != value) setScore(competitor, curr, value, cause);
   }
 
-  public void incrementScore(Competitor competitor, double amount) {
+  public void incrementScore(Competitor competitor, double amount, ScoreCause cause) {
     double oldScore = this.scores.get(competitor);
     double newScore = oldScore + amount;
-    setScore(competitor, oldScore, newScore);
+    setScore(competitor, oldScore, newScore, cause);
   }
 
-  private void setScore(Competitor competitor, double oldScore, double newScore) {
+  private void setScore(Competitor competitor, double oldScore, double newScore, ScoreCause cause) {
     if (this.config.scoreLimit() > 0 && newScore > this.config.scoreLimit()) {
       newScore = this.config.scoreLimit();
     }
 
     CompetitorScoreChangeEvent event =
-        new CompetitorScoreChangeEvent(competitor, oldScore, newScore);
+        new CompetitorScoreChangeEvent(competitor, oldScore, newScore, cause);
     this.match.callEvent(event);
 
     this.scores.put(competitor, event.getNewScore());

core/src/main/java/tc/oc/pgm/variables/types/ScoreVariable.java

@@ -2,6 +2,7 @@
 
 import tc.oc.pgm.api.party.Competitor;
 import tc.oc.pgm.api.party.Party;
+import tc.oc.pgm.score.ScoreCause;
 import tc.oc.pgm.score.ScoreMatchModule;
 
 public class ScoreVariable extends AbstractVariable<Party> {
@@ -24,6 +25,8 @@ protected double getValueImpl(Party party) {
   @Override
   protected void setValueImpl(Party party, double value) {
     if (party instanceof Competitor c)
-      party.moduleOptional(ScoreMatchModule.class).ifPresent(smm -> smm.setScore(c, value));
+      party
+          .moduleOptional(ScoreMatchModule.class)
+          .ifPresent(smm -> smm.setScore(c, value, ScoreCause.VARIABLE));
   }
 }