# 📦 Aufträge auf Returox (RX_Order)

Mit dem **Auftragssystem** kannst du andere Spieler für das Sammeln bestimmter Items bezahlen oder selbst Items abgeben und dafür **TX** verdienen. Alles läuft über übersichtliche Inventarmenüs: Du musst niemanden direkt anschreiben oder mit ihm gleichzeitig online sein.

## 📖 1. Was sind Aufträge?

Ein Auftrag ist eine öffentliche Suchanzeige für ein bestimmtes Item. Ein Spieler legt fest, **welches Item**, **wie viele Stück** und **wie viel TX insgesamt** er dafür bezahlen möchte. Andere Spieler können anschließend passende Items abgeben. Der Auftraggeber holt die gesammelten Items später ab.

Es gibt zwei Möglichkeiten, das System zu nutzen:

- **🪙 Als Auftraggeber:** Du suchst Items, legst eine Menge und einen Gesamtpreis fest und lässt sie von anderen sammeln.
- **⛏️ Als Lieferant:** Du suchst dir einen offenen Auftrag, gibst passende Items ab und erhältst TX für die tatsächlich angenommenen Stücke.

**Für Anfänger:** Öffne mit `/order` die Auftragsübersicht. Dort kannst du die offenen Aufträge ansehen, selbst einen Auftrag erstellen oder bereits gesammelte Items aus deinen Aufträgen abholen.

## 🚀 2. Schnellstart

### Du möchtest TX verdienen?

1. Gib `/order` im Chat ein.
2. Suche in der Übersicht einen Auftrag für ein Item, das du besitzt oder sammeln kannst.
3. Klicke auf das gewünschte Item.
4. Lege passende Items in die oberen fünf Reihen des Abgabefensters.
5. Schließe das Fenster. Erst dadurch wird deine Abgabe verarbeitet.
6. Für angenommene Items bekommst du die entsprechende Bezahlung in TX.

### Du möchtest Items sammeln lassen?

1. Gib `/order place` ein.
2. Wähle ein Item aus deinem Inventar als Muster aus.
3. Lege den **Gesamtpreis** und die **gewünschte Gesamtmenge** fest.
4. Klicke auf die grüne Wolle **„Auftrag erstellen“**.
5. Andere Spieler können nun Items für deinen Auftrag abgeben.
6. Öffne später `/order claim`, um die eingegangenen Items abzuholen.

## ⌨️ 3. Alle Spielerbefehle

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| `/order` | Öffnet die Übersicht der offenen Aufträge. | `/order` |
| `/auftrag` | Deutscher Alias für `/order`. | `/auftrag` |
| `/order place` | Öffnet das Menü zum Erstellen eines Auftrags. | `/order place` |
| `/auftrag place` | Gleiche Funktion über den deutschen Alias. | `/auftrag place` |
| `/order claim` | Öffnet die Übersicht deiner eigenen Aufträge zum Abholen von Items. | `/order claim` |
| `/auftrag claim` | Gleiche Funktion über den deutschen Alias. | `/auftrag claim` |

**Argumente:** `place` und `claim` sind die einzigen vorgesehenen Unterbefehle. Du musst weder einen Spielernamen noch eine Item-ID angeben. Weitere Pflicht- oder optionale Argumente gibt es nicht. Die Auswahl des Auftrags erfolgt im Menü.

**Hinweis zur Schreibweise:** In Befehlsanleitungen würde `<spieler>` für eine Pflichtangabe und `[spieler]` für eine optionale Angabe stehen. Bei RX_Order brauchst du beides nicht.

## 🖥️ 4. Die Auftragsübersicht

**Öffnen:** `/order` oder `/auftrag`

Die Übersicht ist ein großes Inventarmenü mit **54 Feldern**. Bis zu **36 Aufträge pro Seite** werden in der Mitte als Items dargestellt. Jeder angezeigte Auftrag ist noch nicht vollständig beliefert.

### Was steht bei einem Auftrag?

