feat: initial CR-Core library (team + player + command framework)

Pure Maven library for CR Minecraft game plugins, targeting Paper 1.16.5. Common abstractions (fr.luc.crcore.common): Identifiable, Named, ScoreHolder, AbstractEntity, Repository<T>. Team domain (fr.luc.crcore.team): Team entity with name/tag/color/leader/ visibility (PUBLIC|PRIVATE)/members/scores/spawn point, TeamMember, TeamRole/TeamColor/TeamVisibility enums, TeamRanking record, TeamService with overridable hooks (factories, validations, lifecycle events), in-memory repository, dedicated exception hierarchy. Player domain (fr.luc.crcore.player): PlayerProfile with named scores per player, PlayerProfileService with auto-creation, individual rankings, exception hierarchy. Both Team and PlayerProfile implement ScoreHolder. Command framework (fr.luc.crcore.command): Command interface, AbstractCommand base, BaseCommand (CommandExecutor + TabCompleter), SubCommand, CommandContext, CommandResult, ArgumentType<T> + ArgumentTypes catalogue (STRING, INTEGER, DOUBLE, BOOLEAN, ONLINE_PLAYER, enumOf, choice). Docs (docs/) is the single source of truth: README, setup, features, decisions log, and 6 PlantUML diagrams (team class/sequence/activity/join, player class, command class). Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-06-08 17:17:56 +02:00
commit ffc77c4213
53 changed files with 3642 additions and 0 deletions
@@ -0,0 +1,110 @@
+@startuml player-class-diagram
+title CR-Core — Player domain (class diagram)
+
+skinparam classAttributeIconSize 0
+hide empty members
+
+' === Common abstractions ===
+
+package "fr.luc.crcore.common" {
+
+  interface Identifiable {
+    + getId(): UUID
+  }
+
+  interface ScoreHolder {
+    + getScore(name): int
+    + hasScore(name): boolean
+    + getScores(): Map<String, Integer>
+    + getTotalScore(): int
+    + addScore(name, delta): int
+    + setScore(name, value): int
+    + resetScore(name): boolean
+    + resetAllScores(): void
+  }
+
+  abstract class AbstractEntity {
+    - id: UUID
+    + getId(): UUID
+  }
+
+  interface "Repository<T extends Identifiable>" as Repository {
+    + save(entity: T): T
+    + findById(id): Optional<T>
+    + findAll(): Collection<T>
+    + delete(id): boolean
+  }
+
+  AbstractEntity ..|> Identifiable
+}
+
+' === Player domain ===
+
+package "fr.luc.crcore.player" {
+
+  class PlayerProfile {
+    - scores: Map<String, Integer>
+    + PlayerProfile(playerId: UUID)
+    + getPlayerId(): UUID
+  }
+
+  class PlayerRanking <<record>> {
+    + rank: int
+    + profile: PlayerProfile
+    + score: int
+  }
+
+  interface PlayerProfileRepository
+
+  class InMemoryPlayerProfileRepository {
+    - profiles: Map<UUID, PlayerProfile>
+  }
+
+  interface PlayerProfileService {
+    + getOrCreateProfile(playerId): PlayerProfile
+    + getProfile(playerId): Optional<PlayerProfile>
+    + deleteProfile(playerId): boolean
+    + getAllProfiles(): Collection<PlayerProfile>
+    --
+    + addScore(playerId, name, delta): int
+    + setScore(playerId, name, value): int
+    + getScore(playerId, name): int
+    + resetScore(playerId, name): boolean
+    + resetAllScores(playerId): void
+    --
+    + getRankingByScore(name): List<PlayerRanking>
+    + getGlobalRanking(): List<PlayerRanking>
+    + getTopRankingByScore(name, limit): List<PlayerRanking>
+    + getTopGlobalRanking(limit): List<PlayerRanking>
+  }
+
+  class PlayerProfileServiceImpl {
+    - repository: PlayerProfileRepository
+    --
+    # newProfile(playerId): PlayerProfile
+    # newRanking(rank, profile, score): PlayerRanking
+    # rank(scoreFn): List<PlayerRanking>
+    --
+    # onProfileCreated(profile): void
+    # onProfileDeleted(profile): void
+    # onScoreChanged(profile, name, oldV, newV): void
+  }
+
+  class PlayerException
+  class PlayerProfileNotFoundException
+
+  PlayerProfile --|> AbstractEntity
+  PlayerProfile ..|> ScoreHolder
+  PlayerProfileRepository --|> Repository
+  InMemoryPlayerProfileRepository ..|> PlayerProfileRepository
+  PlayerProfileServiceImpl ..|> PlayerProfileService
+
+  PlayerRanking --> PlayerProfile
+  PlayerProfileServiceImpl o--> PlayerProfileRepository
+  PlayerProfileService ..> PlayerRanking : produces
+
+  PlayerException --|> RuntimeException
+  PlayerProfileNotFoundException --|> PlayerException
+}
+
+@enduml