PHPackages                             xypp/forum-quests - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. xypp/forum-quests

ActiveFlarum-extension

xypp/forum-quests
=================

Add quests to the forum, and reward with money or other things

v2.0.4(1y ago)21.7k↓50%1[2 issues](https://github.com/zxy19/flarum-forum-quests/issues)[1 PRs](https://github.com/zxy19/flarum-forum-quests/pulls)MITPHP

Since Jul 24Pushed 1y ago1 watchersCompare

[ Source](https://github.com/zxy19/flarum-forum-quests)[ Packagist](https://packagist.org/packages/xypp/forum-quests)[ RSS](/packages/xypp-forum-quests/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (7)Versions (28)Used By (0)

Forum Quests
============

[](#forum-quests)

[![License](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667)](https://camo.githubusercontent.com/7013272bd27ece47364536a221edb554cd69683b68a46fc0ee96881174c4214c/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75652e737667) [![Latest Stable Version](https://camo.githubusercontent.com/6a18fb1d47cb8153ad8485015f55f1edfbb1eda6458f1ff4dc19f122cec3ebb1/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f787970702f666f72756d2d7175657374732e737667)](https://packagist.org/packages/xypp/forum-quests) [![Total Downloads](https://camo.githubusercontent.com/8d0689f050e94a95e03e379bc8325885f0c640631a504b2d5c1b76ca52316b6f/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f787970702f666f72756d2d7175657374732e737667)](https://packagist.org/packages/xypp/forum-quests)

A [Flarum](http://flarum.org) extension. Add quests to the forum, and reward with money or other things.

中文用户请参阅 [README-CN.md](README-CN.md)

Migration Guide
---------------

[](#migration-guide)

If you are upgrading from 1.x to 2.0, please follow the steps below

1. Backup your database
2. Disable this extension
3. Update the extension. You'll see our dependencies are also installed. If you are using `Collector` extension before, go to step 7.
4. Enable `Localize Date Lib` and configure Timezone
5. Enable `Collector` and check settings(Same as before by default)
6. Run `php flarum collector:migrate`. This command will copy all data from forum-quests database to collector.
7. Enable this extension

Simply Guide
------------

[](#simply-guide)

Go [Configure Before Usage](#configure-before-usage)

Description
-----------

[](#description)

[![Effect](https://camo.githubusercontent.com/f7e313b56f8af92da5db15667e87639293d65cee1da6d62c3363625e7ef81147/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f323831326238643338376637383362382e706e67)](https://camo.githubusercontent.com/f7e313b56f8af92da5db15667e87639293d65cee1da6d62c3363625e7ef81147/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f323831326238643338376637383362382e706e67)

This extension provided a data analysis system that tracks user's data when it changed and trigger the corresponding quests.

When a user satisfy the condition of a quest, it will be triggered and the quest will be done. The reward will be given to the user.

If re-available is set, when the time is up, the quest can be triggered again.

Features
--------

[](#features)

### Time Span

[](#time-span)

This extension allows you to use time span in condition. For example, "Post Count" > 0 in Span 1 means that the user must post at least one post this day. The time span is calculated by the timezone configured in admin panel.

### Re-Available

[](#re-available)

The quest is always supposed to be done multiple times, for example, once a day. You can use `re-available` option to make the quest to be available again after some time. The extension currently support re-available after a day(by timezone) or after certain hours(exact time).

### Frontend List and Hidden Item

[](#frontend-list-and-hidden-item)

This extension provides a frontend page for user to know what quest they are able to do. You can also hide the quest from the quest list until it is done.

Notice
------

[](#notice)

### About Recalculate Command

[](#about-recalculate-command)

This command will ask all conditions to be rebuilt from database. However some conditions have not recorded with time so they will lost all accumulation data after recalculate.

When you running `php flarum collector:recalculate` command, by default it will stop running and ask you to confirm when some conditions are not able to be rebuilt from database. If this is the first time you run this command, just type `y` to continue.Otherwise **Press Enter Or Type `n` to skip rebuilt** or you will lose all accumulation data and only get the total value of this condition.

### Refreshing after edit

[](#refreshing-after-edit)

If you change a quest's Re-Available from `once` to any other value, you may found that the users that had done the quest formerly was not able to do it again. That's because the extension will calculate the time user can do the quest again when they have just done it.

To fix the problem, rum `php flarum forum-quests:refresh`

### Configure before usage

[](#configure-before-usage)

After installing, there are still something you need to do.

If you haven't enable `Collector`

1. Enable `Localize Date Lib` and configure Timezone
2. Enable `Collector` and check settings(Same as before by default)

Then enable the extension.

### For Best Experience

[](#for-best-experience)

The quest done will notify the user by alert notification.

It will be better to work with following

- xypp/flarum-websocket-notification
- blomstra/realtime
- kyrne/websocket
- flarum/pusher

Installation
------------

[](#installation)

Install with composer:

**Please Read Install Guide [\#Configure before usage](#configure-before-usage)**

```
composer require xypp/forum-quests:"*"
```

Updating
--------

[](#updating)

**Please Read the [Migration Guide](#migration-guide) First Before Updating**

```
composer update xypp/forum-quests:"*"
php flarum migrate
php flarum collector:recalculate
php flarum cache:clear
```

Screenshots
-----------

[](#screenshots)

[![Quest List Page](https://camo.githubusercontent.com/e6471f69736ba46c75485294e279ba2fe6165bba073277fe5ccf0207bb4fa941/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f303933623337313866646531376239302e706e67)](https://camo.githubusercontent.com/e6471f69736ba46c75485294e279ba2fe6165bba073277fe5ccf0207bb4fa941/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f303933623337313866646531376239302e706e67)[![Add Quest Modal](https://camo.githubusercontent.com/32b0a426a173b29565df9c0973bc03c1ea823b0adad070cb5e1bf5ee8101799c/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f663536386162353861663530373031332e706e67)](https://camo.githubusercontent.com/32b0a426a173b29565df9c0973bc03c1ea823b0adad070cb5e1bf5ee8101799c/68747470733a2f2f63646e2d667573696f6e2e696d67696d672e63632f692f323032342f663536386162353861663530373031332e706e67)

Comparing to Achievements/AutoMod?
----------------------------------

[](#comparing-to-achievementsautomod)

This extension is designed for following targets that other extensions lacks:

- Metric Pre Day
- One-time trigger(No leave event)
- Multiple times
- Frontend List

Integration
-----------

[](#integration)

The extension natively provides the following Conditions/Rewards.

**Conditions**

- Post Count(core)
- Discussion Count(core)
- Change Email(core)
- Change Avatar(core)
- User Page Visit(core)
- Page Reloads(core)
- Discussion Replied(core)
- Like Received(flarum/likes)
- Like Sent(flarum/likes)
- Store Purchased(xypp/store)
- Discussion was view(michaelbelgium/flarum-discussion-views)
- Badge Received(v17development/flarum-user-badges)
- Money(AntoineFr/money)

**Rewards**

- Money(AntoineFr/money)
- Store Item(xypp/store)
- Badge(v17development/flarum-user-badges)

**From Other Extensions**

- foskym/flarum-custom-levels: Reward with exp.
- xypp/flarum-invite-user: Conditions of invitation

Links
-----

[](#links)

- [Packagist](https://packagist.org/packages/xypp/forum-quests)
- [GitHub](https://github.com/zxy19/flarum-forum-quests)

###  Health Score

27

—

LowBetter than 49% of packages

Maintenance18

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~3 days

Recently: every ~9 days

Total

27

Last Release

570d ago

Major Versions

v0.2.4 → v1.0.02024-08-28

v1.0.0 → v2.0.02024-09-11

### Community

Maintainers

![](https://www.gravatar.com/avatar/ac2785bf6307ee44bd2fdeba70cf00f77f0fe9eb7e5b70e3fbe40a25f6ab61c4?d=identicon)[zxy19](/maintainers/zxy19)

---

Top Contributors

[![zxy19](https://avatars.githubusercontent.com/u/23428495?v=4)](https://github.com/zxy19 "zxy19 (31 commits)")

---

Tags

flarum

### Embed Badge

![Health badge](/badges/xypp-forum-quests/health.svg)

```
[![Health](https://phpackages.com/badges/xypp-forum-quests/health.svg)](https://phpackages.com/packages/xypp-forum-quests)
```

###  Alternatives

[fof/upload

The file upload extension for the Flarum forum with insane intelligence.

188171.7k15](/packages/fof-upload)[fof/byobu

Well integrated, advanced private discussions.

61105.8k9](/packages/fof-byobu)[fof/gamification

Upvotes and downvotes for your Flarum community

4157.1k6](/packages/fof-gamification)[fof/user-bio

Add a user bio to user profiles

2196.5k9](/packages/fof-user-bio)[flarum-lang/russian

Russian language pack for Flarum.

13126.1k](/packages/flarum-lang-russian)[fof/drafts

Allow users to create post and discussion drafts

1771.1k5](/packages/fof-drafts)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)