Hapless StudiosTown Wiki + New Page
For wiki builders

Wiki Guide

Everything you can do when writing a page. Type the left-hand syntax in the editor and it renders on the page.

Getting started

Only people with the editor role can create or edit pages. When you are logged in with that role you will see + New Page and Edit buttons. Click one to open the editor. The editor has a live preview on the right, so you can see your formatting as you type. Click Save page when done.

Spotted a mistake but can't edit? Use the Join the Discord button on the wiki home and open a ticket.

Page types

At the top of the editor, pick a type:

Every page can be tagged Available in Town and/or Town Debug, and marked Exclusive to Notable+ / Mod. Weapon pages also have a Fire mode tag (Semi-automatic, Fully-automatic, Burst). All show on the page.

Text basics

# Big heading
## Section heading
### Small heading

**bold text** and *italic text*

- a list item
- another item

Headings build the page structure. Use ## for most sections.

Link to another wiki page (by name)

[[M4]]
[[M4|the standard rifle]]

Links to the page named "M4". Add | to change the words shown. A link is blue if the page exists, red if it still needs writing.

Tip: as soon as you type [[ in the editor, a dropdown of matching pages appears, use the arrow keys and Enter (or click) to insert one. Type [[# to search by Page ID instead.

Link to a page by its ID (recommended)

[[#ABC123]]
[[#ABC123|click here for the M4]]

Every page has a short Page ID (shown in the page's "Page info" box and at the top of the editor). Linking by ID keeps working even if the page is later renamed. Use | to set the words readers see, otherwise it shows the page's title.

Link to an outside website

[the Roblox game](https://www.roblox.com/games/...)

Images and video

In the editor toolbar use Image or Video / GIF. You can either paste a URL or upload a file from your device. Uploaded files are stored on the server, so everyone sees them.

![a caption](https://example.com/picture.png)

Click an image in the live preview to cycle its alignment: full width, centered, left, or right. You can also paste a YouTube link or an .mp4/.webm/.gif URL and it embeds as a player.

Audio (MP3)

Two ways, both in the toolbar:

Player (a play bar): the Audio button. Paste an .mp3/.ogg/.wav URL or upload a clip.

![Audio](https://example.com/sound.mp3)

Inline word (click a word to play): the Sound word button, or type it directly:

The gun makes {audio:https://example.com/shot.mp3|this sound} when fired.

The word becomes a clickable link with a small speaker icon; clicking it plays the clip. You can also point either one at an uploaded clip's media: token.

Colour

{c:red|this text is red}
{c:#df1800|brand red text}

Use a colour name or a hex code. Toolbar button: Color.

Callouts

> [!TIP] A helpful hint goes here.
> [!NOTE] Something to remember.
> [!INFO] Extra information.
> [!WARNING] Be careful with this.
> [!DANGER] This will get you killed.

Coloured boxes that stand out. You can put lists inside a callout by adding more > lines.

Tables

| Weapon | Damage |
| --- | --- |
| M4 | 33 |
| M9 | 24 |

Spoilers / collapsible sections

+++ Click to reveal the ending
Hidden content that stays folded until clicked.
+++

Great for long pages or spoilers. Toolbar button: Spoiler.

Tabbed sections

=== Stats
The numbers go here.
=== Lore
The story goes here.
===

Makes clickable tabs (for example Stats vs Lore on one page). End the block with a line of just ===. Toolbar button: Tabs.

Boxes

:::box Box title
:::item First item
Write anything here. **Markdown** and [[links]] work.
:::item Second item
More content.
:::

Builds a clean framed box with its own titled mini-panels inside, the same style the weapon Traits box uses. Great for grouping related info nicely. The title and the items are optional. Toolbar button: Box.

Pros and Cons

The Pros / Cons toolbar button drops in a ready-made green-Pros / red-Cons layout you just fill in. No syntax to remember.

Quotes with attribution

> The town remembers everyone.
> -- DecodeUnicode

A line starting with -- becomes the credited author.

Footnotes / references

The M4 was added in the first update[^1].

[^1]: Source: the changelog.

A numbered [1] appears in the text and a References list is built at the bottom automatically. Toolbar button: Footnote.

Live stats from another page

The M9 deals {{M9|damage}} per shot.
{{M9|fireRate}} rounds per minute.

Pulls a value straight from another page so your text stays correct automatically: when that page's stat changes, this number updates too. Use {{Page name|field}} (or a Page ID). The field is a stat key like damage, fireRate, weight, or any field on that page.

Categories and subcategories

In the editor's Categories field, type one or more category names separated by commas. A page can be in several at once:

Weapons, Pistols, Meta

To nest a category inside another, edit the Category page itself and put its parent in its Categories field (for example the "Pistols" category lists "Weapons" as its parent). The six big cards on the wiki home are the main sections.

Aliases / redirects

In the editor's Aliases field, add other names that should point to the same page (comma separated):

M4A1, M4 Carbine

Now [[M4A1]] and [[M4 Carbine]] both lead to the M4 page, and show as existing (blue) links.

Tags and verification

Weapon, armor and tool stats

When the page type is Weapon, Armor, Attachment or Tool, a structured form appears. Fill in the fields and they build the coloured info-box on the right of the page (leave a stat blank to show "-").

Guns auto-calculate damage per second and time to kill from the damage and fire rate. Akimbo, shield-penetration and "paired with shield/body" show in a separate Traits box beside the stats. Melee (the Melee toggle) has its own posture / swing / guard / parry / backstab fields with damage-by-hit math. Tools come in Healing (auto health-per-second/minute), Utility, and Defense.

Armor is one piece per page (a helmet is its own page, a vest is its own page). Each piece has a single HP value and the part it covers. Armor fully blocks all damage to that part until its HP runs out, then it breaks (repaired with a Wrench). Damage multipliers do not apply to armor, and higher base-damage guns break it faster, any overkill on the breaking shot carries into the body part underneath. Rough guide: 50 HP is light, 80 stalls most SMGs briefly, 150 is extreme.

Armor sets: switch the Armor editor to Armor set to make a set page. Give it a name, tick the body slots the set covers (head, torso, left/right shoulder, arm, leg) and type how many armor slots wearing it uses. Pieces join the set by typing the set's name into their Categories field, and the set page adds up their total weight automatically. Clothing (the third toggle) is a stat-less cosmetic item; file it into the set the same way and it shows in the set's totals box.

Snippets, drafts and search

Reordering categories and pages

When you are logged in as an editor, you can drag and drop to reorder things:

The order is saved for everyone. Reordering does not show up in the edit history, so it stays clean.