Craft

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