- **Item:** Das gesuchte Item und seine Eigenschaften.
- **Bereits abgegeben:** Zum Beispiel `16/64`. Von 64 gewünschten Items wurden bisher 16 angenommen.
- **Preis pro Item:** Der aus dem Gesamtpreis errechnete Stückpreis in TX.
- **Auftraggeber:** Der Spieler, der den Auftrag erstellt hat.

**Klicke auf einen Auftrag**, um das zugehörige Abgabefenster zu öffnen.

### Schaltflächen

| Schaltfläche | Position | Funktion |
|---|---|---|
| **⬅️ Vorherige Seite** (Pfeil) | Unten links | Geht eine Seite zurück, sofern du nicht auf Seite 1 bist. |
| **📄 Seite X** (Papier) | Unten mittig | Zeigt die aktuelle Seitennummer an. |
| **➡️ Nächste Seite** (Pfeil) | Unten rechts neben der Seitenanzeige | Zeigt weitere Aufträge, wenn eine Folgeseite vorhanden ist. |
| **📦 Deine Items durch Aufträge** (Truhe) | Unten, vorletztes Feld | Öffnet die Abholübersicht deiner eigenen Aufträge. |
| **📖 Was sind Aufträge?** (Buch) | Unten rechts | Öffnet direkt das Menü zum Erstellen eines Auftrags. |

**Gut zu wissen:** Das Buch ist kein eigener Hilfetext zum Durchblättern. Ein Klick darauf führt direkt zur Auftragserstellung.

### Eigene Aufträge in der Übersicht

Auch dein eigener Auftrag kann in der allgemeinen Übersicht erscheinen, solange noch Items fehlen. Der Beschreibungstext deutet zwar eine Bearbeitung an, **ein Bearbeitungsmenü gibt es derzeit aber nicht**. Ein Klick öffnet auch bei eigenen Aufträgen das normale Abgabefenster.

## 📝 5. Einen Auftrag erstellen

**Öffnen:** `/order place`, `/auftrag place` oder das Buch in der Auftragsübersicht.

Das Erstellmenü hat **27 Felder** und vier wichtige Stellen:

| Angezeigtes Item | Position | Was du damit machst |
|---|---|---|
| **🪙 Goldbarren „Preis setzen“** | Obere Auswahl, links | Legt fest, wie viele TX du **insgesamt** für den Auftrag ausgibst. |
| **🟠 „Item einsetzen“** | Mitte | Zeigt das Item an, das andere Spieler abgeben sollen. |
| **🏷️ Namensschild „Anzahl setzen“** | Obere Auswahl, rechts | Legt die gewünschte Gesamtmenge fest. |
| **🟩 Grüne Wolle „Auftrag erstellen“** | Unten rechts | Bestätigt den Auftrag. |

### Schritt 1: Item auswählen

Klicke im **eigenen Inventar** auf das Item, das du bestellen möchtest. Es wird als **Muster** in der Mitte des Erstellmenüs angezeigt.

Das ausgewählte Item wird dabei **nicht aus deinem Inventar entfernt**. Es dient nur als Vorlage. Auch besondere Eigenschaften des Items, etwa Verzauberungen, sind für später abgegebene Items relevant.

### Schritt 2: Gesamtpreis festlegen

1. Klicke auf den Goldbarren **„Preis setzen“**.
2. Gib im Eingabefenster den gewünschten Gesamtpreis in TX ein.
3. Klicke auf **„Übernehmen“**, um ihn zu speichern, oder auf **„Abbrechen“**, um nichts zu ändern.

Der Preis muss **größer als 0 TX** sein. Du brauchst mindestens so viele TX auf deinem Konto, wie du für den gesamten Auftrag anbieten möchtest. Für Dezimalzahlen verwendest du bei der Eingabe einen **Punkt**, zum Beispiel `12.5`.

### Schritt 3: Menge festlegen

1. Klicke auf das Namensschild **„Anzahl setzen“**.
2. Gib eine **ganze Zahl größer als 0** ein, beispielsweise `64`.
3. Bestätige mit **„Übernehmen“** oder verlasse die Eingabe mit **„Abbrechen“**.

