How to Use a Headcanon Generator: Every Control, in Order

Most pages about a headcanon generator show a screenshot and a button and stop there. This page is the written version instead: every control named the way it is labelled on screen, the order that avoids wasted rolls, and three complete sessions with the exact lines they produce — so you can open the tool in a second tab, follow along, and land on the same output. Nothing here is a feature list. It is the sequence of clicks, and the five settings that decide what one roll can return.

One roll fills five slots: the name decides who the line is about, the vibe locks the tone, the categories decide which of the five slots exist, and the count decides how many of them you get — while the last two together set how many lines the roll has to choose from.

The four controls, in the order you set them

There are four controls, and the count is worth stating plainly because a lot of pages leave it vague: one text field, six vibe chips, five category chips, five number buttons. That is the whole interface. There is no model picker, no prompt box, no account, and nothing behind a sign-in.

• Character name — one text field. It stops accepting text at 60 characters, and the field label says what happens if you leave it blank: “leave it blank and the generator will pick a placeholder name for you”.
• Vibe — six chips: Wholesome, Funny, Romantic, Angsty, Chaotic, Melancholy. They are independent toggles, and the label spells out the default: “pick any combination, none selected = anything goes”. None are pressed when the page loads.
• What goes in the set — five category chips: Personality, Backstory, Relationships, Quirks, Secrets. All five are on at load, and the tool will not let you switch off the last one, so a set can never come back empty.
• How many lines — five number buttons, 1 to 5, with 3 selected at load. This is how many lines one roll returns.

Under those sit the two buttons that do the rolling, Generate headcanons and Roll again. Each line in a finished set also carries its own reroll this button, and once a set exists, two more buttons appear: Copy full set and Download as .txt.

The order matters because of one behaviour that runs through the whole tool: every tap on a vibe chip, a category chip or a number button re-rolls the set immediately. You are never editing settings and then confirming them. You are setting the name, and then rolling by touching whatever you change next.

Step 1: type the name first

Set the name before you touch anything else. If you set the vibe first and type the name last, the batch on screen still belongs to the previous name until something rolls again, so the fastest way to avoid confusion is to start in the text field.

Leaving it empty is a real option, and it is the one setting you cannot type back in. The tool does not refuse to run without a name; it reaches into a list of 40 built-in placeholder names and picks one at random for that roll. Those names are ordinary first names and they demo the tool perfectly well, but the choice happens at random the moment you roll. If a batch you liked came from a blank name field, the name printed on the card is the only record you will get of it, so note it before you roll again.

Capitalisation counts, which surprises people who expect a name field to be forgiving. The tool builds its result from the exact text in the field, so Marlow and marlow are two different characters as far as the roll is concerned. In a test with identical settings and only the capital M changed, the two batches shared 0 of 5 lines. Type the name the way you want it to behave, and type it the same way next time if you want the batch back.

Step 2: set the vibe, or leave it off on purpose

The vibe chips set tone, not topic. They start unpressed, and unpressed is a deliberate mode rather than an empty state: with nothing selected, a roll may return any of the six tones, which is why a five-line set built that way reads like five different moods. That is usually what you want for a first pass, because the tones tell you what the character is like before you have decided what the scene is.

Pressing a vibe chip does two things at once. It narrows what the roll can draw from — one chip pressed takes the pool from 180 lines down to 30 — and it re-rolls immediately, so the set on screen becomes a single-tone set before you have touched anything else. Because the chips are independent, a partial selection is a genuine third option: three chips pressed gives you a pool of 90 lines spanning exactly those three tones.

What the vibe chips cannot do is promise a mix. Pressing Wholesome narrows every line in the set to Wholesome; it does not hand you one Wholesome line and four others. If you want contrast inside one set, press nothing. If you want the set to hold a single note, press exactly one chip and read all five lines in that voice — that is the setting the second session below uses.

Step 3: set the categories, which decide what the set is made of

The five category chips decide which kinds of line exist in the set, and this is the control that changes what you can do with the output. Each label maps to a different job, and the tool keeps them distinct on purpose, so a line is never a vague blend of two of them:

