# 🛒 RX_Shop – Der Admin-Shop auf Returox

Willkommen im Shop von **Returox**! Mit **RX_Shop** kannst du angebotene Gegenstände kaufen, eigene Gegenstände an den Shop verkaufen und größere Mengen bequem auf einmal handeln. Dafür stehen dir übersichtliche Inventarmenüs und einfache Befehle zur Verfügung.

> **Kurzstart:** Gib `/shop` ein, wähle eine Kategorie und klicke auf ein angebotenes Item. Mit `/sellgui` kannst du deine verkaufbaren Gegenstände in ein Verkaufsfenster legen und **beim Schließen** verkaufen.

## 📖 1. Plugin-Übersicht

**Plugin:** RX_Shop  
**Art:** Zentraler Admin-Shop für Spieler  
**Verfügbar:** Auf den Returox-Servern, auf denen der Shop angeboten wird

### Was bietet der Shop?

- 🛍️ **Items kaufen:** Durchsuche Shop-Kategorien und kaufe die gewünschte Menge.
- 💰 **Items verkaufen:** Verkaufe einzelne Gegenstände, ganze Stapel oder mehrere Arten auf einmal.
- 📦 **Größere Mengen handeln:** Kaufe oder verkaufe direkt bis zu neun Stapel eines Items in einem Vorgang.
- 🧺 **Verkaufs-GUI:** Lege verschiedene Items in ein Fenster und verkaufe geeignete Items automatisch beim Schließen.
- ⌨️ **Schnellbefehle:** Verkaufe den Inhalt deiner Hand, geeignete Items aus deinem Inventar oder einen bestimmten Materialtyp.
- 🪙 **Drei Währungen:** Je nach Shop-Angebot wird mit **TX**, **Coins** oder **Vote-Punkten** gehandelt.

Der Shop wird von Returox eingerichtet. **Welche Kategorien und Items angeboten werden und wie viel sie kosten oder einbringen, kann sich ändern.** Das Plugin enthält keine feste Liste von Shop-Kategorien oder allgemeingültigen Itempreisen.

### In wenigen Schritten anfangen

1. Öffne mit `/shop` das Hauptmenü.
2. Wähle eine Kategorie über ihr Symbol.
3. Schaue dir bei einem Item die Zeilen **„Kaufen“** und **„Verkaufen“** an.
4. Nutze auf der Java Edition **Linksklick zum Kaufen** oder **Rechtsklick zum Verkaufen**.
5. Stelle im folgenden Fenster die Menge ein und bestätige den Handel.

Wenn du lieber mehrere unterschiedliche Items verkaufen möchtest, öffne direkt `/sellgui`.

---

## 🎮 2. Alle Spielerfunktionen erklärt

### 🧭 2.1 Shop öffnen und Kategorien auswählen

**Wofür?** Im Hauptmenü findest du die vom Netzwerk angebotenen Shop-Abteilungen. Jede Kategorie wird durch ein eigenes Item-Symbol dargestellt.

**So funktioniert es:**

1. Schreibe `/shop` in den Chat.
2. Klicke auf das Symbol einer Kategorie.
3. Du siehst die angebotenen Gegenstände dieser Kategorie.
4. Benutze bei Bedarf die Schaltflächen **„Vorherige Seite“** und **„Nächste Seite“**.
5. Mit dem **Kompass „Zurück“** kommst du zum Shop-Hauptmenü.

**Beispiel:** Du möchtest ein Baumaterial erwerben. Öffne `/shop` und suche in den tatsächlich angezeigten Kategorien danach.

**Gut zu wissen:** Du kannst eine bestehende Kategorie auch direkt mit `/shop <shopname>` öffnen. Dafür musst du ihren genauen internen Namen kennen. Falls dieser Name nicht gefunden wird, öffnet sich stattdessen das Hauptmenü. Die Bezeichnung auf dem Kategoriesymbol muss nicht unbedingt mit dem Namen im Befehl übereinstimmen.

### 🛍️ 2.2 Einzelne Items kaufen

**Wofür?** Du kannst eine genau festgelegte Menge eines angebotenen Items kaufen.

**Schritt für Schritt:**

1. Öffne `/shop` und anschließend die passende Kategorie.
2. Bewege den Mauszeiger auf das gewünschte Item. Steht dort ein **Kaufpreis**, ist es zum Kauf angeboten.
3. Klicke auf der Java Edition **mit links** auf das Item.
4. Im Fenster **„Kaufen“** stellst du mit den roten und grünen Glasscheiben die Stückzahl ein.
5. Klicke auf den **Goldbarren „Kaufen“**.
6. Bei erfolgreichem Kauf erhältst du die Items und eine Nachricht mit Menge und Gesamtpreis.

**Voraussetzungen:** Du benötigst ausreichend Guthaben in der beim Item angezeigten Währung sowie genügend Inventarplatz. Der Kaufpreis muss größer als null sein.

