Knowledge Editor

Knowledge Overview

So what is knowledge? Knowledge is described in greater detail on the Knowledge page, but a brief synopsis is given here. Knowledge is defined as something that the NPC is aware of that they did not experience themselves.

Knowledge is added to various knowledge docs in three ways.

1. Knowledge is added to knowledge documents as part of the mission system. When companions are sent on a mission, a mission narrative is AI generated. This narration is converted into knowledge updates and appended to relevant documents. More detail can be found in the mission section.

2. Knowledge can be added to the user-journal as an effect of completing an npc_objective.

3. Knowledge documents exist at game creation. This knowledge is created inside of the knowledge editor and thus is what we are going to cover on this page.

Knowledge consists of a tag, description, and various levels of knowledge. The knowledge tag is essentially the unique identifier for some entity. For instance, if you want NPCs to know things about an NPC TumTum, I'd recommend just creating a tag 'TumTum'. The description could be 'Information about the NPC 'TumTum'. The description is optional at this point - so feel free to use or not use this if you'd like. Finally, we have the knowledge itself. Knowledge is sub-divided into 3 types (inherent, inherited, assigned) and 6 levels (0-5).

Knowledge of level 0 - Inherent Knowledge - all NPCs know this knowledge. An NPC need not be assigned this knowledge to know it. For example, this could include like world-specific knowledge that all NPCs know.

Knowledge of level 1 - Common / Inherited Knowledge - This is essentially the knowledge that an NPC would have of some entity if they know like even the smallest amount about that entity. This knowledge is also known through inheritance. If an NPC is assigned knowledge of some tag, then that NPC also knows all level 1 knowledge of all child tags of that parent entity tag.

Assigned knowledge - levels 2-5 - Assigned knowledge is not known unless an NPC is explicitly assigned access to this level (or higher) of information. This knowledge is not inherited. Level 5 knowledge is essentially expert knowledge.

Creating Knowledge

Creating new knowledge is really pretty straight forward. Go to the knowledge editor in the front end, type in your tag (unique identifier, cannot be changed after), and click create new tag.

Then just fill in the boxes.

Lasly, click Update Knowledge to save (or update) the knowledge information.

All NPCs will have access to the level0 knowledge at this point. However, if you want NPCs to have access to level 1-5 knowledge, you'll either have to setup the inheritance tree (not implemented yet though), or assign knowledge to your NPCs 1-by-1 in the NPC Editor.