19.24.5 KPAGES

In Lusternia, knowledge pages (kpages) are like special notes that can help your dweller or pet remember important information using the cognition system. Here's a simple guide to understanding and using kpages:

What Are Kpages For?
--------------------
Kpages are mini-information pages that your character can use to give denizens more knowledge. They're handy for things like:

- Learning About History: You can create a kpage to remember specific events in the game's history.
- Org Knowledge: Keep track of general information about the various cities in the game.
- Spreading Rumors: Record rumors you want your denizen to share with others.
- Character or Creature Info: Store details about other characters or creatures in the game world.

Creating Kpages
---------------
Let's say your dweller is named Boberta and you are from BobTown. Here's how you can create kpages for Boberta:

- Create a Kpage for Boberta: Start by creating a kpage named "Boberta".
- Add Dweller Info: Put basic details about you, your house, or your family so the AI knows any specific things Boberta should know.
- Create an Nations Kpage: Make another kpage called "Nations" and add any general city or commune info you want Boberta to know.
- Create a BobTown Kpage: Make another kpage called "BobTown" and add any specific BobTown-related info.
- Nest the BobTown Kpage: Nest the "BobTown" kpage to the "Cities" kpage
- Assign the Kpage: Use the assign command to set the "Boberta" and the "Cities" kpages to Boberta. The "BobTown" kpage is automatically added as well, as it is nested to "Cities".

Using Keywords for Efficiency
-----------------------------
All of your Kpages will be sent along with each query so to save chars and make kpages more efficient, you may set keywords for them. This way, the kpage is only sent to the AI when those keywords are mentioned by players. For instance, if you set the keyword "BobTown" for the BobTown kpage, it will only come up when someone mentions "BobTown." 

Sharing Kpages
--------------
You can assign kpages to multiple characters or creatures and even nest them under different kpages. You can grant access to your kpages to other players to use. This allows you to maintain one main kpage and share its content with various characters or groups of players.

Global Kpages
-------------
You will notice there are several kpages that are available to everyone. These are maintained by the admin and will be periodically updated with new information. The goal is to keep them as short and helpful at the same time as possible. Dash, the gnome explorer has the following pages assigned: 1, 9, 13, 15, 16. Those pages have other pages nested in them to greater effect. You can copy those pages and adjust them for your denizens.

Cognition Kpage Syntax
------------------------------------------------------------------------------
CREATE <name>               Create a new knowledge page.
DELETE <id>                 Delete a knowledge page.
RENAME <id> <name>          Rename a knowledge page.
EDIT <id>                   Edit a page.
ASSIGN <id> <target>        Assign a page to a creature.
UNASSIGN <target>           Remove a page from a creature.
UNASSIGN <id> ALL           Remove a page from all creatures.
LIST                        List your pages.
<id>                        Show information about a page.
NEST <id> <parent>          Attach a page to another.
DENEST <id> [ALL]           Unattach a page from another, or all pages.
GRANT <id> TO <player>      Grant access to a page.
REVOKE <id> FROM <player>   Revoke access to a page.
KEYWORD <id> ADD <x>        Add a keyword.
KEYWORD <id> REMOVE <x>     Remove a keyword.
KEYWORD <id> CLEAR          Remove all keywords.
------------------------------------------------------------------------------

Also See: HELP COGNITION, HELP COGNITION PERSONALITY, HELP COGNITION RULES, HELP COGNITION FAQ, HELP AI ETHICS