# 🛒 Returox Wiki: Spieler-Shops & Shop-Warps

**Plugin:** RX_ChestShop  
**Für:** Spieler auf dem Minecraft-Netzwerk **Returox**

Mit Spieler-Shops kannst du Gegenstände über einen eigenen Laden verkaufen oder von anderen Spielern ankaufen. Shop-Warps helfen dir, solche Läden zu finden, zu besuchen und deinen eigenen Laden bekannt zu machen.

> **Kurz erklärt:** Ein **Spieler-Shop** ist ein Handelsschild an einer Kiste oder einem anderen geeigneten Container. Ein **Shop-Warp** ist ein öffentlicher Reisepunkt für deinen Laden. Beides sind unterschiedliche Gegenstände und Funktionen.

## 🚀 Schnellstart

1. Öffne mit `/playershop` das Verzeichnis der Shop-Warps.
2. Wähle den Kopf eines Spielers und klicke im folgenden Menü auf die **Enderperle**, um seinen Shop-Warp zu besuchen.
3. Suche bestimmte Gegenstände über das Schild **„Item suchen“** oder `/playershop search <suchbegriff>`.
4. Für einen eigenen Handelsshop brauchst du das besondere **Spieler-Shop-Schild** und einen geeigneten Container. Platziere das Schild seitlich am Container.
5. Klicke mit rechts auf dein Shopschild, stelle Ware, Menge und Preis ein und **öffne** den anfangs geschlossenen Shop.
6. Mit dem besonderen **Shop-Warp-Item** kannst du zusätzlich einen Reisepunkt für deinen Laden setzen.

**Wichtig:** Die besonderen Shop-Schilder und Shop-Warp-Items können durch dieses Plugin nicht selbst hergestellt oder mit einem normalen Spielerbefehl angefordert werden. Wo sie auf Returox ausgegeben oder erhältlich sind, legt das vorliegende Plugin nicht fest.

---

## 📦 1. Spieler-Shop erstellen

Ein Spieler-Shop handelt über ein **besonderes Eichen-Wandschild**, das an einem Container befestigt wird. Unterstützt werden **normale Kisten, Redstone-Kisten, Fässer und Shulker-Kisten**.

### So erstellst du deinen Shop

1. Stelle einen geeigneten Container an deinem gewünschten Verkaufsort auf.
2. Halte das besondere Item **„Schild • Spieler-Shop“** in der Hand.
3. Setze es **an die Seite** des Containers, nicht oben darauf und nicht frei im Raum.
4. Der Shop wird angelegt und gehört dir.
5. Klicke mit **Rechtsklick** auf dein Shopschild, um die Einstellungen zu öffnen.
6. Wähle das Handelsitem, lege die Menge und den Preis fest, entscheide dich für **Ankauf** oder **Verkauf** und schalte den Shop auf **geöffnet**.

Ein neuer Shop startet mit diesen Werten:

| Einstellung | Anfangswert |
|---|---|
| Shop-Typ | **Ankauf** |
| Menge pro Handel | **1 Gegenstand** |
| Preis pro Handel | **1 TX** |
| Status | **Geschlossen** |
| Angezeigtes Item | Zunächst der erste gefundene Gegenstand aus dem Container, sonst ein Kistensymbol |

**Hinweise:**

- An einem Container kann nicht gleichzeitig ein zweiter Spieler-Shop angelegt werden.
- Shopschilder müssen an der Seite angebracht sein.
- Schild und Container müssen sich innerhalb **desselben Minecraft-Chunks** befinden. Ein Chunk ist ein 16 × 16 Blöcke großer Bereich. Ein Shop genau über einer Chunk-Grenze wird abgewiesen.
- Das Plugin legt keine feste Höchstzahl deiner Spieler-Shops fest. Andere Grundstücks- oder Serverregeln können trotzdem Grenzen setzen.
- Ein Shop ist erst nutzbar, wenn er geöffnet ist und die Handelsbedingungen erfüllt sind.

### Beispiel

Du möchtest 16 Eisenbarren für 80 TX verkaufen. Lege genügend Eisenbarren in deinen Container, wähle im Shop-Menü **Verkauf**, setze **Eisenbarren**, **16** als Menge und **80** als Preis. Öffne danach den Shop. Jeder normale erfolgreiche Rechtsklick-Kauf überträgt dann 16 Eisenbarren für insgesamt 80 TX.

---

## 💰 2. Ankauf und Verkauf verstehen

| Shop-Typ | Was macht der Besitzer? | Was machen Besucher? | Geldfluss |
|---|---|---|---|
| **Verkauf** | Bietet Waren aus seinem Container an | Kaufen die eingestellte Ware | Besucher zahlen an den Besitzer |
| **Ankauf** | Kauft Waren von Besuchern an | Verkaufen ihre passenden Gegenstände | Besitzer zahlen an Besucher |

