Sunucu Bağlantısı

Siparişler, cezalar ve sıralama puanları site ile sunucu arasında otomatik akar.

Siteyi yayınla

Eklenti sitenin yayın adresine bağlanır; yayınlanmamış adres dışarıdan çağrılamaz.

Gizli anahtarı kopyala

Panelde tanımladığın SERVER_BRIDGE_KEY değerini eklentinin config.yml dosyasına yaz.

Eklentiyi kur

Verilen kaynak kodu derleyip plugins/ klasörüne at, sunucuyu yeniden başlat.

Komutları ürüne ekle

Yönetim panelinde her ürünün sunucu komutunu gir; satın alma anında kuyruğa düşer.

Bağlantı uçları

Tüm istekler x-server-key başlığında gizli anahtarı taşır.

GET/api/server/deliveriesBekleyen teslimatları listeler (eklenti çeker).
POST/api/server/deliveries{ ids } göndererek teslimatları teslim edildi işaretler.
POST/api/server/sync{ punishments, ranked, matches } göndererek ceza, rank ve maç sonuçlarını aktarır.
GET/api/server/balance?player=AdOyuncunun site üzerindeki R-Coin bakiyesini döner.
POST/api/server/status{ online, max_players, players } ile çevrimiçi sayısını siteye aktarır.

Ranked veri formatı

Eklenti maçtan sonra oyuncuların KP'sini ve maç sonucunu gönderir. Kazanç +25 KP, kayıp -15 KP; her kademe 100 KP ve 7 rank (Demir, Bronz, Gümüş, Altın, Platin, Diamond, Rivals) × 3 kademe. Rank ve kademe sitede KP'den otomatik hesaplanır.

POST /api/server/sync
{
  "ranked": [
    {
      "player": "aybars_",
      "kp": 1250,
      "wins": 34,
      "losses": 12,
      "ranked_enabled": true,
      "kits": ["sword:HT3", "axe:LT3", "crystal:MT3"]
    }
  ],
  "matches": [
    {
      "winner": "aybars_",
      "loser": "ByBeratt",
      "kit": "sword",
      "kp_gain": 25,
      "kp_loss": 15,
      "played_at": "2026-11-17T18:00:00Z"
    }
  ]
}

Eklenti dosyaları

Paper/Spigot 1.20+ üzerinde çalışır. Dosyaları bir Maven projesinde toplayıp derledikten sonra sunucunun plugins klasörüne koy.

plugin.yml
name: TrPvpBridge
version: 1.0.0
main: net.trpvp.bridge.TrPvpBridge
api-version: '1.20'
description: TRPVP sitesi ile siparis, ceza ve siralama kopruesi
config.yml
# Sitenin adresi (yayinlandiktan sonraki adres)
api-url: "https://SITENIZ.base44.app"

# Gizli anahtar: yonetim panelindeki SERVER_BRIDGE_KEY ile ayni olmali
api-key: "BURAYA_GIZLI_ANAHTAR"

# Kac saniyede bir teslimat kontrol edilsin
poll-seconds: 20
TrPvpBridge.java
package net.trpvp.bridge;

import com.google.gson.JsonArray;
import com.google.gson.JsonElement;
import com.google.gson.JsonObject;
import com.google.gson.JsonParser;
import org.bukkit.Bukkit;
import org.bukkit.plugin.java.JavaPlugin;

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.time.Duration;

public class TrPvpBridge extends JavaPlugin {

    private final HttpClient http = HttpClient.newBuilder()
            .connectTimeout(Duration.ofSeconds(10))
            .build();
    private String base;
    private String key;

    @Override
    public void onEnable() {
        saveDefaultConfig();
        base = getConfig().getString("api-url", "").trim().replaceAll("/+$", "");
        key = getConfig().getString("api-key", "").trim();
        if (base.isEmpty() || key.isEmpty()) {
            getLogger().severe("api-url veya api-key eksik: plugins/TrPvpBridge/config.yml");
            return;
        }
        long seconds = Math.max(5, getConfig().getLong("poll-seconds", 20));
        Bukkit.getScheduler().runTaskTimerAsynchronously(this, this::poll, 40L, seconds * 20L);
        getLogger().info("TRPVP kopruesi aktif: " + base);
    }