**Mengenlimit:** Im normalen Kauffenster kannst du **1 bis zu einem vollen Stapel** auswählen. Wie groß ein Stapel ist, hängt vom Item ab. Für größere Mengen gibt es **„Mehr kaufen“**.

**Beispielrechnung:** Ein Item kostet angenommen **12 TX pro Stück**. Wenn du drei Stück kaufst, zahlst du **36 TX**. Das ist nur ein Rechenbeispiel, kein fest eingestellter Preis auf Returox.

**Tipp:** Kontrolliere vor der Bestätigung den Gesamtpreis am Item in der Mitte. Der Shop nimmt die Zahlung in der **angezeigten** Währung entgegen.

### 💎 2.3 Einzelne Items verkaufen

**Wofür?** Verkaufe eine selbst gewählte Stückzahl eines Items an den Shop.

**Schritt für Schritt:**

1. Öffne die Shop-Kategorie, in der dein Item angeboten wird.
2. Prüfe, ob das Item einen **Verkaufspreis** hat.
3. Klicke auf der Java Edition **mit rechts** auf das Item.
4. Stelle im Fenster **„Verkaufen“** die Stückzahl ein.
5. Klicke auf den **Goldbarren „Verkaufen“**.
6. Die verkauften Items werden aus deinem Inventar entfernt und die Auszahlung gutgeschrieben.

**Voraussetzungen:** Du musst die benötigte Anzahl passender Items besitzen. Der Verkaufspreis muss größer als null sein.

**Beispielrechnung:** Wenn der Shop angenommen **4 TX pro Stück** bezahlt und du zehn Stück verkaufst, erhältst du **40 TX**.

**Wichtig:** Ein Item muss zum Shop-Angebot passen. Gegenstände mit einem anderen Namen, besonderen Eigenschaften oder anderen Item-Daten werden nicht automatisch wie die normale Variante behandelt.

**Tipp:** Im Kauffenster kannst du über die **Redstone-Fackel „Zu verkaufen wechseln“** direkt zum Verkaufen wechseln. Umgekehrt gibt es dieselbe Möglichkeit im Verkaufsfenster.

### ⚡ 2.4 Mit Shift + Rechtsklick alle passenden Items verkaufen

**Wofür?** Du möchtest nicht jedes Mal eine Menge auswählen, sondern alle vorhandenen Exemplare eines bestimmten Shop-Items auf einmal verkaufen.

**Schritt für Schritt (Java Edition):**

1. Öffne die gewünschte Shop-Kategorie.
2. Suche das Item mit einem aktiven Verkaufspreis.
3. Halte **Shift** gedrückt und klicke **mit rechts** auf das Shop-Item.
4. Das Plugin sucht im normalen Inventar einschließlich der Schnellzugriffsleiste nach passenden Items.
5. Sind passende Items vorhanden und ist eine gültige Auszahlung möglich, werden sie verkauft und du erhältst eine Bestätigung.

**Voraussetzungen:** Das Item muss verkaufbar sein und du musst mindestens ein passendes Exemplar besitzen. Es werden **nicht alle beliebigen Items** verkauft, sondern nur die zum angeklickten Angebot passenden.

**Beispiel:** Du hast dieselbe verkaufbare Steinvariante in mehreren Inventarstapeln. Shift + Rechtsklick auf das passende Angebot verkauft diese Exemplare gesammelt.

**Tipp:** Für viele *verschiedene* Itemarten sind `/sell inventory` oder `/sellgui` bequemer.

### 📦 2.5 Mehr kaufen: 1 bis 9 Stapel

**Wofür?** Für größere Einkaufsmengen musst du den normalen Mengenzähler nicht mehrfach benutzen.

**Schritt für Schritt:**

1. Öffne bei einem kaufbaren Item das Fenster **„Kaufen“**.
2. Klicke auf das **Namensschild „Mehr kaufen“**.
3. Wähle eine der grünen Schaltflächen **„1 Stack kaufen“** bis **„9 Stacks kaufen“**.
4. Bei ausreichendem Guthaben und Inventarplatz wird die ausgewählte Stapelmenge gekauft.

**Voraussetzungen:** Der Kauf muss für dieses Item erlaubt sein. Du benötigst den vollständigen Gesamtpreis und ausreichend Platz. Ein nicht möglicher Kauf wird abgelehnt.

**Mengenbeispiel:** Bei einem Item mit maximal 64 Stück pro Stapel entsprechen drei Stapel **192 Items**, neun Stapel **576 Items**. Bei Items mit kleineren Stapeln fallen die Mengen entsprechend geringer aus.

**Tipp:** Hier wird **direkt durch die Auswahl der Stapel-Schaltfläche gekauft**. Es gibt keinen zusätzlichen Bestätigungsbutton.

### 📦 2.6 Mehr verkaufen: 1 bis 9 Stapel

**Wofür?** Verkaufe mit einem Klick mehrere volle Stapel eines bestimmten Items.

**Schritt für Schritt:**

