Skip to main content
← Back

Cobblemon Karp of the Week NPC

CobblemonMinecraftMolangDatapackQuestNPC

A weekly Cobblemon quest built around the 31 Magikarp Jump forms. The Karp Collector NPC picks a form for the player each week, gives them a biome hint and a Journey task, and trades them 'Karp Coins' (KC) and shop unlocks when they bring the right karp back. Lifetime progress is tracked through milestone titles and cosmetic/tool unlocks. I made it to give players more of a reason to collect all 31 forms, and to add content specifically tied to fishing, which is usually my favorite activity in any game that adds it!

Karp Collector

First visit

The Karp Collector NPC offers a starter quest the first time the player interacts with it: bring me one normal Magikarp. On submission, the player receives 10KC, access to the shop, a warp unlock to the Collector's location, and entry to the weekly loop.

Weekly loop

Each week, the Collector picks a Jump form for the player. Selection prioritizes forms the player has not yet submitted. Once all 31 normal forms are in, selection switches to forms the player has not yet submitted a shiny version of. The player is given:

  • A description of the karp's appearance.
  • A biome hint pointing them toward where to find it.
  • A Journey task auto-assigned for tracking in /journal.

On submission, the Collector trades the player 5KC for a normal Magikarp, or 25KC for a shiny one. The form's trophy is also unlocked in the shop. Shiny submissions unlock both the normal and shiny trophies for that form.

The week resets at Sunday 00:00 server time for all players simultaneously. The default is UTC, but the timezone can be adjusted with an offset.

Rewards

The Karp Collector's shop is buy-only and gated by permissions granted as the player progresses. It is implemented in SkiesGUIs. The cosmetics and tools listed below are placeholders rather than functional items. (at time of writing)

  • Trophies (62 total, one per form, normal and shiny):
    • Normal: 4KC
    • Shiny: 20KC
  • Resources (ungated):
    • $1k: 1KC
    • IV Candy: 1KC
  • Cosmetics (unlocked at 5/10/15/20 unique forms submitted):
    • Fishing Boots: 4KC
    • Fishing Waders: 8KC
    • Fishing Vest: 12KC
    • Fishing Hat: 16KC
  • Tools:
    • Karp Rod: 20KC (unlocked at all 31 normal forms submitted)
    • Prismatic Rod: 40KC (unlocked at all 31 shiny forms submitted)

Titles

Lifetime weekly completions award milestone titles:

  • title.fisher on the first normal submission.
  • title.angler on the first shiny submission.
  • title.karp_collector for all 31 normal forms.
  • title.karp_connoisseur for all 31 shiny forms.
  • title.karp_cadet / crewman / commander / captain / colonel / king at 5, 10, 20, 30, 45, and 60 weekly completions.

Fish tank

A fish tank is built behind the Collector. As the player submits each form, that exact karp variant appears swimming in the tank, visible only to them via per-player NPC visibility. A completionist's tank shows all 31 forms swimming in their own personalized aquarium.

It should be noted that the fish tank can ship after the core quest, since the gating permission (npc.kotw.submitted.<aspect>) is set on submission whether or not any tank NPCs exist yet.

Special tools

The Karp Rod and Prismatic Rod are aspirational long-term goals, not yet implemented:

  • Karp Rod: Boosts the chance of reeling in a Jump form. Doubles the shiny chance on reeled-in Magikarps.
  • Prismatic Rod: Never reels in Magikarps. Doubles the shiny chance on every other reeled-in species.

These are intended to be rare endgame items. The Prismatic Rod especially requires every shiny form to unlock, which will take a dedicated player a year or more.

Techy Stuff

  • Built on Cobblemon's NPC, dialogue, and behaviour systems, configured in JSON.
  • Quest logic written in Molang. The weekly reset is gated by a next_reset_date string in q.player.data compared against q.date_is_after, rather than a server-wide cron job.
  • Form selection draws from the player's un-unlocked pool first, falling back to shinies-only once all normals are in, and then to anything once both sets are complete.
  • Server-side dependencies: Journey (task tracking and per-player visibility), LuckPerms (progression gates), Impactor (karp_coins currency), and SkiesGUIs (shop interface).
  • Trophies, the Karp Coin item, and the aquarium NPCs are modeled and textured in Blockbench as filament assets, served through Polymer so vanilla clients see them without installing a resourcepack.

It should be noted that the Fishing Cosmetics and Special Rods cannot be implemented purely via datapack and require a dedicated companion mod. Servers that do not want to install a sidemod can still ship the entire core quest, the shop, all 62 trophies, the titles, and the milestone system.

Built for the Callisto and Cobblewilds Cobblemon servers, but available for commission.