server: every unique on the shard - census the later sources, import Roc, Demon God Shaitan and the rest

Open
#3,495 1 comment 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
Domain
backend, game-dev

Research direction

This is a census across many data sources, not a single code change, and it depends on the open design work in #3348 and the Roc import in #3399. Start by reading catalogue/monsters_real_test.go (realUniques) and monster/data/qinshi_tomb_characterdata.tsv to see how uniques are listed today. Done means the census table is complete and every unique in it spawns on the shard, or the owner has recorded why one does not.

Written by the indexing model from the issue text.

Description

area: server enhancement priority: critical

Owner order, 2026-11-14: "WE MUST HAVE ALL UNIQUES." Every unique the later sources carry has to exist on the shard. This came out of the Devil's Spirit unique-token design (#3348), which needs the full unique roster.

Where the shard stands today (checked 2026-11-14)

Placed from the v1.150 data (characterdata MonsterType 3, catalogue/monsters_real_test.go realUniques):

Unique Level HP
Tiger Girl 20 0.6M
Cerberus 24 0.7M
Captain Ivy 30 1.1M
Uruchi 40 1.8M
Isyutaru 60 4.3M
Lord Yarkan 80 9.4M
Demon Shaitan (MOB_RM_TAHOMET) 90 12.7M

Each also has stronger _L2 and _L3 rows (3x and 10x HP).

Qin-Shi Tomb (the Jangan cave) is behind SRO_QINSHI_TOMB, default on. Its rows are embedded in monster/data/qinshi_tomb_characterdata.tsv, and the TombChain spawns the uniques:

Unique Level HP
Black Tortoise Jeonuk 98 11.0M
White Tiger Soho 99 8.8M
Azure Dragon Taeho 99 8.8M
Vermilion Bird Yeomje 98 8.4M
Flame Master Sinmu 100 23.0M
White Snake Baekryeong 100 250M

Black Snake Soso, Snake General and Tomb General are grade 8.

Egypt and the Pharaoh tombs are imported with SRO_CAP110_MONSTERS, among them Apis, Karkadann and Mustafa (docs/features/CAP110.md).

Missing:

  • Roc (MOB_RM_ROC): the v1.150 client has its name, effects and skill effect, but no characterdata row. The v1.188 server's drop generator names it (research/investigations/loot/drop-generator-hypothesis.txt, 0x0072462f). Its arena, gate and quest are #3399.
  • Demon God Shaitan (MOB_RM_DEVILSAYTAN): the v1.150 client has its name; the shard has no characterdata row and no spawn.

Steps

  1. Census. List every unique (MonsterType 3, and the grade-8 bosses) that appears in any source we read: v1.150, VSRO, the pinned v1.696 client, the v1.188 server, iSRO-R, the census. For each, record whether the shard spawns it, behind which flag, and from which source.
  2. Import every missing unique: its characterdata, skills and tactics rows, its spawn (field nest, instance or event), and its drops. Each import gets its own PR, following the later-sources import rule. Roc goes through #3399.
  3. Flags: where a unique ships behind a port-only switch, say whether the switch is on in production, and list any that are off for the owner.

Done when

The census table is complete, and every unique in it spawns on the shard (or the owner has recorded why one doesn't).

Refs #3348, #3399, #1751.

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.