1. Öffne bei einem verkaufbaren Item das Fenster **„Verkaufen“**.
2. Klicke auf **„Mehr verkaufen“** (Namensschild).
3. Wähle **„1 Stack verkaufen“** bis **„9 Stacks verkaufen“**.
4. Wenn du genügend passende Items besitzt, wird die gewählte Menge verkauft.
5. Du erhältst die entsprechende Auszahlung und eine Bestätigung.

**Voraussetzungen:** Du brauchst die vollständige ausgewählte Anzahl passender Items. Bei zu wenigen Items erfolgt kein Verkauf dieser Menge.

**Beispiel:** Ein Material ist bis zu 64 Stück stapelbar. Bei „2 Stacks verkaufen“ benötigst du **128 passende Stück** im normalen Inventar.

**Tipp:** Unter den Stapelschaltflächen wird der jeweilige voraussichtliche Erlös angezeigt. Ein Klick auf die Schaltfläche führt den Verkauf direkt aus.

### 🧺 2.7 Verkaufs-GUI: Verschiedene Items gemeinsam verkaufen

**Wofür?** Du möchtest schnell unterschiedliche verkaufbare Items loswerden, ohne jedes einzeln im Shop zu suchen.

**So öffnest du es:**

- Mit `/sellgui`.
- Oder mit `/shop` und anschließend dem **Netherstern „Sachen verkaufen“** im Hauptmenü.

**Schritt für Schritt:**

1. Öffne die **„Verkaufs-GUI“**.
2. Lege Gegenstände aus deinem Inventar in die **oberen fünf Reihen** des Fensters. Auch normales Verschieben und das Verteilen per Ziehen auf diese Plätze ist vorgesehen.
3. Der **Netherstern in der untersten Reihe** zeigt die Verkaufserläuterung und nach der Aktualisierung eine Zusammenfassung der erkannten Auszahlungen.
4. **Schließe das Fenster**, wenn du fertig bist.
5. Erst jetzt versucht der Shop, alle geeigneten eingelegten Items zu verkaufen und schreibt dir den Erlös gut.

**Was passiert mit nicht verkaufbaren Items?** Sie werden nicht verkauft, sondern deinem Inventar zurückgegeben. Ist dort nicht genügend Platz, werden überschüssige Items in deiner Nähe auf den Boden gelegt.

**Was darf ich nicht benutzen?** Die unterste Reihe ist für die Anzeige reserviert. In diese Reihe kannst du keine Verkaufs-Items legen.

**Beispiel:** Lege verschiedene gewöhnliche Materialien, für die es aktuell einen Ankaufspreis gibt, in das Fenster. Beim Schließen werden die geeigneten Items zusammen verkauft. Andere Gegenstände bekommst du zurück.

**Wichtiger Hinweis:** Der Netherstern ist **kein Verkaufsbutton**. Das Schließen des Fensters löst den Verkauf aus. Kontrolliere deshalb vorher, welche Gegenstände du hineingelegt hast. Eine gesonderte Rückfrage vor dem Verkauf ist nicht vorgesehen.

### ⌨️ 2.8 Schnellverkauf per Befehl

Wenn du Menüs vermeiden möchtest, kannst du die Verkaufsbefehle verwenden. `/sell` und `/sellall` sind dabei **gleichwertige Befehlsnamen**.

#### `inventory`: Gesamtes normales Inventar verkaufen

1. Gib `/sell inventory` oder `/sellall inventory` ein.
2. Das Plugin prüft die **36 normalen Inventarplätze**, einschließlich der Schnellzugriffsleiste.
3. Items mit einem passenden, aktiven Verkaufspreis werden verkauft.
4. Du erhältst eine Zusammenfassung der verkauften Stückzahl und gegebenenfalls der verschiedenen Währungen.

**Es werden nicht automatisch Rüstung oder die Zweithand geleert.** Nicht verkaufbare Items verbleiben im Inventar.

**Beispiel:** Nach dem Farmen kannst du mit `/sell inventory` alle momentan für den Shop passenden Items aus den normalen Inventarplätzen verkaufen.

**Achtung:** Dieser Befehl führt den Verkauf sofort aus und bietet keine zusätzliche Bestätigung. Verwende ihn nur, wenn du wirklich alle geeigneten Items verkaufen möchtest.

#### `hand`: Den gehaltenen Stapel verkaufen

1. Nimm das gewünschte Item in die **Haupthand**.
2. Gib `/sell hand` oder `/sellall hand` ein.
3. Wenn der Stapel verkaufbar ist, wird **der gesamte gehaltene Stapel** verkauft.

**Beispiel:** Du hast 32 passende Items in der Haupthand. Mit `/sell hand` verkaufst du diese 32 Stück auf einmal.

**Achtung:** Der Befehl verkauft nicht nur ein einzelnes Stück. Gegenstände in der Zweithand werden nicht berücksichtigt.

#### `block <material>`: Eine bestimmte Materialart verkaufen