• Personality — how the character behaves, usually under mild pressure.
• Backstory — one thing that happened before the story you are telling starts.
• Relationships — one connection to another person, stated as a behaviour rather than a feeling.
• Quirks — something an observer could notice, with the explanation left off.
• Secrets — one thing the character is not saying out loud.

All five are on when the page loads, and the tool refuses to let you switch off the last one. There is no combination you can get stuck in where the set comes back empty.

The behaviour worth watching is what a set of categories does when it meets the count. With all five categories on and the count at 5, a roll returns one line from each category — never two from the same one, and never a category missing. Across 2,000 rolls of exactly those settings, the number of distinct categories in the batch came out at 5 every single time, so this is not a tendency you have to work for; it is what the setting does. Drop to three categories with the count at 3 and the same rule scales down, one line from each of the three. That is the tool's own shape showing through: one category, one slot.

The rule has one boundary, and it is the only one on this page worth memorising. Once the count is larger than the number of categories you have left on, the extra lines have to come from somewhere, so categories start repeating. Two categories with the count at 5 will always give you five lines drawn from two categories. It is not a fault — there is simply nothing else in the set to fill the slots with — but if seeing the same label twice on one card bothers you, keep the count at or below the number of categories you have switched on.

Step 4: set the count last

The number buttons are the last thing you set, for a simple reason: they are the cheapest way to make everything else re-roll. Pressing a number button rolls on the spot, exactly like pressing a vibe chip, so if you have just set the name, the vibe and the categories and you want to see the result, pressing the number is one action instead of two.

Three is selected when the page loads, and it is a reasonable default for a quick look. Five is the number that matches the tool's own five-category shape and the number that fills a one-page character sheet in one press. One is the number for hunting a single line: narrow the categories and the vibe down to the cell you want, set the count to 1, and use the line's own reroll this button until you have the line you will actually keep.

The count is part of the roll, not a display length. Changing it does not append lines to the bottom of what you already have; it produces a different batch. With the same name, the same vibes, the same categories and the same roll counter, a count of 3 and a count of 5 shared 0 of 3 lines across their first three positions. If you liked a three-line set and then press 5 hoping to keep it and grow it, you are asking for a different set.

Session 1: the five-slot sketch, in one press

This is the setting to start from, and it is the one that gives a usable character sketch with a single roll. Name Marlow in the text field, no vibe chips pressed, all five category chips left on, then press the 5 button. The card shows an archetype above the lines, then one line per category. This is the entire output, tags and all:

Archetype: The Patient Storm

• [Secrets / Wholesome] Marlow practises kind sentences in advance so there is one ready when it is needed.
• [Relationships / Melancholy] Marlow sits with people through hard things and never mentions it afterwards.
• [Personality / Funny] Marlow treats every minor inconvenience like a personal rival and keeps score.
• [Backstory / Chaotic] Marlow once joined a club for the snacks and ended up running it for two years.
• [Quirks / Funny] Marlow has one specific mug that only they may use, and everyone has accepted this.

Read the five tags in order and notice two things. Every category appears exactly once, which is the setting doing what it says. And the five categories do not arrive in their listed order — this roll came back Secrets, Relationships, Personality, Backstory, Quirks. The category set is fixed; the sequence is part of the roll, so a second press of the same number can reorder the same five slots. Nothing is broken when that happens.

As a character sketch, this is already enough to write a scene: something the character does quietly for other people, a way they show up for people in hard moments, a running joke about how they take small problems personally, one thing from before the story, and one object that other people have learned to work around. The archetype line is a label drawn at the start of the roll, one of 24, and it is worth treating as a reading aid rather than a setting — it does not change the five lines, and you cannot pick it.

Session 2: the same character in one locked tone

Now take the same name and press exactly one vibe chip, then set the count back to 5. Name Marlow, Wholesome the only vibe pressed, all five categories on, count 5. Every line comes back in that one tone, still one per category:

Archetype: The Second Draft

