Fishbot
Start/Wiki

Fishbot-Angeln

Das Angelspiel im Bot — von den ersten Würfen bis zu Saisons, eigenen Fischarten und Administration.

1. Worum es geht

Angeln ist ein kleines Spiel im Bot. Du wirfst die Angel aus, wartest kurz, und ziehst einen Fisch heraus. Manche sind häufig, manche sieht man einmal im Monat. Fische bringen Punkte für die Rangliste und lassen sich für Spielwährung verkaufen. Von dem Geld kaufst du bessere Ruten und Köder, schaltest neue Gewässer frei und füllst dein Fischbuch.

Es kostet nichts, es hat keine Kaufoption für echtes Geld, und es läuft komplett im selben Bot wie alles andere.

2. Erste Schritte

  1. Ein Server-Admin schaltet das Modul mit /setup → Fishbot-Angeln ein.
  2. Du tippst /fisch angeln.
  3. Fertig. Du startest mit einer Holzrute, fünf Tauwürmern und dem Dorfteich.

Danach lohnen sich drei Befehle:

  • /fisch daily — jeden Tag Geld abholen, die Serie erhöht den Betrag
  • /fisch aufgaben — drei kleine Aufgaben, die zusätzlich zahlen
  • /fisch shop — sobald etwas Geld da ist

3. Alle Befehle

Befehl Was passiert
/fisch angeln Wirf die Angel aus
/fisch profil [mitglied] Geld, Fänge, Ausrüstung, Punkte — auch von anderen
/fisch buch Welche Arten du schon gefangen hast
/fisch gewaesser Gewässer ansehen und wechseln
/fisch shop Ruten und Köder kaufen, Ausrüstung wechseln
/fisch daily Tagesbelohnung
/fisch aufgaben Deine drei Aufgaben für heute
/fisch rangliste [zeitraum] Bestenliste der Saison oder aller Zeiten
/fisch saison Neue Saison starten (nur Admins, ab Pro)
/fisch setup Einrichtung (nur Admins)

Alle Antworten außer der Rangliste sieht nur du.

4. Was bei einem Fang passiert

  1. Der Bot prüft, ob deine Wartezeit abgelaufen ist. Wenn nicht, sagt er dir, wie lange noch.
  2. Er würfelt eine Seltenheit. Wie oft dabei etwas Gutes herauskommt, hängt vom Gewässer, deiner Rute, deinem Köder und der Server-Einstellung ab.
  3. Aus dieser Seltenheit wird eine Art gezogen, die in deinem Gewässer vorkommt.
  4. Dann eine Variante — meist normal, selten etwas Besonderes.
  5. Die Größe wird gewürfelt. Sehr große Exemplare sind selten; dein Rekord je Art landet im Fischbuch.
  6. Aus all dem ergibt sich der Wert. Ein Köder wird verbraucht, dein Fischbuch aktualisiert, Punkte werden gutgeschrieben und Aufgaben zählen mit.

5. Seltenheiten und Varianten

Seltenheit Häufigkeit (Grundgewicht) Wert Punkte
⚪ Gewöhnlich 600 ×1 1
🟢 Ungewöhnlich 250 ×2 3
🔵 Selten 100 ×5 10
🟣 Episch 35 ×12 30
🟠 Legendär 12 ×35 100
🔴 Mythisch 3 ×100 400

Die Zahlen sind Gewichte, keine Prozente: Sie gelten nur im Verhältnis zueinander und verschieben sich mit Gewässer, Rute, Köder und Servereinstellung nach oben.

Variante Häufigkeit Wirkung
Normal 93 % —
✨ Glänzend 5 % Wert ×4
🐋 Gigantisch 2 % Wert ×3, deutlich größer

Varianten zählen im Fischbuch getrennt — eine glänzende Forelle ist ein eigener Eintrag.

6. Gewässer

Freigeschaltet wird über die Gesamtzahl deiner Fänge. Jedes Gewässer hat eigene Arten und bessere Chancen auf Seltenes.

