# 📦 RX_Crate – Kisten und Belohnungen auf Returox

**Spieleranleitung für das Minecraft-Netzwerk Returox**

## 📖 Plugin-Übersicht

Mit **RX_Crate** kannst du besondere Belohnungskisten, sogenannte **Crates**, öffnen. Jede Crate besitzt eigene mögliche Belohnungen und benötigt einen **passenden Crate-Key**. Vor dem Öffnen kannst du dir anschauen, welche Gegenstände in der Kiste enthalten sind und wie hoch ihre jeweilige Gewinnchance ist.

Du brauchst dafür keine Befehle. Die wichtigsten Aktionen funktionieren direkt an einer aufgestellten Crate:

| Aktion an der Crate | Was passiert? |
|---|---|
| **Linksklick** | Du siehst die möglichen Belohnungen und ihre Chancen. |
| **Rechtsklick mit passendem Key** | Du verbrauchst einen Key und startest eine Öffnung. |
| **Schleichen + Rechtsklick mit mehreren passenden Keys** | Du öffnest bis zu **5 Crates gleichzeitig**. |

**So fängst du an:** Suche eine aufgestellte Crate, prüfe mit Linksklick die Belohnungen und benutze dann den passenden Schlüssel für einen Rechtsklick. Ohne Schlüssel kannst du die Belohnungen trotzdem ansehen.

## 🗝️ 1. Crate-Keys verstehen

Ein **Crate-Key** ist ein besonderer Schlüssel, der im Spiel wie ein **Stolperdrahthaken** aussieht. Sein Name zeigt an, zu welcher Crate er gehört. Ein Schlüssel für eine bestimmte Crate öffnet keine andere Crate.

### So verwendest du einen Key

1. Suche die Crate, deren Name zu deinem Key passt.
2. Nimm den Schlüssel in die Hand.
3. Klicke mit der **rechten Maustaste** auf die Crate.
4. Bei einer gültigen Crate mit Belohnungen wird ein Schlüssel verbraucht und die Animation beginnt.

**Beispiel:** Du hast einen Key für eine Vote-Crate erhalten. Diesen kannst du an der passenden Vote-Crate einlösen, sofern sie auf deinem Spielserver aufgestellt ist.

**Wichtig:** Ein gewöhnlicher Stolperdrahthaken, der nur ähnlich aussieht, ist kein gültiger Crate-Key. Echte Schlüssel können außerdem nicht als Stolperdrahthaken platziert werden.

## 👀 2. Belohnungen vor dem Öffnen ansehen

Du kannst jede erkannte Crate **ohne Schlüssel** ansehen.

1. Stelle dich vor die Crate.
2. Klicke mit der **linken Maustaste** auf die Kiste.
3. Im Menü **„Belohnungen“** siehst du die möglichen Gewinne.
4. Bewege den Mauszeiger über einen Gegenstand, um dessen Beschreibung und Gewinnchance zu lesen.
5. Gibt es viele Belohnungen, blätterst du mit **„Nächste Seite“** und **„Vorherige Seite“** weiter.

Die Belohnungen erscheinen in der Vorschau nach ihrer Chance sortiert, beginnend mit den wahrscheinlicheren Gewinnen. Pro Seite können **36 Belohnungen** angezeigt werden.

Die Vorschau ist **nur zum Anschauen** gedacht. Du kannst dort keine Gegenstände herausnehmen oder verändern.

### 🎯 So sind die Chancen zu verstehen

Die angezeigte Chance ist der Anteil einer Belohnung an der **Summe aller eingestellten Belohnungsgewichte**. Die Anzeige berücksichtigt also auch die übrigen Gegenstände in der Crate.

**Ein einfaches Beispiel:** Besteht eine Crate aus zwei Belohnungen mit den Gewichten 10 und 30, liegen ihre tatsächlichen Gewinnchancen bei **25 % und 75 %**.