1. Ermittle den Minecraft-Materialnamen, beispielsweise `STONE` für Stein.
2. Gib `/sell block STONE` oder `/sellall block STONE` ein.
3. Der Shop verkauft die vorhandenen passenden Items dieses Materialtyps aus deinen **36 normalen Inventarplätzen**.

**Wichtig:** Der Materialname allein macht einen Gegenstand noch nicht verkaufbar. Es muss ein passendes Shop-Angebot mit aktivem Verkaufspreis geben. Besondere Varianten mit abweichenden Eigenschaften werden nicht automatisch mitverkauft.

**Tipp:** Bei der Eingabe von `/sell block` kann dir die Befehlsvervollständigung Materialnamen vorschlagen. Das bedeutet nicht, dass jedes vorgeschlagene Material ankaufbar ist.

---

## ⌨️ 3. Vollständige Befehlsübersicht

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| `/shop` | Öffnet das Shop-Hauptmenü. | `/shop` |
| `/shop <shopname>` | Öffnet eine vorhandene Kategorie direkt. | `/shop Baumaterial` (nur falls die Kategorie so heißt) |
| `/sellgui` | Öffnet das Verkaufsfenster zum Einlegen verschiedener Items. | `/sellgui` |
| `/sellall` | Zeigt die Hilfe für die Schnellverkaufsbefehle. Verkauft allein noch nichts. | `/sellall` |
| `/sell` | Alias für `/sellall`; zeigt ohne weitere Angaben dieselbe Hilfe. | `/sell` |
| `/sellall inventory` | Verkauft alle geeigneten Items im normalen Inventar. | `/sellall inventory` |
| `/sell inventory` | Kürzerer Alias für den Inventarverkauf. | `/sell inventory` |
| `/sellall hand` | Verkauft den passenden Stapel in deiner Haupthand. | `/sellall hand` |
| `/sell hand` | Kürzerer Alias für den Verkauf des gehaltenen Stapels. | `/sell hand` |
| `/sellall block <material>` | Verkauft passende Items eines Materialtyps im normalen Inventar. | `/sellall block STONE` |
| `/sell block <material>` | Kürzerer Alias für den Materialverkauf. | `/sell block STONE` |

### So liest du die Argumente

- `<material>` und `<shopname>` bedeuten: Für **diese Befehlsvariante** musst du hier einen Wert einsetzen.
- `/shop [shopname]` bedeutet: Der Kategoriename ist **optional**. Ohne Namen öffnet sich das Hauptmenü.
- Bei `/sell block <material>` muss der Materialname angegeben werden. Beispiel: `STONE`.
- Die Bezeichnungen `inventory`, `hand` und `block` sind feste Unterbefehle. Sie werden genau so eingegeben.

### Wann funktioniert ein Befehl nicht wie erwartet?

- **`/shop <shopname>`:** Existiert der angegebene Shopname nicht, landest du im Hauptmenü. Der interne Kategoriename muss passen.
- **`/sell inventory`:** Nur Items, die der Shop tatsächlich ankauft, werden entfernt und vergütet.
- **`/sell hand`:** Du musst in der Haupthand einen passenden, verkaufbaren Stapel halten.
- **`/sell block <material>`:** Der Materialname muss gültig sein und zum verkaufbaren Angebot passen. Sonst erscheint die Hilfe oder eine Ablehnung.
- **`/sell` ohne Unterbefehl:** Das ist lediglich die Befehlsübersicht, noch kein Verkauf.
- **`/sellgui`:** Der eigentliche Verkauf findet beim **Schließen** des Fensters statt.

Alle hier aufgeführten Funktionen sind Spielerfunktionen. Sie bieten keine Möglichkeit, Shop-Angebote, Preise oder Kategorien selbst zu verändern.

---

## 🖥️ 4. Alle Spielermenüs und Schaltflächen

### 4.1 Hauptmenü „Menü“

**Öffnen:** `/shop`  
**Größe:** 5 Reihen

| Anzeige | Bedeutung | Aktion |
|---|---|---|
| Kategorie-Item | Eine vom Netzwerk angelegte Shop-Abteilung | Anklicken öffnet diese Kategorie |
| ⭐ Netherstern „Sachen verkaufen“ | Direkter Zugang zum Sammelverkauf | Anklicken öffnet die Verkaufs-GUI |
| Glasscheiben | Gestaltung des Menüs | Keine Spieleraktion |

Die Anzahl, Namen und Symbole der Kategorien richten sich nach den aktuellen Angeboten.

### 4.2 Kategorienmenü „Shop“

**Öffnen:** Kategorie im Hauptmenü anklicken oder `/shop <shopname>`  
**Größe:** 6 Reihen

