Features

Social apps

Chirp, Pixl, TikKok, Snap, Ask, Flame, News and Marketplace.

The social apps, the dating app, News and Marketplace. All of them are in the App Store and none is installed on a new phone; players install the ones they want.

App What it is Config
Chirp Short posts, replies, reposts, polls Config.Social
Pixl Photo and video posts, private accounts, stories Config.Social
TikKok Short vertical videos: For You / Following, saves, reposts, pinned videos, inbox, discover (app id clips) Config.Social
Snap Photos and videos that open once, between friends, with streaks Config.Social
Ask Questions to an account, answered in public Config.Social
Flame Dating: swipe, match, chat Config.Dating, Config.Social
News Stories published by a news job Config.News
Marketplace Classified listings with the seller's number Config.Marketplace

Live streams have their own page: Live.

#Accounts

Chirp, Pixl, TikKok, Snap, Ask and Flame use accounts, not the phone number. Each app has its own accounts.

  • An account has a username (3 to 20 lower case letters, digits, _ or .), a password (4 to 32 characters), a display name, a bio, a picture and a header.
  • A character can create AccountsPerPlayer accounts in each app.
  • The password is the key. Anyone who knows it can log in to the account on their own phone. A player switches between their own accounts without the password.
  • Changing the password logs the account out everywhere. Deleting an account needs the password; it then stays in the admin tablet's trash for Config.Admin.TrashDays days.
  • Blocking an account hides it both ways.
  • New accounts get the default picture and header set in config_server.lua (ServerConfig.Social.DefaultAvatar and DefaultBanner). Left empty, the app shows initials and a plain header.

#The verified badge

VerifyMode decides how an account gets the badge:

Value How
'admin' Only staff give it, from the admin tablet
'purchase' The player buys it in the app for VerifiedPrice, paid from the bank. It lasts VerifyDays days; buying again adds the days on top
'followers' Given by itself when the account reaches VerifyFollowers followers. It lasts VerifyDays days
'purchase_or_followers' Both of the above

Staff can always give or take the badge on the tablet, also for good. Scripts use SetSocialVerified, see Server exports: social.

#Options (Config.Social)

Option Default What it does
VerifiedPrice 10000 Price of the badge for VerifyDays days
GoldPrice 10000 Price of Flame Gold (see Flame below)
PostMaxLength 280 Characters in a Chirp post. Pixl and TikKok captions allow 2200
BioMaxLength 80 Characters in a bio
AccountsPerPlayer 3 Accounts one character can create in each app
StoryHours 24 Hours a Pixl story stays up
VerifyMode 'purchase' How accounts get the badge, see above
VerifyFollowers 500 Followers needed in the 'followers' modes
VerifyDays 30 How long a badge lasts
PinnedVideos 3 TikKok videos an account can pin to the top of its profile (0 turns pinning off)

The admin tablet can change VerifiedPrice, GoldPrice, PostMaxLength, BioMaxLength, AccountsPerPlayer, StoryHours and the four Verify values while the server runs. Config.Social.SwipeLimit is only a fallback: Flame's limit is Config.Dating.SwipeLimit, and Social.SwipeLimit is used when that one is left out.

#Chirp

Short posts, like a microblog.

  • A post holds up to PostMaxLength characters and up to 4 pictures, videos or GIFs.
  • Like, repost, reply, comment (up to 500 characters) and like comments.
  • Polls: 2 to 4 choices of up to 25 characters, open for 1 hour, 6 hours, 1 day, 3 days or 7 days.
  • Feeds: home (people you follow), explore, hashtags, a profile, liked posts, and the trending hashtags of the last 24 hours.
  • Likes, replies, reposts, comments, mentions and new followers give a notification.

#Pixl

Photo and video posts with captions up to 2200 characters.

  • Private accounts. Only approved followers see the posts. Switching back to public lets every waiting request in.
  • Stories. A picture that stays up StoryHours hours. One account can have 20 stories up at once. The owner sees who viewed each one.

#TikKok