Es sind auch sehr kleine Gewichte wie **0,01 %** möglich. Eine solche Einstellung entspricht genau **0,01 % tatsächlicher Gewinnchance**, wenn alle Gewichte zusammen **100 %** ergeben. Die Vorschau zeigt die berechnete Gewinnchance an.

Ein seltener Gegenstand ist deshalb nicht automatisch nach einer bestimmten Anzahl von Öffnungen garantiert.

## 🎁 3. Eine Crate öffnen

Für eine normale Öffnung benötigst du **einen passenden Key**.

1. Nimm den Schlüssel in die Hand.
2. Klicke mit **Rechtsklick** auf die richtige Crate.
3. Ein Inventarmenü mit einer laufenden Belohnungsanimation öffnet sich.
4. Warte, bis die Animation beendet ist.
5. Der ausgewählte Gegenstand wird deinem Inventar hinzugefügt.

Während der Animation laufen verschiedene mögliche Belohnungen durch die Anzeige. Bei einer Einzelöffnung ist die entscheidende Belohnung anschließend in der Mitte der Anzeige zu sehen. Es gibt außerdem passende Klick- und Abschlusssounds.

**So viel kostet die Öffnung:** Genau **1 passender Key** pro normaler Öffnung. Ein zusätzlicher Geldbetrag oder ein Erfahrungspunkt-Abzug ist in RX_Crate nicht vorgesehen.

**Hinweis:** Bleibe nach Möglichkeit bis zum Ende der Animation auf dem Server. Eine sichere Nachzustellung bei einem Verbindungsabbruch während der Animation ist in dieser Plugin-Version nicht gewährleistet.

## ⚡ 4. Mehrere Crates auf einmal öffnen

Du musst deine Schlüssel nicht unbedingt einzeln verwenden. Mit **Schleichen + Rechtsklick** kannst du mehrere Öffnungen gleichzeitig starten.

### Schritt für Schritt

1. Halte **mindestens 2 gleiche, passende Crate-Keys** als Stapel in der Hand.
2. Drücke deine **Schleichen-Taste** (standardmäßig `Shift`).
3. Klicke währenddessen mit der **rechten Maustaste** auf die passende Crate.
4. Die Kiste startet mehrere animierte Belohnungsreihen gleichzeitig.
5. Nach Abschluss erhältst du für jede gestartete Öffnung eine Belohnung.

| Keys im gehaltenen Stapel | Öffnungen mit einem Schleichen-Rechtsklick | Verbrauchte Keys |
|---:|---:|---:|
| 1 | 1 | 1 |
| 2 | 2 | 2 |
| 3 | 3 | 3 |
| 4 | 4 | 4 |
| 5 | 5 | 5 |
| 8 | 5 | 5 |

Bei mehr als fünf Schlüsseln bleibt der Rest des Stapels erhalten. Die **Obergrenze beträgt 5 gleichzeitige Öffnungen**.

**Tipp:** Wenn du nur einen Key einsetzen möchtest, benutze den normalen Rechtsklick ohne Schleichen.

## 🖥️ 5. Alle Spielermenüs im Überblick

### Belohnungsvorschau

**Öffnen:** Linksklick auf eine aufgestellte Crate.

| Anzeige oder Schaltfläche | Bedeutung |
|---|---|
| Belohnungsgegenstände | Diese Items können aus der Crate kommen. |
| „Chance“ in der Gegenstandsbeschreibung | Berechnete Gewinnwahrscheinlichkeit dieses Gegenstands. |
| „Nächste Seite“ (Papier) | Zeigt weitere Belohnungen, falls vorhanden. |
| „Vorherige Seite“ (Papier) | Kehrt zur vorherigen Seite zurück. |
| Dekorative Glasscheiben | Nur Gestaltung; keine Belohnungen. |

Belohnungen und Glasscheiben lassen sich in dieser Vorschau nicht entnehmen. Die Pfeile erscheinen nur, wenn eine entsprechende Seite erreichbar ist.

### Crate-Öffnung mit einer Belohnung

