Umstieg von CoreEngine

Mira hieß früher CoreEngine. Es ist dasselbe Plugin mit denselben Modulen und Configs: Daten, Claims, Konten und Items bleiben beim Update erhalten. Neu sind die Namen, unter denen Commands, Permissions und Platzhalter erreichbar sind. Die alten Namen funktionieren nicht mehr und müssen einmal umgestellt werden.

Update in vier Schritten #

Server stoppen und den Ordner plugins/CoreEngine sichern.
Die alte CoreEngine-*.jar aus plugins/ entfernen. Den Ordner plugins/CoreEngine liegen lassen, Mira übernimmt ihn.
Die Mira-JAR in plugins/ legen und den Server starten.
Permissions (zum Beispiel in LuckPerms), Platzhalter in anderen Plugins und eigene Befehls-Aliase oder Skripte auf die neuen Namen umstellen, siehe Alt und neu.

Tipp: In LuckPerms lassen sich die alten Nodes im Web-Editor (/lp editor) schnell finden und ändern. Gruppen, die coreengineclaim.rank.vip hatten, brauchen danach mira.claim.rank.vip.

Was beim ersten Start passiert #

plugins/CoreEngine wird in einem einzigen Schritt zu plugins/Mira umbenannt. Es wird nichts kopiert, es entsteht kein zweiter Datenstand.
Die Hauptdatenbank data/coreengine.db heißt danach data/mira.db, ihre Begleitdateien (-wal, -shm, -journal) wandern mit, und storage.sqlite-file in der config.yml wird angepasst. Steht dort ein selbst gewählter Dateiname, bleibt alles, wie es ist.
Die Claim-Datenbank modules/claim/claims.db behält ihren Namen.
In den Kommentarzeilen der YAML-Dateien wird der alte Name durch Mira ersetzt. Eingestellte Werte bleiben unberührt.
Ein nie veränderter Standard-Chat-Präfix CORE » wird zu MIRA ». Ein angepasster Präfix bleibt stehen.
Items aus der CoreEngine-Zeit (zum Beispiel Cosmetics, Shop-Waren, /lore- und /sign-Texte) werden weiter erkannt und umgestellt, sobald Mira sie das nächste Mal bearbeitet.
Mira legt in plugins/Mira die Datei .migrated-from-coreengine an. Darin steht, wann was übernommen wurde.

Wann Mira deaktiviert bleibt #

Mira legt nie eine leere Datenbank neben die echten Daten. Passt etwas nicht, bleibt das Plugin deaktiviert und schreibt eine Meldung mit Anleitung (SEVERE) ins Log:

Situation4

Situation	Lösung
Die alte CoreEngine-JAR ist noch geladen	Server stoppen, `plugins/CoreEngine-*.jar` entfernen (den Ordner behalten), neu starten
`plugins/CoreEngine` und ein nicht leerer Ordner `plugins/Mira` existieren beide	Mira führt nie zusammen. Enthält `plugins/Mira` nur die Standarddateien eines ersten Testlaufs, diesen Ordner aus `plugins/` verschieben. Liegen dort die gültigen Daten, `plugins/CoreEngine` in ein Backup verschieben
Der Ordner lässt sich nicht in einem Schritt umbenennen	Server stoppen und den Ordner von Hand in `Mira` umbenennen (auf demselben Laufwerk), dann starten
In `plugins/Mira` liegt die Datei `.migration-incomplete`	Die Anweisungen in der Datei befolgen, die Datei löschen, neu starten

Alt und neu #

Bereich17

Bereich	Alt (CoreEngine)	Neu (Mira)
Reload	`/coreengine reload`, `/ce reload`	`/mira reload` (ohne Alias)
Bestätigungs-Handler (intern)	`/coreconfirm`	`/miraconfirm`
Ban-Aliase	`/coreban`, `/coretempban`, `/coreunban`, `/corebanip`, `/coreunbanip`	`/miraban`, `/miratempban`, `/miraunban`, `/mirabanip`, `/miraunbanip`; die Hauptbefehle `/cban`, `/ctempban`, `/cunban`, `/cbanip`, `/cunbanip` bleiben
Namespace-Schreibweise	`/coreengine:msg`, `coreengine:home`	`/mira:msg`, `mira:home`
Web-Panel	`/cweb`	`/cweb` (unverändert)
Admin-Permissions	`coreengine.*`, `coreengine.admin.reload`	`mira.*`, `mira.admin.reload`
Claim-Permissions	`coreengineclaim.<node>`, z. B. `coreengineclaim.admin`, `coreengineclaim.blocksperhour.<zahl>`, `coreengineclaim.rank.<rang>`	`mira.claim.<node>`, z. B. `mira.claim.admin`, `mira.claim.blocksperhour.<zahl>`, `mira.claim.rank.<rang>`
Web-Panel-Permissions	`core.web.*`, `core.web.use`, `core.web.category.<name>`, `core.web.cooldown.bypass`	`mira.web.*`, `mira.web.use`, `mira.web.category.<name>`, `mira.web.cooldown.bypass`
Alle anderen Permissions	`home.use`, `team.*`, `mod.ban`, ...	unverändert
Platzhalter	`%coreengine_<name>%`, z. B. `%coreengine_balance%`	`%mira_<name>%`, z. B. `%mira_balance%`
Claim-Platzhalter	`%coreengineclaim_<name>%`, z. B. `%coreengineclaim_blocks_available%`	`%miraclaim_<name>%`, z. B. `%miraclaim_blocks_available%`
Datenordner	`plugins/CoreEngine/`	`plugins/Mira/` (wird automatisch verschoben)
Modul-Configs	`plugins/CoreEngine/modules/*.yml`	`plugins/Mira/modules/*.yml`
Datenbank	`data/coreengine.db`	`data/mira.db` (wird automatisch umbenannt)
Claim-Config	`GriefPrevention.Database.UseCoreEngine` in `modules/claim.yml`	entfällt; ein noch vorhandener Eintrag wird nicht mehr gelesen und kann gelöscht werden
Jobs-Herkunftsprüfung	`placed-block-provider: coreengineprotect` (auch `cep` oder `native`) in `modules/jobs.yml`	`auto` oder `coreprotect`; ein alter Wert erzeugt eine Warnung im Log, Mira nutzt dann `auto`
Wiki-Adressen	`coreengine.org/coreengine/...`	`coreengine.org/mira/...` (alte Links leiten weiter)

Die vollständige Liste aller Commands und Permissions steht in der Command- & Permission-Referenz, alle Platzhalter unter Integrationen.

Frühere Zusatz-Plugins #

CoreEngineProtect und das eigenständige CoreEngineClaim gibt es nicht mehr. Der Grundstücksschutz steckt als Claim-Modul direkt in Mira, die Block-Historie für den Exploit-Schutz der Jobs und für das Untersuchungswerkzeug der Claims liefert CoreProtect. Ihre JAR-Dateien gehören nicht mehr in den Ordner plugins/. Ein alter Ordner plugins/CoreEngineClaim aus der Zeit des eigenständigen Claim-Plugins wird nicht mehr automatisch übernommen.

ZurückÜberblick WeiterPerformance