Initial release: EchoRP v11.0 Modular RP Infrastructure

Author: jarettr

.github/workflows/build.yml

@@ -0,0 +1,31 @@
+name: Java CI with Gradle
+
+on:
+  push:
+    branches: [ "main", "master" ]
+  pull_request:
+    branches: [ "main", "master" ]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+    - uses: actions/checkout@v3
+    - name: Set up JDK 17
+      uses: actions/setup-java@v3
+      with:
+        java-version: '17'
+        distribution: 'temurin'
+        cache: gradle
+
+    - name: Grant execute permission for gradlew
+      run: chmod +x gradlew
+
+    - name: Build with Gradle
+      run: ./gradlew build
+
+    - name: Upload Core Artifact
+      uses: actions/upload-artifact@v3
+      with:
+        name: EchoRP-Core
+        path: core/build/libs/*.jar

.gitignore

@@ -0,0 +1,26 @@
+# Gradle
+.gradle/
+build/
+*/build/
+
+# IDE (IntelliJ IDEA, VS Code)
+.idea/
+*.iml
+.vscode/
+*.swp
+*.DS_Store
+
+# Compiled files
+*.class
+*.jar
+!gradle-wrapper.jar
+
+# Logs and DB (local testing)
+*.log
+*.db
+*.h2.db
+plugins/
+logs/
+
+# Secrets & Local Configs
+config.yml

api/build.gradle.kts

@@ -0,0 +1,15 @@
+plugins {
+    id("java-library")
+}
+
+repositories {
+    mavenCentral()
+    maven("https://repo.papermc.io/repository/maven-public/")
+}
+
+dependencies {
+    // Only Paper API and Lombok are required for the API layer (TS 1.4)
+    compileOnly("io.papermc.paper:paper-api:1.20.1-R0.1-SNAPSHOT")
+    compileOnly("org.projectlombok:lombok:1.18.30")
+    annotationProcessor("org.projectlombok:lombok:1.18.30")
+}

api/src/main/java/com/echorp/api/EchoRPAPI.java

@@ -0,0 +1,25 @@
+package com.echorp.api;
+
+import com.echorp.api.module.ModuleProvider;
+import com.echorp.api.service.CacheService;
+import com.echorp.api.service.DatabaseService;
+import com.echorp.api.service.RatingService;
+
+/**
+ * Main entry point for EchoRP API (TS 1.4).
+ * Provides access to core services for module developers.
+ */
+public interface EchoRPAPI {
+    
+    /** @return Service for rating calculations and retrieval (TS 2.2) */
+    RatingService getRatingService();
+    
+    /** @return Asynchronous database access service (TS 2.2) */
+    DatabaseService getDatabaseService();
+    
+    /** @return Caching service with CAS support (TS 2.4) */
+    CacheService getCacheService();
+    
+    /** @return Manager for module discovery and lifecycle (TS 2.1) */
+    ModuleProvider getModuleProvider();
+}

api/src/main/java/com/echorp/api/event/PlayerRatingChangeEvent.java

@@ -0,0 +1,37 @@
+package com.echorp.api.event;
+
+import org.bukkit.event.Event;
+import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * Fired whenever a player's rating is updated (TS 1.4, 6.1).
+ * Async by default to ensure no performance impact on the main thread.
+ */
+public class PlayerRatingChangeEvent extends Event {
+    private static final HandlerList HANDLERS = new HandlerList();
+
+    private final String playerUuid;
+    private final String category;
+    private final double oldRating;
+    private final double newRating;
+    private final int version; // Required for Event Sourcing consistency (TS 6.2)
+
+    public PlayerRatingChangeEvent(String playerUuid, String category, double oldRating, double newRating, int version) {
+        super(true); // Always asynchronous
+        this.playerUuid = playerUuid;
+        this.category = category;
+        this.oldRating = oldRating;
+        this.newRating = newRating;
+        this.version = version;
+    }
+
+    public String getPlayerUuid() { return playerUuid; }
+    public String getCategory() { return category; }
+    public double getOldRating() { return oldRating; }
+    public double getNewRating() { return newRating; }
+    public int getVersion() { return version; }
+
+    @NotNull @Override public HandlerList getHandlers() { return HANDLERS; }
+    public static HandlerList getHandlerList() { return HANDLERS; }
+}