Die Menge bezeichnet **Items**, nicht Inventarstapel. `64` bedeutet 64 einzelne Items.

### Schritt 4: Auftrag bestätigen

Kontrolliere Item, Gesamtpreis und Menge. Klicke danach auf **„Auftrag erstellen“** (grüne Wolle).

Wenn alles passt und du genügend TX besitzt, wird dir der **gesamte festgelegte Preis sofort abgezogen** und der Auftrag angelegt. Du erhältst die Nachricht **„Auftrag wurde erstellt.“**

Fehlen Preis, Menge oder Item, wird der Auftrag nicht angelegt. Auch mit zu wenig TX kannst du ihn nicht erstellen. Schlägt das Speichern nach einer Abbuchung fehl, versucht das System, den Betrag zurückzuerstatten. Sollte eine Rückerstattung einmal fehlschlagen, wirst du aufgefordert, das Team zu kontaktieren.

### Beispiel: Diamanten bestellen

Du möchtest **64 Diamanten** und bietest dafür **320 TX**.

- Gewünschtes Item: **Diamant**
- Anzahl: **64**
- Gesamtpreis: **320 TX**
- Rechnerischer Preis: **5 TX pro Diamant**

Du zahlst bei der Erstellung 320 TX ein. Gibt jemand später 16 passende Diamanten ab, werden davon **80 TX** an den Lieferanten ausgezahlt. Die übrigen 48 Diamanten können andere Spieler oder derselbe Spieler später liefern.

**Wichtig:** Im aktuellen Auftragssystem gibt es für Spieler keine eigene Schaltfläche zum nachträglichen Ändern, Stornieren oder Löschen eines Auftrags. Prüfe deine Angaben daher **vor dem Erstellen** sorgfältig.

## ⛏️ 6. Items für einen Auftrag abgeben

**Öffnen:** `/order` eingeben und in der Übersicht auf einen offenen Auftrag klicken.

Im Abgabefenster stehen dir die **oberen fünf Reihen mit insgesamt 45 Feldern** zur Verfügung. Die unterste Reihe ist für die Anzeige reserviert.

### So funktioniert die Abgabe

1. Lege die Items, die du verkaufen möchtest, in die freien Felder des Abgabefensters.
2. Du kannst normale Inventarklicks verwenden. Auch **Shift-Klick aus deinem Inventar** kann Items in die freien Abgabefelder verschieben.
3. In der Mitte der unteren Reihe siehst du das Auftragsitem. Bei passenden eingelegten Items erscheint dort eine **TX-Vorschau**.
4. **Schließe das Inventar**, um deine Abgabe abzuschicken.
5. Das System prüft die eingelegten Items und bezahlt die Stücke, die noch für den Auftrag benötigt werden.

Es gibt **keinen separaten Verkaufen-Knopf**. Das Schließen des Abgabefensters löst die Verarbeitung aus.

### Welche Items werden angenommen?

Nur Items, die zum gesuchten Muster passen, zählen für den Auftrag. Nicht nur der Itemtyp, sondern auch besondere Itemeigenschaften können entscheidend sein.

**Beispiel:** Wenn ein Auftrag ein bestimmtes verzaubertes Werkzeug sucht, reicht ein gewöhnliches Werkzeug derselben Art nicht unbedingt aus.

- **Falsche Items** werden nicht verkauft und dir beim Schließen zurückgegeben.
- **Zu viele passende Items** werden nur bis zur noch benötigten Auftragsmenge angenommen. Der Rest wird dir zurückgegeben.
- Falls dein Spielerinventar bei einer Rückgabe zu voll ist, können zurückgegebene Items **bei deiner Position auf den Boden fallen**. Achte deshalb auf genügend Platz und einen sicheren Standort.

### Teilmengen sind erlaubt

Du musst nicht die gesamte gewünschte Menge auf einmal liefern. Wenn ein Auftrag noch 40 Items benötigt und du nur 10 besitzt, kannst du die 10 abgeben und wirst für diese 10 bezahlt.

