Presets and Prompts - Inktomi93/OrbWeaver GitHub Wiki

A preset is how you shape the writing: the order of everything that goes into the prompt, the sampling settings, the questions it asks you per chat, and the regex scripts it runs. It does not choose the model. Replies use the room host's Chat model, selected under Model roles. → Connect a model

Each setting explains itself in the app, so this is about the tasks.

Open and activate a preset

Open Presets. A fresh install has one preset, the built-in default. Press New to start another, or Duplicate a row from its menu to start from one you like.

Exactly one preset is active. It's the one the next reply is written with. Press the activate dot on a preset's row to make it active, and Orbweaver confirms with a notice. A room always writes with its host's active preset, so in a shared chat the host's choice applies to everyone. The one per-room exception is a game's GM voice. → RPG mode

Changes save as you make them.

The built-in default is protected

You can't change the built-in default. Your first edit to it saves your own copy and tells you so, and if the default was active, the copy becomes active. If you already have a copy, you're asked whether to keep editing it or start a new one.

The built-in default also can't hold regex scripts. Edit anything else about it first and the copy can.

Arrange the prompt

Open a preset and switch to its Prompt view. The sections are listed in the order they go to the model.

The Prompt view with the Chat history band

  • Sections are either built-in pieces (the main prompt, the character's description, your persona, memory, attached documents under Databank, world info and more) or Literal text you write yourself.
  • Chat history is the divider where the conversation goes in. It's always on and can't be deleted. Sections before it come before the conversation. Sections after it come after your last message.
  • Reorder by dragging a row by its handle, or by picking it up with the keyboard.
  • Switch a section off with its switch. Nothing is deleted, so you can bring it back. Built-in pieces can only be switched off. Only Literal text can be deleted.
  • Add puts a new section on the list and opens its editor. You can add Literal text, or any built-in piece that isn't already there.
  • Edit a section with the arrow button on its row. There you can rename it, change its role, place it inside the conversation at a depth (sections after Chat history), or limit it to certain kinds of generation with Fires on.

The Memory section is where recalled memories land. It stays empty unless the host has memory switched on (Remember earlier in long chats, under Chat behavior) and the chat has something to recall. The summaries behind those memories are written by the host's Utility model. → How memory works

To see what a section costs, open the Prompt readout (Show details if it's hidden). It shows an estimated token cost for each section, priced against the chat you last had open as if this preset were the active one. With no chat open it falls back to rough estimates from the preset's own text. To see the whole assembled prompt for the next reply, the host can use the chat's Preview tab. → How a turn is built

Watch for the prompt-cache warning

If the preset editor warns about changing content before Chat history, review the named sections and move them after the history when that suits your prompt. The built-in order does not need rearranging just to clear a warning. To check changing lore in a particular room, open its Preview; it names the entries involved. See How a turn is built.

Tune sampling

The Params view holds the Quality dial and the sampling and reasoning controls. Sampling and reasoning show only the controls your Chat model supports, so connect and select a Chat model first. Until then, those parts wait. → Connect a model

Check Editing for Chat role before changing a preset for your story. Connection in view changes the readout only; it does not switch your Chat connection or the editor's target.

If a preset holds a value your current model ignores, a notice names it. Press Keep to leave it for a model that does honor it, or Clear to remove it.

Ask yourself a question per chat: variables

A variable is a question your preset asks for each chat, such as which tone to write in.

  1. Open the preset's Data view and press Add variable.
  2. Give it a name, the question, and the options to pick from.
  3. Use {{name}} in a section. The picked answer is filled in there.
  4. In a chat, open Show details, go to This chat, and answer under Macro picks.

Answers belong to the chat, so everyone in the room shares them, and any member can change them. A variable you haven't answered uses its default. The same section holds the inputs of any macros you wrote in the Data view.

Import a SillyTavern preset

Press Import a preset on the Presets page and drop in the preset's .json file. A summary shows what's about to happen before you commit:

  • It becomes a new preset named after the file.
  • SillyTavern's prompt order becomes your section list, and its custom prompts become Literal text sections.
  • Any SillyTavern field that has a value but no home here is listed, so nothing is dropped silently.

Only Chat Completion presets come over. Text Completion, KoboldAI and NovelAI presets aren't supported, and the import refuses them. → Coming from SillyTavern

Importing a preset exported from Orbweaver works too. A preset with the same content as one you have is reused; the same name with different content lands beside it as "Name 2". Nothing is replaced. To share a preset or back it up, use Export in its row menu. The built-in default has no Export, so duplicate it first.

A whole SillyTavern profile import brings your presets in with "(OpenAI)" after their names, and regex scripts that came attached to a preset are attached to it again.

Run regex scripts from a preset

A preset can run find-and-replace scripts from your regex script library. Open its Transforms view, find Regex, and pick the scripts you want. You can open the library from there to write new ones, and a script has a tester so you can try it before it touches a chat.

To see which scripts run in one chat, use the Regex section under This chat. Only the host can change them.

Import a regex script on the Regex page takes a raw SillyTavern regex file or an Orbweaver export.