# 🏠 RX_Home | Das Home-System auf Returox

Willkommen beim Home-System von **Returox**! Mit Homes speicherst du deine Lieblingsorte und kehrst später mit wenigen Klicks oder einem Befehl dorthin zurück. Das funktioniert auch dann, wenn dein gespeicherter Ort auf einer anderen Welt oder einem anderen Server innerhalb des Netzwerks liegt.

**Das Wichtigste auf einen Blick:**

- **Menü öffnen:** `/home` oder `/homes`
- **Direkt teleportieren:** `/home <name>`
- **Ohne Home-Modul:** bis zu **5 Homes**
- **Mit Home-Modul:** je nach Modul **6 bis 21 Homes**
- **Homes verwalten:** erstellen, teleportieren, löschen, Position aktualisieren und Anzeigesymbol ändern

## 🚀 Schnellstart: Dein erstes Home

1. Stelle dich an den Ort, den du speichern möchtest, zum Beispiel vor dein Haus.
2. Öffne mit `/home` das Home-Menü.
3. Klicke unten auf den **hellgrünen Farbstoff** zum Erstellen eines Homes.
4. Du wirst aufgefordert, einen Namen in den Chat zu schreiben. Du darfst vorher noch zu einer anderen Position laufen.
5. Gib zum Beispiel `Base` in den Chat ein. **Die Position beim Absenden deiner Nachricht** wird gespeichert.
6. Fertig! Dein neues Home erscheint im Menü, zunächst mit einem **Kompass** als Symbol.

Um zurückzukehren, öffnest du `/home` und klickst auf **Base**. Oder du gibst direkt `/home Base` ein.

## ⌨️ Alle Spielerbefehle

| Befehl | Beschreibung | Beispiel |
|---|---|---|
| `/home` | Öffnet die Übersicht deiner Homes und die Verwaltung. | `/home` |
| `/homes` | Zweiter Name für denselben Befehl (Alias). | `/homes` |
| `/home <name>` | Teleportiert dich zu deinem gespeicherten Home. | `/home Base` |
| `/homes <name>` | Dasselbe wie `/home <name>`, nur mit dem Alias. | `/homes Farm` |

**Was bedeutet `<name>`?** Du ersetzt diese Pflichtangabe durch den Namen eines bereits gespeicherten Homes. Die spitzen Klammern schreibst du nicht mit. Es gibt für normale Spieler keine weiteren Home-Unterbefehle.

**Gut zu wissen:**

- Die Schreibweise des Namens mit Groß- oder Kleinbuchstaben spielt beim Wiederfinden keine Rolle. `Base` und `base` führen zum selben gespeicherten Namen.
- Beim Tippen von `/home ` können dir bereits bekannte Home-Namen vorgeschlagen werden.
- Für einen direkten Teleport per Befehl sind **Namen ohne Leerzeichen** am praktischsten. Das Menü kann auch Homes mit Leerzeichen im Namen öffnen, während der Befehl nur das erste Wort als Namen verarbeitet.
- Wenn ein Home nicht existiert oder vorübergehend nicht erreichbar ist, erhältst du eine Fehlermeldung.

## 🖥️ Das Home-Menü verstehen

Mit `/home` öffnest du ein Inventarmenü mit **6 Reihen**. In der Mitte siehst du deine Homes. Die Schaltflächen befinden sich überwiegend in der untersten Reihe.

| Item im Menü | Funktion | So benutzt du es |
|---|---|---|
| 🧭 **Kompass oder selbst gewähltes Item** | Gespeichertes Home | Anklicken, um dich dorthin zu teleportieren. Nach Auswahl einer Bearbeitungsfunktion führt der Klick stattdessen diese Aktion aus. |
| 🟢 **Hellgrüner Farbstoff** | Home erstellen | Anklicken und anschließend einen Namen in den Chat eingeben. |
| 🔴 **Redstone** | Home löschen | Erst Redstone anklicken, dann das zu löschende Home. |
| ✨ **Glowstone-Staub** | Home-Position aktualisieren | Erst Glowstone-Staub anklicken, dann das Home, das auf deinen aktuellen Standort gesetzt werden soll. |
| 🟠 **Oranger Farbstoff** | Home-Symbol ändern | Erst den Farbstoff anklicken, dann das Home und anschließend ein Item aus der Auswahl wählen. |
| 🟣 **Lila Glasscheibe** | Freier Home-Platz | Zeigt einen verfügbaren Platz an. Zum Erstellen verwendest du den hellgrünen Farbstoff. |
| 🟠 **Orange Glasscheibe „Modul-Slot“** | Noch kein Modul eingesetzt | Zeigt an, dass du momentan ohne Home-Modul spielst. |
| 🎁 **Home-Modul (Spielerkopf)** | Eingesetztes Modul | Rechts unten anklicken, wenn du das Modul wieder herausnehmen möchtest. |
| 🚧 **Barriere** | Noch keine Homes | Erscheint, wenn deine Home-Liste leer ist. |