### Waren in einem Verkaufsshop kaufen

1. Besuche einen **geöffneten Verkaufsshop**.
2. Schaue auf das Shopschild: Es zeigt Ware, Menge, Preis und Besitzer, solange der Shop verfügbar ist.
3. Halte genügend Geld und freien Platz im Inventar bereit.
4. Klicke mit **Rechtsklick** auf das Shopschild.
5. Bei Erfolg bekommst du die Ware und der Preis wird abgebucht.

**Besonderheit: Schleichen + Rechtsklick.** Bei einem **Verkaufsshop** kaufst du damit nicht die eingestellte Menge, sondern die **maximale Stapelgröße des angebotenen Gegenstands** (zum Beispiel 64 bei üblichen Baublöcken). Der Gesamtpreis wird anteilig aus Menge und Einzelhandels-Preis berechnet. Dafür müssen der volle Stapel im Shop vorhanden sein, dein Guthaben ausreichen und dein Inventar genug Platz bieten. Diese Sonderaktion gilt **nicht** für Ankaufsshops.

**Beispiel:** Ein Shop verkauft 8 Steine für 40 TX. Ein normaler Rechtsklick kauft 8 für 40 TX. Schleichen + Rechtsklick kauft bei einer Stapelgröße von 64 insgesamt 64 für 320 TX.

### Waren an einen Ankaufsshop verkaufen

1. Nimm die **genau passende Ware** in dein Inventar.
2. Gehe zu einem geöffneten **Ankaufsshop**.
3. Klicke mit **Rechtsklick** auf das Shopschild.
4. Der Shop nimmt die eingestellte Menge ab und zahlt dir den angezeigten Preis.

Der Shop kann nichts ankaufen, wenn seine Kiste keinen Platz mehr hat oder der Besitzer nicht genug Geld besitzt. Ein Verkauf scheitert auch, wenn du die passende Menge nicht mitbringst.

**Achtung bei besonderen Items:** Verzauberungen, Namen und andere Eigenschaften können beim Warenvergleich eine Rolle spielen. Ein ähnlich aussehender Gegenstand muss nicht automatisch zum eingestellten Shop-Item passen.

---

## 🖱️ 3. Shopschilder bedienen

| Aktion am Schild | Wirkung |
|---|---|
| **Rechtsklick als Besucher** | Führt einen Kauf oder Verkauf aus, wenn alles passt |
| **Schleichen + Rechtsklick als Besucher** | Kauft bei **Verkaufsshops** eine maximale Stapelgröße statt der eingestellten Menge |
| **Linksklick ohne Schleichen** | Öffnet bei einem geöffneten Shop ein kleines Informationsmenü |
| **Rechtsklick als Besitzer** | Öffnet die Shop-Einstellungen |
| **Schleichen + Schild abbauen als Besitzer** | Entfernt deinen Shop und lässt das normale Spieler-Shop-Schild fallen |

### Das Informationsmenü

Der Linksklick zeigt ein kleines, fünf Plätze großes Menü mit dem angebotenen **Item**, dem **Preis für die eingestellte Menge**, dem **aktuellen Vorrat** und dem **Besitzer**. Dieses Menü dient der Information, nicht zum Herausnehmen der Ware. In einem geschlossenen Shop ist es für Besucher nicht verfügbar.

### Was steht auf dem Schild?

Im Normalzustand zeigt das Schild **Ankauf oder Verkauf**, das Item mit seiner Menge, den Preis und den Spielernamen. Je nach Situation erscheint stattdessen ein Hinweis wie **„Shop ist geschlossen“**, **„Shop ist leer“** oder **„Shop ist voll“**.

---

## ⚙️ 4. Eigenen Shop bearbeiten

Öffne dein Shopschild mit **Rechtsklick**. Im Menü **„Bearbeiten • SpielerShop“** findest du:

| Symbol | Schaltfläche | Funktion |
|---|---|---|
| 🚧 Barriere, Platz 1 | **Shop-Typ wechseln** | Wechselt zwischen Ankauf und Verkauf |
| 🏷️ Namensschild, Platz 2 | **Shop-Item Anzahl ändern** | Fragt im Chat nach der Menge pro normalem Handel |
| 🪟 Glas, Platz 4 | **Item anzeigen** | Schaltet das sichtbare Warenitem über dem Container ein oder aus |
| 📦 Warenitem, Platz 5 | **Item ändern / Shop umsetzen** | Du kannst unten ein Item aus deinem eigenen Inventar auswählen; Klick auf dieses Menüfeld baut den Shop zum Umsetzen ab |
| 📜 Papier, Platz 6 | **Historie ansehen** | Zeigt bisherige Käufe und Verkäufe dieses Shops |
| 🪙 Goldnugget, Platz 8 | **Preis ändern** | Fragt im Chat nach dem Preis pro Handel |
| 🟢/⚪ Farbstoff, Platz 9 | **Shop öffnen/schließen** | Wechselt den Shop-Status |