| Anzeige oder Aktion | Bedeutung |
|---|---|
| Shop-Item mit Zeile „Kaufen“ | Der angezeigte Preis pro Stück; **Linksklick** öffnet Kaufen |
| Shop-Item mit Zeile „Verkaufen“ | Der angezeigte Ankaufspreis pro Stück; **Rechtsklick** öffnet Verkaufen |
| **Shift + Rechtsklick** auf verkaufbares Item | Verkauft sofort alle passenden Exemplare aus dem normalen Inventar |
| 📄 „Vorherige Seite“ | Wechselt zur vorherigen Seite, sofern vorhanden |
| 📄 „Nächste Seite“ | Wechselt zur nächsten Seite, sofern diese Angebote enthält |
| 🧭 Kompass „Zurück“ | Zurück zum Shop-Hauptmenü |
| Glasscheiben | Dekoration, nicht zum Handeln gedacht |

**Beachte:** Ein Item muss nicht zwingend in beide Richtungen handelbar sein. Fehlt ein Kauf- oder Verkaufspreis, ist die entsprechende Aktion nicht aktiv. Der Wechsel der Seiten verändert weder deine Items noch dein Guthaben.

### 4.3 Menü „Kaufen“

**Öffnen:** Linksklick auf ein kaufbares Shop-Item  
**Größe:** 6 Reihen

| Symbol | Beschriftung | Funktion |
|---|---|---|
| Item in der Mitte | „Preis“ | Zeigt die ausgewählte Menge und ihren Gesamtpreis |
| Rote Glasscheibe | „Um 10 verringern“ | Senkt die Menge um 10, mindestens auf 1 |
| Rote Glasscheibe | „Um 1 verringern“ | Senkt die Menge um 1 |
| Rote Glasscheibe | „Auf 1 setzen“ | Setzt die Menge auf 1 |
| Grüne Glasscheibe | „Um 1 erhöhen“ | Erhöht die Menge um 1 |
| Grüne Glasscheibe | „Um 10 erhöhen“ | Erhöht die Menge um 10 |
| Grüne Glasscheibe | „Setze auf …“ | Wählt die maximale Stapelgröße dieses Items |
| 🟨 Goldbarren | „Kaufen“ | Bestätigt den Kauf der ausgewählten Stückzahl |
| Redstone-Fackel | „Zu verkaufen wechseln“ | Öffnet die Verkaufsansicht desselben Items |
| Namensschild | „Mehr kaufen“ | Öffnet die Auswahl von 1 bis 9 Stapeln |
| 🧭 Kompass | „Zurück“ | Zurück in die Shop-Kategorie |

Die Mengenwahl bleibt zwischen **1 Stück und der maximalen Größe eines Stapels**. Wenn du eine Grenze erreicht hast, werden nicht verfügbare Mengenbuttons durch graue Glasscheiben ersetzt.

### 4.4 Menü „Verkaufen“

**Öffnen:** Rechtsklick auf ein verkaufbares Shop-Item  
**Größe:** 6 Reihen

| Symbol | Beschriftung | Funktion |
|---|---|---|
| Item in der Mitte | „Du erhältst“ | Zeigt ausgewählte Menge und möglichen Erlös |
| Rote Glasscheiben | „Um 10 verringern“, „Um 1 verringern“, „Auf 1 setzen“ | Verringern bzw. setzen die Stückzahl |
| Grüne Glasscheiben | „Um 1 erhöhen“, „Um 10 erhöhen“, „Setze auf …“ | Erhöhen die Stückzahl bis zur maximalen Stapelgröße |
| 🟨 Goldbarren | „Verkaufen“ | Verkauft die gewählte Anzahl, falls vorhanden |
| Redstone-Fackel | „Zu kaufen wechseln“ | Öffnet die Kaufansicht desselben Items |
| Namensschild | „Mehr verkaufen“ | Öffnet die Auswahl von 1 bis 9 Stapeln |
| 🧭 Kompass | „Zurück“ | Zurück in die Shop-Kategorie |

**Wichtig:** Die im Fenster ausgewählte Menge wird aus deinem **normalen Inventar** entnommen. Du musst die Items nicht in dieses Menü legen.

### 4.5 Menü „Mehr kaufen“

**Öffnen:** Namensschild „Mehr kaufen“  
**Größe:** 3 Reihen

| Anzeige | Funktion |
|---|---|
| Item oben | Zeigt, um welchen Artikel es geht |
| Grüne Glasscheiben „1 Stack kaufen“ bis „9 Stacks kaufen“ | Führt sofort den Kauf der jeweiligen Stapelmenge aus |
| 🧭 Kompass „Zurück“ | Kehrt zur normalen Kaufansicht zurück |

**Keine zusätzliche Bestätigung:** Der Klick auf die gewünschte Stapelzahl ist bereits der Kaufversuch.

### 4.6 Menü „Mehr verkaufen“

**Öffnen:** Namensschild „Mehr verkaufen“  
**Größe:** 3 Reihen

