Contributor title: Discord Contributor role shows a yellow title in game (port-only)

Open
#3,358 2 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
12/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Active
Tech stack
go, typescript

Research direction

This is a design-heavy port feature spanning server, client and reverse-engineering research, so it is not a first task. Start by reading the Contract section: the contributors.json and contributor-titles.json files in the shard directory, the 0x3FC1 roster packet, and the SRO_CONTRIBUTOR_TITLES switch. Done means the native title routines are labelled in both Binary Ninja databases and the summary is posted here.

Written by the indexing model from the issue text.

Description

area: client area: server enhancement priority: high

Owner ask (2026-11-12): every Discord member with the Contributor role carries a yellow Contributor title in game, seen by everyone. On by default; a contributor can turn their own title off, and that choice is a server setting (every viewer sees the same state), not a client cosmetic.

Port-only, not native: behind SRO_CONTRIBUTOR_TITLES (off = native, nothing on the wire).

Contract

  • Source of truth: contributors.json in the shard directory, {"accounts":["<account id>", ...]}, written atomically by an ops sync (Discord role members -> linked game accounts). The GameWorld re-reads it when it changes (polled each minute); a missing file means no contributors, a corrupt one keeps the last good set and logs.
  • Opt-out: contributor-titles.json in the shard directory, owned by the GameWorld only ({"hidden":["<account id>"]}). /contributor off and /contributor on in chat change it for the speaker's account; a non-contributor gets a system line saying so.
  • Wire: S->C 0x3FC1 (port-only, next free after 0x3FC0) carries the shown roster: u16 count, count x { u16 len, ascii name }, the character names currently online in the division whose account is a contributor and not hidden. Sent to a session on world entry and to every session in the division whenever the roster changes.
  • Client: a player whose name is in the roster gets a yellow Contributor row over the nameplate (above the guild row); chat lines from that sender get a [Contributor] tag that stands out from the yellow global channel.

Native research (same ticket)

Label every title-related routine in both Binary Ninja databases (client: CPSTitle/pstitle.txt, the com_honor_level_%d icon users incl. sub_6757a0/sub_6758e0, stall title mode 4 on the nameplate, siegefortressbattlerank.txt users; server: the matching senders). Record what v1.150 actually shows over a name and how it is switched on, in ../research and a summary here.

Dominant language
Go
Stars
97
Forks
61
Avg merge
4h 14m
Merged PRs (30d)
913

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from opensro-dev/opensro

All issues in opensro-dev/opensro

Similar issues

More Go issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.