Daily Quests und persönliche Serien
Mit FlammiCraft ausgelieferte Mod-Version: 2.64.0
Verwaltungs-API ab 2.56.0
Mit bind = "0.0.0.0" lauscht die API auf allen IPv4-Schnittstellen und nimmt
Verbindungen von jeder Quell-IP an, die das Hostnetz zulässt. Jeder Aufruf
benötigt weiterhin den privaten API-Schlüssel. Standard bleibt 127.0.0.1.
Das Zugriffswerkzeug verwendet die tatsächliche Serveradresse als Ziel.
Die API verwaltet Aufgaben, vollständige Questreihen, Daily-Pools und die Freigabe des Boards in gemeinsam geprüften, atomaren Änderungspaketen. Reihen unterstützen feste und zufällige Positionen, Zeitlimits und Folgereihen. Bei aktiven oder wiederherstellbaren Durchläufen bleibt die Struktur gesperrt; gespeicherte Durchläufe verhindern das Löschen ihrer Reihe. Spielerfortschritt, verdiente Belohnungen und der laufende Daily-Umlauf bleiben erhalten.
Große API-Kataloge werden revisionsgebunden seitenweise gelesen. Der In-Game-Editor erhält größere Bestände in begrenzten Paketen und zeigt sie erst nach vollständigem Empfang. Das Antwortlimit beträgt nun 4.194.304 Zeichen mit Reserve für Spielerzustand und Meldungen. Client und Server benötigen passende Protokoll-62-Builds; das Speicherformat bleibt unverändert. Die API-Anleitung beschreibt Format, Grenzen und die weiterhin erforderliche manuelle Abnahme. Quellprüfung und Build aktivieren keinen Zugang.
Das richtige Schild benutzen
Die optionale Verwaltungs-API verwendet ausschließlich die private, standardmäßig
ausgeschlossene config/tdeconomy-database.toml, Abschnitt [database.quest_api].
Diese Datei wird nicht an Clients synchronisiert. API-Schlüssel gehören niemals
in tdeconomy-common.toml oder eine auszuliefernde Konfiguration. Beim Umstieg eine
bisher wirksame serverconfig/tdeconomy-database.toml aus dem Weltordner mit ihren
bestehenden Werten im globalen config-Ordner erhalten; vorhandene unterschiedliche
Dateien zuerst lokal abgleichen. Die API-Anleitung
beschreibt die Einrichtung und den Austausch möglicherweise offengelegter Schlüssel.
Quelländerung und Build verändern keine Serverkonfiguration.
Ein Daily Quest Sign (tdeconomy:daily_sign) öffnet immer das Daily-Board mit Angeboten, persönlichem Fortschritt, Abgabe und Belohnungen. Ein ungebundenes Quest Series Sign (tdeconomy:quest_sign) bedient persönliche Serien. Für aktive Aktionen muss das richtige Schild in deiner Dimension geladen und höchstens acht Blöcke von dir entfernt sein.
/quests, /money quests und /money daily öffnen dagegen ein lesendes Journal. Damit kannst du unterwegs Fortschritt und Fristen prüfen, aber keine Annahme, Abgabe oder Abholung aus der Ferne auslösen.
Das Board lesen
Oben links steht, wo du dich befindest, zum Beispiel Daily-Quests » Verwaltung » Neue Aufgabe. Oben rechts läuft die verbleibende Zeit. Die Farbe einer Aufgabe zeigt ihre Schwierigkeit: Bronze für Leicht, Silber für Mittel, Gold für Schwer.
Bei einer angenommenen Aufgabe steht vor jedem Ziel ein Zeichen: rot heißt fehlt noch, grün heißt erledigt. Darunter gibt es genau einen Hauptknopf: Belohnung abholen, sonst Abgeben, sonst Vorzeigen. Ist er gesperrt, steht der Grund daneben, etwa dass rot markierte Ziele fehlen oder Aktionsziele automatisch zählen. Annehmen und Abbrechen fragen vorher nach und nennen die Folgen. Bei einer Questreihe steht dabei, die wievielte Aufgabe der Reihe gerade läuft.
Ist das Board noch nicht eingerichtet, sehen Spieler nur einen Hinweis. Die genaue Ursache sehen Betreiber.
Eine Daily erledigen
- Am Daily-Schild die drei Angebote und deren konkrete Anforderungen öffnen.
- Schwierigkeit, Material, Aktionsart, Frist und Belohnung prüfen. Ein Questtag läuft von 06:00 Europe/Berlin bis zum nächsten 06:00.
- Genau ein Angebot dieses Questtags annehmen.
- Die geforderten Aktionen ausführen beziehungsweise die passenden Waren bereitstellen.
- Bei einer Abgabe- oder Vorzeigeaufgabe rechtzeitig zum Daily-Schild zurückkehren und den Abschluss auslösen.
- Die gespeicherte Belohnung am Schild abholen. Für Gegenstände genug Inventarplatz freimachen.
Abbruch, Tod, Fehler, erneutes Verbinden oder Abholung schalten für denselben Questtag keine zweite Wahl frei. Die Zeit läuft auch offline weiter. Eine reine Aktionsaufgabe speichert nach der letzten rechtzeitigen Aktion ihren Belohnungsanspruch; Abgabe- und Vorzeigeaufgaben benötigen den Schildabschluss vor Ablauf.
Parallel eine Serie spielen
Eine persönliche Serie kann neben einer Daily laufen. Es gibt höchstens einen aktiven Serienlauf. Die nächste Position ist erst nach Abschluss des Vorgängers und frühestens 24 Stunden nach dessen Annahme verfügbar. Nach dem Freischalten bleiben 24 Stunden zum Annehmen. Eine verpasste Folgeannahme, verpasste Arbeitsfrist oder ein Abbruch beendet den Lauf; der nächste Versuch beginnt wieder bei Aufgabe eins. Bereits verdiente Ansprüche bleiben bestehen.
Aktionsfortschritt zählt nur für die ausgewählte aktive Daily- oder Serien-Aktionsaufgabe. Am Schild den Fokus prüfen und bei Bedarf wechseln. Ein Fokuswechsel behält beide bisherigen Zähler; er erledigt keine Aufgabe automatisch. Reine Materialaufgaben benötigen keinen Aktionsfokus.
Belohnung und Fehlerhilfe
Belohnungen können Geld, Items oder beides enthalten. Die Abholung erfolgt vollständig oder gar nicht: Zu wenig Inventarplatz lässt den gesamten Anspruch offen. Eine andere noch offene Belohnungsart verhindert die Abholung an ihrem passenden Schild nicht.
| Problem | Prüfen |
|---|---|
| Journal zeigt Fortschritt, aber keinen Abgabeknopf | Zum richtigen Schild zurückkehren. |
| Eine Aktion zählt für die falsche Aufgabe | Aktionsfokus am Schild prüfen. |
| Vorhandene Items passen nicht | Itemdaten, Vorlage beziehungsweise erlaubte Varianten und angenommenen Auftrag prüfen. |
| Keine neue Daily-Annahme möglich | Bereits genutzte Tageswahl, geöffnetes System und Betreiberfreigabe prüfen. |
| Belohnung wird nicht abgeholt | Ausreichend Platz für das gesamte Ergebnis schaffen und erneut am richtigen Schild versuchen. |
Betreiber benötigen für Daily-Aktivierung genau 60 gültige unterschiedliche Aufgaben je Schwierigkeitsstufe. Änderungen an laufenden angenommenen Bedingungen gelten nicht rückwirkend; Ausfallkorrekturen verlangen einen Grund und können freigegebene Mittel erneut reservieren. Schließen des Boards sperrt neue Annahmen, erhält aber Abschluss und Abholung. Die englische Referenz beschreibt Poolzyklen, Serienenden und Wiederherstellungsgrenzen ausführlich.
Aufgaben und Reihen anlegen
Als Betreiber am Schild Bearbeiten öffnen. Die Liste zeigt Aufgaben mit Schwierigkeit und den Vermerken im Pool, nicht im Pool oder Finale; das Suchfeld filtert sofort. Bei Daily-Schildern steht oben, wie viele der je 60 Poolplätze belegt sind.
+ Neue Aufgabe öffnet ein einziges Formular. Pflichtangaben haben rechts ein Zeichen: rot fehlt, grün erledigt. Optionale Angaben bleiben ungefärbt. Unten steht, wie viele Pflichtangaben noch offen sind und welche zuerst. Speichern bleibt gesperrt, bis alle Pflichtangaben erledigt sind. Das Fragezeichen neben einem Feld erklärt es; mit der Tastatur zeigt der Fokus denselben Text.
- Titel eingeben, optional eine Beschreibung. Der Zähler zeigt die verbleibenden Zeichen.
- Schwierigkeit wählen.
- Ziele hinzufügen: + Abgeben nimmt Items beim Abschluss weg, + Vorzeigen prüft sie nur, + Aktion zählt Taten wie Abbauen oder Besiegen. Beim Item zuerst Item und Menge wählen, dann, ob ein normales Item genügt, ob es wie ein Musteritem sein muss oder ob die Daten egal sind. Jede Zielzeile hat eine Mengeneingabe, Ändern und ×.
- Belohnung festlegen: Geld, feste Items, eine Zufallsbelohnung oder eine Kombination. Sobald ein Geldbetrag eingetragen ist, erscheint die Kontoauswahl als Pflichtfeld. Zufallsbelohnung hinzufügen öffnet die Liste; bei jedem Eintrag steht seine Chance, darunter die Anzahl der Ziehungen und ob dasselbe Item mehrfach kommen darf.
- Unter Mehr Optionen stehen das Thema für Questreihen und der Finale-Schalter. Eine Finale-Aufgabe kommt nie in den Daily-Pool; das Formular warnt bei Daily-Schildern davor.
Auf breiten Fenstern steht rechts eine Vorschau des Questzettels, auf schmalen öffnet Vorschau sie. Duplizieren legt eine Kopie an. Zurück mit ungespeicherten Änderungen fragt nach.
+ Neue Reihe öffnet das Reihenformular: Titel, Zeit pro Aufgabe (24 oder 48 Stunden), optional eine Zeit je Schwierigkeit, das Verhalten nach der letzten Aufgabe und die Aufgabenliste. + Feste Aufgabe wählt eine Aufgabe aus dem Katalog, + Zufällige Aufgabe einen Platz mit Schwierigkeit und optionalem Thema; die Zeile nennt, wie viele Aufgaben passen. Pfeile ändern die Reihenfolge, × entfernt einen Platz.
Läuft eine Reihe gerade bei Spielern, steht das in der Liste neben ihrem Namen. Im Formular erklärt ein Hinweis die Sperre: Bis diese Durchläufe enden, ist nur der Titel änderbar; Aufgaben, Zeiten und das Ende sind gesperrt. Spieler sehen bei einer gesperrten Reihe den Grund, etwa dass schon eine andere Reihe läuft, dass sie erst nach der vorherigen Reihe freigeschaltet wird oder wann der nächste Start möglich ist.
Bestehende Bedingungen bearbeiten
Als Betreiber über Bearbeiten die Aufgabe öffnen und bei einer Zielzeile Ändern wählen; die Bedingung muss dafür nicht entfernt werden. Die Auswahl zeigt die aktuellen Werte als Details, lange Werte zusätzlich im Tooltip.
- Bei Aktionen lassen sich Aktionsart, Ziel, Dimension und Menge einzeln ändern. Nach dem Wechsel der Aktionsart ein passendes Ziel auswählen; Menge und Dimension bleiben erhalten.
- Bei Materialbedingungen lassen sich Item oder Item-Tag, Menge, Abgabe oder Vorzeigen, Datenvergleich und Datenvorlage ändern. Datenvorlage ersetzen übernimmt die Daten eines ausgewählten Musteritems und wählt den Vorlagenvergleich. Der separate Schalter Alle Itemdaten ignorieren bleibt dabei erhalten.
- Datenfilter bearbeiten zeigt Felder der gespeicherten Vorlage und des Standarditems. Muster für Filterfelder auswählen ergänzt die tatsächlich vorhandenen Daten eines anderen Musteritems, ohne dieses zur neuen Vorlage zu machen. Bereits ausgewählte Filter bleiben sichtbar, auch wenn ihr Feld im Muster fehlt. Mit den Checkboxen Felder oder ganze Gruppen umschalten und mit Filter fertig übernehmen. Bei aktiviertem Alle Itemdaten ignorieren werden die einzelnen Filter erst nach Ausschalten dieses Schalters wieder wirksam.
- Bei Item-Tags lässt sich unter Erlaubte Itemvarianten bearbeiten eine Auswahl festlegen. Alle aktuellen Mitglieder dieses Item-Tags erlauben hebt diese Einschränkung ausdrücklich auf. Eine leere Einzelauswahl wird nicht stillschweigend als Freigabe aller Varianten übernommen.
Abbrechen eines Auswahldialogs übernimmt dessen neue Auswahl nicht. Bereits übernommene Feldänderungen liegen zunächst nur im Aufgabenentwurf. Erst Speichern sichert die Aufgabe auf dem Server. Identität, andere Bedingungen, nicht geänderte Einstellungen, bestehende Tagesangebote und bereits angenommene Aufgaben bleiben erhalten.
Honig und Honigwaben
Die Aktionsarten Honigflaschen ernten und Honigwaben ernten sind getrennt wählbar. Als Ziel den Bienenstock beziehungsweise ein passendes Block-Tag wählen, optional mit Dimension. Die Flasche zählt nur für das Flaschenziel, eine zum Ernten geeignete Schere nur für das Wabenziel. Eine erfolgreiche Ernte zählt einmal; drei erzeugte Waben sind keine drei Ernteaktionen. Verhinderte Aktionen und reine Maschinenaktionen zählen nicht.
Die bisherige Aktionsart Honig oder Honigwaben ernten bleibt verfügbar und akzeptiert beide Varianten. Bestehende und bereits angenommene Aufgaben, Fortschritte und Ansprüche werden dafür nicht umgeschrieben. Die Questkorrekturen in 2.39.0 ändern weder das Economy-SavedData-Schema 22 noch das Board-Schema 5. Client und Server benötigen passende Protokoll-60-Builds.
Lieferreihen entfernt
Ab 2.56.0 gibt es die eigenen Daily-Lieferreihen nicht mehr. Ein Daily-Schild öffnet immer das Daily-Board, auch wenn es früher mit einer Lieferreihe verbunden war. Gespeicherte Lieferreihen, Läufe, Belege und Korrekturen bleiben unverändert in den Wirtschaftsdaten erhalten, werden aber nicht mehr angeboten. Für mehrstufige Wege Questreihen am Quest Series Sign verwenden.
Cluster-Fortschritt ab 2.56.0
Im Datenbankmodus wird Aktionsfortschritt mit eindeutiger Ereignis-ID, ursprünglichem Versuch und Ereigniszeitpunkt eingereiht. Der aktuelle Questschreiber verarbeitet ihn am neuesten gemeinsamen Stand und bestätigt ihn in derselben Speicherung. Doppelte Ereignisse zählen einmal; Ereignisse eines ersetzten Versuchs zählen nicht für den neuen Versuch. Eine gespeicherte Warteschlange übersteht Ausfälle und Neustarts des sendenden Backends. Die Anzeige kann sich kurz verzögern. Während eines Datenbankausfalls sind eingereihter Fortschritt und Belohnungsabholung getrennt; die Abholung benötigt weiterhin eine verfügbare Wirtschaft. Siehe Clusterbetrieb und manuelle Abnahme.
Speicherung und manuelle Abnahme
Ab 2.56.0 werden ungeordnete Quest-Mengen und Zuordnungen in einer festen Reihenfolge gespeichert. Identische Daten anderer Backends lösen dadurch keine wiederholten Schreibanforderungen allein wegen einer anderen Java-Iterationsreihenfolge aus. Vor der Übergabe der Quest-Schreibsperre werden noch ausstehende Änderungen zur Veröffentlichung eingereiht; abgelaufene lokale Sperren können erneut angefordert werden. Aufgaben- und Serienentwürfe bleiben bei einer abgelehnten Speicherung geöffnet. Bei „Ein anderer Server speichert gerade Questdaten“ kurz warten und im erhaltenen Entwurf erneut Speichern wählen. Erst eine bestätigte Speicherung führt zur Verwaltungsliste zurück. Keine Questdateien oder Sperrtabellen zurücksetzen.
Ab 2.63.0 wartet der Aufgaben-Editor nach Speichern im Cluster bis zu acht Sekunden auf die Schreibsperre. Wird sie in dieser Zeit verfügbar, prüft der Server die ursprüngliche Katalogrevision erneut und speichert bei passender Revision. Bei einem Zeitlimit oder einer zwischenzeitlichen Katalogänderung bleibt der Entwurf geöffnet.
Für diese Korrekturen passende 2.56.0-Builds auf allen Backends und Clients manuell installieren und vollständig neu starten. Die automatisierten Prüfungen verwenden ausschließlich eine lokale Testdatenbank. Die manuelle Clusterabnahme bleibt offen: Aufgabe auf Backend A speichern, auf B und C prüfen, eine Änderung auf B speichern und auf A erneut öffnen. Auch einen abgelehnten Speicherversuch und den erhaltenen Entwurf prüfen.
Der Server speichert ein neues Tagesangebot samt Umlauf vor der Anzeige verbindlich. Bei einem Schreibfehler wird das neue Angebot nicht freigegeben. Das Board zeigt einen roten Speicherfehler; erneut versuchen und bei Wiederholung als Betreiber Weltspeicher und Serverlog prüfen. Keine Questdateien zurücksetzen. Abschluss und Abholung bestehender Aufgaben bleiben von einer fehlgeschlagenen neuen Ziehung getrennt.
Quellprüfung und automatisierte Tests ersetzen keine In-Game-Abnahme. Nach manueller Installation passender Builds und vollständigem Neustart prüfen:
- Ein Angebot öffnen, neu verbinden und den Server regulär neu starten; die Karten müssen gleich bleiben. Schreibfehler werden automatisiert mit einer Testgegenstelle geprüft; dafür keine produktiven Weltdateien sperren oder beschädigen.
- Zwei spezifische Ernteziele und ein kombiniertes Ziel am selben Bienenstock ausprobieren. Flasche und Schere müssen nur das passende spezifische Ziel und das kombinierte Ziel fortschreiben.
- Eine bestehende Materialbedingung mit verschachtelten Moddaten öffnen. Nur einen Filter ändern, anschließend die Menge ändern und speichern. Vorlage, übrige Filter, Abgabeart und Varianten müssen erhalten bleiben. Einen Filterdialog abbrechen und prüfen, dass seine Änderungen nicht übernommen wurden.
- Aktionsziel und Dimension einer vorhandenen Bedingung ändern. Eine schon vorher angenommene Aufgabe muss ihre alten Bedingungen behalten; neue Annahmen verwenden die geänderte Definition, bei Daily-Angeboten ab dem nächsten Umlauf.
- Eine neue Aufgabe anlegen: Rot und Grün der Pflichtangaben, gesperrtes Speichern, Kontofeld erst nach Geldbetrag, Vorschau bei breitem und schmalem Fenster sowie Tastaturbedienung mit Tab, Enter und Escape prüfen.
- Ein früher mit einer Lieferreihe verbundenes Daily-Schild öffnen; es muss das Daily-Board zeigen.