Die übrigen Glasscheiben dienen der Anordnung des Menüs und sind keine eigenen Funktionen.

**Klickarten:** Du brauchst weder Rechtsklick noch Shift-Klick für besondere Home-Aktionen. Das Plugin unterscheidet in diesen Menüs nicht zwischen speziellen Klickarten. Items können nicht einfach in die Menüfelder verschoben werden. **Zum Einsetzen eines Moduls klickst du auf das Modul in deinem eigenen Inventar unterhalb des geöffneten Home-Menüs.**

## 📍 1. Home erstellen

Ein Home merkt sich den Ort, an dem du später wieder erscheinen möchtest.

**So geht's:**

1. Öffne `/home`.
2. Klicke auf den **hellgrünen Farbstoff**.
3. Gehe bei Bedarf zu deiner gewünschten Position.
4. Schreibe den Namen in den Chat und sende ihn ab.
5. Nach erfolgreichem Speichern erhältst du eine Bestätigung und die Home-Übersicht öffnet sich erneut.

**Beispiel:** Du stehst vor deinem Lagerhaus und schreibst `Lager`. Später erreichst du es mit `/home Lager`.

**Regeln und Grenzen:**

- Der Name darf **höchstens 64 Zeichen** haben und nicht leer sein.
- Zwei Homes mit demselben Namen sind für dich nicht erlaubt. Wähle in diesem Fall einen anderen Namen.
- Auch die Groß- und Kleinschreibung erzeugt keinen zweiten, unabhängigen Namen.
- Du kannst nur so viele Homes anlegen, wie deine aktuell verfügbaren Home-Plätze erlauben.
- Während das System auf einen Namen wartet, wird **deine nächste Chatnachricht als Home-Name** verwendet und nicht normal im Chat veröffentlicht.
- Es gibt **keinen eigenen Abbruchbefehl** für diese Namenseingabe. Das bloße Schließen des Menüs beendet sie nicht; beim Verlassen des Servers wird sie zurückgesetzt.

**Tipp:** Verwende kurze, eindeutige Namen wie `Base`, `Mine`, `Farm` oder `Dorf`. Dadurch sind direkte Teleports besonders einfach.

## 🚀 2. Zu einem Home teleportieren

Du hast zwei Möglichkeiten:

**Über das Menü**

1. Gib `/home` ein.
2. Suche das Home anhand seines Namens oder Symbols.
3. Klicke darauf. Du wirst zu diesem Ort teleportiert.

**Über einen Befehl**

Gib zum Beispiel `/home Farm` ein. Mit `/homes Farm` geht es genauso.

Das Home speichert nicht nur den Standort, sondern auch die **Welt, den Server und die Blickrichtung**. Deshalb kommst du an die gespeicherte Position zurück und schaust grundsätzlich in die gespeicherte Richtung.

**Wichtige Hinweise:**

- Homes auf anderen Returox-Servern können einen automatischen Serverwechsel auslösen. Der Teleport wird auf dem Zielserver fortgesetzt.
- Die Zielwelt und der Zielserver müssen verfügbar sein. Ist die gespeicherte Position nicht erreichbar, kann der Teleport fehlschlagen.
- Während ein Home-Vorgang noch läuft, kannst du nicht gleichzeitig einen zweiten Home-Vorgang starten.
- Beim Teleport wird vorübergehend ein **Schutz vor Schaden** aktiviert. Dieser ist auf **100 Spiel-Ticks**, also bei normaler Servergeschwindigkeit ungefähr **5 Sekunden**, begrenzt. Er ersetzt keine dauerhaft sichere Umgebung.

## ✨ 3. Die Position eines Homes aktualisieren

Wenn du umgebaut hast oder dein Eingang inzwischen woanders liegt, kannst du dasselbe Home auf deinen neuen Standort setzen. Der Name bleibt erhalten.