*Die Platzangaben zählen die neun Felder von links nach rechts. Die Farbstofffarbe zeigt den aktuellen Zustand: Grün bedeutet geöffnet, Grau bedeutet geschlossen.*

### Shop-Item ändern

Während das Bearbeiten-Menü offen ist, klicke **unten in deinem eigenen Inventar** auf den Gegenstand, den der Shop handeln soll. Das ausgewählte Item wird übernommen. Der Shop nimmt damit nicht automatisch ein Item aus deiner Hand als Verkaufsvorrat: Die tatsächlichen Waren liegen weiterhin im Container.

### Menge festlegen

1. Klicke auf das **Namensschild**.
2. Das Menü schließt sich und du erhältst eine Chat-Aufforderung.
3. Schreibe eine ganze Zahl, zum Beispiel `16`.
4. Erlaubt sind **1 bis zur maximalen Stapelgröße** dieses Items. Bei einem üblichen stapelbaren Gegenstand also 1 bis 64, bei nicht stapelbaren Gegenständen nur 1.

Mit `cancel` kannst du die Eingabe abbrechen. Bei der Mengeneingabe wird das Einstellungsmenü nach dem Abbruch nicht automatisch wieder geöffnet.

### Preis festlegen

1. Klicke auf den **Goldnugget**.
2. Trage den gewünschten Preis in den Chat ein, zum Beispiel `25` oder `12.5`.
3. Der Preis muss **mindestens 0,1 TX** betragen.
4. Bei erfolgreicher Eingabe öffnet sich das Bearbeiten-Menü wieder.

Mit `cancel` brichst du die Preiseingabe ab. Verwende bei Dezimalzahlen einen **Punkt**, zum Beispiel `1.5`, nicht ein Komma. Der eingetragene Betrag gilt für die **gesamte eingestellte Menge**, nicht automatisch pro Einzelitem.

### Sichtbares Item über der Kiste

Mit **„Item anzeigen“** kannst du eine Vorschau der Ware **über dem Container** ein- oder ausschalten. Voraussetzung ist ein freier Block direkt über der Kiste. Das schwebende Item ist **nur eine Anzeige**: Andere Spieler können es nicht einfach aufsammeln. Ein neues Shop-Schild ist standardmäßig für diese Anzeige vorgesehen.

### Shop öffnen oder schließen

Klicke auf den **Farbstoff**. Ein geschlossener Shop kann nicht von normalen Besuchern zum Handeln verwendet werden. Schließe deinen Shop zum Beispiel, wenn du Waren oder Preise neu einstellen möchtest.

### Shop umsetzen oder endgültig abbauen

**Mit bestehenden Einstellungen umziehen:**

1. Öffne die Shop-Einstellungen.
2. Klicke **oben auf das zentrale Warenitem** im Menü.
3. Das Schild wird entfernt und ein **spezielles Umsetz-Item** mit den Shop-Einstellungen fällt auf den Boden.
4. Hebe es auf und setze es seitlich an einem anderen geeigneten Container wieder ein.

**Normal abbauen:** Schleiche und baue dein eigenes Shopschild ab. Dabei fällt das normale Spieler-Shop-Schild. Dies ist **nicht** dieselbe Aktion wie das Umsetzen mit gespeicherten Einstellungen. Der Warenbestand bleibt im Container, solange du diesen nicht selbst entfernst.

Solange ein Shopschild zu einem Container gehört, kann dieser nicht einfach abgebaut werden. Entferne zuerst den Shop.

---

## 📜 5. Shop-Historie ansehen

Im Bearbeiten-Menü öffnest du mit **Papier → „Historie ansehen“** die Handelsgeschichte genau dieses Shops.

Zu jedem Eintrag werden angezeigt:

- der Kunde,
- Ankauf oder Verkauf,
- die gehandelte Menge,
- der damalige Gesamtpreis,
- der Zeitpunkt des Handels und das zugehörige Item.

Die Historie zeigt bis zu **45 Einträge pro Seite**. Mit **„Vorherige Seite“** und **„Nächste Seite“** navigierst du. Während des Ladens erscheint **„Historie wird geladen ...“**. Die Einträge sind zur Ansicht gedacht und lassen sich nicht durch Anklicken erneut handeln.

---

## 🧭 6. Shop-Warps finden und besuchen

Öffne das Warp-Verzeichnis mit:

```text
/playershop
```

Die Liste **„Spieler-Warps • Shop-Warp“** zeigt öffentliche, geöffnete Shop-Warps. Sie ist **nach Likes sortiert**, sodass beliebte Shops weiter oben erscheinen. Pro Seite werden höchstens **36 Shop-Warps** angezeigt.