api/src/main/java/com/echorp/api/event/PlayerWeightCalculateEvent.java

@@ -0,0 +1,33 @@
+package com.echorp.api.event;
+
+import org.bukkit.event.Event;
+import org.bukkit.event.HandlerList;
+import org.jetbrains.annotations.NotNull;
+
+public class PlayerWeightCalculateEvent extends Event {
+    private static final HandlerList HANDLERS = new HandlerList();
+
+    private final String giverUuid;
+    private final String targetUuid;
+    private final String category;
+    private double weight;
+
+    public PlayerWeightCalculateEvent(String giverUuid, String targetUuid, String category, double initialWeight) {
+        // ИСПРАВЛЕНИЕ: Говорим ядру сервера, что событие асинхронное (true)
+        super(true);
+        
+        this.giverUuid = giverUuid;
+        this.targetUuid = targetUuid;
+        this.category = category;
+        this.weight = initialWeight;
+    }
+
+    public String getGiverUuid() { return giverUuid; }
+    public String getTargetUuid() { return targetUuid; }
+    public String getCategory() { return category; }
+    public double getWeight() { return weight; }
+    public void setWeight(double weight) { this.weight = weight; }
+
+    @NotNull @Override public HandlerList getHandlers() { return HANDLERS; }
+    public static HandlerList getHandlerList() { return HANDLERS; }
+}

api/src/main/java/com/echorp/api/module/EchoModule.java

@@ -0,0 +1,28 @@
+package com.echorp.api.module;
+
+import java.util.logging.Logger;
+
+/**
+ * Base interface for all EchoRP modules.
+ * Every module in the /modules directory must implement this.
+ */
+public interface EchoModule {
+    
+    /** Called when the module is being initialized */
+    void onEnable();
+
+    /** Called when the module is being shut down or reloaded */
+    void onDisable();
+
+    /** @return Unique module identifier */
+    String getName();
+
+    /** @return Current module version */
+    String getVersion();
+
+    /** Sets the logger provided by the Core */
+    void setLogger(Logger logger);
+
+    /** @return Logger assigned to this module */
+    Logger getLogger();
+}

api/src/main/java/com/echorp/api/module/ModuleDescription.java

@@ -0,0 +1,20 @@
+package com.echorp.api.module;
+
+import lombok.Builder;
+import lombok.Value;
+import java.util.List;
+
+/**
+ * Metadata for a module, typically loaded from module.yml (TS 2.1).
+ */
+@Value
+@Builder
+public class ModuleDescription {
+    String name;         // Unique name
+    String version;      // Version string
+    String mainClass;    // Path to the EchoModule implementation
+    List<String> depends; // Hard dependencies
+    List<String> softDepends; // Optional dependencies
+    List<String> libraries; // Maven coordinates for runtime libraries
+    boolean reloadable;  // Supports hot-reload without server restart
+}

api/src/main/java/com/echorp/api/module/ModuleProvider.java

@@ -0,0 +1,15 @@
+package com.echorp.api.module;
+
+import java.util.Collection;
+import java.util.Optional;
+
+/**
+ * Service for managing and discovering active modules.
+ */
+public interface ModuleProvider {
+    /** Find a loaded module by name */
+    Optional<EchoModule> getModule(String name);
+
+    /** @return A list of all currently enabled modules */
+    Collection<EchoModule> getEnabledModules();
+}

api/src/main/java/com/echorp/api/service/CacheService.java

@@ -0,0 +1,21 @@
+package com.echorp.api.service;
+
+import java.util.Optional;
+
+/**
+ * Service for local and distributed caching (TS 2.4).
+ */
+public interface CacheService {
+    
+    <K, V> void put(String cacheName, K key, V value);
+    
+    <K, V> Optional<V> get(String cacheName, K key);
+
+    /**
+     * Atomically updates a value if the current value matches expectations.
+     * Crucial for Optimistic Locking (TS 6.2).
+     */
+    <K, V> boolean compareAndSet(String cacheName, K key, V expect, V update);
+    
+    void invalidate(String cacheName, Object key);
+}