Befehle und Rechte
Befehle stellen eine Möglichkeit da um Server zu administrieren und Spieler mit dem Server interagieren zu lassen.
In Sponge werden Befehle durch ein Rechtesystem verwaltet (englisch permission management). Rechte erlauben es Serverbetreibern festzulegen wer was darf (und was nicht!). Standardmäßig wird Spielern mit Operator Status das Ausführen alle Befehle erlaubt. Spieler ohne Operator Status haben keinen Zugriff auf administrative Befehle oder Befehle für die bestimmte Rechte vergeben sein müssen. Der Serverbetreiber kann durch das Vergeben von Berechtigungen, mit Hilfe eines passenden Plugins, Feineinstellungen vornehmen.
Bemerkung
Sponge ist kein Rechteverwaltungssystem. Um Rechte an einzelne Spieler oder Gruppen zu geben oder entziehen wird ein entsprechendes Plugin benötigt.
Operator Befehle
Diese Befehle sind, zusätzlich zu den normalen Befehlen für Spieler, für Server Moderatoren (englisch operator) verfügbar.
Sponge
Diese Befehle sind für Spieler mit Operator Status oder einer gleichwertigen Berechtigung, auf Servern die Sponge einsetzen, verfügbar.
Befehl |
Beschreibung |
Berechtigung |
---|---|---|
/sponge audit |
Erzwingt das Laden von ungeladenen Klassen um Mixin Debugging zu aktivieren. |
sponge.command.audit |
/sponge blockinfo |
Shows the type and some additional information about the block you are looking at. |
sponge.command.blockinfo |
/sponge chunks |
Gibt die Chunk-Informationen für eine Welt, eine Dimension oder global aus. |
sponge.command.chunks |
/sponge config |
Ändert eine globale Konfiguration oder die einer Welt oder Dimension. |
sponge.command.config |
/sponge entityinfo |
Shows the type and some additional information about the entity you are looking at. |
sponge.command.entityinfo |
/sponge heap |
Gibt den dynamischen Speicher (englisch heap) der JVM aus. |
sponge.command.heap |
/sponge metrics |
Gets or sets whether metric (also known as server stats) collection is enabled for a given plugin. |
sponge.command.metrics |
/sponge mods |
Lists currently installed forge mods. (SpongeForge only) |
sponge.command.mods |
/sponge plugins |
Lists currently installed Sponge plugins. |
sponge.commands.plugins |
/sponge plugins reload |
Stößt die Plugin-Eigenen Prozeduren an, sich selbst neu zu laden. |
sponge.command.plugins.reload |
/sponge reload |
Läd die globale, eine Welt- oder Dimensionkonfiguration neu. |
sponge.command.reload |
/sponge save |
Speichert die globale, eine Welt- oder eine Dimensionkonfiguration. |
sponge.command.save |
/sponge timings |
Der Hauptbefehl für das Zeitmessung-Modul. |
sponge.command.timings |
/sponge tps |
Zeigt die Ticks pro Sekunde für jede Welt an. |
sponge.command.tps |
/sponge version |
Gibt die Versionen von der verwendeten Spongeimplementierung und der Sponge-API in der Konsole aus. |
sponge.command.version |
/sponge which |
Prints which plugin provided the command, it’s aliases and alternatives. |
sponge.command.which |
/sponge:callback |
Internally used for callback actions on
|
|
/sponge:help |
Zeige Informationen zu, auf dem Server, verfügbaren Befehlen an. |
sponge.command.help |
Sponge Befehlsparameter
/sponge chunks [-g] [-d dim] [-w world]
/sponge config [-g] [-d dim] [-w world] key value
/sponge save [-g] [-d dim|*] [-w world|*]
/sponge reload [-g] [-d dim|*] [-w world|*]
Befehls Konflikte
In cases of command conflict, Sponge provides a primary alias mechanism to specify which command is to be used. For
example, Minecraft provides the reload command and
Sponge provides the reload command. To
specify which command to use, prefix it with minecraft
or sponge
and a :
. So, to use Sponge’s reload command
above, type in /sponge:reload
. This approach can also be used to handle conflicts between mods and/or plugins. Do
the same thing, just use the mod-id or the plugin-id and a :
. An example is /examplemodid:tp
.
Furthermore, the primary alias mechanism can be used to overcome incompatibilities. Let’s say a plugin registers a command, but the command is incompatible with your mod. If you can configure your mod to use a Minecraft native command or another plugin’s command, you can restore the expected behavior or prevent unexpected behaviors.
Bemerkung
Das /sponge audit
sorgt dafür, dass alle noch nicht geladenen Klassen geladen werden, wodurch die gesamte Aufgabe von allen eingebauten Umgebungsvariablen aufgezeichnet werden kann. DIes benötigt die mixin.checks Variable, weitere Informationen unter Mixin wiki.
Tipp
Here are a few simple examples of the sponge config command in action. Note that at least one target flag must be specified. Please see Sponge konfigurieren for a more detailed explanation.
/sponge config -d minecraft:nether logging.chunk-load true
Da ein Dimensionstyp definiert wurde, würde dies die Konfiguration der Nether verändern (und daher alle Nether-Welten).
/sponge config -w DIM1 logging.chunk-load true
Dies würde die Konfiguration der Welt DIM1 verändern.
Sponge provides two permissions for debugging purposes:
Allow using Sponge’s block and entity tracking message channel:
sponge.debug.block-tracking
This message channel is used by the client (if the SpongeForge mod is installed) to display the block and entity owner and notifier in the debug view.Allow hovering of command execution errors to get the stacktrace:
sponge.debug.hover-stacktrace
Zeitmessungen
Timings are a tool built into Sponge that allows server administrators to monitor the performance of their server.
Timings will collect information about a server so that a report may later be generated on the data. Information that
is recorded by timings include the server motd, version, uptime, memory, installed plugins, tps, percent of tps loss,
number of players, tile entities, entities, and chunks.
Below is a list of sub-commands to /sponge timings
:
Befehl |
Beschreibung |
---|---|
/sponge timings on |
Schaltet das Zeitmessung-Werkzeug ein. Beachte das dies auch die Zeitmessungs-Daten zurücksetzt. |
/sponge timings off |
Schaltet das Zeitmessung-Werkzeug aus. Beachte das die meisten Zeitmessung-Befehle dann nicht mehr funktionieren und auch keine Zeitmessungen aufgezeichnet werden können. |
/sponge timings reset |
Löscht alle bisher gesammelten Daten und beginnt mit der Aufzeichnung direkt nach Ausführung dieses Befehls. |
/sponge timings report |
Erstellt einen Timings-Bericht über die Serverleistung auf https://timings.aikar.co |
/sponge timings verbon |
Aktiviert eine ausführliche Ausgabe der Zeitmessungen. |
/sponge timings verboff |
Deaktiviert eine ausführliche Ausgabe der Zeitmessungen. Beachte das genaue Zeitmessungen nicht mehr verfügbar sein werden. |
/sponge timings cost |
Fragt die Kosten für Zeitmessungen ab. |
Forge
Die folgenden Befehle sind nur nutzbar, wenn SpongeForge genutzt wird. Andere Implementierungen der SpongeAPI (wie z. B. SpongeVanilla) enthalten diese Befehle nicht.
Befehl |
Beschreibung |
Berechtigung |
---|---|---|
/forge tps |
Zeigt die Ticks pro Sekunde für jede Welt an. |
forge.command.forge |
/forge track |
Aktiviert das Tracken von Blockobjekten. |
forge.command.forge |
Für alle Forge Mods, die die Vanilla Befehl-API benutzen, wird diese Form von Befehlberechtigungen benutzt <modid>.command.<befehlsname>
.
Vanilla
Es gibt viele Vanilla-Befehle die auch in Sponge-Servern verwendet werden können. Die Liste hier ist nicht vollständig, umfasst aber die am häufigsten genutzten Befehle.
Diese Befehle stehen nur für Operatoren oder Spieler mit passender Berechtigung zur Verfügung. Generell haben die Berechtigungen für Vanilla-Befehle die Struktur minecraft.command.<Befehl>
, wie man unten sehen kann.
Befehl |
Beschreibung |
Berechtigung |
---|---|---|
/ban |
Einen Spieler verbannen. |
minecraft.command.ban |
/ban-ip |
Eine IP Adresse bannen. |
minecraft.command.ban-ip |
/banlist |
Eine Liste aller verbannten Spieler anzeigen. |
minecraft.command.banlist |
/clear |
Ein Inventar leeren. |
minecraft.command.clear |
/deop |
Einem Spieler Operator Rechte entziehen. |
minecraft.command.deop |
/difficulty |
Den Schwierigkeitsgrad des Spiels ändern. |
minecraft.command.difficulty |
/gamemode |
Den Spielmodus eines Spielers festlegen. |
minecraft.command.gamemode |
/gamerule |
Eine Spielregel festlegen. |
minecraft.command.gamerule |
/give |
Einem Spieler einen Gegenstand (englisch item) geben. |
minecraft.command.give |
/kill |
Einen Spieler oder Objekt töten. |
minecraft.command.kill |
/op |
Einem Spieler Operator Rechte geben. |
minecraft.command.op |
/pardon |
Einen Spieler von der Bannliste streichen. |
minecraft.command.pardon |
/save-all |
Den Spielstand des Servers sichern. |
minecraft.command.save-all |
/save-off |
Das automatische Speichern deaktivieren. |
minecraft.command.save-off |
/save-on |
Das automatische Speichern aktivieren. |
minecraft.command.save-on |
/setidletimeout |
Festlegen wie lange Spieler abwesend sein können, bevor sie vom Server gekickt werden. |
minecraft.command.setidletimeout |
/setworldspawn |
Den Spawnpunkt der Welt festlegen. |
minecraft.command.setworldspawn |
/stop |
Den Server anhalten. |
minecraft.command.stop |
/toggledownfall |
Zwischen Sonnenschein und Regen umschalten. |
minecraft.command.toggledownfall |
/tp |
Teleportiert Spieler und Objekte. |
minecraft.command.tp |
/weather |
Setzt das Wetter auf die angegebene Bedingung. |
minecraft.command.weather |
/whitelist |
Verwaltung der Liste der erlaubten Spielernamen für den Server. |
minecraft.command.whitelist |
/worldborder |
Die Weltgrenze bearbeiten. |
minecraft.command.worldborder |
Sponge also creates permissions for these Minecraft features:
Allow player to use the entity-selector in commands:
minecraft.selector
Erlaubt Spielern den Spawn-Schutz auf allen Welten zu umgehen: ‚‘ minecraft.spawn-protection.override‘‘
Erlaubt Spielern den Force Gamemode auf allen Welten zu umgehen: ‚‘ minecraft.force-gamemode.override‘‘
Ermöglicht das Bearbeiten eines normalen Befehlsblocks mit dem angegebenen Namen:
minecraft.commandblock.edit.block.<name>
Ermöglicht das Bearbeiten einer Befehlsblocklore mit dem angegebenen Namen:
minecraft.commandblock.edit.minecart.<name>
Bemerkung
These permissions use the actual name of the commandblock, which is normally @
by default.
Es gibt weiter extra Berechtigungen um den Zugriff auf den Server zu verwalten:
Ignoriere Whitelist:
minecraft.login.bypass-whitelist
Erlaube das ignorieren des Spielerlimits:
minecraft.login.bypass-player-limit
Bemerkung
Sponge offers improved multi-world support, such as per-world world borders. By default, Sponge only changes the
world border (or other world options) of the world the player is currently in. The vanilla behavior of setting it
for all worlds can be restored using the global configuration and setting
sponge.commands.multi-world-patches.worldborder
(or the corresponding entry) to false
. See
global.conf for details. Sponge assumes that multi-world plugins also
provide optimized configuration commands for those options and thus does not provide its own variants.
Befehle für Spieler
Die folgenden Befehle sind für alle Spieler ohne Operator Status im unmodifizierten (englisch vanilla) Minecraft verfügbar.
Befehl |
Beschreibung |
Berechtigung |
---|---|---|
/help |
Zeige Informationen über Commands auf einem Server, normalerweise wird das Sponge Kommando genutzt! |
minecraft.command.help |
/me |
Teile jedem mit, was du gerade tust. |
minecraft.command.me |
/say |
Zeigt jedem aktuell verbundenen Mitspieler eine Nachricht an (oder, falls Selektoren benutzt werden, nur diesen Spielern). |
minecraft.command.say |
/tell |
Sendet eine private Nachricht an einen anderen Spieler. |
minecraft.command.tell |
Eine vollständige Liste der Vanilla Befehle kann hier eingesehen werden: https://minecraft-de.gamepedia.com/Befehl. DIe Berechtigungen für Minecraft Befehle sehen auf einem Sponge-basierten Server folgendermaßen aus: minecraft.command.<Befehl>
.
Besondere Befehls-Funktionen
Sponge and most Sponge plugins support additional command features such as auto completion and hoverable text. The image
below shows the output using the /sponge plugins
command (yellow box). The elements in that list can be hovered over
to get addition information such as the current version number (red box). Some elements in the example below also have
additional actions bound to them. For example, the plugin entries in that list can be clicked to show more detailed
information (purple box) about that plugin. This is equivalent to sending the /sponge plugins <pluginId>
command.
The auto completion can be triggered by pressing tab. Entering /sponge plugins
(with a trailing space) and then
pressing tab will show a list of possible values (turquoise box) that can be used in that context. Pressing tab again
will iterate the possibilities, if any. Theoretically it is possible to write most commands by pressing only tab and
space (and maybe the first letter of each segment).
Tipp
Wenn du selbst ein Plugin-Autor bist und ein Texte mit Tooltipps oder Aktionen verwenden möchtest, dann sieh dir unsere Text Dokumentation an.