Ein Spielerkopf kann den **Shop-Namen**, den **Besitzer**, die **Likes**, den **Server** sowie die Zahl der **Verkaufs- und Ankaufsshops** dieses Besitzers zeigen.

### So teleportierst du dich

1. Klicke im Verzeichnis auf den **Kopf des gewünschten Shops**.
2. Das Detailmenü **„Spieler-Warp“** öffnet sich.
3. Klicke auf die **Enderperle „Zum Shop teleportieren“**.
4. Du wirst zum Warp gebracht. Liegt der Warp auf einem anderen Returox-Server, kann dafür ein Serverwechsel nötig sein.

Ein Warp kann vorübergehend **geschlossen** sein oder aufgrund einer unsicheren bzw. nicht mehr verfügbaren Position nicht funktionieren. Beim Teleport über die Warp-Auswahl ist ein kurzer Schadensschutz von **5 Sekunden** vorgesehen.

### Befehls-Teleport

Du kannst außerdem `/playershop <spieler>` verwenden, zum Beispiel `/playershop BeispielSpieler`. Existiert ein zugehöriger Warp und ist er geöffnet, versucht das Plugin, dich dorthin zu bringen. Falls das nicht möglich ist, erhältst du gegebenenfalls eine Meldung oder das normale Warp-Menü öffnet sich.

### Hauptmenü: alle Schaltflächen

| Symbol | Schaltfläche | Bedeutung |
|---|---|---|
| 👤 Spielerkopf | **Shop-Eintrag** | Öffnet das Detailmenü dieses Shops |
| 🏷️ Namensschild | **Letzte Suche wiederholen** | Wiederholt deine letzte Suche, sofern vorhanden |
| 🪧 Eichenschild | **Item suchen** | Fragt im Chat nach einem Suchbegriff |
| ⭐ Netherstern | **Aktualisieren** | Öffnet das aktuelle Warp-Verzeichnis erneut |
| 🟩 Grüne Wolle | **Deine gelikten Shops** | Zeigt von dir mit einem Like markierte Shops |
| 👤 Eigener Kopf | **Dein Shop-Warp verwalten** | Öffnet deine Einstellungen, wenn du einen eigenen Warp hast |
| 📄 Papier | **Vorherige/Nächste Seite** | Wechselt die Seite, sofern vorhanden |

### Shop-Detailmenü

| Symbol | Aktion |
|---|---|
| Enderperle | Zum Shop-Warp teleportieren |
| Grauer Farbstoff | Dem Shop ein **Like geben** |
| Grüner Farbstoff | Deinen bisherigen Like **entfernen** |
| Kiste | Die in diesem Shop angebotenen bzw. gesuchten Items ansehen |
| Zurück-Kopf | Zum Warp-Verzeichnis zurückkehren |

Du kannst **deinen eigenen Warp nicht liken**. Pro Spieler und Warp gibt es nur einen Like, der später wieder zurückgenommen werden kann.

---

## 🔎 7. Gegenstände suchen und filtern

Du musst nicht jeden Laden einzeln besuchen. Die **Item-Suche** durchstöbert die vorhandenen Spieler-Shops nach einem Suchbegriff. Auch die Item-Übersicht eines bestimmten Shop-Warps hat Filter.

### Suchen über das Warp-Menü

1. Öffne `/playershop`.
2. Klicke auf **„Item suchen“** (Eichenschild).
3. Gib einen Suchbegriff in den Chat ein, zum Beispiel `Diamant`, und sende ihn ab.
4. Wähle ein Ergebnis aus, um dich zu diesem **konkreten Shopschild** teleportieren zu lassen.

Mit `cancel` brichst du die Chat-Suche ab. Das Hauptmenü kann die **letzte Suche wiederholen**, solange diese für deine aktuelle Spielsitzung gespeichert ist.

### Direkt per Befehl suchen

```text
/playershop search Diamant
```

Du kannst mehrere Wörter eingeben, zum Beispiel `/playershop search verzaubertes Buch`. Die Suche berücksichtigt unter anderem Materialnamen, angezeigte Itemnamen und Verzauberungsbezeichnungen.

**Schnellsuche über die Hand:** Bei `/playershop search` **ohne weiteren Text** muss sich ein Item in deiner **Haupthand** befinden. Dann wird nach dessen Material gesucht. Mit leerer Haupthand bekommst du eine Hinweismeldung.

### Verkaufs- und Ankaufsshops filtern

In der Item-Suche und in der Item-Liste eines einzelnen Warps findest du den **Kompass „Filtern“**. Jeder Klick schaltet weiter:

1. **Ankauf & Verkauf**: beide Arten.
2. **Ankauf**: Shops, die deine Items kaufen.
3. **Verkauf**: Shops, in denen du Items kaufen kannst.
4. Wieder **Ankauf & Verkauf**.