1. Gehe zu der **neuen gewünschten Position**.
2. Öffne `/home`.
3. Klicke auf **Glowstone-Staub**.
4. Klicke auf das Home, dessen Position du ändern möchtest.
5. Das Home merkt sich nun deinen aktuellen Standort, die Welt, den Server und deine Blickrichtung.

**Beispiel:** Dein altes Home `Base` liegt noch vor der Baustelle. Nach dem Umzug stellst du dich vor die neue Haustür, aktualisierst `Base` und kannst denselben Namen weiterhin verwenden.

**Wichtig:** Der alte Standort wird damit ersetzt. Es gibt im Home-Menü keine eigene Rückgängig-Funktion.

## 🗑️ 4. Ein Home löschen

Wenn du einen gespeicherten Ort nicht mehr brauchst, kannst du den Platz wieder freimachen.

1. Öffne `/home`.
2. Klicke auf **Redstone**.
3. Klicke anschließend auf das Home, das du entfernen möchtest.
4. Das Home wird gelöscht und die Übersicht neu geladen.

**Beispiel:** Du brauchst dein altes Home `Mine` nicht mehr und möchtest einen neuen Platz für `Dorf`.

**Achtung:** Das Löschen erfolgt **direkt nach der Auswahl des Homes**, ohne zusätzliches Bestätigungsmenü. Eine Wiederherstellungsfunktion ist im Home-System nicht vorhanden. Überlege deshalb vorher, ob du den gespeicherten Standort noch benötigst.

## 🎨 5. Das Symbol eines Homes ändern

Jedes neue Home startet mit einem **Kompass**. Du kannst ihm aber ein passendes Symbol geben, damit du es schneller erkennst.

1. Öffne `/home`.
2. Klicke auf den **orangen Farbstoff**.
3. Wähle das Home aus, dessen Symbol du ändern möchtest.
4. Im neuen Menü suchst du dir ein Item aus.
5. Klicke darauf. Das ausgewählte Item wird als Symbol in der Home-Übersicht gespeichert.

**So funktioniert die Symbolauswahl:**

- Pro Seite werden **bis zu 36 Items** angezeigt.
- Unten findest du gegebenenfalls **Papier für „Vorherige Seite“ und „Nächste Seite“**.
- Du kannst sowohl viele Blöcke als auch andere verfügbare Minecraft-Items als Symbol auswählen.
- Die Auswahl verändert **nur das Anzeige-Item des Homes**, nicht die echten Blöcke an deinem gespeicherten Ort.

**Tipp:** Nutze einen Erzblock für deine Mine, Weizen für deine Farm oder ein Bett für deine Base.

## 🎁 6. Home-Module und zusätzliche Plätze

Du beginnst mit **5 Home-Plätzen**. Ein Home-Modul erhöht die Höchstzahl deiner speicherbaren Homes auf den Wert, der auf dem Modul steht.

| Ausstattung | Maximale Anzahl Homes |
|---|---:|
| Ohne Home-Modul | **5** |
| Modul mit der Aufschrift „6 Home-Punkte“ | **6** |
| Modul mit der Aufschrift „10 Home-Punkte“ | **10** |
| Modul mit der Aufschrift „15 Home-Punkte“ | **15** |
| Modul mit der Aufschrift „21 Home-Punkte“ | **21** |

Es gibt Module für **jede ganze Platzanzahl von 6 bis 21**. Die Tabelle zeigt nur Beispiele. Ein Modul mit 15 Plätzen bedeutet **15 Homes insgesamt**, nicht 5 zusätzliche plus 15.

### Modul einsetzen

1. Besorge dir ein gültiges Home-Modul als Item im Spiel.
2. Achte darauf, dass es sich in deinem Inventar befindet.
3. Öffne `/home`.
4. **Klicke im unteren, eigenen Spielerinventar auf das Home-Modul.** Du musst es nicht in den orangefarbenen Modul-Slot ziehen.
5. Das Modul wird eingesetzt und dein Home-Limit entsprechend angepasst. Das Modul-Item wird dabei aus deinem Inventar genommen.

### Modul entfernen

1. Sorge für **mindestens einen freien Platz** in deinem Spielerinventar.
2. Öffne `/home`.
3. Klicke auf das **eingesetzte Home-Modul rechts unten** im Menü.
4. Das Modul wird herausgenommen und als Item zurückgegeben, sofern du **höchstens 5 Homes** gespeichert hast.

**Wichtig zu Modulen:**