| Anzeige | Funktion |
|---|---|
| Item oben | Zeigt den zu verkaufenden Artikel |
| Grüne Glasscheiben „1 Stack verkaufen“ bis „9 Stacks verkaufen“ | Verkauft sofort die jeweilige Stapelmenge, wenn genügend passende Items vorhanden sind |
| Text unter den Stapelbuttons | Zeigt den dafür vorgesehenen Erlös |
| 🧭 Kompass „Zurück“ | Kehrt zur normalen Verkaufsansicht zurück |

**Keine Teilverkäufe bei zu wenig Bestand:** Wenn du beispielsweise drei Stapel auswählst, aber nur zwei passende besitzt, wird diese Auswahl nicht ausgeführt.

### 4.7 Menü „Verkaufs-GUI“

**Öffnen:** `/sellgui` oder Netherstern im Hauptmenü  
**Größe:** 6 Reihen

| Bereich / Symbol | Funktion |
|---|---|
| Obere 5 Reihen | Dort legst du die Items ab, die du verkaufen möchtest |
| Unterste Reihe mit grauen Glasscheiben | Gesperrter Bedien- und Anzeigebereich |
| ⭐ Netherstern „Verkaufe hier Items“ | Hinweise und Zusammenfassung möglicher Erlöse in TX, Vote-Punkten und Coins |
| Fenster schließen | Löst den Verkauf der geeigneten eingelegten Items aus |

Nicht geeignete Items werden zurückgegeben. Wenn dein Inventar für die Rückgabe keinen Platz bietet, landen die übrigen Gegenstände in deiner Nähe auf dem Boden.

### Hinweise zu Klickarten und Bedrock

Die Shop-Liste erklärt auf der **Java Edition** ausdrücklich Linksklick, Rechtsklick und Shift + Rechtsklick. Bei erkannten **Bedrock-Spielern** erscheint stattdessen der allgemeinere Hinweis **„Klicke zum kaufen/verkaufen“**. Die tatsächlichen Kauf- und Verkaufswege verwenden dieselben Shop-Funktionen; die genauen Linksklick- und Rechtsklick-Aktionen sind im aktuellen Plugin vor allem für die Java-Bedienung eindeutig beschrieben.

Für den Verkauf stehen unabhängig von dieser Anzeige auch `/sellgui`, `/sell hand`, `/sell inventory` und `/sell block <material>` zur Verfügung.

---

## 🪙 5. Preise, Währungen und wichtige Regeln

### Die drei Währungen

| Währung im Shop | Anzeige | Verwendung |
|---|---|---|
| TX | `TX` | Kaufen und Verkaufen bei entsprechend eingestellten Items |
| Vote-Punkte | `Vote-Punkte` | Kaufen und Verkaufen bei entsprechend eingestellten Items |
| Coins | `Coins` | Kaufen und Verkaufen bei entsprechend eingestellten Items |

Jedes Shop-Angebot legt fest, **welche dieser Währungen** für das Item gilt. Du kannst beim Kaufen oder Verkaufen eines Items nicht selbst eine andere Währung auswählen.

### Wie werden Beträge berechnet?

- **Kauf:** Preis pro Stück × ausgewählte Stückzahl.
- **Verkauf:** Ankaufspreis pro Stück × verkaufte Stückzahl.
- Bei **Coins** und **Vote-Punkten** werden nur ganze Punkte verwendet. Der Gesamtpreis beim Kauf wird **aufgerundet**, die Gesamtauszahlung beim Verkauf **abgerundet**.
- Bei **TX** können auch Beträge mit Nachkommastellen vorkommen.
- Ergibt ein Verkauf in einer Ganzzahlwährung nach der Berechnung keine auszahlbare ganze Einheit, wird dieser Verkauf nicht durchgeführt.

**Rechenbeispiel für Ganzzahlwährungen:** Kostet ein Item angenommen **0,5 Coins pro Stück**, werden beim Kauf von drei Stück **2 Coins** berechnet. Würde der Shop dagegen **0,5 Coins pro Stück** auszahlen, brächte der Verkauf von drei Stück **1 Coin**. Die Zahlen dienen nur zur Erklärung der Rundung.

### Weitere Grenzen und Besonderheiten

- Eine Transaktion funktioniert nur, wenn das gewünschte Item in der jeweiligen Richtung **handelbar** ist.
- Beim Kaufen brauchst du genügend **Guthaben und Inventarplatz**.
- Beim Verkaufen brauchst du genügend **passende Items**.
- **Normale Mengenfenster:** bis zur jeweiligen maximalen Stapelgröße.
- **„Mehr kaufen“ / „Mehr verkaufen“:** feste Auswahl zwischen **1 und 9 Stapeln**.
- **Schnellverkauf per Befehl:** Prüft das normale 36-Plätze-Inventar, einschließlich Schnellzugriffsleiste, nicht automatisch Rüstung oder Zweithand.
- **Verkaufs-GUI:** Nimmt bis zu **45 Inventarplätze** mit eingelegten Gegenständen auf; die letzte Reihe bleibt für die Anzeige reserviert.
- **Cooldowns oder tägliche Verkaufsgrenzen** sind für die hier dokumentierten Spielerhandlungen nicht vorgesehen.
- **Eigene Shop-Level, Erfahrungspunkte, Upgrades, tägliche Shop-Belohnungen oder Freischaltaufgaben** sind nicht Teil von RX_Shop.