**Öffnen:** Rechtsklick auf eine Crate mit dem passenden Key.

Du siehst eine **3-reihige Animation** mit durchlaufenden Gegenständen. Ein Trichter mit der Beschriftung **„Dein Item“** kennzeichnet die Gewinnanzeige. Nach Ablauf erscheint der Gewinn in der Mitte und wird ausgegeben.

Die angezeigten Gegenstände während der Animation sind keine frei entnehmbaren Items.

### Crate-Öffnung mit mehreren Belohnungen

**Öffnen:** Schleichen + Rechtsklick mit einem Stapel von mindestens zwei passenden Keys.

Hier werden mehrere animierte Reihen angezeigt. Die Zahl der Öffnungen bestimmt, wie viele Reihen für die Gewinne verwendet werden. Jede Reihe liefert am Ende eine eigene Belohnung. Du kannst aus der laufenden Anzeige keine Gegenstände herausziehen.

### Während einer laufenden Animation

Pro Spieler ist **nur eine aktive Crate-Animation gleichzeitig** vorgesehen. Klickst du währenddessen erneut auf eine Crate, öffnet sich die bereits laufende Anzeige wieder, anstatt eine weitere Öffnung zu starten.

## 🐉 6. Crate-Keys durch besiegte Mobs erhalten

Auf passenden Spielservern von Returox besteht beim Besiegen eines Mobs eine Chance, einen Crate-Key zu bekommen.

Diese Funktion ist in RX_Crate für **Farmwelt-Server** und den Server **OneBlock-1** vorgesehen. Auf anderen Servern ist dieser Mob-Key-Drop durch RX_Crate nicht aktiviert.

### So funktioniert es

1. Besiege einen Mob, sodass der Sieg deinem Spieler zugerechnet wird.
2. Mit etwas Glück erhältst du eine Nachricht über einen Crate-Key.
3. Der passende Key wird deinem Inventar hinzugefügt.
4. Verwende ihn später an der entsprechenden Crate.

Die **voreingestellte Grundchance beträgt 1 % pro geeignetem Mob-Kill**. Dieser Wert kann vom Serverteam verändert werden. Eine Garantie auf einen Drop nach einer festen Zahl an Kills gibt es nicht.

### Welche Key-Art kann erscheinen?

Wenn ein Mob-Key-Drop ausgelöst wird, entscheidet eine weitere Zufallsauswahl über die Art des Schlüssels:

| Key-Art | Anteil an der Key-Art-Auswahl |
|---|---:|
| Vote | 76 % |
| Returox | 7 % |
| Mythic | 10 % |
| Divine | 5 % |
| Legendary | 2 % |

Diese Werte sind **nicht** die Wahrscheinlichkeit, dass jeder besiegte Mob genau diesen Schlüssel gibt. Zuerst muss der allgemeine Key-Drop ausgelöst werden. Außerdem muss die ausgewählte Crate-Art auf dem Server vorhanden sein; sonst wird für diese Auswahl kein Key ausgegeben.

**Beispiel:** Wenn die allgemeine Mob-Key-Chance bei 1 % steht, ist ein Key-Drop selten. Die Tabelle beschreibt erst danach, welche Key-Art ausgewählt wird.

## 🏷️ 7. Unterschiedliche Crates und schwebende Hinweise

Auf Returox können mehrere Crate-Arten stehen. Sie können unterschiedliche Namen, Schlüssel und Belohnungen besitzen. Welche Crates du tatsächlich findest und welche Items enthalten sind, hängt von den aktuell aufgestellten Kisten ab.

Über einer Crate siehst du einen schwebenden Hinweis mit dem Namen der Kiste und den wichtigsten Aktionen:

- **Linksklick**, um Belohnungen anzusehen.
- **Rechtsklick**, um die Kiste zu öffnen.
- **Sneak + Rechtsklick**, um mehrere Kisten zu öffnen.

Der schwebende Hinweis dient nur zur Orientierung. Du benutzt die **Kiste darunter**, nicht den Text selbst.