- Es kann immer nur **ein Home-Modul gleichzeitig** eingesetzt sein.
- Ein neues Modul ersetzt ein bereits eingebautes Modul nicht automatisch.
- Zum Wechsel musst du das alte Modul erst entfernen. Wenn du mehr als 5 Homes hast, musst du dafür zunächst einige Homes löschen.
- Das System erlaubt es nicht, ein Modul zu entfernen, wenn du danach mehr Homes hättest als die **5 Standardplätze** erlauben.
- Home-Module sehen wie besondere **Spielerkopf-Items** aus und lassen sich nicht als gewöhnlicher Block platzieren.
- Das Home-Plugin enthält **keinen normalen Spielerbefehl und kein eigenes Menü zum Kaufen oder Herstellen** von Modulen. Wo du eines auf Returox erhältst, ist durch das Home-System selbst nicht festgelegt.
- Falls bei einer Modul-Rückgabe dein Inventar voll ist, informiert dich das System. Eine ausstehende Rückgabe kann beim nächsten Login erneut versucht werden.

## 🌍 7. Homes über Server und Welten hinweg

Du kannst einen Home-Punkt auf einem Returox-Server speichern und ihn später auch von einem anderen Server aus auswählen.

**Beispiel:** Du speicherst `Farm` auf einem Farmwelt-Server. Später bist du auf einem anderen Spielserver und nutzt `/home Farm`. Das Home-System kann dich zum passenden Server wechseln und dort zu deinem gespeicherten Ort teleportieren.

Beachte dabei: Der Wechsel kann länger dauern als ein Teleport innerhalb derselben Welt. Wenn der Zielserver nicht erreichbar ist oder die gespeicherte Welt fehlt, kann der Vorgang scheitern. Verwende den Befehl nicht mehrfach hintereinander, während der Wechsel noch läuft.

## ⭐ Fortschritt, Belohnungen und Kosten

Das Home-System hat **kein eigenes Levelsystem, keine Erfahrungspunkte, keine täglichen Aufgaben, keine Belohnungsserie und keine eigenen Geldkosten für die gezeigten Home-Aktionen**. Seine Erweiterung besteht aus den Home-Modulen mit 6 bis 21 Plätzen.

Es ist auch **keine feste Wartezeit zwischen zwei erfolgreichen Home-Teleports** festgelegt. Ein neuer Vorgang wird aber blockiert, solange der vorherige noch bearbeitet wird. Der kurze Schadensschutz beim Teleport ist keine Teleport-Wartezeit.

## 💡 Tipps und Tricks

1. **Home an der richtigen Stelle speichern:** Stelle dich vor deine Tür oder an einen freien, sicheren Platz und schau in die gewünschte Richtung.
2. **Namen ohne Leerzeichen wählen:** `Lager` oder `EndPortal` sind leichter per Befehl erreichbar als Namen mit mehreren Wörtern.
3. **Symbole passend gestalten:** Damit findest du deine Homes im Menü auch ohne langes Lesen.
4. **Position statt Name austauschen:** Wenn deine Base umzieht, aktualisiere dein vorhandenes Home, anstatt es erst zu löschen und neu anzulegen.
5. **Vor dem Löschen nachdenken:** Gelöschte Homes können nicht über eine Home-Schaltfläche wiederhergestellt werden.
6. **Module rechtzeitig planen:** Wenn du später ein größeres Modul einsetzen möchtest, bedenke, dass du zum Herausnehmen des alten Moduls wieder auf höchstens fünf gespeicherte Homes kommen musst.
7. **Ein freier Modulplatz reicht nicht aus:** Das Modul setzt du durch Anklicken des Items **in deinem eigenen Inventar** ein.
8. **Nicht wild herumklicken, wenn etwas lädt:** Home-Aktionen werden nacheinander verarbeitet, damit keine widersprüchlichen Teleports entstehen.

## ❓ Häufig gestellte Fragen (FAQ)

### 1. Wie öffne ich das Home-Menü?

Schreibe `/home` oder `/homes` in den Chat.

### 2. Wie speichere ich meinen ersten Home-Punkt?

Öffne `/home`, klicke auf den hellgrünen Farbstoff und gib anschließend den gewünschten Namen im Chat ein.

### 3. Wo genau wird die Position gespeichert?

An dem Ort, an dem du **beim Absenden des Home-Namens** stehst. Deine Blickrichtung wird ebenfalls gespeichert.

### 4. Wie teleportiere ich mich am schnellsten zur Base?

Mit `/home Base`, wenn dein Home `Base` heißt. Alternativ kannst du es im Home-Menü anklicken.

