Glossary
Craft borrows words from tabletop games, software and AI, and some of them mean something specific here. Each entry says what the word means in Craft in a line or two, and links to the doc that explains it. For how the parts fit together, start with About Craft.
Projects and files
- Project: what you build in Craft, a world or a system. It holds files, file types, folders and settings. Project settings
- World: a project people play. Games are started from a world. About Craft
- System: a project that is a rules framework for others to build on. It isn't played; people create a world from it. About Craft
- File: one record of a world: a character, a place, an item, a rule, a page of lore. Every file has a name, a folder and a type. Files
- Folder: free-form grouping of files. Any type of file can sit in any folder. Files
- File type: the blueprint for one kind of file. It says what its files store, how they look, and whether they are a special kind. File types
- Schema: the fields a file type's files store, with their kinds and rules. File types
- Field type: the kind of a schema field: text, number, a list, a reference, a picture and so on. Field types
- Key fields: the fields of a type the GM keeps in mind on later turns after it reads one of its files. File types
- Designation: what tells Craft a type's files are people, places, game starts or scripts, and turns on the features built for them. Most types have none. Designations
- Layout: how a type's files look on their page, and which values players change with a tap. Layouts
- Reference field: a field that points at another file, like a character's class. References
- Computed field: a field that works out its value from an expression instead of storing one, like a modifier from a score. Computed fields
- Visibility (of a file): whether the GM can find and read a file. Every file is visible unless it is hidden. Visibility
- Version history: the earlier versions of a file or a file type, which you can go back to. Versions
- Mention: a link to another file written inside a file's text. Links and mentions
- Trash: where deleted things wait until you restore them or delete them for good. Deleted projects and games go to your account's Trash for 3 days and are then deleted. A world's own trash of files, folders and file types is never emptied on a timer. The trash, deleting a game
Places and maps
- Location: a file of a type with the location designation. A location can have a map. Maps
- Map: the picture of a place, with the areas, pins, tokens and exits drawn on it. It belongs to a location file. Maps
- Root map: the world's top map, which opens first. Every other map sits somewhere below it. Maps
- Area: a shape drawn on a map, usually linked to the place it marks, like a district or a room. Map areas
- Pin: a point on a map, usually linked to a place too small to draw. Pins
- Token: a person standing on a map. Tokens
- Terrain: ground marked on a battle map: impassable ground nobody can stand on, or a kind of ground the map defines, like water or lava, with what it does to whoever stands in it. Terrain and walls
- Wall: a line on a map nobody can walk through. The GM walks moves around walls. Terrain and walls
- Exit: an area or pin that is a way to another place: a door, stairs, a road, a portal. The GM moves the party through exits. Exits
- Linked location: a place tied to another without a spot on a map: inside it, part of the same place, or joined to it by a way. Linked locations
- Transport: a location that carries people, like a ship or a caravan. Linked locations
The Game Master
- Game Master (GM): the AI that runs a game. It tells the story, rolls dice and records what changes. It reads GM instructions and keeps its own memory, scene and trackers. About Craft
- GM instructions: the rules a world gives the GM: always on, situational and procedures. GM instructions
- GM instruction file: deprecated with GM Harness V1. A file the GM once read its rules from. The GM no longer reads these files. GM instructions
- Always on instruction: an instruction the GM gets on every turn. GM instructions
- Situational instruction: a short reminder the GM gets only on turns when its moment comes. Triggers
- Trigger: the moment a situational instruction is for, like "when a character drops to 0 HP". Triggers
- Procedure: the steps for running a longer moment, like a fight or a negotiation. The GM reads one whole when its moment comes. Procedures
- Section: a named group of GM instructions. The GM reads them in order. Format
- Craft's defaults: the instructions and procedures Craft adds to every world, kept up to date until you change them. Craft's defaults
- Player option: a question the player answers for their game, like difficulty or response length. Each choice brings its own instructions. GM instructions
- Script: JavaScript the GM runs during play, so a rule comes out the same every time. Scripts
- Script card: the card a script players can see draws in the story, with buttons that run its actions. Script cards
- Dice notation: how a roll is written, like
2d6+3. Dice
Games and play
- Game: one playthrough of a world. It is its own copy of the world, made from the latest version when it started (or the live project, before the first version). It has one player, its owner. Your game
- Game slot: what each game you own uses from your plan, including games in the trash. Deleting a game, limits
- Inspect turn: the message menu action that shows exactly what the GM was sent on a turn (its instructions and every message) and every step it took, with search. The message menu
- Request id: the id of the GM request behind a message, copied from its menu. Orbit and the Craft CLI read a turn's record by it. Debugging a GM turn
- Delete from here: the message menu action that removes a message and everything after it, and undoes the GM's file changes from those turns. The message menu
- Lobby: where a player picks a game start, a character and the game's settings before play. Game starts
- Game start: a saved opening players pick from: where play begins, who they can play, who is in the opening scene and where, and how the first turn opens. Game starts
- Extra: someone or something in a scene with no file of its own, like two bandits, a guard dog or a crate. It can be a copy of a file, such as a monster's stat block. Game starts
- Prelude: a world's intro of full-screen steps, played when a new game opens. Flows
- Creation flow: the guided steps a player goes through to make a character. Flows
- Current state: what a game holds about right now: where the party is, who is on the map and where, the time, and the trackers. The current state
- Pinned files: the files in a game's side panel for players to open during play. A world sets the ones new games start with. About Craft
- Scene: the place play is in and the people in it, kept in the current state. The current state
- Tracker: a card the GM keeps in the current state for players to watch: the time, objectives, a turn order, a clock, standing with a faction. Trackers
- Tracker template: what a world's own tracker starts as, and its rules. Tracker kinds
- Game memory: what the GM keeps of earlier play: recent turns word for word, older ones folded into chapters, and a running summary. What the GM remembers
- Image bank: Craft's library of ready-made art. With it on, the pictures the GM adds in a game are free. The image bank
- Expression: one of the faces a character's portrait can show. Expressions
- Cutout: a character's picture with no background, which stands in the scene. Expressions
Building with AI
- Orbit: the assistant built into every world, for building. In a game it is the out-of-character channel. Orbit is not the GM. Orbit
- Subagents: small helpers Orbit hands a wide job to, each with its own list of files. Orbit
- Instructions for Orbit: a world's standing instructions for Orbit. The GM never reads them. Orbit
- Craft CLI: the command that keeps a project in sync with a folder on your computer, for editing with any tool or coding agent. The Craft CLI
- Workspace: where a project is edited: the workspace in the app, or a folder cloned with the Craft CLI. The Craft CLI
- CDF (Craft Data Format): a world as plain files. A Workspace CDF is a zip of a whole world. Import and export
- Import: bringing a Workspace CDF zip, or one file, into Craft: as a new world, or as changes to a world you have. Import and export
Sharing
- Draft: the project as you are editing it. Once a project has a version, new games start from the version, not the draft. Publishing
- Version (release): a numbered, frozen copy of the whole project. New games start from the latest version. Releases
- Visibility (of a project): who can find a project: only you, anyone with the link, or everyone on Discover. Publishing
- Discover: where published worlds, systems and visual novels are listed for everyone. Publishing
- Clone: a copy of a project in a new project of your own. Publishing
- Game sync: pulling a world's newer version into a game, or pushing a game's changes back to its world. Game sync
- Package: a slice of a project, files and the file types they need, for other creators to install. Packages
- Handbook: a book of chapters a project carries for people: the Player's Handbook or the Builder's Manual. Handbooks
- Visual novel: a story readers click through page by page, made from a game or written from scratch. Visual novels
- Profile: your public page: your shared projects, visual novels and packages, your achievements, and who follows you. Others tip you from it. Energy and credits
- Studio: your own library of every picture, video and track you make or upload, across every world. The studio
- Content rating: how mature a shared world is, set by the review after publishing. The content policy
Energy and credits
- Energy: the daily allowance a plan gives for AI use. It refills every day. Energy and credits
- Credits: bought, earned or tipped; they never expire, and pay for anything energy can. Energy and credits
- Core models: a set of capable, affordable text models, free up to a daily amount on every plan and unlimited on Plus and above. Energy and credits
- Creator earnings: credits a creator earns when other people play their worlds, or worlds built on their systems. Energy and credits
- Usage history: every charge on your account: when, what for, the model, the amount and which currency paid. Energy and credits
- Limits: the caps Craft puts on files, instructions, maps and the rest. Limits