## ⌨️ 8. Befehlsübersicht für normale Spieler

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| **Keine Spielerbefehle vorhanden** | Alle für normale Spieler vorgesehenen Funktionen werden direkt an der Crate bedient. | **Linksklick** für die Vorschau; **Rechtsklick** mit Key zum Öffnen. |

Das Plugin registriert zwar den Befehl `/crate`, aber dessen Funktionen sind im aktuellen Stand der **Verwaltung** vorbehalten. Daher gibt es **keine frei verfügbaren `/crate`-Unterbefehle oder Aliase für normale Spieler**.

Es gibt folglich auch keine von Spielern einzugebenden Pflichtargumente (`<...>`) oder optionalen Argumente (`[...]`).

## ⭐ 9. Belohnungen, Voraussetzungen und Grenzen

| Bereich | Regel für Spieler |
|---|---|
| Belohnungen ansehen | Ohne Key möglich, per Linksklick. |
| Einzelöffnung | Ein passender Key erforderlich. |
| Mehrfachöffnung | Mindestens zwei passende Keys im Stapel, höchstens fünf Öffnungen gleichzeitig. |
| Falscher Key | Öffnung startet nicht. |
| Crate ohne gültige Belohnungen | Öffnung startet nicht. |
| Aktive Animation | Es läuft höchstens eine pro Spieler gleichzeitig. |
| Volles Inventar | Nicht hineinpassende Gewinne werden in der Nähe des Spielers auf den Boden fallen gelassen. |
| Belohnungschancen | Unterschiedlich je Crate; in der Vorschau sichtbar. |
| Level und Erfahrung | Kein eigenes Crate-Level- oder Erfahrungssystem vorhanden. |
| Freischaltungen und Upgrades | Keine eigenen Spieler-Upgrades oder Freischaltstufen vorhanden. |
| Zusätzliche Kosten | Kein eigener Geld- oder Erfahrungskosten-Abzug für Öffnungen vorhanden. |
| Tägliches Limit | Kein eigenes Tageslimit für Crate-Öffnungen implementiert. |

Die Länge der Animation bedeutet nicht, dass du eine bestimmte Belohnung erzwingen kannst. Jede Öffnung verwendet die für die jeweilige Crate hinterlegten Chancen.

## 💡 10. Tipps und Tricks

1. **Erst ansehen, dann öffnen:** Mit Linksklick prüfst du kostenlos, welche Belohnungen möglich sind.
2. **Auf den Key-Namen achten:** Der richtige Schlüssel ist wichtiger als das Aussehen des Stolperdrahthakens.
3. **Mehrere Keys gesammelt einlösen:** Mit Schleichen + Rechtsklick kannst du bis zu fünf Öffnungen in einem Durchgang starten.
4. **Vorher Platz schaffen:** Wenn dein Inventar voll ist, können Gewinne neben dir auf dem Boden landen.
5. **Seltene Belohnungen richtig einschätzen:** Eine kleine Chance ist keine Garantie nach einer bestimmten Anzahl von Versuchen.
6. **In der Vorschau blättern:** Bei mehr als 36 möglichen Gewinnen gibt es weitere Seiten.
7. **Auf Farmwelt und OneBlock achten:** Nur auf den dafür vorgesehenen Servern können Mobs über RX_Crate Schlüssel geben.
8. **Animation zu Ende laufen lassen:** Bleibe nach dem Öffnen möglichst verbunden, bis dein Gewinn ausgegeben wurde.
9. **Die Beschriftung über der Crate lesen:** Dort stehen die wichtigsten Mausaktionen direkt im Spiel.

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

### 1. Wie fange ich mit Crates an?
Suche eine aufgestellte Crate und klicke sie zunächst mit links an. Dann kannst du die Belohnungen ansehen. Zum Öffnen brauchst du einen passenden Key.

### 2. Welchen Befehl muss ich zum Öffnen eingeben?
Keinen. Öffnen und Vorschau funktionieren direkt mit der Maus an der Crate.

