Social features and community analytics

Social features and community analytics

This page documents the current Mediabot v3 social and community-analysis layer.

These commands turn existing IRC data into lightweight portraits, dashboards, games, timelines, achievements and channel diagnostics.

No extra database schema is required beyond the current reference schema. The commands read existing data such as CHANNEL_LOG, KARMA, KARMA_LOG, TRIVIA_SCORES, QUOTES, CHANSET_LIST, CHANNEL_SET, the achievements JSON store, and runtime memory.

---

Quick command map

Command	Aliases	Purpose
`achievements [nick	list	all
profil [nick]	profile	Show a compact channel profile for a nick.
radar [Nd]		Show current or historical activity signals.
dashboard	chanstats	Show a compact dashboard for the current channel.
leaderboard [category] [period]	lb	Show rankings for messages, karma, trivia, duels and achievements.
`chronos [short	full]`	chrono, timeline
features	capabilities, caps	Show channel capabilities and key chanset state by NOTICE.
observatory	obs	Show a compact live channel/bot status view.
mood	ambiance	Read the current channel mood from recent messages.
duel <nick>		Challenge a present nick to a d20 duel.
horoscope [nick]	horo	Show a deterministic daily IRC horoscope.
compat <nick1> [nick2]	affinity	Compare IRC affinity between two nicks.
`quotegame [stop	top]`	qg

---

Channel feature flags

Some public behavior is controlled per channel through chansets.

+AchievementAnnounce

Controls public achievement unlock announcements.

When disabled, achievements still unlock and persist silently.

chanset #channel +AchievementAnnounce
chanset #channel -AchievementAnnounce

+Games

Controls playful public commands such as:

• duel
• horoscope
• compat
• quotegame

chanset #channel +Games
chanset #channel -Games

---

Achievements

achievements
achievements Te[u]K
achievements list
achievements top

Achievements are persisted in JSON and can be unlocked through normal channel activity, karma, trivia, wordcount, duels, quote games and other social features.

Public announcements are controlled by +AchievementAnnounce.

---

Profiles and activity views

profil

profil
profil Te[u]K

Shows a compact channel profile for a nick:

• first/last seen;
• message count;
• channel rank;
• karma;
• trivia score;
• activity pattern;
• achievement count.

radar

radar
radar 7d

Shows activity signals such as channel activity, newcomers, silent users and notable recent patterns.

dashboard

dashboard
chanstats

Shows a compact channel dashboard with messages, active nicks, top contributors, activity shapes, karma and achievements.

---

Leaderboard

leaderboard
leaderboard msgs
leaderboard karma
leaderboard trivia
leaderboard duels
leaderboard achievs

Recent period filters are supported when the underlying data has a reliable timestamp:

leaderboard 24h
leaderboard 7d
leaderboard 30d
leaderboard msgs 7d
leaderboard karma 7d

Period filters currently apply to:

• msgs through CHANNEL_LOG.ts;
• karma through KARMA_LOG.ts.

Other categories are all-time only.

---

Chronos

chronos
chronos short
chronos full
chrono short
timeline full

chronos turns channel history into a timeline.

• short gives a compact summary;
• full gives the narrative version.

---

Features and observatory

features

features
capabilities
caps

Shows channel capabilities and important chanset state by NOTICE to the requester.

Useful to understand why a feature is enabled or silent on a channel.

observatory

observatory
obs

Shows a compact public view of the current channel and bot state:

• uptime;
• last-hour activity;
• energy level;
• games status;
• achievement status;
• announcement status;
• selected chansets;
• metrics status.

---

Mood

mood
ambiance

Analyzes recent public messages to provide a playful summary of channel energy and mood.

This is not a moderation decision engine. It is a lightweight social signal.

---

Games

Duel

duel SomeNick
duel stats
duel top

Challenges a present nick to a d20 duel. Duel wins/losses can unlock achievements.

Horoscope

horoscope
horoscope SomeNick

Produces a deterministic daily IRC horoscope.

Compatibility

compat NickA NickB
affinity NickA NickB

Compares two nicks using IRC-derived signals such as overlap and interaction.

Quote game

quotegame
quotegame top
quotegame stop

Starts a quote guessing game from stored quotes. The game now uses a proactive 60-second timer and announces the answer if nobody wins.

---

Help topics

Useful help commands:

help social
help games
help chansets
help features
help observatory
help leaderboard
help quotegame

---

Operator notes

These features are designed to be fun but not noisy.

Recommended defaults for a new or quiet channel:

chanset #channel +Games
chanset #channel -AchievementAnnounce

Enable +AchievementAnnounce only where public achievement messages are welcome.