Skip to content

Für Server-Betreiber

Cubiq Server Rules

Ein kleines, kostenloses Plugin und Server-Mod, das dem Cubiq Client sagt, was auf deinem Server erlaubt ist: einzelne Funktionen sperren, erzwingen oder eine Einstellung begrenzen – global, je Welt oder je Unterserver.

Alle Plattformen stecken in einem Release – nimm die Datei für deine Server-Software. Open Source unter GPL-3.0.

Was es kann

  • Funktionen sperren

    Zum Beispiel Minimap, Fullbright oder Zoom in einer PvP-Arena. Im Cubiq-Menü steht dann „Vom Server gesperrt“.

  • Funktionen erzwingen

    Eine Funktion ist immer an, z. B. Dauer-Sprinten auf einem Parkour-Server.

  • Einstellungen begrenzen

    Fester Wert oder Bereich, z. B. Zoom höchstens 4× oder Freecam nur mit Fair Play (keine Kamera durch Wände).

  • Je Welt und je Server

    Regeln je Welt bei Bukkit, Sponge und Server-Mods, je Unterserver bei Velocity und BungeeCord. Genauere Einträge gehen vor globale.

  • Ausnahme für dein Team

    Spieler mit der Permission cubiqrules.bypass bekommen gar keine Regeln – praktisch für Admins und Builder.

  • Spieler ohne Cubiq Client

    Optional: Antwortet ein Spieler nicht rechtzeitig als Cubiq Client, passiert nichts, er bekommt einen Hinweis oder wird gekickt.

Plattformen

Eine Jar je Plattform. Die Regeln sind überall gleich, nur der Ort der Config unterscheidet sich.

  • Spigot, Paper, Purpur & Folia

    Minecraft 1.8.8 bis zur neuesten Version, eine Jar für alle

    Datei
    cubiq-server-rules-bukkit-<version>.jar
    Config
    plugins/CubiqServerRules/config.yml
    Jar
  • Velocity

    Velocity 3.x – Regeln je Unterserver

    Datei
    cubiq-server-rules-velocity-<version>.jar
    Config
    plugins/cubiq-server-rules/config.yml
    Jar
  • BungeeCord & Waterfall

    Regeln je Unterserver

    Datei
    cubiq-server-rules-bungee-<version>.jar
    Config
    plugins/CubiqServerRules/config.yml
    Jar
  • Sponge

    Sponge API 8 und neuer

    Datei
    cubiq-server-rules-sponge-<version>.jar
    Config
    config/cubiqserverrules/config.yml
    Jar
  • Fabric, NeoForge & Forge (Server-Mod)

    Fabric 1.20.1, 1.21.1, 1.21.4, 1.21.11 · NeoForge 1.21.1, 1.21.11 · Forge 1.20.1 – nur auf dem Server nötig

    Datei
    cubiq-server-rules-<loader>-<mc>-<version>.jar
    Config
    config/cubiq-server-rules.yml
    Jar

Hinter einem Proxy gehen die Regeln des Proxys vor einem Plugin auf dem Unterserver.

Konfiguration

Alles auskommentiert heißt: nichts gesperrt. Modul-IDs und Einstellungsnamen stehen in der Dokumentation.

# Cubiq Server Rules – control Cubiq Client features on your server.
# Note: members of the Cubiq team with the "serverrules.bypass" permission can override these rules
# after an in-game confirmation. This is documented on purpose.
modules:            # global
  minimap: false    # false = forced off, true = forced on
  fullbright: false
settings:
  zoom.factor: {max: 4}
  cinematic.freecamFairPlay: true
worlds:             # Bukkit/Sponge/mods: per world; Velocity/Bungee: "servers:" per backend server
  pvp_arena:
    modules: {zoom: false, freelook: false}
message: ""         # optional text shown once to Cubiq Client players
missing-client:     # players whose client does not answer with a Cubiq Client hello
  action: ignore    # ignore | notify | kick
  timeout-seconds: 10
  notify-message: "This server works best with the Cubiq Client."
  kick-message: "Please join with the Cubiq Client."
bypass-permission: cubiqrules.bypass   # players with this server permission get no rules

Befehle

  • /cubiqrules reload – Config neu laden und die neuen Regeln an alle schicken.
  • /cubiqrules status <spieler> – Zeigt, ob ein Spieler den Cubiq Client nutzt und welche Regeln für ihn gelten.

Permission cubiqrules.admin (Server-Mods: OP-Level 3).

So funktioniert es

  1. Der Cubiq Client meldet sich nach dem Betreten über einen Plugin-Kanal beim Server.

  2. Das Plugin antwortet mit den Regeln für die Welt (bzw. den Unterserver) des Spielers – auch wenn es keine gibt.

  3. Bei Welt- oder Serverwechsel und nach /cubiqrules reload kommen die Regeln neu und ersetzen die alten.

  4. Verlässt der Spieler den Server, vergisst der Client alle Regeln. Gespeichert wird nichts.

Cubiq Server Rules steuert nur den Cubiq Client. Es ist kein Anti-Cheat: Andere Clients ignorieren es, und ein veränderter Client kann sich als Cubiq Client ausgeben.

Offen dokumentiert: Ausnahme für das Cubiq-Team

Mitglieder des Cubiq-Teams mit dem Team-Recht serverrules.bypass können eine gesperrte Funktion trotzdem benutzen – aber nur nach einer Nachfrage im Spiel („Dieser Server sperrt Minimap. Als Cubiq-Team trotzdem benutzen?“) und nur, bis sie den Server verlassen.

  • Es gibt sie, damit das Team Funktionen auf jedem Server testen und Spielern helfen kann.
  • Der Server erfährt davon nichts und kann es nicht abschalten.
  • Es steht hier, in der Dokumentation, in der README und als Kommentar oben in jeder Config – nichts davon ist versteckt.
  • Die Ausnahme für dein eigenes Team ist die Server-Permission cubiqrules.bypass – die hast du komplett selbst in der Hand.
Dokumentation

Fragen oder fehlt eine Plattform?

Frag auf Discord oder öffne ein Issue – das Plugin ist Open Source wie der Rest von Cubiq.