Fishing Game

🎣 Fishing Game Documentation

The fishing game is a fun, interactive game where players can catch various sea creatures and compete for high scores.

Table of Contents

Basic Commands

Player Commands

Hidden / Admin-Oriented (Not shown in standard help)

Contest Commands

Game Features

🌟 Rarity System

Fish are categorized into eight rarity tiers that affect catch rates (weights shown are relative selection weights, lower = rarer):

Rarity Weight Color Examples
Mythic 0.75 Dark Orange Helios-Sunfish
Ultra-Legendary 0.5 Deep Pink Diamond-Ring
Legendary 1 Gold Blue-Whale, Clockwork-Carp
Epic 5 Purple Great-White-Shark, Hammerhead-Shark, Narwhal, Lavender-Braid-Eel, DevOps-Ducky
Rare 15 Blue Marlin, Sailfish, Barracuda, Tarpon, Mahi-Mahi, Starfall-Salmon, Wahoo
Uncommon 30 Green Sea-Bass, Smallmouth-Bass, Bonefish, Comfy-Catfish, Tuna
Common 50 Gray Blue-Tang, Butterfly-fish, Clown-Fish, Crab, Lobster, Parrot-Fish, Perch, Sea-Cucumber, Seahorse, Shrimp, Starfish, Sea-Urchin, Button-Shield-Minnow, Tangled-Headset
Junk 60 Brown Stinky-Boot, Worn-Trainers

The game internally normalizes weights; lower weight = rarer. Mythic sits between ultra‑legendary and legendary in rarity (rarer than legendary but slightly more common than ultra-legendary). Mythic fish currently award special point multipliers in catches.

📋 Fish Descriptions

Each fish includes a unique description that adds flavor to your catch, like:

💎 Mythic & Ultra-Legendary Catches

These tiers produce the most dramatic announcements:

Mythic – Currently includes the radiant Helios-Sunfish.

Ultra-Legendary – Includes special treasures like:

Both Mythic and Ultra-Legendary receive very large point multipliers. Contest multipliers stack.

🎲 Catch Variety System

The game uses smart randomization to ensure variety:

🗑️ Junk Catches

Sometimes you’ll pull up trash instead of fish:

Fishing Mechanics

Points Calculation

Points are calculated based on both size and weight:

Base Points = (weight_kg × 10) + size_cm

Maximum points are capped at 2× the fish’s theoretical maximum to prevent outliers.

Cooldowns

Special Catches

Contests

Contest Features

Starting a Contest

Admins can start a contest with:

!startfishingcontest [duration_minutes] [thread_name]

Example: !startfishingcontest 10 "Weekend Fishing Tournament"

Contest Flow

  1. Admin starts contest → Thread created with “[ACTIVE]” tag
  2. “GET READY!” countdown (10 seconds)
  3. “🎣 START FISHING!” → Contest begins
  4. Players fish in the thread with no cooldowns
  5. Contest ends → Final results posted automatically
  6. Thread locked and archived for history

Configuration

The game uses my_fishing_game_config.json for customization:

{
	"member_catch_ratio": 50,      // 1 in X chance to catch a member
	"cooldown_seconds": 30,         // Seconds between casts
	"no_catch_chance": 0.15,        // Chance to catch nothing
	"rarity_tiers": {               // Rarity configuration (example weights)
		"mythic": { "weight": 0.75, "color": "#FF8C00" },
		"ultra-legendary": { "weight": 0.5, "color": "#FF1493" },
		"legendary": { "weight": 1, "color": "#FFD700" },
		"epic": { "weight": 5, "color": "#9B59B6" },
		"rare": { "weight": 15, "color": "#3498DB" },
		"uncommon": { "weight": 30, "color": "#2ECC40" },
		"common": { "weight": 50, "color": "#7F8C8D" },
		"junk": { "weight": 60, "color": "#8B4513" }
	},
	"fish": [...]                   // Fish data array
}

Fish Data Structure

{
	"name": "Great-White-Shark",
	"min_size_cm": 300,
	"max_size_cm": 600,
	"min_weight_kg": 680,
	"max_weight_kg": 2300,
	"rarity": "epic",
	"description": "The apex predator of the ocean, both feared and respected worldwide."
}

Admin Commands

Configuration Commands

Contest Management

Testing Commands

Examples

!addfish Goldfish 10 25 0.1 0.5 common "A classic pet fish that somehow ended up in open water."
!setfishcooldown 45s
!startfishingcontest 15 "Friday Night Fish Frenzy"

Tips for Players

  1. Check conditions: Use !fishconditions to see all available fish by rarity
  2. Join contests: No cooldowns and 50% bonus points!
  3. Check the leaderboard: Use !fishstats to see where you rank
  4. Learn about fish: Use !fishinfo to study your catches
  5. Variety is key: The game prevents repeat catches for better variety
  6. Don’t give up: Even junk catches earn points!

Database Storage

All catches are stored in fishing_game.db with:

This allows for persistent leaderboards, statistics tracking, and contest history.

Asset Requirements

Fish Images

Complete Fish List (Current Build)

The live configuration includes both classic species and new additions. For a visual catalog with images, see the separate Fish Catalog.

Mythic

Ultra-Legendary

Legendary

Epic

Rare

Uncommon

Common

Junk

Use !fishlist for detailed size/weight ranges.

Happy Fishing! 🎣

Generated from repository docs. Last build: 2025-09-12 11:03 UTC