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
