Keskin Fishing

An advanced, multi-tier fishing progression and zone system for Paper and Purpur servers by keskinreal

✨ Main Features

✦ Modern Symmetrical GUI: Sleek and user-friendly menus designed for intuitive navigation.
✦ 9 Configurable Rod Tiers: Faster fishing speeds, higher catch rates, and extra fish at higher tiers.
✦ Fishing XP & Level Progression: Independent level system separated from vanilla XP.
✦ World-Based Fishing Zones: Define, visualize, and delete custom fishing zones by radius and center coordinates.
✦ Fish Market & Economy: Sell Cod, Salmon, Tropical Fish, and Pufferfish for money and Fishing Points.
✦ Rod Upgrades & Perks: Upgrade fishing rods with Fishing Points; configure bonus items and drop chances per tier.
✦ Item Exploitation Protection: System items can be traded/stored in chests, but are fully blocked from crafting, anvils, grindstones, and smithing tables.
✦ Vault & Economy Fallback: Full Vault economy integration with configurable deposit/withdraw command fallbacks.

📌 Requirements & Compatibility

Java Version: Java 21 or newer

Server Core: Paper / Purpur 1.21.4

Optional Dependencies: Vault, Economy Plugins, FancyNpcs

📦 Installation Guide

Stop the server completely.
Place KeskinFishing-1.0.9.jar inside your plugins folder.
Start the server.
Stand at the desired center point and create a zone using /fishingadmin setzone main 40.
Visualize the zone boundary using /fishingadmin zone main.
Configure settings in plugins/KeskinFishing/config.yml and run /fishingadmin reload.

⚡ Commands Reference

Player Commands

/fishing

Opens the main fishing menu.

/fishing profile

Opens player fishing profile & stats.

/fishing sell

Opens the fish sales market menu.

/fishing upgrade

Opens the fishing rod upgrade menu.

/fishing claim

Claims the starter fishing rod.

/fishing language <code>

Sets personal display language.

/fishing help

Displays the fishing guide.

Admin Commands

/fishingadmin reload

Reloads configurations & locales.

/fishingadmin npcopen <player>

Opens main GUI for a player via NPC.

/fishingadmin give-rod <player> <1-9>

Gives a specific tier rod to a player.

/fishingadmin points <player> <add|set|remove> <amount>

Manages player Fishing Points.

/fishingadmin xp <player> <add|set|remove> <amount>

Manages player Fishing XP.

/fishingadmin setzone <id> <radius>

Creates a fishing zone at current location.

/fishingadmin removezone <id>

Removes an existing fishing zone.

/fishingadmin zone [id]

Visualizes fishing zone boundaries.

🌐 Multi-Language & Personalization

Command structure always remains in English, while GUI items, messages, and carried rod descriptions translate dynamically.

en_US tr_TR es_ES de_DE fr_FR pt_PT nl_NL bg_BG hi_IN zh_CN zh_TW ru_RU it_IT ja_JP ko_KR pl_PL uk_UA

⚙️ Key Configurations

Starter Rod Prices

starter-rod:
  enabled: true
  first-purchase-price: 0.0
  allow-repeat-purchases: true
  repeat-purchase-price: 100.0

NPC Requirement Locks

npc:
  requirements:
    sell: true
    upgrade: true
    starter-rod: true

🤖 FancyNpcs Action

fishingadmin npcopen {player}

Configure this command action on FancyNpcs to interactively route players into the fishing interface.

🔒 Signature & Safety

/fishingadmin license

Catches and rewards deliver straight to inventory. If full, the catch cancels cleanly to prevent item duplication.

Developed with passion by keskinreal