ramon/point-system

Points, avatar frames and group tiers for Flarum 2

v2.1.5 2026-06-25 00:35 UTC

Requires

• flarum/core: ^2.0.0

Requires (Dev)

• flarum/realtime: ^2.0.0

MIT

• Ramon Guilherme

• shop
• avatar
• Gamification
• points
• decoration
• flarum
• auto-group

README

Point System

Points, frames and flair. Gamification for Flarum 2.

Point System turns activity into a small economy. Users earn points for posting, getting likes, logging in and signing up, then spend them on avatar frames, animated username styles and permanent group tiers. Admins control the catalog, the prices and every earning rule.

There are 24 built in username decorations, from gold and neon to glitch and rainbow, plus a free form CSS editor with keyframes support when you want to design your own. Everything previews live before anyone spends a point.

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
• Avatar frames in PNG, APNG, GIF or WebP, rendered everywhere the avatar appears
• Username decorations with live preview in the shop, in the admin form and in the post stream
• Group tiers purchasable with points, attached permanently on claim
• Admin tools for manual credit and debit with reasons, plus a users panel with search and sorting
• Notifications when points change or a tier is joined, websocket pushed if flarum/realtime is around
• Events fired on every change, so other extensions can react

Installation

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

Enable Point System on the Extensions page. Rules, catalog, tiers and permissions are all managed in the admin panel.

Optional companions: flarum/likes unlocks the like related rules and flarum/realtime makes notifications land in real time.

License

MIT. Suggestions and bug reports go in the issue tracker.