Die TX-Vorschau ist eine Orientierung. Wenn ein anderer Spieler denselben Auftrag fast gleichzeitig erfüllt, können am Ende weniger Items angenommen und bezahlt werden als zuvor angezeigt.

### Welche Klickarten funktionieren?

Das Menü unterstützt das normale Einlegen und Herausnehmen von Items sowie das beschriebene Shift-Einlagern. Die unterste Reihe mit der Auftragsanzeige ist geschützt. Bestimmte Sonderaktionen wie Zahlentasten-Tausch, Doppelklick-Sammeln, Mittelklick und der Tausch mit der Zweithand sind in diesem Fenster gesperrt. Es gibt **keine eigenen unterschiedlichen Verkaufsaktionen** für Links-, Rechts- oder Shift-Klick.

### Auszahlung

Für erfolgreich angenommene Items erhältst du **TX**. Der Stückwert richtet sich nach dem Gesamtpreis des Auftrags geteilt durch die gewünschte Gesamtmenge. Die Abgabeübersicht zeigt dir anschließend, wie viele TX du durch den Verkauf erhalten hast.

Wenn keine passenden Items eingelegt waren, erscheint die Nachricht **„Es wurden keine Items verkauft“**.

## 📥 7. Gesammelte Items abholen

**Öffnen:** `/order claim`, `/auftrag claim` oder die Truhe **„Deine Items durch Aufträge“** im Hauptmenü.

Die Abholübersicht zeigt **deine eigenen Aufträge** an, auch wenn sie noch nicht vollständig beliefert wurden. Es passen **36 Aufträge auf eine Seite**; weitere erreichst du mit den Pfeilen.

Bei jedem Auftrag siehst du unter anderem:

- Wie viele Items insgesamt bereits abgegeben wurden.
- Welcher Stückpreis für den Auftrag gilt.
- **„Zum abholen bereit“:** die Anzahl, die du bisher noch nicht abgeholt hast.

### So holst du Items ab

1. Öffne `/order claim`.
2. Suche den gewünschten Auftrag.
3. Prüfe die Angabe **„Zum abholen bereit“**.
4. Sorge für ausreichend Platz in deinem Inventar.
5. **Klicke auf das Auftragsitem.** Verfügbare Items werden direkt in dein Inventar übertragen.

**Du musst nicht warten, bis der gesamte Auftrag erfüllt ist.** Du kannst auch zwischenzeitlich bereits gelieferte Items abholen.

Wenn nur Platz für einen Teil der verfügbaren Items ist, kann das System zunächst diese Teilmenge übertragen. Was du noch nicht abgeholt hast, bleibt für eine spätere Abholung verfügbar. Ist gar kein Platz frei, erscheint ein entsprechender Hinweis.

Wenn der Auftrag vollständig beliefert und **alles abgeholt** wurde, ist er abgeschlossen und wird aus der Auftragsverwaltung entfernt.

### Seitenwechsel in der Abholübersicht

- **⬅️ Pfeil unten links:** vorherige Seite.
- **📄 Papier unten mittig:** aktuelle Seite.
- **➡️ Pfeil unten rechts:** nächste Seite, falls vorhanden.

## 🪙 8. Preise, Fortschritt und Grenzen

### Was bedeutet der Preis pro Item?

Der Stückpreis ist keine zusätzliche Gebühr. Er ergibt sich aus deiner Preisangabe:

**Gesamtpreis ÷ gewünschte Itemmenge = rechnerischer Stückpreis**

Ein Auftrag über **100 Items für insgesamt 250 TX** hat damit einen rechnerischen Wert von **2,5 TX je Item**. Die angezeigten Zahlen können gerundet sein.

### Wann bekommst du Geld beziehungsweise Items?