Gewässer Frei ab Fangglück
🪷 Dorfteich Start —
🏞️ Fluss 25 Fänge +5 %
🏔️ Bergsee 100 Fänge +12 %
🌊 Meer 250 Fänge +20 %
🕳️ Tiefsee 600 Fänge +30 %
🌋 Vulkansee 1200 Fänge +45 %

Wechseln mit /fisch gewaesser. Du kannst jederzeit zurück — manche Arten gibt es nur im Teich.

7. Shop und Ausrüstung

Ruten kauft man einmal, sie bleiben.

Rute Preis Fangglück Wartezeit
🪵 Holzrute Start — —
🎋 Bambusrute 500 +5 % −10 %
🖤 Karbonrute 2 500 +12 % −20 %
⭐ Profirute 10 000 +20 % −30 %
👑 Meisterrute 40 000 +30 % −40 %

Köder werden pro Wurf verbraucht und kommen im Fünferpack.

Köder Preis (5 Stück) Fangglück
🪱 Tauwurm 5 +5 %
🌽 Mais 15 +10 %
🎏 Kunstköder 50 +20 %
✨ Goldköder 200 +40 %

Ist der letzte Köder verbraucht, angelst du einfach ohne weiter — der Bot sagt Bescheid.

8. Fischbuch

/fisch buch zeigt alle Arten nach Seltenheit sortiert. Was du noch nie gefangen hast, steht als ??? da — sonst wäre die Suche witzlos. Bei bekannten Arten siehst du, wie oft du sie gefangen hast, deinen Größenrekord und welche Varianten du schon hattest.

9. Tägliche Belohnung und Aufgaben

/fisch daily gibt es einmal pro Tag. Die Belohnung startet bei 100 und steigt mit jedem Tag in Folge um 25, bis 250 bei sieben Tagen. Ein ausgelassener Tag setzt die Serie zurück.

/fisch aufgaben zeigt drei Aufgaben, die sich jede Nacht (UTC) erneuern — zum Beispiel „Fange 10 Fische" oder „Fange einen seltenen Fisch oder besser". Sie werden nebenbei erledigt, während du spielst; die Belohnung kommt automatisch.

10. Rangliste und Saisons

Punkte gibt es je nach Seltenheit und Variante des Fangs, nicht nach Menge — ein mythischer Fisch ist mehr wert als 400 gewöhnliche.

/fisch rangliste zeigt standardmäßig die aktuelle Saison, zeitraum: Alle Zeiten die Gesamtwertung. Die Gesamtwertung wird nie zurückgesetzt.

Sind Saisons eingeschaltet, kann ein Admin mit /fisch saison eine neue starten: Die Saisonwertung geht auf null, die drei Erstplatzierten werden vorher als Podium festgehalten.

11. Die Buttons unter einem Fang

Button Was er tut
🎣 Nochmal angeln Neuer Wurf, sobald die Wartezeit abgelaufen ist
💰 Verkaufen Wandelt den Fang in Währung um. Danach ausgegraut — jeder Fisch zählt einmal
📖 Fischbuch Öffnet dein Fischbuch, ohne den Fang zu verlassen

12. Wartezeit und Pity

Wartezeit ist die Pause zwischen zwei Würfen. Der Server stellt sie ein, eine bessere Rute verkürzt sie. Server ohne Pro-Plan können nicht unter 60 Sekunden gehen; mit Pro sind minimal 5 Sekunden möglich.

Pity ist die eingebaute Pechsträhnen-Bremse: Der Bot zählt mit, wie viele Fänge du ohne etwas Seltenes hattest. Ist die eingestellte Schwelle erreicht (Standard 25), ist der nächste Fang garantiert mindestens selten. Danach beginnt die Zählung von vorn — auch dann, wenn du zwischendurch ohne Pity etwas Seltenes gefangen hast.

13. Für Administratoren

Einrichtung über /fisch setup oder im Dashboard unter dem Modul.