Short vertical videos (the app id is clips). Videos only, captions up to 2200 characters. The longest video the camera records is Config.Limits.VideoSeconds (default 30).

  • Feed. Two tabs: For You (everyone's videos, newer and well-liked ones first) and Following. One video per screen; swipe, drag with the mouse, turn the wheel (one notch, one video) or use the arrow keys. Tap pauses, a double tap likes. The thin bar at the bottom scrubs. The sound setting is remembered on the phone.
  • Rail. Follow the author, sound on/off, like, comments, bookmark (save), repost, share. The sound line reads "Original sound - {author}": there is no music library.
  • Profile. Following / Followers / Likes received, and four tabs: videos, reposts, liked, saved. Saved videos are private (only the owner sees the tab, nobody is notified). Up to PinnedVideos of one's own videos can be pinned to the top of the grid (Share, then Pin). Grid tiles show the play count.
  • Inbox. Activity (likes, comments, follows, mentions), direct messages (the shared social DMs) and suggested accounts: accounts the viewer does not follow, most followed first. Dismissing a suggestion is kept on that phone.
  • Share. Pick up to 10 accounts and send them the video as a message card that opens it. The same sheet copies the caption, pins or deletes one's own video, or reports and blocks.
  • Discover. Search accounts, hashtags and videos by caption; trending hashtags of the last day; the most liked videos of the last two weeks.
  • Create. Gallery, Camera or Link, then caption and hashtags. A link is only accepted from the server's allowed upload hosts (ServerConfig.Upload.AllowedHosts or the upload provider), the same rule as every post.
  • Guide. The "i" on the feed (and the profile menu) opens a short guide with an FAQ inside the app.

Options: Config.Social.PinnedVideos (default 3, 0 turns pinning off).

#Snap

Photos and videos that open once.

  • Friends are accounts that follow each other. Snaps only go to friends; a one-way follow shows up as a friend request.
  • A snap goes to up to 20 friends at once, with a caption of up to 80 characters, and shows for 1 to 10 seconds.
  • It opens once. The receiver can replay the last one once, within 10 minutes.
  • Streaks. When both friends send each other a snap on the same day, the streak grows by one. A day missed starts it over.
  • The sender sees when a snap was opened.

#Ask

Players send questions to an account; the account owner answers them in public.

  • Questions up to 300 characters, answers up to 1000 characters, with an optional picture.
  • A question can be sent anonymously. The receiver does not see who asked.
  • One character can send 10 questions a day to the same account.
  • Unanswered questions stay in the owner's inbox. Answered ones appear on the profile and in the feeds, and can be liked.

#Flame

A dating app. Players make a profile, swipe through others and chat once both liked each other.

#How it works

  1. The player creates a Flame account, then a profile: age (18 to 99), gender, who they want to see, a bio, up to MaxPhotos photos and up to MaxInterests interests from Interests.
  2. Discover shows profiles that match the age range and the gender they chose.
  3. Swipe: like, nope or super like. When two players like each other, it is a match and a Flame chat opens between them.
  4. Unmatch or block ends the match and deletes the chat for both.

Counters reset at midnight server time. Without Gold a player has SwipeLimit swipes and SuperLikesPerDay super likes per day, and can undo the last swipe within UndoSeconds seconds. Everyone sees how many people liked them; only Gold shows who.

#Flame Gold

Bought in the app for Config.Social.GoldPrice, paid from the bank. It lasts GoldDays days; buying again adds the days on top. With Gold:

  • no swipe limit,
  • GoldSuperLikes super likes per day,
  • the list of who liked you, with a live notice for each new like,
  • undo at any time.

#Options (Config.Dating)

Option Default What it does
SwipeLimit 50 Swipes per day without Gold. The admin tablet can change it
SuperLikesPerDay 1 Super likes per day without Gold
GoldSuperLikes 5 Super likes per day with Gold
GoldDays 30 Days one Gold purchase lasts
UndoSeconds 10 Seconds in which the last swipe can be undone without Gold
MaxPhotos 6 Photos on a profile
MaxInterests 5 Interests on a profile
SwipeDays 30 Used as Config.Retention.swipes when that key is missing
Interests 16 ids Interest ids. The names are in the locale under flame.interests

Swipes older than Config.Retention.swipes days (default 30) are deleted, so those people show up in Discover again.

#News

A newspaper app. Players of a news job publish stories; everyone reads them.

  • A story has a title (up to 100 characters), a text (up to 4000), an optional picture and a section from Categories.
  • A story can be marked live. It keeps its LIVE badge for LiveHours hours, unless the newsroom edits it and switches live off sooner.
  • Every new story is shown as a notification to everyone online who has not switched News notifications off.
  • Authors can always edit and delete their own stories. Anyone with the job and the grade can edit and delete every story of that job.

#Options (Config.News)

Option Default What it does
Jobs { weazel = 0, lifeinvader = 0 } Job name = lowest grade allowed to publish. Set it to your server's news jobs. The admin tablet can change it
Categories 'city', 'crime', 'politics', 'economy', 'traffic', 'weather', 'sports', 'entertainment' Sections. The first one is the default. Names are in the locale under news.categories.<id>
LiveHours 3 Hours the LIVE badge stays on
Config.Retention.news 90 Days before stories are deleted

#Marketplace

Classified ads. A listing shows the seller's name and phone number, so buyers call or text them.

  • A listing has a title (up to 60 characters), a text (up to 500), up to MaxImages pictures, a category and an optional price up to MaxPrice.
  • Posting costs PostPrice, taken from the bank. If posting fails the fee is refunded.
  • A character can post DailyLimit listings in 24 hours, deleted ones included.
  • Sellers delete their own listings. Anyone can report a listing; staff handle reports on the admin tablet.

#Options (Config.Marketplace)

Option Default What it does
Categories { 'vehicle', 'food', 'house', 'item', 'job', 'service' } Category ids. Names are in the locale
PostPrice 250 Fee per listing. 0 makes posting free
DailyLimit 5 Listings per character in 24 hours
MaxImages 3 Pictures per listing
MaxPrice 100000000 Highest asking price
Config.Retention.listings 3 Days before listings are deleted

The admin tablet can change Categories, PostPrice, DailyLimit and MaxImages while the server runs.

#Retention

The daily clean-up at 04:00 server time deletes old rows. 0 keeps everything.

Key Default What is deleted
posts 90 Chirp, Pixl and TikKok posts
stories 1 Expired and deleted Pixl stories (they are also removed every hour)
snaps 30 Snaps, opened or not
swipes 30 Flame swipes
messages 30 Direct messages in the social apps and Flame chats
news 90 News stories
listings 3 Marketplace listings

#Good to know

  • "Limit" when creating an account. The character already has AccountsPerPlayer accounts in that app. A deleted account no longer counts, but its username stays taken.
  • Someone else is using my account. They know the password. Change it: that logs out every phone.
  • Buy button for the badge is missing. VerifyMode is 'admin' or 'followers', which do not sell it.
  • Snap says "not a friend". Snaps only go to accounts that follow each other.
  • A News reporter cannot publish. Their job is not in Config.News.Jobs, or their grade is below the number given there.
  • Pictures refused. Every image link must be on a host in ServerConfig.Upload.AllowedHosts.
  • Marketplace listings disappear after three days. That is Config.Retention.listings. Raise it to keep them longer.