    private HttpRequest.Builder request(String path) {
        return HttpRequest.newBuilder(URI.create(base + path))
                .header("x-server-key", key)
                .header("content-type", "application/json")
                .timeout(Duration.ofSeconds(15));
    }

    private void poll() {
        reportStatus();
        try {
            HttpResponse<String> response = http.send(
                    request("/api/server/deliveries?limit=25").GET().build(),
                    HttpResponse.BodyHandlers.ofString());

            if (response.statusCode() != 200) {
                getLogger().warning("Teslimatlar alinamadi: HTTP " + response.statusCode());
                return;
            }

            JsonObject body = JsonParser.parseString(response.body()).getAsJsonObject();
            JsonArray items = body.getAsJsonArray("items");
            if (items == null || items.size() == 0) {
                return;
            }

            JsonArray done = new JsonArray();
            for (JsonElement element : items) {
                JsonObject delivery = element.getAsJsonObject();
                String id = delivery.get("id").getAsString();
                String player = delivery.get("player").getAsString();
                String command = delivery.get("command").getAsString().replace("{player}", player);

                if (!player.isEmpty()) {
                    Bukkit.getScheduler().runTask(this, () ->
                            Bukkit.dispatchCommand(Bukkit.getConsoleSender(), command));
                }
                done.add(id);
            }
            acknowledge(done);
        } catch (Exception error) {
            getLogger().warning("Koprue hatasi: " + error.getMessage());
        }
    }

    private void reportStatus() {
        try {
            JsonArray players = new JsonArray();
            Bukkit.getOnlinePlayers().forEach(player -> players.add(player.getName()));

            JsonObject payload = new JsonObject();
            payload.addProperty("online", players.size());
            payload.addProperty("max_players", Bukkit.getMaxPlayers());
            payload.add("players", players);

            HttpResponse<String> response = http.send(
                    request("/api/server/status")
                            .POST(HttpRequest.BodyPublishers.ofString(payload.toString()))
                            .build(),
                    HttpResponse.BodyHandlers.ofString());
            if (response.statusCode() != 200) {
                getLogger().warning("Durum gonderilemedi: HTTP " + response.statusCode() + " - " + response.body());
            }
        } catch (Exception error) {
            getLogger().warning("Durum gonderilemedi: " + error.getMessage());
        }
    }

    private void acknowledge(JsonArray ids) {
        try {
            JsonObject payload = new JsonObject();
            payload.add("ids", ids);
            http.send(
                    request("/api/server/deliveries")
                            .POST(HttpRequest.BodyPublishers.ofString(payload.toString()))
                            .build(),
                    HttpResponse.BodyHandlers.discarding());
        } catch (Exception error) {
            getLogger().warning("Teslimat onayi gonderilemedi: " + error.getMessage());
        }
    }
}
pom.xml
<project xmlns="http://maven.apache.org/POM/4.0.0">
  <modelVersion>4.0.0</modelVersion>
  <groupId>net.trpvp</groupId>
  <artifactId>trpvp-bridge</artifactId>
  <version>1.0.0</version>
  <properties>
    <maven.compiler.source>17</maven.compiler.source>
    <maven.compiler.target>17</maven.compiler.target>
  </properties>
  <repositories>
    <repository>
      <id>papermc</id>
      <url>https://repo.papermc.io/repository/maven-public/</url>
    </repository>
  </repositories>
  <dependencies>
    <dependency>
      <groupId>io.papermc.paper</groupId>
      <artifactId>paper-api</artifactId>
      <version>1.20.4-R0.1-SNAPSHOT</version>
      <scope>provided</scope>
    </dependency>
  </dependencies>
</project>

Ürünlere sunucu komutu eklemek için yönetim panelini kullan.

Yönetim paneli