API v6.4 - Cultures

From Classic's Cultural Protocols to Legacy's new, automated system of 353 mapped ethnicities, 196 religions and 241 languages.

---

Shoutouts: Doc, beifengxiaoxiao, Luis1p, Infinite1, imperialpearl and Auditorii for helping save CPs from Classic!

New goodies

1. https://assets.prtcy.com/backups/202511-cultures.docx - includes a backup of all CPs from https://forum.prtcy.com/forum-51.html (ported from Classic), since that section will be deleted after the launch

2. https://api.prtcy.com/cultures/ - {nation_key}s are matched from https://prtcy.com/gateway/library/nations/

   1. keys/

   2. digests/ - {nation_key}

   3. ethnicities/ - {ethnicity_key}

   4. religions/ - {religion_key}

   5. languages/ - {language_key}

   6. nations/ - {nation_key}

      1. digest/

      2. demonym/

      3. summaries/

         1. general/

         2. ethnicities/

         3. religions/

         4. languages/

         5. tools/

      4. items/

         1. ethnicities/ - list of {ethnicity_key}s

         2. religions/ - list of {religion_key}s

         3. languages/ - list of {language_key}s

         4. tools/ - list

To double-check your nation’s culture, first find its key from https://prtcy.com/gateway/library/nations/, then visit https://api.prtcy.com/cultures/{nation_key}/ but replace {nation_key}, i.e. https://api.prtcy.com/cultures/8/ (Amudim).

Changes

1. Endpoints can be individually handled (optional), when there is no data

2. Cleaned up development logs

Fixes
N / A

Background

We used the list of nations, which includes their keys and names, from the website’s library at https://prtcy.com/gateway/library/nations/ and the list of CPs from https://forum.prtcy.com/thread-248.html.

Our goal was to generate (with the help of AI) 2 things:

1. Summaries for each nation

2. Items for the library

And our categories were:

1. Ethnicities

2. Religions

3. Languages

4. Tools

Each culture has a general summary, 3 separate summaries for each category, a guideline summary, a digest meant solely for players looking which nation to join and a list of items for each of those categories.

Limits are 1200 characters for summaries, 240 for digest and max 15 for items.

---

Countdown to launch: processing Cultural Protocols from Classic to Legacy

Process (AI-assisted)

Each CP was scraped and matched with the list of nations. With the help of natural language processing (NLP), ethnicity, religion and language items were extracted and re-formatted in the following fields:

1. Name (i.e. Dundorfian)

2. Real-life equivalent (i.e. German)

3. Population % (i.e. 75.5)

If the name was encountered for the first time, it was also added as a library item. A demonym was attempted to be extracted - reverted to null if unsuccessful.

For tools, a simple name and URL format, kept only for that specific nation.

Then, summaries were generated (incl. guideline).

Finally, the digest.

Almost an hour later…

Purpose

Quite simple, actually. Display the information on portals (former nation pages) and the library - and allow players to edit that information on both, with requests.

1. On the library, items can be added/edited/deleted, impacting all nations

2. On portals, players can only add items that are available on the library

3. Digests work automatically behind the scenes

More on the above, on future updates.

---

Missed the previous update?