| Situation | Was passiert? |
|---|---|
| Du erstellst einen Auftrag. | Der festgelegte Gesamtpreis wird von deinem TX-Guthaben abgezogen. |
| Du gibst passende Items ab und schließt das Abgabefenster. | Die angenommenen Items werden bezahlt. |
| Du gibst unpassende oder überschüssige Items ab. | Sie werden zurückgegeben, gegebenenfalls auf den Boden gelegt. |
| Jemand beliefert deinen Auftrag. | Die Items stehen dir über `/order claim` zur Abholung bereit. |
| Du holst nur einen Teil ab. | Der Rest bleibt zum späteren Abholen verfügbar. |
| Alles wurde geliefert und abgeholt. | Der Auftrag gilt als abgeschlossen und verschwindet. |

### Welche Limits gibt es?

- **36 angezeigte Aufträge pro Übersichtsseite**.
- **45 Einzahlungsfelder** im Abgabefenster; wie viele Items hineinpassen, hängt von deren Stapelgröße ab.
- **Preis und Menge müssen größer als 0 sein.** Die Menge muss eine ganze Zahl sein.
- **Keine feste Frist oder tägliche Auftragsbegrenzung** ist für Spieler in diesem System vorgesehen.
- **Keine Level, Erfahrungspunkte, Auftragsränge, Freischaltungen oder Upgrades** sind Bestandteil dieses Plugins.
- **Keine zusätzliche feste Auftragsgebühr** ist im gezeigten Ablauf vorgesehen. Der gesamte festgelegte Preis wird für die Bezahlung der Lieferanten verwendet.

Wenn du Menüs sehr schnell nacheinander öffnest, kann eine Anfrage kurz ignoriert werden. Öffne das gewünschte Menü dann einfach erneut.

## 💡 9. Tipps und Tricks

1. **🧮 Rechne vor der Auftragserstellung nach.** Ein Gesamtpreis von 320 TX für 64 Items entspricht 5 TX je Stück.
2. **🎯 Wähle das richtige Musteritem.** Eine andere Verzauberung oder andere Eigenschaften können verhindern, dass Items angenommen werden.
3. **📦 Nutze Teillieferungen.** Auch kleinere Mengen können dir TX einbringen.
4. **💰 Vergleiche die Stückpreise.** Der in der Übersicht angezeigte Stückpreis hilft dir, passende Aufträge auszuwählen.
5. **📥 Hole Items regelmäßig ab.** Bereits gelieferte Items müssen nicht bis zum Ende des Auftrags liegen bleiben.
6. **🎒 Halte Inventarplätze frei.** Das ist besonders wichtig beim Abholen und bei der Rückgabe überschüssiger Items.
7. **🧭 Nutze die Seitenpfeile.** Aufträge, die du auf Seite 1 nicht findest, können auf weiteren Seiten stehen.
8. **✅ Schließe das Abgabefenster bewusst.** Erst dann wird das Einzahlen verarbeitet. Bloßes Hineinlegen zahlt noch keine TX aus.
9. **📖 Nutze die Kurzbefehle.** Mit `/order place` und `/order claim` kommst du direkt zum richtigen Menü.
10. **🔎 Kontrolliere deine Bestellung vorher.** Ein nachträgliches Bearbeiten oder Stornieren über das Spielermenü ist aktuell nicht vorgesehen.

## ❓ 10. Häufig gestellte Fragen (FAQ)

### 1. Wie öffne ich das Auftragssystem?

Mit `/order` oder `/auftrag`. Beide Befehle öffnen die Übersicht der offenen Aufträge.

### 2. Wie erstelle ich einen Auftrag?

Öffne `/order place`, wähle ein Item als Muster aus, stelle Gesamtpreis und Anzahl ein und bestätige mit der grünen Wolle.

### 3. Kostet das Erstellen eines Auftrags TX?

Ja. Der von dir festgelegte **Gesamtpreis** wird beim Erstellen abgezogen. Eine zusätzliche feste Gebühr wird in diesem Plugin nicht erhoben.

### 4. Wird mein Musteritem beim Erstellen verbraucht?

Nein. Das Item aus deinem Inventar dient nur als Vorlage. Du musst es nicht abgeben.

### 5. Warum kann ich meinen Preis nicht einstellen?

Der Preis muss größer als 0 sein, und du brauchst genügend TX. Verwende bei Nachkommastellen einen Punkt, beispielsweise `10.5`.

