OceanPvP plugin summary

What was built

• Paper/Spigot plugin delivering the OceanPvP kit for underground BoxPvP: custom items, shop NPC, Ocean Case lootbox, and region-limited abilities.
• Fabric metadata stub is kept so the jar stays loadable in Fabric environments, but gameplay logic targets Paper.

How it works

• Custom items (all tagged with CustomModelData and given via /giveitems):
  • Shark Sword: on PvP hit applies a random 5s debuff (blind/poison/slow) with a 120s cooldown.
  • Squidward Flute: right-click spawns a hollow 15×15×6 glass bubble that auto-cleans after 15s; 60s cooldown.
  • Double Krabby Patty: right-click grants Regeneration IV (20s), Absorption V (2m), full food; item is not consumed; 90s cooldown.
  • Nemo Fins: when gliding with an elytra inside the region, clears blocks under you (no drops) and speed-boosts flight for a short window; blocks auto-restore to avoid grief; 30s cooldown.
  • Radioactive Boat: throwable that bursts with blindness+slow in a radius and green particles; 45s cooldown.
  • JetBoost Boots: right-click dash forward; 60s cooldown.
  • Harpoon: right-click throw that pulls a hit target and deals bonus damage; 60s cooldown.
  • Ocean Case: right-click to open an animated GUI and roll for configured OceanPvP rewards.
• Region locking: abilities only work inside the configured BoxPvP cuboid. Default region and cooldowns live in config.yml.
• No permanent world damage: glass traps and Nemo block breaking are reverted automatically after their timers.
• Per-player cooldowns: every ability tracks cooldowns separately per player.
• Shop NPC: optional invulnerable villager (configurable location) opens a GUI shop priced in a configurable currency item. Sells all OceanPvP items and Ocean Cases.
• Case system: GUI animation with weighted rewards from case.rewards; players receive the rolled item even if inventories are full (drops on ground if needed).

Configuration notes

• config.yml controls region bounds, all cooldowns, Nemo timings, harpoon/boat values, JetBoost power, shop currency/prices, NPC spawn point, and case reward weights/animation speed.
• Region enforcement uses world/min/max coordinates; set region.enabled to true and adjust bounds for your BoxPvP arena.
• NPC spawning is gated by shop.npc.enabled; set coordinates/yaw and ensure the world exists before enabling.

Output

• Built plugin jar: build/libs/OceanPvP-1.0.0.jar (sources jar alongside for reference).

Server Validation

✅ Server validation passed - The mod was tested on a real Minecraft server and loaded successfully.