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.
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.
{
"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.
name: TrPvpBridge version: 1.0.0 main: net.trpvp.bridge.TrPvpBridge api-version: '1.20' description: TRPVP sitesi ile siparis, ceza ve siralama kopruesi
# 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
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());
}
}
}
<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