Brewery/readme.md

217 lines
9.1 KiB
Markdown
Raw Normal View History

2013-07-01 17:24:32 +02:00
# Brewery
**Brewery ist ein Bukkit-Plugin zum brauen auch alkoholischer Getränke.**
Der schwierige Brauprozess belohnt dich mit verschiedensten Getränken, die durch ihre Effekte und Wirkungen eine Trunkenheit hervorrufen können, die es in Minecraft so noch nicht gegeben hat.
## Installation
* Brewery.jar in den Plugins-Ordner kopieren
2013-07-29 00:18:43 +02:00
* Permissions festlegen
* Server starten
* Optional Aufwachpunkte festlegen
2013-07-01 17:24:32 +02:00
Die Config.yml wird beim Serverstart erstellt.
*Vor der ersten Releaseversion sollte nach jedem Update die Config.yml gelöscht und damit neu generiert werden!*
### Data.yml
Die data.yml beinhaltet alle gespeicherten Daten des Plugins und sollte nicht gelöscht oder verändert werden.
Beim ersten Serverstart wird eine Fehlermeldung darauf hinweisen, dass keine data.yml gefunden wurde. Diese Meldung kann ignoriert werden, da noch keine vorhanden ist und eine neue erstellt wird.
## Config
Die Config.yml enthält:
* Einstellungen
* Rezepte
* Wörter
2013-09-05 22:21:26 +02:00
Sie kann frei editiert werden und nach Belieben angepasst werden. Die Änderungen werden nach ausführen des Commands Reload oder nach einem Serverrestart übernommen
2013-07-01 17:24:32 +02:00
Alle Teile der Config sind kommentiert. Die Kommentare enthalten Erklärungen und Beispiele.
Die Bereits vorhandenen Rezepte, Wörter und Einstellungen sind gleichzeitig Beispiele, um z.B. eigene Rezepte zu erstellen.
**Rezepte**
Hier werden die Rezepte für die verschiedenen Tränke eingetragen. Es können bestehende Rezepte verändert, oder neue hinzugefügt werden. Dabei muss beachtet werden, dass alle Zutaten die verwendet werden ebenfalls in der darunterliegenden Kategorie "cooked" eingetragen werden müssen, um sie für den Kessel zugänglich zu machen.
Die Rezepte bestimmen alle Eigenschaften der entstehenden Tränke. Ob und wie lange sie reifen müssen, ihre Farbe, Effekte die beim Trinken wirken, den Alkoholgehalt, usw. Optionen die weggelassen werden, werden nicht verwendet, oder verwenden die Standardwerte. Wenn z.B. die Anzahl der Destilliervorgänge weggelassen wird, muss der Trank nicht destilliert werden.
Werden im Nachhinein Rezepte umbenannt, so kann es sein, dass vorhandene Tränke den neuen Namen erst nach erneutem Reifen/Brauen erhalten.
2013-07-01 17:24:32 +02:00
**Wörter**
Die Wörter sind eine Auflistung von Worten, Sätzen und Buchstaben, die je nach Alkoholisierung des Spielers seinen Chat beeinflussen und dort Wörter verändern. So kann z.B. jedes "a" in ein "b" geändert werden.
Auch hier können anhand der Erklärungen und Beispiele bestehende "Wörter" verändert oder hinzugefügt werden.
2013-07-29 00:18:43 +02:00
## Commands
<table>
<tr>
<th>Befehl</th><th>Beschreibung</th>
</tr>
<tr>
<td>/br Info</td><td>Informationen über die eigene Trunkenheit</td>
</tr>
<tr>
<td>/br Info [Spieler]</td><td>Informationen über Trunkenheit von [Spieler]</td>
</tr>
<tr>
<td>/br [Spieler] [Trunkenheit] [Qualität]</td><td>Setzen der Spielerwerte. Trunkenheit in %, Qualität von 1-10.</td>
</tr>
2013-08-30 21:19:49 +02:00
<tr>
<td>/br UnLabel</td><td>Versteckt die genauen Zahlen in der Beschriftung des Trankes in der Hand unwiederbringlich</td>
</tr>
2013-08-20 23:19:23 +02:00
<tr>
<td>/br Copy [Anzahl]</td><td>Kopiert den Trank in der Hand. Optional kann die Anzahl angegeben werden</td>
</tr>
2013-08-21 00:04:24 +02:00
<tr>
<td>/br Delete</td><td>Entfernt den Trank in der Hand</td>
</tr>
2013-07-29 00:18:43 +02:00
<tr>
<td>/br Wakeup Add</td><td>Setzen eines neuen Aufwachpunktes an die eigene Position</td>
</tr>
<tr>
<td>/br Wakeup List [Seite]</td><td>Auflisten aller Aufwachpunkte auf [Seite]</td>
</tr>
<tr>
<td>/br Wakeup List [Seite] [Welt]</td><td>Auflisten aller Aufwachpunkte auf [Seite] einer bestimmten [Welt]</td>
</tr>
<tr>
<td>/br Wakeup Check</td><td>Teleportiert nacheinander zu allen Aufwachpunkten, um sie zu überprüfen</td>
</tr>
<tr>
<td>/br Wakeup Check [id]</td><td>Teleportiert zum Aufwachpunkt mit der [id], um ihn zu überprüfen</td>
</tr>
<tr>
<td>/br Wakeup Remove [id]</td><td>Entfernt den Aufwachpunkt mit der [id]</td>
</tr>
<tr>
<td>/br Reload</td><td>Neuladen der Config mitsamt Rezepten</td>
</tr>
</table>
## Permissions
<table>
<tr>
<th>Permission</th><th>Ermöglichter Befehl</th><th>Beschreibung</th>
</tr>
2013-08-30 21:19:49 +02:00
<tr>
<td>brewery.cmd.unlabel</td><td>UnLabel</td><td>Teile der Trankbeschriftung verstecken</td>
</tr>
2013-07-29 00:18:43 +02:00
<tr>
<td>brewery.cmd.info</td><td>Info</td><td>Informationen über die eigene Trunkenheit</td>
</tr>
<tr>
<td>brewery.cmd.infoOther</td><td>Info [Spieler]</td><td>Informationen über Trunkenheit von [Spieler]</td>
</tr>
<tr>
<td>brewery.cmd.player</td><td>[Spieler] *</td><td>Setzen der Spielerwerte</td>
</tr>
<tr>
<td>brewery.cmd.wakeup</td><td>Wakeup *</td><td>Setzen, Überprüfen und Entfernen von Aufwachpunkten</td>
</tr>
2013-08-20 23:19:23 +02:00
<tr>
<td>brewery.cmd.copy</td><td>Copy</td><td>Kopieren von Tränken per Command</td>
</tr>
2013-08-21 00:04:24 +02:00
<tr>
<td>brewery.cmd.delete</td><td>Delete</td><td>Entfernen von Tränken per Command</td>
</tr>
2013-07-29 00:18:43 +02:00
<tr>
<td>brewery.cmd.reload</td><td>Reload</td><td>Config neuladen</td>
</tr>
</table>
2013-07-01 17:24:32 +02:00
## Benutzung
Nach der Installation und Konfiguration kann es ans Brauen von Getränken gehen. Anders als bei Vanilla Minecraft muss hier nicht einfach nur eine Zutat in den Braustand gegeben und gewartet werden. Je nach Rezept kann der Vorgang kompliziert und langwierig sein. Manche Rezepte verlangen eine hohe Genauigkeit in der Einhaltung der Vorgaben. Wird ein Arbeitsschritt zu lange oder zu kurz ausgeführt, kann die Qualität des Getränks stark darunter leiden. Das hat dann zur Folge, dass Nebenwirkungen durch Fuselalkohole und andere Giftstoffe entstehen.
Um ein sinnvolles Brauen der Getränke zu ermöglichen sollten die Spieler die genaue Zusammensetzung der wertvolleren Rezepte nicht kennen (z.B. Rum). Dies steigert den Wert eines hochqualitativen Getränks stark und ein experimentieren und perfektionieren der Getränke wird gefördert.
Je nach Rezept sind einzelne Arbeitsschritte nicht nötig, diese Anleitung beschreibt den allgemeinen Vorgang des Brauens.
2013-08-21 00:04:24 +02:00
**Hinweis:** Tränke sollten nicht per Creative Mode entfernt oder kopiert werden. Dazu bitte /br copy und /br remove verwenden
2013-07-01 17:24:32 +02:00
### Gähren
Schritt 1 besteht aus dem Gähren/Fermentieren der Zutaten.
1. Cauldron über dem Feuer platzieren
2. Mit Wasser füllen
3. Zutaten hinzugeben
4. Gähren lassen
5. In Glasflaschen abfüllen
### Destillieren
1. Flasche mit Ferment in den Braustand
2. Glowstone als Filter oben in den Braustand (Der Filter wird nicht verbraucht)
### Reifen
2013-08-21 00:04:24 +02:00
Für die Reifung ist ein Fass notwendig. Dieses kann auf zwei Arten gebaut werden.
2013-07-01 17:24:32 +02:00
**Kleines Fass**
8 Holztreppen wie folgt anordnen:
![](https://dl.dropboxusercontent.com/u/16240159/Minecraft/Pictures/kl1.png)
Schild "Fass" rechts unten anbringen:
![](https://dl.dropboxusercontent.com/u/16240159/Minecraft/Pictures/kl2.png)
Meldung "Fass wurde erfolgreich erstellt" sollte erscheinen
**Großes Fass**
4 Zäune, 16 Holztreppen, 18 Holzplanken wie folgt anordnen (innen Hohl):
![](https://dl.dropboxusercontent.com/u/16240159/Minecraft/Pictures/gr1.png)
Zapfhahn (Zaun) und Schild "Fass" anbringen:
![](https://dl.dropboxusercontent.com/u/16240159/Minecraft/Pictures/gr2.png)
Meldung "Fass wurde erfolgreich erstellt" sollte erscheinen
------
Das kleine Fass wird mit einem Rechtsklick auf das Schild geöffnet, das Große mit einem Rechtsklick auf den Zapfhahn (Zaun).
2013-08-21 00:04:24 +02:00
Dort hinein kommen nun die Flaschen zur Reifung.
2013-07-01 17:24:32 +02:00
Je nach Rezept kann die Art des benutzten Holzes über die Qualität des gereiften Trankes entscheiden
2013-08-21 00:04:24 +02:00
Das Fass sollte während der Reifung nicht kaputt gehen, da es sonst ausläuft (nach kurzer Zeit).
2013-07-01 17:24:32 +02:00
Schlägt man den Zapfhahn mit einer Axt ab, so werden alle Getränke herausgeschleudert.
### Trinken
Der Alkoholgehalt des Trankes wird beim trinken auf den Spieler übertragen. Je nach Qualität hat dies verschiedene Auswirkungen.
2013-07-03 00:31:34 +02:00
* Der Spieler kann nicht mehr richtig laufen, er wird Torkeln und für eine Strecke weitaus länger brauchen
2013-07-01 17:24:32 +02:00
* Es können Effekte wie Blindness, Confusion, Poison usw. auftreten
2013-07-03 00:31:34 +02:00
* Der Chat wird stark verändert, vieles was geschrieben wird ist fast unverständlich, teilweise nur Gebrabbel
2013-07-01 17:24:32 +02:00
* Ist der getrunkene Alkohol sehr stark wird er sich leicht vergiften
2013-07-03 00:31:34 +02:00
* Hat er sehr viel getrunken, besteht die Wahrscheinlichkeit, dass er sich übergibt
* Loggt der Spieler sich aus wird er Schwierigkeiten haben sich wieder ein zu loggen, da sein Charakter nicht reagiert
2013-07-01 17:24:32 +02:00
* Trinkt er zu viel wird er in Ohnmacht fallen (Disconnect)
### Ausnüchtern
2013-08-21 00:04:24 +02:00
Nach dem Trinken dauert es eine Weile, bis der Alkohol wieder verschwunden ist. In der Zeit nimmt der Pegel stetig ab. Der Alkoholpegel kann auch durch das konsumieren der in der config bestimmten Items gesenkt werden.
2013-07-01 17:24:32 +02:00
* Loggt der Spieler sich stark betrunken aus, kann es sein, dass er sich beim nächsten einloggen (wenn etwas Zeit vergangen ist) an einen ihm völlig unbekannten Ort mitten in der Pampa wiederfindet und keine Ahnung hat wie er dort hingkommen ist
* Loggt er sich erst nach einigen Stunden oder am nächsten Morgen wieder ein befindet er sich bei seinem home, ebenfalls ohne jede Erinnerung
2013-07-03 00:31:34 +02:00
* War der Alkohol nicht von der guten Qualität sind mit Nacherscheinungen zu rechnen (Slowness und Hunger).