Commands

The npc utility provides many commands for interacting with campaigns, game systems, and characters. While some commands have override options for flexibility, almost all customization is handled by NPC’s configuration files. See Core Configuration for how to customize NPC for your games.

Note

Some commands can only be executed within a campaign directory, or one of its subdirectories. When run outside of a campaign, these commands will show a warning and immediately exit.

Commands are often broken into subcommands. Invocation might look something like npc session or npc describe tags.

Tables of Commands

Campaign-Related Commands

Command	Description
init	Create the basic folders to set up an npc campaign
info	Show info about the current campaign
session	Create and open the next session and plot file
latest	Find and open the latest plot or session file, or both
settings	Browse to campaign or user settings

Character Commands

Command	Description
new	Create a new character
lint	Check character files for errors
list	Generate a public listing of characters
reorg	Reorganize character files

Description Commands

Command	Description
describe systems	Show all configured game systems
describe system	Show details about a single system
describe types	Show all configured character types
describe type	Show details about a single character type
describe tags	Show all configured tags for this campaign
describe tag	Show details for the named tag

Report Commands

Command	Description
report values	Show a how many times each unique value appears for the given tag