• [Quirks / Wholesome] Marlow leaves the last of the coffee for whoever comes down next.
• [Secrets / Wholesome] Marlow kept a note a stranger wrote them at a low point, and rereads it on bad days.
• [Relationships / Wholesome] Marlow defends their friends before hearing the full story, and revises afterwards if they have to.
• [Backstory / Wholesome] Marlow spent every summer in the same small town and still measures a good year by whether they got back.
• [Personality / Wholesome] Marlow is the one who stays until the last chair is stacked and never mentions it the next day.

Compare this with Session 1 and the point of the vibe control is obvious: the categories did their job in both sets, but the five lines now agree with each other instead of pulling in five directions. That is the version to take into a scene you have already decided the mood of, or into a scene the reader has already been handed. For a neutral first look, leave the chips alone; for a scene with a decided temperature, press one chip.

The useful habit here is to run the same name through a single chip more than once rather than trusting the first batch. A single-chip roll is drawing from 30 lines, and 30 lines is not a lot — the second press will hand you five different ones. If two chips both look plausible for the scene, run the name through each and keep the batch that reads like the character rather than the mood you were imagining.

Session 3: one cell, one line, six choices

The last session is the one for stealing a single line. Narrow all the way down: name Marlow, Angsty the only vibe pressed, and switch four of the five category chips off so only Secrets stays on. Set the count to 1. The roll now has a pool of six lines — one vibe, one category, six lines — and it hands you one of them:

Archetype: The Almost Retired

• [Secrets / Angsty] Marlow keeps a private list of reasons people leave, and checks themselves against it more often than they should.

Six is the number that makes this mode useful. A single category and a single vibe always land on a cell of six lines, so the line you got is one of six, and reroll this will not repeat the line already on screen: with one line showing, that leaves five other candidates in the same cell. A few presses of reroll this is therefore the fastest way to see everything that cell has to offer for your character, and it is the right tool when one line of a bigger set was almost right.

Use this mode when you already know what you need. If a scene needs one thing this character is hiding, this is a six-choice question instead of a five-category lottery, and the tone is fixed for you. The trade is that the line arrives without a set around it, so it will not come with the four other slots that made Session 1 a sketch.

Getting the set out of the tool

When the set on screen is the one you want, two buttons take it out of the browser. Copy full set puts the whole set on the clipboard. Download as .txt saves it as a plain text file named after the character, lowercased and hyphenated — a roll for Marlow downloads as headcanon-marlow.txt, and it is named after the same text you typed, so a name with a space becomes a hyphen.

Both buttons export the same plain text, and it is worth knowing its shape if you are pasting into a notes file: a four-line header giving the character, the archetype, the vibes used and the categories used; a blank line; then the lines, numbered, each prefixed with its category and vibe in square brackets; then a final line recording that the set was made offline in the browser from a local bank with no server involved. So Session 1 as a saved file opens like this:

Headcanon set for Marlow
Archetype: The Patient Storm
Vibes: any
Categories: Personality, Backstory, Relationships, Quirks, Secrets

1. [Secrets / Wholesome] Marlow practises kind sentences in advance so there is one ready when it is needed.
2. [Relationships / Melancholy] Marlow sits with people through hard things and never mentions it afterwards.
3. [Personality / Funny] Marlow treats every minor inconvenience like a personal rival and keeps score.
4. [Backstory / Chaotic] Marlow once joined a club for the snacks and ended up running it for two years.
5. [Quirks / Funny] Marlow has one specific mug that only they may use, and everyone has accepted this.

The tags are the part worth keeping when you paste. Vibes: any and the bracketed [Category / Vibe] labels record the settings that produced the line, which is the difference between a set you can rebuild later and a list of sentences with no handle on it. If you strip the tags for a clean paste, copy the four header lines first.

If the set is close but one line is wrong, do not re-roll the whole set — use that line's reroll this. It replaces only that line, from the same pool, and it never gives you a line that is already on the card. Re-rolling the whole set throws away the lines you had already accepted; re-rolling one line keeps them.

Why the same settings give you the same lines