### Nach Kategorien filtern

Klicke auf den **Grasblock „Kategorie Filtern“**. Im Kategoriemenü sind folgende Optionen vorhanden:

| Kategorie | Symbol |
|---|---|
| Baumaterial | Ziegel |
| Dekoration | Pfingstrose |
| Redstone | Redstone-Staub |
| Transport | Antriebsschiene |
| Verschiedenes | Lavaeimer |
| Essen | Apfel |
| Werkzeug | Eisenaxt |
| Kampf | Goldschwert |
| Brauen | Trank |
| Sonstiges | Spawner |
| Kein Filter | Barriere |

Beim Anklicken einer Kategorie erscheint wieder die passende Item-Liste. **„Kein Filter“** zeigt alle Kategorien. Kombiniere Kategorien und Ankauf-/Verkauf-Filter, um gezielter zu suchen.

### Die Item-Ergebnisliste

Ein Suchergebnis zeigt das **angebotene Item**, die **Shop-Art** und bei einer allgemeinen Suche auch den **Besitzer**. Klicke auf das Ergebnis, um direkt zu dem zugehörigen Shopschild zu teleportieren, sofern die Position sicher und verfügbar ist. Mit **„Vorherige Seite“**, **„Nächste Seite“** und **„Zurück“** navigierst du durch die Ergebnisse; pro Seite passen bis zu **36 Items** hinein.

**Warum fehlen manche Shops?** Geschlossene Shops werden ausgefiltert. Ebenso können Shops mit zu wenig verfügbarem Vorrat fehlen. Beim Nachladen erscheint kurz **„Inhalte werden geladen ...“**. Die tatsächliche Verfügbarkeit kann sich inzwischen ändern, wenn andere Spieler handeln.

---

## 🌍 8. Eigenen Shop-Warp setzen

Ein Shop-Warp ist ein eigener Reisepunkt, an dem dich andere Spieler finden können. Dafür benötigst du das besondere **„Warp • Shop-Warp“**-Item in Form eines **Enderauges**.

### So setzt du deinen Warp

1. Stelle dich an die Position, an der Besucher später ankommen sollen.
2. Achte darauf, dass du **nicht fliegst** und unter dir ein **fester, nicht flüssiger Block** liegt.
3. Halte das besondere Shop-Warp-Enderauge in der Hand.
4. Mache einen **Rechtsklick** damit.
5. Dein Warp wird gesetzt und **ein Enderauge verbraucht**.

Der erste Warp startet **geschlossen**. Öffne ihn anschließend über `/playershop` → **dein Kopf** → **Shop-Status**, damit er im öffentlichen Verzeichnis erscheint.

### Vorhandenen Warp verschieben

Du kannst nur **einen Shop-Warp gleichzeitig** besitzen. Wenn du das Warp-Item erneut an einer neuen Position benutzt, erscheint deshalb zunächst eine Bestätigung:

1. Rechtsklicke an der neuen, sicheren Position mit dem Shop-Warp-Item.
2. Das Spiel weist dich auf deinen bereits bestehenden Warp hin.
3. **Rechtsklicke innerhalb von 10 Sekunden erneut**, um den Warp zu versetzen.
4. Erst bei der Bestätigung wird ein weiteres Warp-Item verbraucht.

Ohne die zweite Bestätigung verfällt der Vorgang nach zehn Sekunden. Ein Warp kann nicht an einer vom Plugin als unsicher erkannten Position gesetzt werden.

---

## 🛠️ 9. Shop-Warp verwalten

Öffne `/playershop` und klicke auf **deinen eigenen Kopf**. Wenn du einen Warp besitzt, erscheint **„Spieler-Warp Einstellungen“**.

| Symbol | Schaltfläche | Funktion |
|---|---|---|
| Barriere | **Shop-Status** | Warp öffnen oder schließen |
| TNT | **Shop-Warp entfernen** | Löscht den Warp ohne Rückgabe des eingesetzten Items |
| Papier | **Namen ändern** | Ändert den öffentlichen Namen für **10.000 TX** |
| Befehlsblock | **Nachrichten erhalten** | Schaltet Handelsbenachrichtigungen deiner Shops ein oder aus |
| Zurück-Kopf | **Zurück** | Öffnet die Warp-Liste |

### Warp öffnen und schließen

Klicke auf **„Shop-Status“**. Ein geschlossener Warp erscheint nicht in der Liste der geöffneten Warps und kann nicht wie ein normaler offener Warp besucht werden. Der Zustand deiner **einzelnen Shops** ist davon unabhängig: Du kannst einen Warp schließen, ohne jedes Shopschild einzeln zu schließen.