### 3. Kann ich Belohnungen ohne Schlüssel anschauen?
Ja. Ein Linksklick auf die Crate öffnet die Vorschau.

### 4. Warum öffnet sich die Crate mit Rechtsklick nicht?
Du musst einen passenden, gültigen Key in der Hand halten. Außerdem muss die Crate gültige Belohnungen besitzen.

### 5. Kann ich mit einem Vote-Key jede Crate öffnen?
Nein. Der Key muss zu genau der Crate-Art passen, für die er ausgestellt wurde.

### 6. Kann ich fünf Keys gleichzeitig einsetzen?
Ja. Halte mehrere passende Keys im selben Stapel, schleiche und benutze Rechtsklick. Höchstens fünf werden auf einmal verwendet.

### 7. Was passiert, wenn ich acht Keys im Stapel halte und schleiche?
Es werden fünf Crates geöffnet und fünf Keys verbraucht. Die übrigen drei bleiben im Stapel.

### 8. Sind die seltenen Belohnungen garantiert, wenn ich oft genug öffne?
Nein. RX_Crate hat kein eingebautes System, das nach einer bestimmten Anzahl an Öffnungen eine seltene Belohnung garantiert.

### 9. Wie sehe ich die Gewinnchance eines Items?
Öffne die Vorschau mit Linksklick und bewege die Maus über das Item. Dort findest du den Wert bei „Chance“.

### 10. Können Belohnungen eine Chance von nur 0,01 % haben?
Ja. Das System unterstützt sehr kleine Gewichte. Die im Vorschaufenster angezeigte tatsächliche Chance hängt von den Gewichten aller Belohnungen in dieser Crate ab.

### 11. Wie komme ich auf die nächste Belohnungsseite?
Wenn weitere Gewinne vorhanden sind, erscheint unten ein Papier-Symbol mit der Aufschrift „Nächste Seite“. Klicke darauf.

### 12. Kann ich die Gegenstände aus der Vorschau nehmen?
Nein. Die Vorschau zeigt nur, welche Belohnungen möglich sind. Ein echtes Item erhältst du erst nach einer gültigen Öffnung.

### 13. Was passiert, wenn mein Inventar voll ist?
Gewinne, die nicht mehr hineinpassen, werden in der Nähe deines Spielers auf den Boden fallen gelassen. Achte darauf, dass sie nicht liegen bleiben.

### 14. Kann ich während einer Animation eine zweite starten?
Nein. Wenn bereits eine Animation läuft, öffnet ein weiterer Klick die bestehende Anzeige wieder.

### 15. Was passiert, wenn ich während der Animation den Server verlasse?
In der aktuellen Version gibt es keine verlässlich nachgewiesene automatische Nachzustellung für eine beim Verlassen abgebrochene Animation. Warte deshalb bis zum Ende der Öffnung.

### 16. Woher können Keys außer von bereits erhaltenen Schlüsseln kommen?
RX_Crate enthält eine Mob-Key-Drop-Funktion für Farmwelt-Server und OneBlock-1. Andere Bezugsquellen werden von diesem Plugin selbst nicht festgelegt.

### 17. Warum bekomme ich nicht von jedem Mob einen Key?
Ein Key-Drop wird zufällig ausgelöst. Die Voreinstellung liegt bei 1 % pro geeignetem Mob-Kill und kann vom Serverteam geändert werden.

### 18. Muss ich für Crates erst ein Level erreichen oder ein Upgrade kaufen?
Nein. RX_Crate enthält kein eigenes Level-, Upgrade- oder Freischaltsystem. Zum Öffnen brauchst du die richtige Crate, einen passenden Key und verfügbare Belohnungen.

---

**Kurz gemerkt:** 👀 **Linksklick = Vorschau** · 🗝️ **Rechtsklick mit Key = eine Öffnung** · ⚡ **Schleichen + Rechtsklick = bis zu fünf Öffnungen**.