The Sngine Live Addon connects your Sngine website to the self-hosted live server and adds the full live broadcasting experience inside Sngine.

This addon handles the Sngine-side flow: create live pages, watch pages, embedded live player, realtime comments, reactions, gifts, moderation, top supporters, recorded replay sync, and admin controls. It works with the Fluttercrafters live server and can also let the admin keep the legacy Agora mode enabled when needed.

Sngine Addon Live Pages Comments + Reactions Gifts + Earnings Moderation Replay Sync
Open Demo Server Docs

Folder Structure

includes/Core helper functions, API bridge, and the Live client class.
apis/live/Addon AJAX and API endpoints for create, stop, gift, token, and related flows.
templates/Create live page, watch page, lightbox, admin widgets, and UI components.
assets/js/live.jsFrontend live player behavior, comments, reactions, gifts, sockets, and UI sync.
assets/css/live.cssLive page, watch page, and producer layout styles.
admin.phpMain addon admin dashboard for Sngine-side connection and gift controls.

Install the Addon in Sngine

If you want the addon files through the same protected purchase-code flow, use the addon installer command below on your Sngine server.

wget -O install-sngine-live-addon.sh https://sngine-live.fluttercrafters.com/install-sngine-live-addon.sh
bash install-sngine-live-addon.sh \
  --purchase-code=YOUR_PURCHASE_CODE \
  --domain=app.example.com \
  --target=/var/www/html
  1. Copy the fluttercrafters-livestream/ folder into the root of your Sngine website.
  2. Import the SQL file: fluttercrafters-livestream/install.sql.
  3. Open the Sngine admin area and go to the Fluttercrafters Livestream card.
  4. Open /fluttercrafters-livestream/admin or /fluttercrafters-livestream/admin.php.
  5. Save the live server API URL, API key, API secret, and the runtime endpoints.
cp -R fluttercrafters-livestream /path/to/sngine-root/
# then import fluttercrafters-livestream/install.sql into your Sngine database
The addon is the Sngine connector only. The separate live server remains the realtime and media core. Both the live server package and the addon package are protected by the same purchase code workflow.

Database Tables Added by the Addon

sngine_live_settingsCore addon settings, provider mode, audience rules, and endpoint values.
sngine_live_postsLinks Sngine posts to live streams, stream keys, watch URLs, and replay URLs.
sngine_live_giftsStores sent gifts, commission, creator earnings, and balance snapshots.
sngine_live_gift_catalogGift list, prices, icons, image URLs, and optional sound URLs.
sngine_live_gift_settingsGift enablement, currency source, creator payout target, and platform commission.
sngine_live_reactionsRealtime live reaction events such as hearts.
sngine_live_post_settingsPer-post live comment status and pinned comment state.
sngine_live_mutesMuted users per live post.

Sngine Addon Admin Panel

The addon admin dashboard is organized for connection settings, gifts, logs, and editable quick links.

DashboardOverview, shortcuts, and runtime status.
Core ConnectionLive API URL, API key, secret, provider mode, and live endpoints.
Gift CatalogGift pricing, sounds, icons, commission, and platform earning rules.
ActivityRecent gift events and revenue flow.
Server EndpointsSocket.IO, WebRTC, RTMP, and live server dashboard destination.
Docs LinksQuick access to server docs and addon docs.

Provider Selection

The addon lets the admin decide which live provider users should see. This is controlled from the Sngine addon admin panel, not by end users.

  • Fluttercrafters Live Pro: uses your self-hosted server, WebRTC, RTMP, recording, gifts, and the advanced live flow.
  • Sngine Agora Live: keeps compatibility with the older Agora-based live mode if you still need it.

Audience Requirement Rules

You can define who is allowed to go live from the addon admin panel.

  • No minimum requirement: anyone eligible in Sngine can go live.
  • Followers only: user must have at least the configured follower count.
  • Friends only: user must have at least the configured friend count.
  • Followers or friends: reaching either one is enough.
  • Followers and friends: both thresholds must be reached.

The addon reads Sngine's own follower and friend system. Setting the threshold to 0 means that side of the rule is effectively not restricting anyone.

Live Features Inside Sngine

Create Live PageProducer view with preview, chat, gifts, top supporters, and publish controls.
Watch PageViewer watch experience with live chat, reactions, gifts, and replay support.
Pinned CommentsBroadcaster can pin a comment at the top of live chat.
Mute UsersBroadcaster can mute viewers and review the muted list.
Disable CommentsBroadcaster can turn off comments for a live post.
Viewer CountLive viewer count is kept in sync through the realtime layer.
Live ReactionsHeart bursts and reaction activity can be broadcast to all viewers.
Top SupportersSupporters and gift totals remain linked to the live post.
Replay SyncWhen recording is saved, the replay URL is synced back to the Sngine post.

Gifts, Earnings, and Platform Profit

The addon includes a full live gift system with a catalog, price management, creator earnings, and platform commission.

  • Gift catalog supports icon, image URL, sound URL, price, and sort order.
  • Gift purchases can use wallet or points, depending on the admin setting.
  • Creator earnings can go to wallet or monetization balance, depending on the chosen payout target.
  • Platform commission percentage is stored and tracked per gift transaction.
  • Logs record sender balance, receiver balance, commission, and net creator earning.