**Hinweis zur Inaktivität:** Beim Start des Systems können Shop-Warps von Spielern automatisch geschlossen werden, deren letzter erfasster Login **länger als 30 Tage** zurückliegt. Prüfe nach längerer Pause den Status deines Warps.

### Warp umbenennen

1. Klicke auf **„Namen ändern“**.
2. Du brauchst mindestens **10.000 TX**.
3. Trage deinen neuen Namen in den Chat ein.
4. Der Name muss **1 bis 128 Zeichen** lang sein.
5. Bei erfolgreicher Umbenennung werden **10.000 TX** abgezogen.

Mit `cancel` brichst du die Eingabe ab. Der Name darf auch die üblichen `&`-Farbcodes enthalten, die das Spiel bei der Anzeige umsetzt.

### Handelsnachrichten ein- oder ausschalten

Über den **Befehlsblock** legst du fest, ob du Nachrichten erhältst, wenn einer deiner Spieler-Shops erfolgreich Waren **ankauft oder verkauft**. Die Einstellung ist an dein Spielerprofil gebunden und betrifft nicht die normale Bedienung deiner Shops.

### Warp löschen

Klicke auf **„Shop-Warp entfernen“**. Der Warp wird entfernt. **Das verbrauchte Shop-Warp-Item wird nicht zurückerstattet.** Das ist eine andere Funktion als das bloße Schließen oder Versetzen des Warps. Deine einzelnen Kisten-Shops sind eigenständige Läden und werden dadurch nicht automatisch zu neuen Warps.

---

## ⌨️ 10. Alle Spielerbefehle und Aliase

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| `/playershop` | Öffnet das öffentliche Shop-Warp-Verzeichnis | `/playershop` |
| `/playershops` | Alias für `/playershop` | `/playershops` |
| `/shopwarp` | Alias für `/playershop` | `/shopwarp` |
| `/chestshopwarp` | Alias für `/playershop` | `/chestshopwarp` |
| `/playershop <spieler>` | Versucht, den Shop-Warp dieses Spielers zu besuchen | `/playershop BeispielSpieler` |
| `/playershop search` | Sucht das Material in deiner Haupthand | `/playershop search` |
| `/playershop search <suchbegriff>` | Öffnet die Item-Suche mit deinem Text | `/playershop search Diamant` |

**Schreibweise:** `<spieler>` und `<suchbegriff>` sind Pflichtangaben, wenn du genau diese Befehlsvariante verwendest. Leerzeichen innerhalb eines Suchbegriffs sind erlaubt. Für das normale Warp-Menü brauchst du keine Argumente.

**Aliase:** `/playershops`, `/shopwarp` und `/chestshopwarp` rufen denselben Befehl auf. Auch darüber gelten grundsätzlich dieselben Argumente.

**Wichtig:** Ein eigenständiger `/playerwarp`-Befehl wird von **RX_ChestShop selbst nicht registriert** und gehört daher nicht zur bestätigten Befehlsliste dieser Anleitung.

Andere Spielerbefehle oder Freischaltkommandos sind im untersuchten Plugin nicht vorhanden. Die übrigen Funktionen erreichst du über Items, Schilder und Inventarmenüs.

---

## ⭐ 11. Wirtschaft, Grenzen und Besonderheiten

| Thema | Regel im Plugin |
|---|---|
| Währung | **TX**, teilweise mit `$` in der Anzeige |
| Neuer Spieler-Shop | Beginnt mit **1 TX**, **1 Item**, **Ankauf**, **geschlossen** |
| Kleinster Shop-Preis | **0,1 TX pro eingestelltem Handel** |
| Shop-Menge | **1 bis maximale Stapelgröße** des ausgewählten Items |
| Shop-Warps pro Spieler | **1 gleichzeitig** |
| Shop-Warp setzen/versetzen | Verbraucht jeweils **1 besonderes Enderauge** bei erfolgreicher Aktion |
| Warp-Versetzen | Erneuter Rechtsklick als Bestätigung innerhalb von **10 Sekunden** |
| Warp umbenennen | **10.000 TX** |
| Warp löschen | **Keine Rückgabe** des Warp-Items |
| Likes | Nicht für den eigenen Warp; ein Like je Spieler und fremdem Warp |
| Warp-Liste | Höchstens **36 Warps pro Seite**, nach Likes sortiert |
| Item-Suchergebnisse | Höchstens **36 Shops pro Seite** |
| Shop-Historie | Höchstens **45 Einträge pro Seite** |
| Längere Inaktivität | Warp kann nach **mehr als 30 Tagen** seit dem letzten Login beim Systemstart geschlossen werden |
| Schadensschutz nach Warp-Teleport | **5 Sekunden** bei der Teleportation über die Warp-Auswahl vorgesehen |

Es gibt im aktuellen RX_ChestShop **kein eigenes Level-, Erfahrungspunkte-, Upgrade-, Quest-, tägliches Belohnungs- oder Freischaltsystem**. Auch eine tägliche Shop-Aufgabe oder ein allgemeiner Kauf-Cooldown ist nicht implementiert.

