View source for Varsoon's Guide To Modding

[ Originally posted to Mafia Discussion 07/02/2018 by [[Varsoon]]: [https://forum.mafiascum.net/viewtopic.php?f=5&t=75028 link] ]


== Intro ==

:: ''So, you want to moderate a game on this site? Cool.'' 

----

I hope it's rad. Here's the problem, though--there's a ton of guides to playing mafia, but not nearly so many for modding games.

I've decided to make this guide because I've been asked on a few occasions to write a guide and I've also seen plenty of games that are just absolute dumpster fires--I'm not even being entirely metaphorical here, mods have abandoned games I've followed and put literal flame symbols next to the thread title. If I can help folks avoid that scenario, even if it's just one mod or a scant few players, then this'll be worth the time it's taken to write this.

Anyway, I could drop all sorts of reasons why Mafiascum needs a good standard modding guide or why having some sort of golden standard to adhere to would be nice--I could also gloss poetic and slap you around with a bunch of rhetoric, but I'm here to teach you to mod a game and to do it well, so let's get down to basics. As a good heads up, this guide is intended to speak towards modding practices and etiquette for theme games, but most of this stuff is applicable to any game you design and/moderate.

== Concrete Basics ==

:: ''Here are some basics that every game should strive for--these are meant to be concrete practices that you can build into your moderating method.'' 

----

'''1. Always have an informative opening post.'''

:: This is something that's pretty unavoidable on the site, as you have to make a first post to even start a thread on-site. That said, your opening post should be informative; list the players alive, list the full playerlist, include the game title, etc. If you take a look at my games, you'll find that I often do an opening crawl with post 0 being the title of the game, a banner for the game, players in the game, players living, players dead (including how and when they died, such as lynch/kill), and modkills. I've also taken to editing this first post with a running list of links to important moments in the game, such as public abilities being used, votecounts, lynches, flips, etc. My second post is a dump of all the rules that will be in place for the game at hand, including public mechanics, game-specific rules, and the sample role PM. After this, I'll have a third post that includes opening flavor if necessary, and then I'll finish with the first votecount of the game.

'''2. Keep up with an easy-to-read Vote Count.'''

:: Ideally, you should be posting a fresh vote-count every single page, but not many of us have that sort of capability. More realistically, try to get a votecount in at least once every five pages, and, if many players are voting within a small amount of posts, you can do so even sooner. This serves a few purposes: You'll stay engaged with the game because you're there constantly tallying up votes and posting new VC's; Players will know where votes are at most times; Players will have a strong sense that you are present and taking care of the game; You'll have a lower chance of missing something and making a mistake when tallying votes since you're doing with shorter amounts of posts to consider; and, finally, if your game features unique voting mechanics, frequent votecounts won't obscure those mechanics--there's a huge difference between a game with a VC every eight pages where a double voter voted one player then unvoted and no one discovered they are a double voter and one with a VC every other page that ends up showing that. I also specify here--make your VC easy to read and not too complex. Players need information from the VC in the most approachable way you can format it. I'll also post a VC at a player's request, as it's information players, ideally, should have at all times. Finally, try to get your VC to be the first post on each page (every 25th post), as it'll make for neater formatting, easier for players to find, and has the added benefit of letting you know if anyone's breaking some real big rules by deleting their posts. As another note, I tend to use VC's as means of updating players on little things or including reminders--like if I'll miss a few days, I include that at the bottom of my VCs or if a player is publicly unable to be lynched, I'll put that in there, so you VC can also serve as a running 'tracker' of public mechanics in play that players should be aware of.

'''3. Make Sure Public Mechanics Are Public.'''

:: This is a bit of a catch-all, but make sure all of your players are absolutely aware of anything that's supposed to be public and global in your game. When your game starts, send the whole playerlist a game start PM with a link to the game page--I've played games where players are just supposed to divine that a game started without them, or where a mod sends a gamestart PM but has no link so you have to go searching through their topics created to find the game thread. When a player is lynched and the night phase begins, again, send a PM out to all living players indicating this. When day phase starts, again, send a PM out to all living players with a link to the day start post in your game thread. This all said, being public about your public mechanics isn't just sending PMs to people--it's making sure that these public mechanics are made clear in your game thread. I've seen plenty of themed games where a mod will make a flavor post about a player being affected by some power, and we were supposed to just divine what happened from the flavor. Don't do this. If you intend for any effect to be public, make very clear (I use boldface) that the effect is in place. Some games skirt this very awkwardly, such as flavoring third party kills not as a player being 'shot' but instead 'poisoned'. Again, if you want it to be clear that it was not a MAFIA KILL that killed the player, but something else, such as a poisoner or arsonist, make that as clear as you can for your players. This goes for all public mechanics--don't let a Gladiate shot just hang in the air; announce what is happening and make a new VC to reflect it.

'''4. Role Flips Should Be Info Flips.'''

:: Another awkward trend I've seen is moderators not actually flipping the roles of lynched and dead players. I've seen everything from just writing the player was dead in a game that wasn't advertised as flipless to mods just revealing the flavor-name of a role and never telling players what the role actually did. Unless it's a critical feature of your game to obfuscate this sort of information, just be very clear with your role flips. I literally post the entire rolecard (redacting sensitive information such as links to private topics or names of scum partners) with a flip and I write out what the name of the player's role was as well as their alignment. Mafia is entirely a game of information, and denying this sort of information to your players will frustrate them and make them less able to play the game at hand due to a drought of information.

'''5. Ensure Your Game Is 'Mafia'.'''

:: When you begin to get into very creative games of mafia, it can be easy to start to lose track of the core principles of what makes a game Mafia. There should always be a fair balance of an uninformed majority (town) versus some form of an informed minority (scum, cult, werewolves, third party, etc.) and the ratio should be about 1 informed to every 3 uninformed. If you're running a game advertised as a 'Mafia' game, make sure that it has, at the very least, one day phase where all living players can post and vote and a majority vote needs to be had in order to win the game. I've experimented with this a lot and I've found the easiest work-around for me is just to include special rules that say that any MYLO/LYLO in my games have all special voting rules and restrictions disabled. In this way, no matter what, there has to be at least one phase where town either gets a majority vote together to win or scum manages to get that vote elsewhere through rhetoric alone and not any special role or mechanical gimmick. If you want to run a game that deviates heavily from the core of what makes a game 'Mafia', that's fine, but advertise it as such and don't act as if it is a mafia game when it's in signups.

== Abstract Basics ==

:: ''That's all good and cool, but there are some more abstract policies you should probably have under your belt, too. These aren't any sort of thing where you can easily check of a list, but instead serve as a general ethos to work towards.'' 

----

'''1. Be Consistent.'''

:: The worst offense a moderator can make is extreme inconsistency. Make sure all players get their PMs sent to them at the same time. Start your game days on the deadlines you set. If you won't be around for a deadline, let all of your players know via post in thread and PM. If you punish one player for a certain rules violation, make sure you don't give another player a pass for the same type of violation. Consistency, though, doesn't just mean to make sure your moderator posts and game running is the same throughout, but also that your game design and how much you reveal to players is consistent, too. For instance, I've seen games, where, when under pressure, the moderator has come out and explained how something worked when they should not have--their explanation of the mechanic wasn't in the original posts for the game, so getting it late gave an unfair advantage to players that had made it to that later play phase. For this reason, Consistency isn't just having a clear routine, but also standing by your own decisions and not buckling under player pressure to break your own established game. If you answer one person's question in-thread, be ready to do so for everyone's questions. If you are willing to give a player a private topic to write notes, make sure that offer is extended to all your players. If you deny anything to any one player at any time, don't revoke that denial. Last but not least, make sure your role PMs and any private messages you send, in general, follow a consistent formatting.

'''2. Avoid Bias.'''

:: Don't make the mistake of wanting one side in your game to do well versus another side. Your goal is just to see your game run to its end, no matter what happens. It can be very easy, as a moderator, to try to give more information to a scum team or to any informed minority--avoid this. For some moderators, this may mean not talking to any players outside of purely game-related questions. I've seen games where players who ask the mod a lot of questions through PM get a ton of information they wouldn't have access to otherwise and this, too, is a form of bias. Avoid it.

'''3. Don't Alter the Game.'''

:: Once everything is set and going, don't change anything about the game. This would be a concrete rule, but it dips into more abstract territory when you consider moderator communication with players--if you reply in a PT to a player with something that isn't just rules clarification or the answer to a justified mod question, you're altering the game. It may seem innocuous to post a response to someone's joke or to be chummy with your scumteam, but do your best to make your posts as removed from game alteration as possible. If this is a policy you have trouble upholding, then make it your policy not to ever post in thread unless it's a strictly game-related post. I find being thorough with rules and role PMs helps to cut down on this, as when a player asks me how their role functions or interacts, I can defer them to the rule/part of their role. Finally, and this is more of a personal thing, I don't post all the scum role PMs in the scum PT, solely because doing so alters the game and does not allow scum to hide certain features of their roles from each other. While I haven't designed a game where they would really want to, removing that option from players seems like an alteration that could be unwelcome. The other important facet of this rule is that you should do everything possible to keep the game running without needing a modkill on a slot or any other similar moderator action. A force-replacement on a slot is nearly always a better option for continuing a game than modkilling a slot. Just as much as a player can compromise a game by breaking certain rules, a mod, too, can alter their game beyond its originally intended play state by being too heavy-handed in their moderation.

'''4. Be Precise.'''

:: Too often, mods use shorthand that can actually make the game experience altered for some players. For instance, let's say you tell a player they are a 'roleblocker'--what does this even mean? A quick check to the wiki can give some ideas, but a player should not have to go to any external source to figure out what their role in YOUR game does. Simply write out what the role's functionality is. Be clear about exactly what the role does, what its limits are, etc. I've played games where it wasn't clear if I was one use, one shot, or unlimited use. I've played games where I didn't know if I could submit one actions per night or multiple. Be clear about what players can and can't do in your public rules and role PMs. Furthermore, be precise in detailing any mod posts you make in the game--if it's supposed to be a certain player's effect that made something happen, spell that out clearly so everyone understands who did what and when it took effect.

'''5. Be Concise.'''

:: This might come as a bit hypocritical given how long this guide is getting, but shoot for having shorter posts in your game. If you can simplify the wording on a role's ability or on your ruleset or in your flavor, chances are that players will understand it more and be more willing to actually read it. The last thing you want to do is overwhelm your players. For that reason, I use spoiler tags like these when I make posts, so that players can access the more wordy information at their leisure. Using spoiler= tags also has the added benefit of not bloating the page, giving players less they have to scroll through when they are looking through the game.

'''6. Be Vigilant.'''

:: You should always be trying to think of ways that a player might accidentally break your game wide open. Always double check a PM's recipients and contents before you send it. Mix up the order that you send out role PMs so players can't use the timestamps to identify when town got their PMs versus when scum got their PMs. When linking images, make sure that the player can't follow the image URL back to your photobucket or imgur folder and see the images you sent to everyone else. Make absolutely sure of your night actions and their resolutions before actually filling them out. There's a lot you can do here, but what I want to get mods to do is to stop making small mistakes that compromise their games. Constantly make sure you're not making a mistake and that no player is getting anything past you, even if that means checking the exif data on pictures they post to ensure they're not encrypting messages.

== Game Design Basics ==

:: ''Now, most of this has been meant to inform how to run a game, but there's some advice I'd like to give for designing games, as well.'' 

----

'''1. Give Every Player Agency.'''

:: A huge problem that some games have is that players can start to feel like they have no way of affecting the outcome of the game. This turns to players dropping out, lurking, and deferring to peers that seem more in the know. As a game designer, you can avoid a lot of this by simply making sure every player has some level of control over the game. The most simple thing is ensuring that town players can always vote for a lynch or something like it. While rare, I've seen some games where day phases did not result in a lynch, either due to design or capacity to avoid a lynch--this is absolutely detrimental to the gamestate and can result in a lot of player frustration. Make sure players are getting a steady stream of information (either via lynches/kills or some other source that they feel they actually can exhibit control over). It's for this reason that I will often design games where scum has to kill a player every night and town has to lynch a player each day. More on that later. For now, though, there's a lot that you can do to give players agency, and I often try to encourage mods to create some 'extra' mechanic in their games in order to give every player a little something beyond just votes to influence. If you look at games that regularly get nominated for scummies on this site, you'll see many of them feature public mechanics of some sort. I've given every player the ability to create private topics with each other, for instance, or given them a separate vote they could conduct that would enable certain public effects to happen. The goal is that you end up with a game where even someone with a fairly vanilla role still feels like they can do something. Another big thing is that there are roles the remove agency and encourage agency--I tend to love roles like neighborizer because it encourages a player to find someone else to privately chat with for whatever reason, which can help them gain information or exert more control via rhetoric alone. I tend to dislike roles like cop, because a cop result (innocent OR guilty) removes a lot of the critical decision making from the hands of all players but the cop itself. Finally, like I said before, I try to ensure at least one phase of my game always has players voting for a lynch with no other mechanics influencing that vote. Finally, make sure that powerful roles are spread evenly enough so that it doesn't feel like a handful of players have all the influence over the game while relatively vanilla players fall by the wayside.

'''2. Ensure Balance Between 'Clears' and Mafia.'''

:: A lot of roles can provide either hard mod-confirmed clearing on a player (innocents/guilties) or circumstantial enough evidence to clear or condemn a player (successful doctor shot blocked the Night Kill). It is important to balance the amount of clears you have in a game with the amount of Mafia players in the game. You should NEVER allow town to clear equal to or more players than the scum team. It's nearly impossible for a 3 player scumteam to win against a town that has 3 or more confirmed townies. Given how much the site meta trends towards players putting a lot of trust into roles, roleclaims, and occam's razor when it comes to role results, unless you design a game specifically to trip up these investigative kinds of abilities, including them, even if they only 'soft' clear a player, will essentially make those players hard-confirmed as town. By the same right, you likely want to avoid any scenario in which enough guilties could just out the whole mafia team. At that point, sure, it's cool that the vigilante or the cop shot right every time, but it's not fun for the dozen or so other players who just wanted to play a game of rhetoric and not have it thrown out the window because you included a role that could circumvent actually having to play your game. Balance your roles accordingly. Don't include hard mechanical clears, if you can avoid it, unless your game, by design, needs to have those in it. Always consider this as the most important 'balance' of town power versus scum power.

'''3. Check Your Setup.'''

:: Before you run your setup, make sure that you go through literally every role interaction possible in your setup and that you understand the outcomes of them all. The last thing you want is for something to happen that you did not expect, which leads to an overwhelming lead for one team or another. This is why having someone else take a look at your setup can be a great idea, as a second pair of eyes can usually spot something you may have missed in your role interactions or wording of role PMs.

'''4. Balance Against Swing.'''

:: 'Swing' refers to the way in which a setup can become very tilted in the favor of one team or another based on certain lynches, kills, or other role interactions. Swingy setups can be fun, but, as we went over before, consistency will result in a better experience for more players. Furthermore, as mod, if your setup swings too hard in favor of one team, it's practically as though the rest of your design didn't matter and you shouldn't have run the thing in the first place if it'd just result in strong imbalance one way or the other. For this reason, avoid stacking too much power in any one role. Don't build scumteams around a 'leader' type role. If you want to give a powerful role to a player and have it be a part of the setup, consider making another player be the 'backup' to that role, inheriting it when the original owner dies. Always spend a good deal of time looking at your setup and thinking about how unfair it'd be for one team if a certain role was eliminated early or never got the result they needed for their role to 'function', etc. It's for this reason I try to avoid high-swing mechanics like extra kills, doctors, cops, etc. Ideally, if your game is ensured to always just be 1 lynch a day, one kill a night, you're at least building a less swingy setup from out the gate.

'''5. Players Come First.'''

:: With every element of your game design, always ask if what you are including is something that will drive player enjoyment. Will a scum Dayvig make the game more fun at the cost of the fact it will result in a townie dying without even possibly having a chance to play the game? Too often, I'll see moderators design a setup that would be fun to observe if you knew all the moving parts, but they've failed to consider the position of the individual player. This is why I tend to run role madness games or games with a central mechanic--I want every player to have multiple mechanics that are driving them to engage with and have fun with the game, and I try to design mechanics that don't get to just eliminate other people's enjoyment outright. Again, you're not designing something for yourself to watch or for a scum team to plot against a handful of informed townies--you're making a game for every player who has signed up.

== Theme Design Basics ==

:: ''This section dips even further into my person moderator ethos, so take this or leave it, but these are suggestions I find myself giving people time and time again when they ask for help designing their theme games.'' 

----

'''1. Build Around The Theme.'''

:: The theme should come first and foremost in your THEME game. Many mods make the mistake of trying to design a game of mafia, then throwing a theme over it like they're tricking someone. If you want to run a normal closed setup, there are queues for that. Theme games allow you to build entirely original mechanics and roles to render a theme into mafia mechanics. My advice is often this; Find the most central, important thing about the theme you are considering. Incorporate this facet of the theme into a mechanic that influences every player's role. So, for instance, you could build the game around a public mechanic that is derived from that important thematic element. Alternatively, you could design each role to have some sort of reflection of that thematic element within their role. Whatever it is, make sure that this 'theme' element is present and apparent to all your players.

'''2. Don't Let Flavor Break the Game of Mafia.'''

:: Your players, first and foremost, want to play mafia. Don't let the theme allow some theme-savvy players to get an unfair advantage on other players. Always try to craft unique roles that aren't just obviously what a character from the theme chosen would have. One of the most important things you can do is design safe fake claims. This can be tricky with some theme setups, but it's always something you must do as a mod, because the last thing you want is someone clearing another player because they claim a certain character or their abilities match a certain villain or whatever it may be. Give every anti-town player a flavor claim that won't get them killed, and don't just make all of the protagonists of your theme the power roles. In short, don't allow the basic dynamics of the theme you chose to determine the balance of power in your game. Just because something makes sense to be powerful or have a certain ability from your theme does not mean you should always render it as such. Some of my favorite moderators have commonly made the main protagonist of a theme be a fakeclaim or even a scum role. The trick is to play around with this and never fall into a distinct moderator meta. I've had some degree of luck even just giving all the players 'flavorless' role PMs, with their flavor being revealed upon flip.

'''3. Be Flavorful!!'''

:: I've played so many theme games where the theme doesn't seem to matter. I wrote earlier that your game shouldn't just be a normal closed setup 'flavored' as a theme game, but this goes beyond that. Write flavor posts for the kills and lynches, even if it's something minimal. Include pictures in role PMs! Link to scenes from the theme or music! Include quotes on your votecounts! Whatever you do, have fun with it, and make the theme apparent. As much as people are signing up for a MAFIA game, they are still coming to the theme game queue for a THEME game, so try to deliver on that.

'''4. Don't Let Theme Ruin Balance.'''

:: Aaaand at the end of the day, you're still building a mafia game. Have as much fun as you can designing unique mechanics and roles, but make sure your game still adheres to those earlier rules--is your game still 'mafia'? Is it still balanced against swing? Make sure, at its heart, your game is still a mafia game that people can engage with and enjoy beyond all the theme mechanics you design.


== Miscellaneous ==

:: ''Here are some smaller tidbits of advice I've picked up since I've begun modding.'' 

----

* Many players play on phones--don't make anything that can't show up on a phone.
* If you're going to include text in an image, ALWAYS have a text version for people who can't view the image.
* Discourage players from posting game-content related recordings of audio or video; it's hosted on external servers and provides an unfair advantage in the forum-based game.
* Don't use colors that show up poorly on MafBlack or MafSilver settings.
* Always provide Hydras with a PT for their heads to chat in and list all members of the hydra in your playerlist.
* Don't run multiball setups unless you can actually balance against the swing of a multiball setup.
* You can't balance the swing of a multiball setup.
* Don't ever allow a player to amass enough extra voting power that they + the scumteam can lynch anyone else. This is why you disable extra vote mechanics in LYLO/MYLO.
* Don't be draconic in your moderation, but also don't let rules offenses go by without some warning.
* Don't enforce blacklist/Wisdom of the XXX unless you're ready to compromise your unbiased position for people who are generally not the kinds of folks that are pleasant to play with anyway. Players who are truly disruptive to games catch bans for a reason and the banlist should be the only policy you really need to enforce.
* Don't sweat it if your game goes awfully or people are complaining while it's running. Learn what they didn't like and debrief once the game is over. Build a better setup next time.
* Always debrief your game, make public all the PTs, post all the night actions, etc.
* Keep a moderator PT going where you can keep track of actions and record them as they are submitted.
* Don't delete a player's post unless it's an absolute rules violation and you must.

[[Category:Modding Articles]]