PHPackages                             ygpynet/point-system - 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. ygpynet/point-system

ActiveFlarum-extension

ygpynet/point-system
====================

Points, avatar frames and group tiers for Flarum 2

v1.0.0(today)00MITPHPCI passing

Since Aug 24Pushed todayCompare

[ Source](https://github.com/ygpynet/point-system)[ Packagist](https://packagist.org/packages/ygpynet/point-system)[ RSS](/packages/ygpynet-point-system/feed)WikiDiscussions main Synced today

READMEChangelogDependencies (4)Versions (2)Used By (0)

 [![Point System](icon.svg)](icon.svg)

Point System
============

[](#point-system)

 [![CI](https://camo.githubusercontent.com/b4601349d97586b26e7e78aa4a58c51c38e97f501cdb7ac3c8057c26817f1077/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f72616d306e67312f706f696e742d73797374656d2f63692e796d6c3f6272616e63683d6d61696e267374796c653d666c61742d737175617265266c6162656c3d6369)](https://github.com/ram0ng1/point-system/actions/workflows/ci.yml) [![Packagist](https://camo.githubusercontent.com/4abc60c57a44770db3937f4c6d136d79c8db5184fcb26fb98ca005dac5988a00/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f72616d6f6e2f706f696e742d73797374656d3f7374796c653d666c61742d737175617265266c6162656c3d7061636b6167697374)](https://packagist.org/packages/ramon/point-system) [![Downloads](https://camo.githubusercontent.com/3d8850ef806e2e7027114b7ece14db9be1e474d249345073993175edf5959b8e/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f72616d6f6e2f706f696e742d73797374656d3f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ramon/point-system) [![Flarum](https://camo.githubusercontent.com/a132223aa88aa88b24ad5a6117fada567e8f9ce7e6423e24fbe2d77c9b1b9c64/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d322e782d6537363732653f7374796c653d666c61742d737175617265)](https://camo.githubusercontent.com/a132223aa88aa88b24ad5a6117fada567e8f9ce7e6423e24fbe2d77c9b1b9c64/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f666c6172756d2d322e782d6537363732653f7374796c653d666c61742d737175617265) [![License](https://camo.githubusercontent.com/ac049ef4e7a0b7196b09add6ac2d4f180e544c0ac779c2b2ac2fd2723a209579/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d626c75653f7374796c653d666c61742d737175617265)](LICENSE.md) [![Donate](https://camo.githubusercontent.com/26680fc470ae1a7cdffd5e21e44f49eadfd6b9f9358a874c44405609d35ac325/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f646f6e6174652d7374726970652d3637373245353f7374796c653d666c61742d737175617265)](https://donate.stripe.com/fZe5o66nebkf39S28a)

Points, frames and flair. A small economy for your Flarum community.

Point System turns activity into currency. Users earn points for posting, getting likes, logging in and signing up, then spend them in a shop on avatar frames, username styles, profile covers, titles and post highlights. Admins control the catalog, the prices and every earning rule.

It scales with how much you want to run. Keep it to a simple earn and spend loop, or open the whole thing up: let users design and submit their own decorations for approval, let them trade items and points with each other, put stock limits and sale windows on the catalog, and sell permanent group access alongside it.

What it does
------------

[](#what-it-does)

- Points for discussions, replies, likes given and received, daily logins and sign ups, each rule configurable
- Two balances per user: lifetime earned and spendable, with lifetime optionally hidden
- Five decoration families — avatar frames, username styles, profile covers, titles and post highlights — each with its own master switch
- 25 built in username styles and 10 post highlight presets, plus a free form CSS editor with keyframes when you want your own
- Group tiers unlocked automatically at a lifetime threshold, bought outright with points, or both
- Player to player trading of items and points, with both sides required to accept and an admin dashboard that can revert a completed trade
- User submitted decorations with an admin moderation queue, so the catalog can grow without you drawing every frame
- Stock limits, sale windows and per group restrictions on any shop item
- Admin tools for manual credit and debit with reasons, plus a bulk award to every user at once
- Notifications when points change, a tier is joined, an item is granted or a trade moves, websocket pushed if `flarum/realtime` is around
- Plays nice with `flarum/gdpr` for export, anonymization and erasure

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

[](#installation)

```
composer require ramon/point-system
php flarum migrate
php flarum cache:clear
```

Enable Point System on the Extensions page. Rules, catalog, tiers, the moderation queue and permissions are all managed in the admin panel, each option explained in place.

Optional companions: `flarum/likes` unlocks the like related rules, `flarum/realtime` makes notifications land instantly, and `flarum/gdpr` wires points and trades into data export and erasure.

Good to know
------------

[](#good-to-know)

- Users get three pages: `/rewards` to spend, `/decorations` to equip what they own, and `/trades` for exchanges. All three respect permissions, so you can open the shop to everyone and keep trading to a single group.
- Custom CSS on decorations is sanitized twice, on save and again on output. An allowlist strips the primitives that break out of a stylesheet, and it runs on serialization too, so rows written before the hardening are neutralized without a backfill.
- Points never move outside a transaction. Claiming, trading and manual adjustments all commit or roll back as a unit, so a failure mid flow cannot leave a balance debited with nothing delivered.
- Everything the frontend does goes through the `/api/point-system/*` endpoints, and seven events fire on every change, so other extensions can react or drive the economy from outside.

License
-------

[](#license)

[MIT](LICENSE.md). Suggestions and bug reports go in the [issue tracker](https://github.com/ram0ng1/point-system/issues).

###  Health Score

36

—

LowBetter than 79% of packages

Maintenance100

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 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

Unknown

Total

1

Last Release

0d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/222663501?v=4)[ygpynet](/maintainers/ygpynet)[@ygpynet](https://github.com/ygpynet)

---

Top Contributors

[![ygpynet](https://avatars.githubusercontent.com/u/222663501?v=4)](https://github.com/ygpynet "ygpynet (1 commits)")

---

Tags

shopavatarflarumGamificationpointsdecorationauto-group

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ygpynet-point-system/health.svg)

```
[![Health](https://phpackages.com/badges/ygpynet-point-system/health.svg)](https://phpackages.com/packages/ygpynet-point-system)
```

###  Alternatives

[flarum-lang/russian

Russian language pack for Flarum.

13129.1k](/packages/flarum-lang-russian)[flarum-lang/french

French language pack to localize the Flarum forum software plus its official and third-party extensions.

1941.0k](/packages/flarum-lang-french)[fof/gamification

Upvotes and downvotes for your Flarum community

4168.0k10](/packages/fof-gamification)[fof/discussion-language

Specify the language a discussion is written in &amp; sort by language

1035.6k7](/packages/fof-discussion-language)

PHPackages © 2026

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