Ped Relationship Editor

The Ped Relationship Editor is a matrix of every relationship group the game defines. You set who likes and who hates whom, add your own groups, and take away a resource that applies the whole set on every client. Everything runs in your browser.

Quick start

1. Pick a value under Click a cell to set. Hate is picked for you, because that is what most people came for.
2. Click cells in the matrix. A row is how that group feels about the column.
3. Use the filter box to cut the matrix down to the groups you care about, for example GANG or COP.
4. Open Resource at the bottom and press Download resource.
5. Unzip it into your resources folder, add ensure fivemad_relationships to your server.cfg and restart.

Ctrl + Z undoes, Ctrl + Shift + Z redoes. Share copies a link that carries the whole set, so you can send it to someone or keep it in a note.

Reading the matrix

The cell at row COP, column CREW is how cops feel about your crew. The cell at row CREW, column COP is a different cell and can hold a different value.

None is drawn as nothing at all, so the only coloured cells are the ones where somebody feels something. Green is friendly, amber and orange are wary, red is hostile. A cell you changed gets a white outline, so you can always tell your work from the game’s.

Right click a cell to put the game’s own value back.

Set both directions at once in the side panel is an editing convenience: with it on, clicking a cell fills the mirror cell too. Turn it off when you want a one sided relationship, like an animal that attacks the player while the player has no opinion about it.

The acquaintance values

The picker offers Respect, Like, Ignore, Dislike, Hate and None. Wanted (4) and Dead (6) exist in the enum but are left out of it: across 4,141 relationship calls in the game’s own scripts, 4 is set only four times and 6 is never set at all. If you need one, write the number yourself in the runtime code.

The “what it does” column is our own reading of the name. Nobody can start GTA V in a browser, so the names and the numbers are sourced and that column is not.

Focusing a group

Click any group name, in the matrix header or in the changes list, to focus it. The side panel then shows:

• Its hash, both as hex and as the signed integer, ready to copy.
• Set this group’s view of every other group, which fills the whole row in one click.
• Set every other group’s view of this one, which fills the whole column.
• Everything it feels, and everything that feels about it, as two short lists.

Those two row and column buttons only touch the groups the filter is currently showing. Filter to AMBIENT_GANG first and “set every other group to Hate” means every ambient gang, not the whole game.

Your own groups

Type a name and press Add. Names are forced to the shape the game uses: capitals, digits and underscores. The hash is joaat of the lower case name, the same rule the game uses for its own, which is why GetHashKey('MY_GANG') and AddRelationshipGroup('MY_GANG') agree.

Removing a group also removes every relationship that touched it.

Put the player ped here sets which group the player’s own ped joins. The generated resource re-applies it after a respawn, because a new ped handle comes back in its default group.

Presets

A preset is a starting point, not a reset. It adds to what you already have. Reset clears everything.

The outputs

Resource

fivemad_relationships is the one to use on a server. It holds five files:

fivemad_relationships/
  fxmanifest.lua
  config.lua
  server.lua
  client.lua
  README.md

The server publishes the set once to global state. Every client reads it and applies it, including a player who joins an hour later. Change it from another resource and every client swaps over:

exports['fivemad_relationships']:setRelationships({
  groups = { 'MY_GANG' },
  player = '',
  rel = { { 5, 'MY_GANG', 'COP', 255 } },
})

Every row is { acquaintance, from group, to group, what the game shipped }. That fourth number is what makes a change reversible: when the set changes or the resource stops, each client puts the game’s own value back instead of leaving your old one behind. 255 means the game shipped nothing for that pair, so undoing it is a ClearRelationshipBetweenGroups rather than a set.

The client script creates your own groups with AddRelationshipGroup, which returns ok, groupHash, and uses the hash it hands back. GetHashKey on the same name gives the same number, because both are joaat of the lower case name, but the returned hash is the one the game itself is using and it is only the fallback here.

With Per ped groups from a state bag on, the client also watches each ped’s relgroup entity state, so any server script can put one ped in a group:

Entity(ped).state:set('relgroup', 'MY_GANG', true)

Runtime code

The natives on their own, for pasting into a resource you already have. Switch between Lua, JavaScript, TypeScript and C# on the block. This is client side code: the relationship matrix is client side game state and the game never networks it, so every client has to set it for itself.

Which group a ped is in is a different thing, and that one is networked, so SetPedRelationshipGroupHash on the owner of a ped carries to everyone else. Only the matrix itself has to be applied per client.

There is a second block that undoes the first one. Keep it. It is the part people forget.

relationships.dat

The game file, in the format the game ships, with your changes folded into the game’s own set.

The format has a keyword for Respect, Like, Dislike and Hate only. Ignore (2), Wanted (4) and Dead (6) have no keyword and cannot be written at all, and None (255) is written by leaving the line out, so a None you set on a pair the game had an opinion about cannot be expressed. The tab lists every relationship it had to skip. They are all in the resource and in the runtime code.

Troubleshooting

Privacy

Everything runs in your browser. The matrix, the resource zip and the .dat are all built on your own machine and nothing is uploaded. The only thing the page fetches is the list of the game’s own groups.