🌊 SeaCreatures - Fish Up Living Creatures Instead of Loot

Transform your Minecraft fishing experience! Instead of catching boring fish and treasure, reel in dangerous and exciting sea creatures that spawn directly from your fishing hook.

✨ What Does This Plugin Add?

SeaCreatures replaces traditional fishing loot with spawnable entities - both vanilla mobs and custom-configured variants. When players fish successfully, they have a chance to pull up living creatures like Drowned, Guardians, Elder Guardians, or even custom electrified and armored variants!

🎣 Key Features

• Weighted Spawn System: Configure which creatures are common or rare using a simple weight-based system
• Luck of the Sea Integration: Higher enchantment levels increase your chances of catching creatures
• AuraSkills Integration: Creatures require minimum fishing skill levels to catch - progress to unlock rarer spawns!
• Custom Creature Variants: Create electrified guardians, armored drowned, and other unique variants
• Full Customization Per Creature:
  • Custom display names with color code support (&b, &3, etc.)
  • Glowing effects
  • Potion effects (speed, strength, etc.)
  • Custom equipment (armor, weapons)
  • Console command execution on catch
  • Custom XP rewards for AuraSkills
  • Custom drop tables with configurable chances
• Smart Spawn Constraints: Restrict creatures by biome, world, or Y-level
• Configurable Catch Chance: Base percentage plus bonuses per Luck of the Sea level
• Instant Reload: Update your config without restarting the server using /seacreatures reload

🎮 Why Download This Plugin?

For Server Owners:

• Add excitement and danger to fishing activities
• Create progression systems tied to fishing skill levels
• Reward skilled fishers with rare, valuable creature spawns
• Fully configurable to match your server's difficulty and economy

For Players:

• Fishing becomes an active, engaging activity instead of passive waiting
• Risk vs. reward gameplay - catch powerful creatures for better loot
• Skill progression matters - unlock new creatures as you level up fishing
• Unique custom variants keep fishing interesting at all levels

📋 Requirements

• Server Software: PaperMC 1.21.7 (or compatible 1.21.x)
• Java Version: Java 21+
• Dependencies: AuraSkills (for fishing level integration)

🎯 Example Creatures (Default Config)

• Cod (Weight: 30) - Common, basic catch
• Drowned (Weight: 10, Min Level: 3) - Requires level 3 fishing
• Guardian (Weight: 5, Min Level: 3) - Moderate rarity
• Elder Guardian (Weight: 1, Min Level: 5) - Rare, high XP reward (1000)
• Electric Guardian (Weight: 2, Min Level: 7) - Custom glowing variant with Speed effect
• Electric Drowned (Weight: 2, Min Level: 7) - Custom variant with Jump Boost
• Armored Drowned (Weight: 3, Min Level: 7) - Custom variant with full diamond armor

⚙️ Quick Configuration Example

chance:
  base-percent: 35.0
  per-luck-level-bonus: 2.5

creatures:
  - id: ELECTRIC_GUARDIAN
    type: GUARDIAN
    custom: true
    weight: 2
    min-level: 7
    display-name: '&bElectric Guardian'
    glowing: true
    fishing-xp: 2500.0
    potion-effects:
      - SPEED:1:999999
    drops:
      replace-default: true
      items:
        - PRISMARINE_SHARD:5-10:1.0
        - PRISMARINE_CRYSTALS:2-5:0.8
        - DIAMOND:1-2:0.15

🎨 Custom Drop System

Configure exactly what creatures drop when killed:

• Replace vanilla drops or add to them
• Set quantity ranges (min-max)
• Configure drop chances (0.0 to 1.0)
• Quick string format: MATERIAL:min-max:chance (e.g., DIAMOND:1-3:0.25)

🔧 Commands & Permissions

Command	Description	Permission	Default
/seacreatures reload	Reloads configuration	seacreatures.reload	op

💡 How It Works

1. Player catches something with a fishing rod
2. Plugin rolls against configured chance (base % + Luck of the Sea bonus)
3. If successful, the normal catch is removed
4. A random creature is selected based on weight, fishing level, and spawn constraints
5. Creature spawns at the hook location with all customizations applied
6. Player receives configured XP and catch message

🛠️ Perfect For

• RPG Servers: Integrate fishing into your progression systems
• Survival Servers: Add danger and excitement to ocean exploration
• Skyblock: Create unique fishing mechanics for island challenges
• Custom Gameplay: Build fishing tournaments, quests, or challenges

🔗 Links

• Source Code: GitHub Repository
• Issues & Suggestions: GitHub Issues
• Documentation: Full config guide in the README

📜 License

Released under the MIT License - free to use, modify, and distribute!

---

Questions or need help? Check the README or open an issue on GitHub!