xxb5724/catch-the-fish

Watch your users catch as many fishes as they can.

2.0.0 2026-07-30 16:26 UTC

Requires

• ext-json: *
• flarum/core: ^2.0

MIT

• Clark Winkelmann
• Xiaoxiaobai5724

• extension
• flarum
• MiniGame
• april-fools

Published on Packagist.org on 2026-07-30 16:30 UTC

README

A Flarum 2.0 extension. This extension is a fun experiment that adds a minigame to Flarum.

Once enabled, admins or mods can create fish catching rounds.

The fishes will appear on the forum and users compete to catch as many as they can.

It includes many customization options. You can let users change the fish names or choose the placement of the fish themselves.

All aspects of the game are controlled via Flarum permissions.

The extension comes with a starting pack of (public domain image) fish that you can include when creating a new round.

Installation

Installing with Composer:

composer require xxb5724/catch-the-fish

Migrating from clarkwinkelmann/catch-the-fish This extension was transferred to XXB and was previously published as clarkwinkelmann/catch-the-fish. The XXB line begins at 2.0.0, continuing the version history (the previous package reached 1.1.4). For forum admins, migration is a one-line change — swap the package, keep your settings and stored SEO data:

composer remove clarkwinkelmann/catch-the-fish
composer require xxb5724/catch-the-fish
php flarum cache:clear

Upgrade

composer update xxb5724/catch-the-fish
php flarum cache:clear

Configuration

You will find the settings for this extension in 3 different places:

• Extension settings page: global day-based, minute-based and animation settings, as well as probabilities for automatic fish placement and discussion tags whitelist
• Flarum permissions: all access related settings
• Front end page (not in admin): Round and fish configuration

New improvements

The 'Fish Basket' feature from clarkwinkelmann/catch-the-fish wasn’t compatible with mobile, but now it is. Mobile users can choose where to store their fish after catching them. When you go back to the bottom of the homepage, there’s a 'Fish Basket.' Open any discussion or post, select a fish from the basket, and then click anywhere to place it.