### 6. Warum wird meine Item-Anzahl nicht angenommen?

Die Menge muss eine **positive ganze Zahl** sein. `64` funktioniert, `0`, `-5` oder `2.5` nicht.

### 7. Muss ich alle Items eines Auftrags auf einmal abgeben?

Nein. Du kannst auch eine kleinere Menge liefern. Bezahlt werden die Stücke, die noch benötigt und tatsächlich angenommen werden.

### 8. Warum werden meine Items nicht verkauft?

Möglicherweise passen sie nicht genau zum Muster, der Auftrag benötigt keine weiteren Items oder du hast keine passenden Items eingelegt. Beim Schließen bekommst du nicht angenommene Items zurück.

### 9. Warum bekomme ich weniger TX als in der Vorschau angezeigt?

Die Vorschau richtet sich nach dem zuletzt angezeigten Auftragsstand. Wenn andere Spieler gleichzeitig liefern, kann sich die noch benötigte Menge bis zum Schließen des Fensters verändern.

### 10. Wann wird das Geld für abgegebene Items gutgeschrieben?

Die Auszahlung erfolgt bei der Verarbeitung deiner Abgabe, **nachdem du das Abgabefenster geschlossen hast**, sofern passende Items angenommen wurden.

### 11. Wie hole ich die Items aus meinem eigenen Auftrag ab?

Mit `/order claim`. Klicke dort auf den Auftrag mit verfügbaren Items. Achte darauf, dass dein Inventar Platz bietet.

### 12. Kann ich Items abholen, obwohl mein Auftrag noch nicht vollständig ist?

Ja. Bereits abgegebene und noch nicht abgeholte Items kannst du auch zwischendurch abholen.

### 13. Warum kann ich beim Abholen nichts bekommen?

Entweder stehen gerade **0 Items** zur Abholung bereit oder dein Inventar ist voll. Prüfe die Zahl **„Zum abholen bereit“** und schaffe Platz.

### 14. Warum sehe ich meinen Auftrag nicht mehr in der allgemeinen Übersicht?

Dort werden nur Aufträge angezeigt, bei denen noch Items fehlen. Wenn die gewünschte Menge erreicht wurde, erscheint der Auftrag dort nicht mehr. In `/order claim` kannst du deine eigenen Aufträge und noch abholbare Items ansehen.

### 15. Kann ich einen bestehenden Auftrag bearbeiten oder stornieren?

**Nein, nicht über die vorhandenen Spielerfunktionen.** Auch wenn der Text in der allgemeinen Übersicht bei eigenen Aufträgen „bearbeiten“ erwähnt, öffnet ein Klick nur das Abgabefenster.

### 16. Was passiert mit falschen oder zu vielen Items?

Sie werden dir beim Verarbeiten zurückgegeben. Wenn dein Inventar voll ist, können sie neben dir auf dem Boden landen.

### 17. Gibt es Level, besondere Belohnungen oder tägliche Aufträge?

Nein. Das System konzentriert sich auf Aufträge, Items und TX. Ein Level- oder Tagesaufgabensystem gehört nicht dazu.

### 18. Was mache ich bei einer Fehlermeldung oder wenn Items nicht ankommen?

Versuche es nicht mehrfach gleichzeitig. Bei bestimmten unterbrochenen Abläufen kann das System ausstehende Items bei deiner nächsten Anmeldung nachliefern. Wenn TX oder Items trotzdem fehlen, **kontaktiere das Returox-Team** und beschreibe möglichst genau, welchen Auftrag du genutzt hast und was passiert ist.

## 🎉 Zusammenfassung

Mit **`/order`** findest du offene Aufträge und kannst durch das Abgeben passender Items **TX verdienen**. Mit **`/order place`** gibst du selbst einen Sammelauftrag auf. Über **`/order claim`** holst du die Items ab, die andere Spieler für dich gesammelt haben.

**Viel Spaß beim Sammeln, Handeln und Erfüllen von Aufträgen auf Returox!** ⛏️📦