Claims-Dokumentation

Bevor Sie diese Dokumentation lesen, stellen Sie sicher, dass Sie die Benutzer-Claims-Dokumentation gelesen haben. Diese behandelt die grundlegenden Konzepte von Claims und wie Spieler diese verwenden können.

Admin- & Server-Claims

Anstatt auf Plugins wie WorldGuard angewiesen zu sein, können Administratoren das integrierte Claim-System verwenden, um Serverbereiche zu schützen. Server-Claims können von allen Operatoren oder von jedem mit der Berechtigung buildmc.admin verwaltet werden.

Einen Server-Claim zu erstellen funktioniert genauso wie bei jedem anderen Claim, einfach den Server-Typ verwenden:

/claim create server testserver

Der ausgewählte Bereich ist nun standardmäßig geschützt, selbst vor Administratoren. Um den Bereich zu bearbeiten, verwenden Sie die Whitelist-Funktion, um sich selbst Zugriff zu gewähren. Die Server-Claim-Einstellungen erscheinen zusammen mit allen anderen Claims in der Claim-Benutzeroberfläche.

Wenn Sie alle Claim-Schutzmaßnahmen vollständig umgehen möchten, können Sie sich selbst (oder jemand anderem) die Berechtigung buildmc.bypass-claims erteilen.

Platzhalter-Claims

Ein Platzhalter-Claim ist ein spezieller Claim-Typ, der keinen Schutz bietet. Dies ist nützlich für Bereiche wie Einkaufsviertel, wo Spieler keine neuen Claims erstellen sollen, aber trotzdem frei bauen oder ändern können.

Whitelisting- und Schutzregeln sind für Platzhalter-Claims absichtlich deaktiviert.

Konfigurationsoptionen

Die Konfigurationsdatei bietet detaillierte Kontrolle über das Verhalten von Claims. Im Folgenden die gebräuchlichsten Einstellungen:

Maximale Claim-Anzahl

claims:
  # Die Anzahl der Chunks, die jeder Spieler beanspruchen kann
  player-max-chunk-claim-amount: 256 # Standard: 256

  # Die Anzahl der Chunks, die jedes Team beanspruchen kann
  team-max-chunk-claim-amount: 1024 # Standard: 1024

Claim-Werkzeug

claims:
  tool:
    # Das Item, das als Claim-Werkzeug verwendet wird
    tool-item: "carrot_on_a_stick" # Standard: "carrot_on_a_stick"

Der Karottenstab wurde gewählt, da er eines der am wenigsten nützlichen Überlebens-Items ist und sich daher gut als kostenloses, nicht aufdringliches Werkzeug eignet.

Limit der Auswahlgröße

claims:
  tool:
    # Begrenzung der maximalen Größe der Auswahl in Chunks
    # Wenn kleiner als 0, wird das Limit deaktiviert
    limit-selection: 10 # Standard: 10

Ein Limit von 10 bedeutet, dass Sie keinen Bereich größer als 10 Chunks pro Seite beanspruchen können.

Standard-Schutzfunktionen

Jeder einzelne Schutztyp kann einen Standardwert haben und kann im UI ausgeblendet werden, wenn Sie nicht möchten, dass Spieler ihn ändern.

claims:
  protections:
    # Spieler können keine Blöcke abbauen
    player-break:
      default: true
      is-hidden: false

    # Spieler können keine Blöcke platzieren
    player-place:
      default: true
      is-hidden: false

Claim-Protokolle

Die meisten claim-bezogenen Aktionen werden automatisch protokolliert. Sie finden diese Protokolle unter:

plugins/BuildMC-Core/logs/claims

Beispielhafte Log-Einträge:

[2025-10-28 23:04:13] [CLAIM ERSTELLT] Darkylt (d2d1385c-d33a-4d92-a544-020dc67ce7de) hat Claim 'testblue' erstellt
[2025-10-28 23:06:03] [SCHUTZ GEÄNDERT] Darkylt (d2d1385c-d33a-4d92-a544-020dc67ce7de) hat 'buildmc:bells' auf 'deaktiviert' in Claim 'testblue' geändert

Diese Protokolle sind nützlich für Moderation und Untersuchungen. Sie können auch das Verhalten konfigurieren:

claims:
  # Einstellungen für Claim-Protokolle
  logs:
    enabled: true
    rotation-time: "00:00"      # Zeitpunkt der Protokolldrehung (24h-Format)
    retention-days: 14          # Anzahl der Tage, wie lange Protokolle aufbewahrt werden (-1 zum Deaktivieren)
    mirror-to-console: false    # Ob Ereignisse in der Konsole ausgegeben werden

Die Protokolldrehung hilft, die Dateigröße überschaubar zu halten, und die Aufbewahrung stellt sicher, dass alte Einträge regelmäßig gelöscht werden.