The tool computes each batch from five things, and every one of them is visible or countable from the outside: the name as typed, the vibes pressed, the categories left on, the count, and a roll counter that starts at 1. Two runs with the same five match exactly, line for line — in a direct comparison of the same settings twice, the output was identical down to the character.

What makes that workable in practice is how the counter moves. Touching the name field, a vibe chip, a category chip or a number button sets the counter back to 1 and rolls. The two roll buttons, and pressing Enter in the name field, add one to the counter instead. The practical consequence is worth the sentence: the batch you see after arranging the controls is always roll 1 for those settings, and you can get it back later by arranging the same settings — you do not have to remember which control you happened to touch last, because every control puts the counter in the same place.

Three things break that. Leaving the name blank hands the name choice to chance, so the roll is not the one you asked for. Pressing Generate headcanons or Roll again advances the counter, so the settings can be identical while the batch is a different roll. And a name typed with different capitalisation is, as far as the tool is concerned, a different name. Same name, same chips, same categories, same number, and no extra press: that is the whole recipe for a repeatable result, and it works across days and devices, because the tool keeps nothing between visits.

Four things that surprise people

• The two big buttons do the same thing. Generate headcanons and Roll again both advance the roll counter and produce a fresh batch. One is not a submit button and the other a refresh; on a tool with no server, there is nothing to submit.
• A blank name invents one for you. Empty field, 40 built-in placeholder names, chosen at random per roll. It is the only setting on the page you cannot reproduce, so write down the name the card shows you if you plan to come back to it.
• Five categories plus a count of 5 always gives five different categories. Not usually — always. Across 2,000 rolls those settings never produced a batch with two lines sharing a category, and never produced a batch missing one.
• A capital letter is part of the input. Marlow and marlow produced batches that shared 0 of 5 lines. The name field is not a search box; it is part of the key.

Quick answers

• How many lines can one roll give me? Between one and five. The number buttons are the only control for it, and there is no way to ask for more than five in one press.
• Can two lines in one roll come from the same category? Not while the count is at or below the number of categories you have switched on. Raise the count past that number and categories start repeating, because the extra slots have nowhere else to come from.
• Do I need to open a new roll to change the tone? No. Pressing a vibe chip re-rolls the set on the spot, so the tone change and the new batch arrive together.
• Does anything I type leave the browser? No. The page makes no network requests at all, keeps no cookies and no stored data, and works with the connection switched off. There is a two-minute test you can run yourself in a separate note on checking what a generator does with your text.
• Will I see the same lines again next week? Yes, if you enter the same four settings and do not roll again — the tool remembers nothing between visits, so it starts from the same place every time. Only the counter and a blank name get in the way.
• Are the lines written by a model? No. Every line comes from a fixed bank of 180 hand-written lines shipped inside the page: five categories, six vibes, six lines in each of the 30 cells. That fixed bank is also why long reroll sessions eventually repeat, which is covered in why headcanon generators repeat.
• What is the archetype line on the card? One of 24 labels drawn at the start of each roll. It is part of the exported set, but it is not a setting you can choose, and changing it does not change the five lines.

Where to take the set next

Session 1 leaves you with five lines, one per category. If the goal was a character sketch for a scene, that is finished. If the goal is a character you will come back to, the natural next step is to run the same name through more single-vibe passes and collect the results onto one page — the one-page, 30-line template is built for exactly that, and it uses the same five categories this tool does. If you would rather decide which of the 30 cells are worth filling for your character before you start rolling, the category-and-tone matrix walks through all of them, and the six-tone comparison shows what the same character looks like in each tone side by side.

Two last habits are worth keeping. Roll the name with the vibe chips left blank first, read the five lines, and only then decide which tone you actually want — the blank pass is the fastest way to find out what the character is before you commit to a mood. And when you find a line you will use, keep the bracket tag with it. The tag is the only record of the settings that produced it, and it is the difference between a set you can rebuild and a sentence you can only retype. Everything else on this site starts from the same tool: the headcanon generator is the page all of these notes are written about, and the rest of the guides are indexed there.