• Log InLog In
  • Register
Liquid`
Team Liquid Liquipedia
EDT 17:42
CEST 23:42
KST 06:42
  • Home
  • Forum
  • Calendar
  • Streams
  • Liquipedia
  • Features
  • Store
  • EPT
  • TL+
  • StarCraft 2
  • Brood War
  • Smash
  • Heroes
  • Counter-Strike
  • Overwatch
  • Liquibet
  • Fantasy StarCraft
  • TLPD
  • StarCraft 2
  • Brood War
  • Blogs
Forum Sidebar
Events/Features
News
Featured News
RSL Season 1 - Final Week6[ASL19] Finals Recap: Standing Tall15HomeStory Cup 27 - Info & Preview18Classic wins Code S Season 2 (2025)16Code S RO4 & Finals Preview: herO, Rogue, Classic, GuMiho0
Community News
Esports World Cup 2025 - Brackets Revealed14Weekly Cups (July 7-13): Classic continues to roll8Team TLMC #5 - Submission extension3Firefly given lifetime ban by ESIC following match-fixing investigation17$25,000 Streamerzone StarCraft Pro Series announced7
StarCraft 2
General
RSL Revival patreon money discussion thread Weekly Cups (July 7-13): Classic continues to roll Who will win EWC 2025? The GOAT ranking of GOAT rankings Esports World Cup 2025 - Final Player Roster
Tourneys
FEL Cracov 2025 (July 27) - $8000 live event Sea Duckling Open (Global, Bronze-Diamond) RSL: Revival, a new crowdfunded tournament series $5,100+ SEL Season 2 Championship (SC: Evo) WardiTV Mondays
Strategy
How did i lose this ZvP, whats the proper response
Custom Maps
External Content
Mutation # 482 Wheel of Misfortune Mutation # 481 Fear and Lava Mutation # 480 Moths to the Flame Mutation # 479 Worn Out Welcome
Brood War
General
Flash Announces (and Retracts) Hiatus From ASL [ASL19] Finals Recap: Standing Tall BGH Auto Balance -> http://bghmmr.eu/ BW General Discussion Help: rep cant save
Tourneys
Cosmonarchy Pro Showmatches CSL Xiamen International Invitational [Megathread] Daily Proleagues [BSL20] Non-Korean Championship 4x BSL + 4x China
Strategy
Simple Questions, Simple Answers I am doing this better than progamers do.
Other Games
General Games
Stormgate/Frost Giant Megathread Path of Exile Nintendo Switch Thread CCLP - Command & Conquer League Project The PlayStation 5
Dota 2
Official 'what is Dota anymore' discussion
League of Legends
Heroes of the Storm
Simple Questions, Simple Answers Heroes of the Storm 2.0
Hearthstone
Heroes of StarCraft mini-set
TL Mafia
TL Mafia Community Thread Vanilla Mini Mafia
Community
General
US Politics Mega-thread Things Aren’t Peaceful in Palestine Russo-Ukrainian War Thread Stop Killing Games - European Citizens Initiative Summer Games Done Quick 2025!
Fan Clubs
SKT1 Classic Fan Club! Maru Fan Club
Media & Entertainment
[Manga] One Piece Movie Discussion! Anime Discussion Thread [\m/] Heavy Metal Thread
Sports
2024 - 2025 Football Thread Formula 1 Discussion TeamLiquid Health and Fitness Initiative For 2023 NBA General Discussion NHL Playoffs 2024
World Cup 2022
Tech Support
Computer Build, Upgrade & Buying Resource Thread
TL Community
The Automated Ban List
Blogs
Men Take Risks, Women Win Ga…
TrAiDoS
momentary artworks from des…
tankgirl
from making sc maps to makin…
Husyelt
StarCraft improvement
iopq
Trip to the Zoo
micronesia
Customize Sidebar...

Website Feedback

Closed Threads



Active: 656 users

The Narrator - Mafia Web API

Forum Index > TL Mafia
Post a Reply
vossy
Profile Joined October 2019
3 Posts
October 15 2019 22:12 GMT
#1
Hey everyone,

Way back in the day, I used to do something with Dota on WC3 and Team Liquid, so this is quite the throwback.

Anyway, I run a mafia web server called The Narrator. It's a project I've been building out for the past 6(?) years? It's super customizable, and has a bunch of integrations like an interactive web UI, mobile UI, discord bot, and a forum integration.

I was wondering if there's any interest here in continuing to build it, use it, or integrate TL with it (for free of course).

Here's the opposite of a TLDR spoiler with a bunch of info
+ Show Spoiler +
narrator.systeminplace.net

The Narrator is a a role madness online version of Mafia, similar to Town of Salem or Epicmafia. However, unlike other versions of Mafia, the Narrator has been designed to be played however you enjoy mafia, whether that be In Real Life, via your favorite browser, Discord, or, your home forum mafia. The Narrator is also the most customizable version of online Mafia in existence.

Currently, I'm looking to connect with anyone that would be interested in expanding the project, whether you're a developer, designer, artist, a mafia community organizer, or just want to provide feedback. It's long past time I ditch the one man team I've got going.

How it all started
The Narrator started back in the day, as a way for me to host more flavorful mafia games in college, without the need for me to sit out, and without the need for extended nighttimes. A first pass was made as a Slack bot, but in 2016, I made a website/UI for it. Since then, it has expanded also into Discord, and as an integration into other forums.

Current Feature set includes
  • 74 unique abilities
  • Support for multiple mafia, cult, mason, architect chats
  • Custom hidden roles, such that the spawn list is hidden from the players until the end of the game
  • Custom roles with customizable abilities
  • Abilities tied to teams
  • Support for hidden attribute settings
  • Customizable faction/team settings
  • 20 Predefined setups that auto add/remove roles from a game based on the player count. This is very important for getting games started QUICKLY.
  • Nighttime system to determine who controls the faction ability if teammates don't agree
  • System of alliances to handle complex win conditions
  • Support for game theming with regards to item/feedback text, death flavor stories, and role names
  • Leaderboard for personal/global best win rate, games played, best roles, point count
  • Ability to review previous games you've played, including a breakdown of what happened each night
  • ITA/day punch support
  • Preferring a role
  • Partial support for giving dead people a way to be 'omniscient' about what's going on in the game.
  • Last Will support
  • Automated tests that test all the abilities and most of the features above
  • An automated process that's running thousands of games per hour to detect possible bugs/crashes I might have not have accounted for
  • System for choosing a more balanced setup vs a less balanced setup, and how to tell the difference between the two
  • Support for host-chosen hidden roles, to not necessarily rely on the above

Tech Stack (for those of you that are interested)
  • Game logic written in Java and tested with JUnit
  • Web layer written in ExpressJS and tested with mocha
  • Database in RDS using MariaDB
  • Discord written with javascript and tested with mocha
  • UI written with JQuery and webpack, and tested with Cypress (wish to move to React/Redux)
  • Linted using eslint
  • CI/CD using gitlab's free service (Would like to go to Github and CircleCI)
  • Repo https://gitlab.com/the-narrator/NarratorNode

Near&Distant Future Plans
  • Continue developing backbone to connect with more forum communities
  • Maybe integrate with Wolffia
  • Get a product manager to help steer feature development
  • Develop state of the art AI to help judge/generate setups
  • Kickstart campaign
  • Add video integration


Join my discord if you want to reach me directly
https://discord.gg/XaWcNzJ


Cheers,
Voss
vossy
Profile Joined October 2019
3 Posts
October 15 2019 22:14 GMT
#2
P.S. I also contacted TL's admins a little while ago, and they didn't have qualms about me posting this. Apologies if this is in the wrong place.
raynpelikoneet
Profile Joined April 2007
Finland43268 Posts
October 15 2019 22:43 GMT
#3
Definitely the right place to post it.
I'll look more closely into it when i get off work. At first glance looks interesting at least.
table for two on a tv tray
ShoCkeyy
Profile Blog Joined July 2008
7815 Posts
October 16 2019 22:10 GMT
#4
How’s the speed? Has jQuery given you any issues? I’m on the phone but would love to take a look at the git repo when I get a chance.
Life?
vossy
Profile Joined October 2019
3 Posts
October 17 2019 15:05 GMT
#5
I'd like to tear this a new one and redo it in react/redux if i'm being honest. I'm putting off the project until I can get a bunch of test coverage for the UI as is. As for speed, jQuery hasn't given me much trouble. Should it?

The commits are probably a better place to look first. Might give you more of an idea of the code structure I've been moving to.
Please log in or register to reply.
Live Events Refresh
Next event in 2h 18m
[ Submit Event ]
Live Streams
Refresh
StarCraft 2
ZombieGrub195
UpATreeSC 145
Nathanias 138
JuggernautJason79
CosmosSc2 47
StarCraft: Brood War
Sea 2583
Larva 776
Mini 219
[sc1f]eonzerg 18
League of Legends
Dendi1827
Counter-Strike
Stewie2K837
flusha318
oskar238
Super Smash Bros
Liquid`Ken6
Heroes of the Storm
Liquid`Hasu604
Other Games
tarik_tv6981
FrodaN2323
summit1g1973
shahzam1446
C9.Mang0207
RotterdaM130
ViBE122
Skadoodle90
Sick68
Livibee51
Trikslyr46
PPMD39
Organizations
Other Games
gamesdonequick2648
StarCraft 2
angryscii 37
Blizzard YouTube
StarCraft: Brood War
BSLTrovo
sctven
[ Show 19 non-featured ]
StarCraft 2
• Berry_CruncH237
• davetesta8
• RyuSc2 2
• LaughNgamezSOOP
• sooper7s
• AfreecaTV YouTube
• intothetv
• Migwel
• Kozan
• IndyKCrew
StarCraft: Brood War
• Azhi_Dahaki16
• Eskiya23 12
• STPLYoutube
• ZZZeroYoutube
• BSLYoutube
Dota 2
• masondota22561
League of Legends
• TFBlade928
Other Games
• imaqtpie2006
• Scarra1063
Upcoming Events
Replay Cast
2h 18m
OSC
2h 18m
Epic.LAN
14h 18m
Big Brain Bouts
18h 18m
sebesdes vs SpeCial
Harstem vs YoungYakov
GgMaChine vs uThermal
CranKy Ducklings
1d 12h
Epic.LAN
1d 14h
CSO Contender
1d 19h
BSL20 Non-Korean Champi…
1d 20h
Bonyth vs Sziky
Dewalt vs Hawk
Hawk vs QiaoGege
Sziky vs Dewalt
Mihu vs Bonyth
Zhanhun vs QiaoGege
QiaoGege vs Fengzi
Sparkling Tuna Cup
2 days
Online Event
2 days
[ Show More ]
BSL20 Non-Korean Champi…
2 days
Bonyth vs Zhanhun
Dewalt vs Mihu
Hawk vs Sziky
Sziky vs QiaoGege
Mihu vs Hawk
Zhanhun vs Dewalt
Fengzi vs Bonyth
Esports World Cup
4 days
ByuN vs Astrea
Lambo vs HeRoMaRinE
Clem vs TBD
Solar vs Zoun
SHIN vs Reynor
Maru vs TriGGeR
herO vs Lancer
Cure vs ShoWTimE
Esports World Cup
5 days
Esports World Cup
6 days
Liquipedia Results

Completed

JPL Season 2
RSL Revival: Season 1
Murky Cup #2

Ongoing

BSL 2v2 Season 3
Copa Latinoamericana 4
Jiahua Invitational
BSL20 Non-Korean Championship
Championship of Russia 2025
FISSURE Playground #1
BLAST.tv Austin Major 2025
ESL Impact League Season 7
IEM Dallas 2025
PGL Astana 2025
Asian Champions League '25
BLAST Rivals Spring 2025
MESA Nomadic Masters

Upcoming

CSL Xiamen Invitational
CSL Xiamen Invitational: ShowMatche
2025 ACS Season 2
CSLPRO Last Chance 2025
CSLPRO Chat StarLAN 3
BSL Season 21
K-Championship
RSL Revival: Season 2
SEL Season 2 Championship
uThermal 2v2 Main Event
FEL Cracov 2025
Esports World Cup 2025
Underdog Cup #2
ESL Pro League S22
StarSeries Fall 2025
FISSURE Playground #2
BLAST Open Fall 2025
BLAST Open Fall Qual
Esports World Cup 2025
BLAST Bounty Fall 2025
BLAST Bounty Fall Qual
IEM Cologne 2025
TLPD

1. ByuN
2. TY
3. Dark
4. Solar
5. Stats
6. Nerchio
7. sOs
8. soO
9. INnoVation
10. Elazer
1. Rain
2. Flash
3. EffOrt
4. Last
5. Bisu
6. Soulkey
7. Mini
8. Sharp
Sidebar Settings...

Advertising | Privacy Policy | Terms Of Use | Contact Us

Original banner artwork: Jim Warren
The contents of this webpage are copyright © 2025 TLnet. All Rights Reserved.