SeaCreatures

🌊 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

- Instant Reload: Configure which creatures are common or rare using a simple weight-based system - Instant Reload: Higher enchantment levels increase your chances of catching creatures - Instant Reload: Creatures require minimum fishing skill levels to catch - progress to unlock rarer spawns! - Instant Reload: Create electrified guardians, armored drowned, and other unique variants - Instant Reload: - 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 - Instant Reload: Restrict creatures by biome, world, or Y-level - Instant Reload: 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

- Dependencies: PaperMC 1.21.7 (or compatible 1.21.x) - Dependencies: Java 21+ - Dependencies: AuraSkills (for fishing level integration)

🎯 Example Creatures (Default Config)

- Armored Drowned (Weight: 30) - Common, basic catch - Armored Drowned (Weight: 10, Min Level: 3) - Requires level 3 fishing - Armored Drowned (Weight: 5, Min Level: 3) - Moderate rarity - Armored Drowned (Weight: 1, Min Level: 5) - Rare, high XP reward (1000) - Armored Drowned (Weight: 2, Min Level: 7) - Custom glowing variant with Speed effect - Armored 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

```yaml 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:

- Quick string format or add to them - Quick string format (min-max) - Quick string format (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

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

🔗 Links

- Documentation: Documentation - Documentation: %%MD1%% - Documentation: Full config guide in the %%MD2%%

📜 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!*