Einstellung Bedeutung Standard
Wartezeit zwischen zwei Würfen Sekunden; unter 60 nur mit Pro 90
Fangglück knapp · normal · großzügig normal
Pity nach … Fängen 0 schaltet es ab 25
Name der Währung z. B. „Taler", „Schuppen" Muscheln
Erlaubte Kanäle leer = überall erlaubt leer
Kanal für seltene Fänge öffentliche Meldung (Pro) leer
Ab welcher Seltenheit melden selten · episch · legendär · mythisch episch
Saisons verwenden Pro aus
Tägliche Belohnung & Aufgaben an/aus an

Ein eigener Kanal fürs Angeln ist fast immer eine gute Idee — sonst füllt das Spiel den allgemeinen Chat.

14. Eigene Fische, Banner und Bilder

Der komplette Spielinhalt steht in einer einzigen Datei: apps/bot/src/features/fishing/data/content.ts.

Eine neue Art ist ein Eintrag in SPECIES:

{
  key: "stichling",
  name: "Stichling",
  rarity: "gewoehnlich",
  waters: ["teich", "fluss"],
  minCm: 3,
  maxCm: 11,
  basePrice: 2,
  emoji: "🐟",
  image: "stichling.png",
  flavor: "Klein, stachelig, erstaunlich mutig.",
}

Bilder gehören hierhin:

Was Pfad Empfehlung
Fischart apps/web/public/fishing/species/<image> 512×512 px, PNG mit Transparenz
Gewässer-Banner apps/web/public/fishing/banner/<banner> 1200×400 px

Nach dem Bearbeiten den Bot neu starten. Es ist keine Datenbankänderung nötig — Arten und Gewässer stehen bewusst im Code, nicht in der Datenbank.

15. Datenbank und Updates

Das Modul legt vier Tabellen an: FishingProfile, FishBookEntry, FishingItem und FishingSeason. Bestehende Tabellen werden nicht verändert.

npm run db:generate
npm run db:push

Spielstände bleiben bei Updates erhalten. Ändert sich Inhalt (neue Arten, andere Preise), wirkt das sofort — gefangene Fische im Fischbuch bleiben, auch wenn eine Art später umbenannt wird, solange der key gleich bleibt. Den key einer Art nachträglich zu ändern, trennt sie von den bisherigen Fischbuch-Einträgen.

16. Modul ein- und ausschalten

Es gibt zwei Ebenen:

Pro Server — /setup → Fishbot-Angeln → Modul ein-/ausschalten. Betrifft nur diesen Server; die Spielstände bleiben erhalten.

Für die ganze Instanz — in der .env des Bots:

DISABLED_MODULES=fishing

Dann wird /fisch bei Discord gar nicht erst registriert und die Buttons werden nicht beantwortet. Mehrere Module kommagetrennt. Nach der Änderung npm run deploy:commands und Neustart.

17. Häufige Probleme

Problem Lösung
Die Fischbilder fehlen Datei fehlt unter apps/web/public/fishing/species/, oder die Adresse ist von außen nicht erreichbar. Auf localhost kann Discord grundsätzlich keine Bilder laden.
/fisch gibt es nicht npm run deploy:commands ausführen. Steht fishing in DISABLED_MODULES?
„Das Angeln ist ausgeschaltet" Modul auf diesem Server einschalten: /fisch setup.
„Hier wird nicht geangelt" Es sind erlaubte Kanäle eingestellt. Der Bot nennt sie in der Meldung.
Der Cooldown lässt sich nicht unter 60 s stellen Das geht ab dem Pro-Plan. Free-Server sind bei 60 Sekunden gedeckelt.
„Das ging zu schnell hintereinander" Der allgemeine Missbrauchsschutz des Bots. Kurz warten.
Buttons unter einem alten Fang reagieren nicht Nach einem Neustart des Bots normal — /fisch angeln neu aufrufen.
Datenbankfehler beim Start npm run db:generate und npm run db:push nachholen.

Zuletzt aktualisiert: 02. September 2026