M_Viper/AeroMc-Launcher
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 17 Wiki Activity

Upload via GUI (50 Dateien)

Browse Source
This commit is contained in:
M_Viper
2026-09-29 07:09:26 +00:00
parent ee0e6dec32
commit d268e548f5
11 changed files with 1436 additions and 49 deletions
Download Patch File Download Diff File Expand all files Collapse all files
wordpress-plugin/aeromc-friends/includes/routes.php
+303
View File
@@ -0,0 +1,303 @@
<?php
/**
* REST-Routen unter /wp-json/aeromc/v1/... für das Freundesystem.
*
* Bewusst OHNE echte Authentifizierung (Absprache mit dem Nutzer): der
* Launcher meldet sich einfach mit der Minecraft-UUID des aktiven Kontos an.
* Wer eine fremde UUID kennt, könnte sich theoretisch als dieser Spieler
* ausgeben - für den privaten Rahmen dieses Projekts akzeptiert. Eingaben
* werden trotzdem serverseitig geprüft (Format von UUID/Name) und jede
* Datenbankabfrage läuft ausschließlich über $wpdb->prepare, um SQL-Injection
* auszuschließen.
*/
if (!defined('ABSPATH')) {
exit;
}
// Konten gelten als "online", solange ihr letzter Herzschlag (der Launcher
// sendet alle 60s einen) nicht älter als das hier ist.
define('AEROMC_FRIENDS_ONLINE_SECONDS', 180);
// Häufigere Herzschläge als das werden ignoriert (Schutz gegen Missbrauch/
// versehentliche Anfrageflut) - der Launcher selbst sendet ohnehin nur alle 60s.
define('AEROMC_FRIENDS_HEARTBEAT_MIN_GAP', 20);
function aeromc_friends_presence_table() {
global $wpdb;
return $wpdb->prefix . AEROMC_FRIENDS_PRESENCE_TABLE;
}
function aeromc_friends_friends_table() {
global $wpdb;
return $wpdb->prefix . AEROMC_FRIENDS_FRIENDS_TABLE;
}
/** Minecraft-UUIDs kommen mal mit, mal ohne Bindestriche an - einheitlich
* ohne Bindestriche, klein geschrieben speichern/vergleichen. Gibt false
* zurück, wenn es keine gültige UUID (32 Hex-Zeichen) ist. */
function aeromc_friends_normalize_uuid($uuid) {
$stripped = strtolower(str_replace('-', '', (string) $uuid));
if (!preg_match('/^[a-f0-9]{32}$/', $stripped)) {
return false;
}
return $stripped;
}
/** Minecraft-Namensregeln: 1-16 Zeichen, Buchstaben/Ziffern/Unterstrich. */
function aeromc_friends_valid_username($name) {
return is_string($name) && preg_match('/^[A-Za-z0-9_]{1,16}$/', $name);
}
add_action('rest_api_init', function () {
register_rest_route('aeromc/v1', '/presence', [
'methods' => 'POST',
'callback' => 'aeromc_friends_route_presence',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends', [
'methods' => 'GET',
'callback' => 'aeromc_friends_route_list',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/requests', [
'methods' => 'GET',
'callback' => 'aeromc_friends_route_requests',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/sent', [
'methods' => 'GET',
'callback' => 'aeromc_friends_route_sent',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/request', [
'methods' => 'POST',
'callback' => 'aeromc_friends_route_request',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/respond', [
'methods' => 'POST',
'callback' => 'aeromc_friends_route_respond',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/cancel', [
'methods' => 'POST',
'callback' => 'aeromc_friends_route_cancel',
'permission_callback' => '__return_true',
]);
register_rest_route('aeromc/v1', '/friends/remove', [
'methods' => 'POST',
'callback' => 'aeromc_friends_route_remove',
'permission_callback' => '__return_true',
]);
});
/** POST /presence {uuid, username, instance, server} */
function aeromc_friends_route_presence($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
$username = $request->get_param('username');
if (!$uuid || !aeromc_friends_valid_username($username)) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid/username.', ['status' => 400]);
}
$instance = sanitize_text_field((string) $request->get_param('instance'));
$server = sanitize_text_field((string) $request->get_param('server'));
$table = aeromc_friends_presence_table();
$letzte = $wpdb->get_var($wpdb->prepare(
"SELECT last_seen FROM $table WHERE uuid = %s", $uuid
));
if ($letzte && (time() - strtotime($letzte)) < AEROMC_FRIENDS_HEARTBEAT_MIN_GAP) {
return ['ok' => true]; // zu häufig - stillschweigend ignoriert
}
// current_time('mysql', true) statt current_time('mysql'): das zweite
// Argument erzwingt GMT/UTC. Ohne das liefert current_time() die an die
// WordPress-Zeitzone angepasste ORTSZEIT (Einstellungen > Allgemein) -
// das online/offline-Fenster unten vergleicht last_seen aber per
// strtotime()/time() als UTC, wodurch ein Freund bei abweichender
// Zeitzone praktisch nie als offline erkannt worden wäre.
$jetzt_utc = current_time('mysql', true);
$wpdb->query($wpdb->prepare(
"INSERT INTO $table (uuid, username, instance_name, server_label, last_seen)
VALUES (%s, %s, %s, %s, %s)
ON DUPLICATE KEY UPDATE username = %s, instance_name = %s, server_label = %s, last_seen = %s",
$uuid, $username, $instance ?: null, $server ?: null, $jetzt_utc,
$username, $instance ?: null, $server ?: null, $jetzt_utc
));
return ['ok' => true];
}
/** GET /friends?uuid= - akzeptierte Freunde inkl. Online-Status */
function aeromc_friends_route_list($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
if (!$uuid) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
$presence_table = aeromc_friends_presence_table();
$rows = $wpdb->get_results($wpdb->prepare(
"SELECT IF(f.uuid_a = %s, f.uuid_b, f.uuid_a) AS other_uuid
FROM $friends_table f
WHERE (f.uuid_a = %s OR f.uuid_b = %s) AND f.status = 'accepted'",
$uuid, $uuid, $uuid
));
$ergebnis = [];
foreach ($rows as $row) {
$p = $wpdb->get_row($wpdb->prepare(
"SELECT username, instance_name, server_label, last_seen FROM $presence_table WHERE uuid = %s",
$row->other_uuid
));
$online = $p && (time() - strtotime($p->last_seen)) < AEROMC_FRIENDS_ONLINE_SECONDS;
$ergebnis[] = [
'uuid' => $row->other_uuid,
'username' => $p ? $p->username : null,
'online' => (bool) $online,
'instance' => $online ? $p->instance_name : null,
'server' => $online ? $p->server_label : null,
];
}
return $ergebnis;
}
/** GET /friends/requests?uuid= - offene, an mich gerichtete Anfragen */
function aeromc_friends_route_requests($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
if (!$uuid) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
$presence_table = aeromc_friends_presence_table();
$rows = $wpdb->get_results($wpdb->prepare(
"SELECT f.uuid_a AS from_uuid, p.username AS from_username
FROM $friends_table f
LEFT JOIN $presence_table p ON p.uuid = f.uuid_a
WHERE f.uuid_b = %s AND f.status = 'pending'",
$uuid
));
return array_map(function ($r) {
return ['uuid' => $r->from_uuid, 'username' => $r->from_username];
}, $rows);
}
/** GET /friends/sent?uuid= - offene, von mir SELBST gesendete Anfragen */
function aeromc_friends_route_sent($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
if (!$uuid) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
$presence_table = aeromc_friends_presence_table();
$rows = $wpdb->get_results($wpdb->prepare(
"SELECT f.uuid_b AS to_uuid, p.username AS to_username
FROM $friends_table f
LEFT JOIN $presence_table p ON p.uuid = f.uuid_b
WHERE f.uuid_a = %s AND f.status = 'pending'",
$uuid
));
return array_map(function ($r) {
return ['uuid' => $r->to_uuid, 'username' => $r->to_username];
}, $rows);
}
/** POST /friends/request {uuid, username, targetUsername} */
function aeromc_friends_route_request($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
$targetUsername = $request->get_param('targetUsername');
if (!$uuid || !aeromc_friends_valid_username($targetUsername)) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid/targetUsername.', ['status' => 400]);
}
$presence_table = aeromc_friends_presence_table();
$friends_table = aeromc_friends_friends_table();
$ziel = $wpdb->get_row($wpdb->prepare(
"SELECT uuid FROM $presence_table WHERE username = %s", $targetUsername
));
if (!$ziel) {
return new WP_Error('aeromc_not_found', 'Dieser Name wurde noch nie im Launcher gesehen.', ['status' => 404]);
}
$ziel_uuid = $ziel->uuid;
if ($ziel_uuid === $uuid) {
return new WP_Error('aeromc_self', 'Du kannst dich nicht selbst hinzufügen.', ['status' => 400]);
}
$vorhanden = $wpdb->get_var($wpdb->prepare(
"SELECT id FROM $friends_table WHERE (uuid_a = %s AND uuid_b = %s) OR (uuid_a = %s AND uuid_b = %s)",
$uuid, $ziel_uuid, $ziel_uuid, $uuid
));
if ($vorhanden) {
return new WP_Error('aeromc_exists', 'Es gibt schon eine Anfrage oder Freundschaft.', ['status' => 409]);
}
$wpdb->insert($friends_table, [
'uuid_a' => $uuid,
'uuid_b' => $ziel_uuid,
'status' => 'pending',
'created_at' => current_time('mysql'),
]);
return ['ok' => true];
}
/** POST /friends/respond {uuid, otherUuid, accept} */
function aeromc_friends_route_respond($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
$other = aeromc_friends_normalize_uuid($request->get_param('otherUuid'));
$accept = (bool) $request->get_param('accept');
if (!$uuid || !$other) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid/otherUuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
if ($accept) {
$wpdb->query($wpdb->prepare(
"UPDATE $friends_table SET status = 'accepted' WHERE uuid_a = %s AND uuid_b = %s AND status = 'pending'",
$other, $uuid
));
} else {
$wpdb->query($wpdb->prepare(
"DELETE FROM $friends_table WHERE uuid_a = %s AND uuid_b = %s AND status = 'pending'",
$other, $uuid
));
}
return ['ok' => true];
}
/** POST /friends/cancel {uuid, otherUuid} - eine SELBST gesendete Anfrage zurückziehen */
function aeromc_friends_route_cancel($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
$other = aeromc_friends_normalize_uuid($request->get_param('otherUuid'));
if (!$uuid || !$other) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid/otherUuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
$wpdb->query($wpdb->prepare(
"DELETE FROM $friends_table WHERE uuid_a = %s AND uuid_b = %s AND status = 'pending'",
$uuid, $other
));
return ['ok' => true];
}
/** POST /friends/remove {uuid, otherUuid} */
function aeromc_friends_route_remove($request) {
global $wpdb;
$uuid = aeromc_friends_normalize_uuid($request->get_param('uuid'));
$other = aeromc_friends_normalize_uuid($request->get_param('otherUuid'));
if (!$uuid || !$other) {
return new WP_Error('aeromc_invalid', 'Ungültige uuid/otherUuid.', ['status' => 400]);
}
$friends_table = aeromc_friends_friends_table();
$wpdb->query($wpdb->prepare(
"DELETE FROM $friends_table WHERE ((uuid_a = %s AND uuid_b = %s) OR (uuid_a = %s AND uuid_b = %s)) AND status = 'accepted'",
$uuid, $other, $other, $uuid
));
return ['ok' => true];
}