Adding a job

Worked example: adding a BAKER.

1. The enum

core/Profession.java:

BAKER("Padeiro", EnumSet.of(JobType.CRAFT), "rolling_pin"),

Argument	Meaning
`ptName`	Legacy display name — the UI now reads from `.lang`, so this is a fallback
`allowedJobs`	Which `JobType`s the profession may perform
`triggerItemKeyword`	Substring of the item id that assigns the job

Verify the keyword against real ids

fromItemId matches by substring on the item id. Check that an item containing your keyword actually exists:

find Server/Item/Items -iname "*rolling*"

If nothing comes back, the job can never be assigned. This is exactly how bow and sword matching became fragile.

Order matters: fromItemId returns the first match walking the enum in declaration order. A keyword that is a substring of another profession's will shadow it.

2. Translations

Both files, together:

# Server/Languages/en-US/ui.lang
prof.baker = Baker

# Server/Languages/pt-BR/ui.lang
prof.baker = Padeiro

The key is ui.prof. plus the enum name lowercased. A missing key renders as the raw key in game — prof.hunter was missing for a long time and nobody noticed.

3. Showcase icon

logic/NPCShowcaseItems.java:

case BAKER -> "Food_Bread";

Verify the id exists:

ls Server/Item/Items/Food/Food_Bread.json

Return null if there is no sensible item; the slot hides itself.

4. Behaviour (optional)

Without work behaviour the job is cosmetic: it shows in the panel and colours dialogue.

To give it work, add a JobType and handle it in NPCWorkHelper, following how FARM and HUNT are implemented — find target, walk, timeout, act, deposit.

Do not skip the timeout. An NPC that cannot reach its target and has no timeout re-issues the same leash point forever.

5. Check the preference pool

NPCPreferences rolls liked and disliked professions from PROFESSION_POOL. Add the new one there if NPCs should be able to have an opinion about it.

Checklist

Enum entry, keyword verified against a real item
prof.<name> in both language files
Showcase icon, id verified in the assets
JobType and NPCWorkHelper branch, if it should work
Added to PROFESSION_POOL if relevant

1. The enum​

2. Translations​

3. Showcase icon​

4. Behaviour (optional)​

5. Check the preference pool​

Checklist​