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
AccountsPerPlayeraccounts 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.TrashDaysdays. - Blocking an account hides it both ways.
- New accounts get the default picture and header set in
config_server.lua(ServerConfig.Social.DefaultAvatarandDefaultBanner). 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
PostMaxLengthcharacters 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
StoryHourshours. 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
PinnedVideosof 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.AllowedHostsor 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
- The player creates a Flame account, then a profile: age (18 to 99), gender, who they want to see, a bio, up to
MaxPhotosphotos and up toMaxInterestsinterests fromInterests. - Discover shows profiles that match the age range and the gender they chose.
- Swipe: like, nope or super like. When two players like each other, it is a match and a Flame chat opens between them.
- 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,
GoldSuperLikessuper 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
LiveHourshours, 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
MaxImagespictures, a category and an optional price up toMaxPrice. - Posting costs
PostPrice, taken from the bank. If posting fails the fee is refunded. - A character can post
DailyLimitlistings 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
AccountsPerPlayeraccounts 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.
VerifyModeis'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.