Der Shop ist ein zentral verwaltetes Angebot. Er ist **kein persönlicher Spielershop**, bei dem du selbst Preise festlegen oder eigene Verkaufsangebote erstellen kannst.

---

## 💡 6. Tipps und Tricks

1. **Möchtest du gezielt ein Item kaufen?** Verwende `/shop` und achte auf die Kaufpreiszeile.
2. **Willst du nur deinen gehaltenen Stapel verkaufen?** Nutze `/sell hand`, statt dein gesamtes Inventar zu verkaufen.
3. **Hast du viele unterschiedliche Farmitems?** `/sellgui` ist praktisch, weil du auswählen kannst, was du hineinlegst.
4. **Soll alles Geeignete weg?** `/sell inventory` ist am schnellsten, verkauft aber sofort und ohne Bestätigungsfenster.
5. **Nur ein bestimmtes Material loswerden?** Versuche `/sell block STONE`, sofern der Shop dieses Material in passender Form ankauft.
6. **Viele Exemplare desselben Items?** Nutze Shift + Rechtsklick auf das Angebot oder die Menüs „Mehr kaufen“ und „Mehr verkaufen“.
7. **Inventar fast voll?** Räume vor einem größeren Kauf Platz frei. Sonst kann der Kauf abgelehnt werden.
8. **Achte auf besondere Items.** Ein Item mit anderem Namen oder eigenen Eigenschaften ist nicht zwangsläufig mit dem Standarditem im Shop gleichzusetzen.
9. **Nicht jede Anzeige ist ein Button.** In der Verkaufs-GUI zeigt der Netherstern Informationen; verkauft wird erst beim Schließen.
10. **Prüfe die Währung.** Ein Item kann beispielsweise TX kosten, während ein anderes Coins oder Vote-Punkte verlangt.
11. **Nicht alle Items haben beide Preise.** Manche Angebote sind nur kaufbar oder nur verkaufbar.
12. **Kleine Punktbeträge können abrunden.** Verkaufe bei sehr kleinen Coin- oder Vote-Punkte-Werten gegebenenfalls mehrere passende Exemplare gemeinsam, wenn eine einzelne Einheit keine Auszahlung ergibt.

---

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

### 1. Wie öffne ich den Shop?

Mit `/shop`. Du erhältst das Hauptmenü mit den verfügbaren Kategorien.

### 2. Wie komme ich in eine bestimmte Kategorie?

Klicke im Hauptmenü auf das Kategoriesymbol. Falls du den genauen internen Kategorienamen kennst, kannst du auch `/shop <shopname>` verwenden.

### 3. Warum wird mir beim Anklicken eines Items kein Kauffenster angezeigt?

Der Artikel muss einen aktiven Kaufpreis haben. Auf Java öffnet ein **Linksklick** die Kaufansicht. Ohne aktiven Kaufpreis lehnt das Plugin den Kauf ab.

### 4. Wie kann ich ein Item aus meinem Inventar verkaufen?

Öffne die Shop-Kategorie und nutze auf Java **Rechtsklick** auf das verkaufbare Angebot. Alternativ kannst du `/sell hand`, `/sell inventory` oder `/sellgui` verwenden.

### 5. Was ist der Unterschied zwischen Kaufen und Verkaufen?

Beim **Kaufen** gibst du die angezeigte Währung aus und bekommst Items. Beim **Verkaufen** gibst du passende Items ab und erhältst die angezeigte Währung.

### 6. Wie kann ich genau fünf Items kaufen oder verkaufen?

Öffne die Kauf- oder Verkaufsansicht, stelle mit den grünen und roten Glasscheiben **5 Stück** ein und klicke auf den Goldbarren.

### 7. Kann ich mehrere Stapel auf einmal kaufen?

Ja. Nutze im Kauffenster das Namensschild **„Mehr kaufen“** und wähle **1 bis 9 Stapel** aus. Das Item muss kaufbar sein und dein Inventar genügend Platz haben.

### 8. Kann ich mehrere Stapel auf einmal verkaufen?

Ja. Im Verkaufsfenster findest du **„Mehr verkaufen“**. Dort kannst du **1 bis 9 Stapel** wählen, solange du genügend passende Items besitzt.

### 9. Was passiert bei Shift + Rechtsklick auf ein Shop-Item?

Auf Java versucht der Shop, **alle dazu passenden Exemplare** aus deinem normalen Inventar direkt zu verkaufen. Die Aktion funktioniert nur bei einem aktiven Verkaufspreis.

### 10. Was macht `/sell` ohne Zusatz?

Der Befehl zeigt lediglich die Hilfe für `inventory`, `hand` und `block`. Es wird dabei nichts verkauft.

