Kinfolk

# Kinfolk — Family Trees for WoW: Forever

Every character in WoW: Forever has a first **and** a last name. Kinfolk turns that last name into a family. It finds everyone on your ruleset who shares your surname and lets you link them into a family tree, with relationships that both players confirm.

Built for roleplayers, and especially for **Roleplay-PvP**, where families end up split across factions.

## Features

- **Your House, automatically.** Kinfolk reads your last name from your character. There's nothing to set up.

- **Find namesakes.** Press **Scan** (or `/kin scan`) to run a `/who` search for your last name. Kinfolk also notes Emberforges you target, mouse over, group with or see in your guild roster.

- **Kinfolk users find each other.** Players running Kinfolk who share a last name meet on a hidden channel and exchange profiles: class, level, guild and their confirmed family links.

- **Relationships take two.** Claim someone as your sister, son, cousin and so on. They get a popup to Accept, Decline or Suggest a different relationship. A link only becomes solid once both of you agree. Your own alts can be placed right away.

- **A shared tree.** When two other players confirm a link, everyone in the House sees it. Your tree grows beyond the people you've claimed yourself.

- **House divided (RP-PvP).** Kin on the other faction appear in their faction's colour. Since addon whispers don't cross factions, you link them with a short **kinship code** that you swap on Discord or in person.

- **In the world:** a tooltip line on players ("Your cousin · House Emberforge · House divided"), plus optional chat notices when family comes online or levels up, or when a new namesake is nearby.

- **Privacy controls:** choose who can see your family and who can claim you (anyone, guild and friends, or nobody).

## Commands

| Command | What it does |

|---|---|

| `/kin` | Open or close the family tree |

| `/kin scan` | `/who` search for your last name (15-second cooldown) |

| `/kin settings` | Options |

| `/kin claim First Last` | Claim someone as kin |

| `/kin code First Last` | Make a kinship code for kin you can't whisper (other faction) |

| `/kin redeem CODE` | Enter a kinship code someone gave you |

| `/kin forget First Last` | Remove someone from your records |

Left-click the minimap button for the tree, right-click it for settings. Kinfolk also shows up in the addon compartment.

## Limits

- Kinfolk can only see players who are online near you or in its channel, or who are shared by other Kinfolk users. No addon can search a whole ruleset.

- `/who` shows online players of your own faction only.

- Addon messages pause during combat and inside instances. Kinfolk queues them and sends them afterwards.

- Your data is saved per account in `KinfolkDB`.

## Feedback

This is an early release. Please report bugs and ideas in the comments or on the issue tracker.