---

## 💡 12. Tipps und Tricks

1. **Verkauf und Ankauf nicht verwechseln:** Beim Verkauf zahlst du als Kunde, beim Ankauf erhältst du als Kunde Geld.
2. **Shop vor dem Öffnen prüfen:** Neue Shops starten geschlossen. Kontrolliere Item, Menge, Preis und Vorrat.
3. **Preis pro Handel beachten:** 20 TX für 4 Items bedeutet 20 TX für alle 4 zusammen, nicht 20 TX pro Stück.
4. **Volle Stapel kaufen:** Mit Schleichen + Rechtsklick auf einen Verkaufsshop kannst du direkt die maximale Stapelgröße kaufen, wenn Vorrat und Geld reichen.
5. **Spezielle Items passend wählen:** Besonders bei verzauberten oder umbenannten Gegenständen solltest du testen, ob exakt die gewünschten Items gehandelt werden.
6. **Schwebende Ware einschalten:** Die Item-Anzeige über der Kiste hilft anderen Spielern, deinen Shop schneller zu erkennen.
7. **Zum Umziehen das Bearbeiten-Menü nutzen:** Nur der Menüpunkt zum Umsetzen trägt die bisherigen Shop-Einstellungen weiter.
8. **Shop-Warp gut platzieren:** Wähle einen festen, frei zugänglichen Ankunftspunkt und lasse Platz um die Besucher herum.
9. **Likes helfen bei der Sichtbarkeit:** Die öffentliche Warp-Liste sortiert nach Beliebtheit.
10. **Suche statt lange Wege:** Suche direkt nach dem gewünschten Item und filtere danach auf Ankauf oder Verkauf.
11. **Lieblingsshops sammeln:** Mit Likes kannst du Shops in deiner Liste **„Deine gelikten Shops“** wiederfinden.
12. **Inventar kurz laden lassen:** Die größeren Such- und Warp-Menüs füllen ihre Einträge nach dem Öffnen teilweise schrittweise.
13. **Auf den Chunk-Rand achten:** Wenn ein Shopschild nicht gesetzt werden kann, versuche eine andere Seite des Containers oder stelle ihn weiter von der Chunk-Grenze entfernt auf.
14. **Handelsnachrichten einstellen:** Wenn du viele Verkäufe hast, kannst du die Nachrichten in den Warp-Einstellungen deaktivieren.
15. **Regelmäßig vorbeischauen:** Nach längerer Abwesenheit solltest du prüfen, ob dein Warp wieder geöffnet werden muss.

---

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

### 1. Wie finde ich Shops von anderen Spielern?

Mit `/playershop`. Klicke auf einen Spielerkopf und anschließend im Detailmenü auf die Enderperle.

### 2. Wie suche ich nach Diamanten?

Nutze `/playershop search Diamant` oder öffne `/playershop`, klicke auf **„Item suchen“** und schreibe `Diamant` in den Chat.

### 3. Kann ich nach dem Item in meiner Hand suchen?

Ja. Halte es in der **Haupthand** und gib `/playershop search` ohne weiteres Argument ein.

### 4. Was ist der Unterschied zwischen Ankauf und Verkauf?

Ein **Verkaufsshop** gibt dir Ware gegen Geld. Ein **Ankaufsshop** nimmt deine Ware und gibt dir Geld.

### 5. Warum funktioniert der Rechtsklick auf einen Shop nicht?

Mögliche Gründe: Der Shop ist geschlossen, leer oder voll, dir fehlen Items oder Geld, der Besitzer hat beim Ankauf zu wenig Geld oder der Shop ist nicht mehr gültig. Achte auf die Chatmeldung.

### 6. Warum kann ich mein Shop-Schild nicht setzen?

Verwende das besondere Shop-Schild **seitlich an einem geeigneten Container**. Er darf nicht bereits einen Shop besitzen und Schild und Container dürfen nicht über einer Chunk-Grenze liegen.

### 7. Warum kann ich meinen neuen Shop nicht sofort nutzen?

Neue Shops starten **geschlossen**. Öffne ihn über Rechtsklick auf das eigene Schild und dann den Status-Farbstoff.

### 8. Wie ändere ich den Preis?

Rechtsklicke auf dein Shopschild, wähle den **Goldnugget** und schreibe den Preis in den Chat. Der Mindestpreis beträgt `0.1` TX.

### 9. Wie ändere ich die angebotene Ware?

Öffne dein Bearbeiten-Menü und klicke **in deinem Spielerinventar unten** auf das gewünschte Item.

### 10. Kann ich einen kompletten Stack auf einmal kaufen?