### 11. Was ist der Unterschied zwischen `/sell` und `/sellall`?

Keiner bei den angebotenen Funktionen. `/sell` ist ein **Alias** von `/sellall`; beide unterstützen dieselben Unterbefehle.

### 12. Was macht `/sell inventory`?

Der Befehl verkauft sofort alle passenden, verkaufbaren Items in deinen 36 normalen Inventarplätzen. Nicht verkaufbare Gegenstände bleiben dort.

### 13. Verkauft `/sell hand` ein einzelnes Item oder den ganzen Stapel?

Es verkauft den **gesamten passenden Stapel in deiner Haupthand**. Die Zweithand zählt nicht dazu.

### 14. Wie funktioniert `/sell block STONE`?

Der Befehl sucht nach passenden Stein-Items in deinem normalen Inventar. Nur Varianten, für die der Shop ein passendes Verkaufsangebot hat, werden verkauft.

### 15. Kann ich auch Items mit besonderen Namen oder Verzauberungen verkaufen?

Nur wenn sie zu einem tatsächlich vorhandenen, verkaufbaren Shop-Eintrag passen. Ein besonders veränderter Gegenstand wird nicht automatisch wie ein normaler Gegenstand desselben Materials behandelt.

### 16. Wann wird in der Verkaufs-GUI wirklich verkauft?

**Beim Schließen des Fensters.** Das Einlegen allein verkauft noch nichts. Der Netherstern ist eine Informationsanzeige, kein Bestätigungsknopf.

### 17. Was passiert mit Items in der Verkaufs-GUI, die der Shop nicht annimmt?

Sie werden deinem Inventar zurückgegeben. Wenn dafür der Platz fehlt, werden die übrigen Items in deiner Nähe auf den Boden gelegt.

### 18. Warum bekomme ich die Meldung „nicht genug“ oder „kein Platz“?

Für den Kauf fehlt dir entweder Guthaben in der richtigen Währung oder Inventarplatz. Für einen Verkauf kannst du zu wenige passende Items besitzen.

### 19. Warum sehe ich manchmal keinen Button für eine weitere Shop-Seite?

Der **„Nächste Seite“**-Button wird im normalen Shop nur angezeigt, wenn auf der folgenden Seite Angebote vorhanden sind. Der Zurück-Button erscheint entsprechend erst ab Seite 2.

### 20. Kann ich meine eigene Shop-Kategorie anlegen oder Preise ändern?

Nein. Normale Spieler können vorhandene Angebote nutzen, aber keine Kategorien oder Preise selbst verwalten.

### 21. Gibt es Shop-Level, tägliche Belohnungen oder freischaltbare Rabatte?

Nein, RX_Shop enthält keine solchen eigenen Spielerfortschritts- oder Belohnungsfunktionen.

### 22. Kann ich auf Bedrock dieselben Befehle verwenden?

Die Spielerbefehle sind nicht auf Java-Spieler beschränkt. Im Shop erhältst du auf Bedrock jedoch einen allgemeineren Klickhinweis. Die zuverlässig nachvollziehbaren Linksklick-, Rechtsklick- und Shift-Kombinationen sind in dieser Anleitung ausdrücklich für die Java Edition beschrieben.

### 23. Kann ich den Shop auch benutzen, wenn ein Item plötzlich verschwunden ist?

Wenn ein zuvor angezeigtes Angebot nicht mehr vorhanden ist, meldet der Shop, dass das Item nicht mehr verfügbar ist. Öffne die Kategorie erneut, um den aktuellen Stand anzusehen.

### 24. Werden alle Items automatisch zum gleichen Preis gekauft und verkauft?

Nein. **Ankaufs- und Verkaufspreis** sind getrennt. Maßgeblich sind jeweils die Werte, die am konkreten Item angezeigt werden.

---

## ✅ 8. Kurzübersicht zum Merken

| Ich möchte … | Das funktioniert so |
|---|---|
| Den Shop öffnen | `/shop` |
| Eine Kategorie auswählen | Kategoriesymbol anklicken |
| Ein Item kaufen | Linksklick auf Shop-Item (Java) |
| Ein Item verkaufen | Rechtsklick auf Shop-Item (Java) |
| Alle passenden Exemplare verkaufen | Shift + Rechtsklick auf Shop-Item (Java) |
| Bis zu neun Stapel handeln | Namensschild „Mehr kaufen“ oder „Mehr verkaufen“ |
| Mehrere Itemarten über ein Fenster verkaufen | `/sellgui`, Items einlegen, Fenster schließen |
| Den gehaltenen Stapel verkaufen | `/sell hand` |
| Alle geeigneten Inventar-Items verkaufen | `/sell inventory` |
| Ein Material gezielt verkaufen | `/sell block STONE` |
| Die Verkaufsbefehle anzeigen | `/sell` oder `/sellall` |

**Viel Spaß beim Handeln auf Returox!** 🛒💚