### 5. Wie viele Homes darf ich erstellen?

Ohne Modul fünf. Mit einem passenden Home-Modul sind sechs bis maximal 21 Homes möglich.

### 6. Warum kann ich kein weiteres Home erstellen?

Vielleicht sind alle Plätze belegt. Lösche einen nicht mehr benötigten Home-Punkt oder verwende ein Modul mit größerem Limit.

### 7. Warum wird mein Home-Name nicht angenommen?

Der Name darf nicht leer oder länger als 64 Zeichen sein. Außerdem darfst du denselben Namen nicht schon für ein anderes Home verwenden.

### 8. Kann ich Homes mit Leerzeichen benennen?

Beim Erstellen im Chat ja. Für den direkten Befehl `/home <name>` empfiehlt sich allerdings ein Name ohne Leerzeichen, weil dabei nur das erste Wort berücksichtigt wird. Über das Menü kannst du solche Homes weiterhin auswählen.

### 9. Kann ich mein Home später verschieben?

Ja. Stelle dich an den neuen Ort, klicke im Home-Menü auf Glowstone-Staub und wähle dein Home aus.

### 10. Kann ich ein Home umbenennen?

Eine eigene Umbenennungsfunktion gibt es nicht. Du kannst das alte Home löschen und ein neues mit deinem gewünschten Namen erstellen. Dabei geht der alte gespeicherte Standort verloren.

### 11. Kann ich das Item meines Homes ändern?

Ja. Klicke im Menü auf den orangen Farbstoff, danach auf dein Home und schließlich auf ein Item in der Symbolauswahl.

### 12. Verändert ein anderes Symbol auch mein Gebäude?

Nein. Es ändert nur das Icon in der Home-Übersicht.

### 13. Warum finde ich ein bestimmtes Symbol nicht sofort?

Die Symbolauswahl hat mehrere Seiten. Mit den Papier-Schaltflächen unten kannst du vor- und zurückblättern. Nicht jedes Minecraft-Material ist in der Auswahl enthalten.

### 14. Kann ich zu Homes auf einem anderen Returox-Server reisen?

Ja. Das Home-System unterstützt automatische Serverwechsel zu gespeicherten Homes. Der Zielserver und die gespeicherte Welt müssen dafür erreichbar sein.

### 15. Warum funktioniert ein Teleport manchmal nicht?

Das Home könnte gelöscht worden sein, der Zielserver oder die Zielwelt könnte fehlen oder der Vorgang könnte bereits laufen. Beachte die Nachricht, die dir das Home-System anzeigt.

### 16. Kann ich zwei Home-Module gleichzeitig benutzen?

Nein. Es kann nur ein Modul eingesetzt sein. Es bestimmt dein gesamtes Home-Limit.

### 17. Warum kann ich mein eingebautes Modul nicht entfernen?

Du brauchst einen freien Inventarplatz und darfst höchstens fünf Homes gespeichert haben. Andernfalls musst du zuerst Homes löschen.

### 18. Muss ich mein Home-Modul in den orangefarbenen Slot ziehen?

Nein. Öffne `/home` und klicke das gültige Modul **unten in deinem normalen Spielerinventar** an.

### 19. Wie breche ich die Eingabe eines Home-Namens ab?

Ein eigener Abbruchbefehl ist nicht eingebaut. Die nächste Chatnachricht wird als Name aufgefasst, auch wenn du das Menü bereits geschlossen hast. Beim Verlassen des Servers wird die ausstehende Namenseingabe verworfen.

### 20. Gibt es eine Sicherheitsbestätigung beim Löschen?

Nein. Sobald du Redstone und danach ein Home anklickst, wird der Löschvorgang ausgeführt. Wähle sorgfältig aus.

### 21. Kostet die Nutzung Geld oder Erfahrungspunkte?

Nein. Für das Erstellen, Bearbeiten und Teleportieren ist im Home-System selbst kein Geld- oder Erfahrungspunktepreis vorgesehen.

### 22. Bin ich nach einem Home-Teleport vor Schaden geschützt?

Ja, kurzzeitig. Der Schutz endet nach höchstens 100 Spiel-Ticks, bei normaler Geschwindigkeit etwa fünf Sekunden. Verlasse dich trotzdem nicht auf einen gefährlichen Zielort.

---

**Viel Spaß beim Erkunden und Bauen auf Returox!** 🏡 Nutze deine Homes, um jederzeit schnell zu deinen wichtigsten Orten zurückzukehren.