Ja, bei **Verkaufsshops** mit **Schleichen + Rechtsklick** auf das Schild. Der Preis wird passend zur maximalen Stapelgröße berechnet.

### 11. Wo sehe ich, was mein Shop schon verkauft oder angekauft hat?

Im Bearbeiten-Menü unter **„Historie ansehen“**. Dort findest du Kunde, Shop-Typ, Menge, Preis und Zeitpunkt.

### 12. Wie entferne ich einen Shop, ohne meine Einstellungen zu verlieren?

Öffne das Shop-Bearbeiten-Menü und klicke auf das **mittlere Warenitem**. Hebe das besondere Umsetz-Item auf und platziere es neu.

### 13. Darf jemand anderes mein Shopschild abbauen?

Normale Besucher können deinen Shop nicht einfach abbauen. Als Besitzer kannst du **schleichend das Schild abbauen**.

### 14. Warum erscheint mein Warp nicht in der Liste?

Prüfe, ob du bereits ein Warp-Item gesetzt und den Warp in deinen Einstellungen **geöffnet** hast. Bei längerer Inaktivität kann er automatisch geschlossen worden sein.

### 15. Wie setze ich meinen bestehenden Warp an einen anderen Ort?

Benutze an der neuen sicheren Stelle ein weiteres besonderes Warp-Enderauge und bestätige die Aktion mit einem **zweiten Rechtsklick innerhalb von zehn Sekunden**.

### 16. Kann ich mehrere Shop-Warps haben?

Nein. Dieses Plugin verwaltet **einen Shop-Warp pro Spieler**. Du kannst ihn aber an eine andere Stelle versetzen.

### 17. Wie benenne ich meinen Warp um?

Über `/playershop` → **dein Kopf** → **„Namen ändern“**. Die Umbenennung kostet **10.000 TX** und der Name darf 1 bis 128 Zeichen lang sein.

### 18. Bekomme ich das Shop-Warp-Item nach dem Löschen zurück?

Nein. Das Löschmenü weist ausdrücklich darauf hin, dass das Item **nicht erstattet** wird.

### 19. Kann ich meinen eigenen Shop liken?

Nein. Du kannst nur anderen Warps ein Like geben. Einen vergebenen Like kannst du im Detailmenü wieder entfernen.

### 20. Kann ich nur Verkaufsshops anzeigen lassen?

Ja. Nutze in der Item-Liste den **Kompass „Filtern“** und wähle **Verkauf**. Über den Grasblock kannst du zusätzlich eine Itemkategorie wählen.

### 21. Was bedeutet „Keine passenden Shops gefunden“?

Zu deiner Suche und deinen Filtern gibt es momentan keine sichtbaren passenden Shops. Prüfe den Suchtext, wähle **Ankauf & Verkauf** und entferne gegebenenfalls den Kategoriefilter.

### 22. Warum teleportiert mich ein Suchergebnis manchmal nicht?

Ein Shopschild kann fehlen, nicht mehr verfügbar sein oder an einer Position stehen, die für die Teleportation nicht sicher ist. Das Plugin prüft diese Bedingungen beim Besuch.

### 23. Was bedeutet „Shop ist voll“ oder „Shop ist leer“?

**Leer** bedeutet bei einem Verkaufsshop, dass nicht genügend Ware für den Handel vorhanden ist. **Voll** bedeutet bei einem Ankaufsshop, dass für weitere Waren kein ausreichender Lagerplatz vorhanden ist.

### 24. Kann ich Handelsbenachrichtigungen ausschalten?

Ja. Wenn du einen eigenen Shop-Warp besitzt, kannst du über dessen Einstellungen **„Nachrichten erhalten“** ein- oder ausschalten.

### 25. Kann ich mit `cancel` eine Eingabe abbrechen?

Ja. Das gilt für die Chat-Suche, die Mengen- und Preiseingabe sowie das Umbenennen des Shop-Warps, wenn das Spiel gerade auf deine Eingabe wartet.

### 26. Gibt es Level, Shop-Upgrades oder tägliche Belohnungen?

Nein. Solche Systeme sind in dieser Version von **RX_ChestShop** nicht enthalten.

---

## ✅ Auf einen Blick

**Shop finden:** `/playershop`  
**Item finden:** `/playershop search <suchbegriff>`  
**Shop besuchen:** Kopf wählen → Enderperle  
**Ware kaufen/verkaufen:** Rechtsklick auf ein geöffnetes Shopschild  
**Vollen Stapel kaufen:** Schleichen + Rechtsklick auf einen **Verkaufsshop**  
**Shop bearbeiten:** Rechtsklick auf das **eigene** Shopschild  
**Shop-Warp verwalten:** `/playershop` → eigener Kopf  
**Eingabe abbrechen:** `cancel`

Viel Spaß beim Handeln, Entdecken und Einrichten deines eigenen Shops auf **Returox**! 🛒