Settings
Settings tells the Workbench where things are: the DayZ install it reads the game from, the optional DayZ Server and DayZ Tools, and the folders of your mods. It also holds the language, the theme, the external editor, whether Beans Assistant shows and the privacy choices. Nothing is applied before you click Save.
The screen
The settings are grouped in five tabs. Auto-detect and Save stay in the header on every tab; Save writes the changes of all tabs at once. The last tab you opened stays selected while the Workbench runs; the first visit opens General, or Game & paths while the DayZ folder is not found.
- General
- Appearance: language (12, or the system's), theme (the four of the Beans Launcher), your profile, whether the last file reopens at start, whether Home shows its first steps again.
- Updates: the daily update check.
- Game & paths
- Installations: the DayZ game folder, the DayZ Server folder, the DayZ Tools folder (optional), the P: drive, your default private key and Blender (the executable used to read FBX and .blend models; empty finds it on its own). Each line says whether the folder is found and whether it looks like the right one. Auto-detect searches your Steam libraries again and keeps the other settings.
- Workspaces: the folders that hold your mod sources. They are listed in the explorers and indexed by the script editor.
- External editor: the command that opens a file at a line in your own editor
(
{file}and{line}); empty picks VS Code, else Notepad++ on Windows. Below it, the size of the Layout Editor's design viewport. - Beans Assistant
- Show or hide the built-in chat. Off: only external agents, through Connect my agent (page).
- Account & usage: the Steam account signed in to Beans Assistant, its plan and usage bars (this month's free use, the plan's daily limit: about 14, 20 or 60 GLM 5.3 Flash requests with Casual, Modder or Creator, pack credits). Account and usage and Plans and packs open them in the assistant panel; Manage plan, Sign out. Signed out: Sign in with Steam.
- Privacy: anonymous usage statistics, the optional Steam Web API key.
- About: version, run the setup again, source code, report a problem, Beans Launcher, the path of the settings file. The menu's About entry opens this tab.
First steps
- Open Settings (the gear at the bottom of the rail, or Ctrl+,).
- Open Game & paths and check the DayZ game folder: a green mark means the game's data can be read. If it is
missing, click Auto-detect, or Browse to
…/steamapps/common/DayZ. - Add the folder of your mods under Workspaces (or create a mod from Home).
- Click Save. The game data loads again; the status bar says when it is ready.
Take the tour of Settings (in the app)
Common tasks
Install and declare DayZ Server
DayZ Server is a free tool in your Steam library (Tools). Install it, then Auto-detect. The Launcher needs it for local tests, and Central Economy finds its missions.
Change the language or the theme
General tab, Appearance, then Save. The language applies to every page; the theme also colours the title bar on Windows 11.
Use your own text editor
Game & paths tab, External editor: for example code -g {file}:{line}. Pages that list problems in files open
them there.
Turn statistics off
Privacy tab: uncheck the usage statistics; the update check is under General. The environment variable
DO_NOT_TRACK=1 turns the statistics off too.
Concepts
- DayZ game folder: the Workbench mounts its PBOs read-only (a virtual file system) so every page can show vanilla scripts, configs, models, layouts and textures. It never writes there.
- P: drive: DayZ Tools work on a virtual drive
P:that mirrors the game's folder structure. The Workbench does not need it; set it only if you use DayZ Tools. - Private key: the
.biprivatekeythat signs your PBOs. Its path is stored, never its content. - Beans gateway: the Beans server the built-in assistant talks to. Its address is built into the Workbench and cannot be changed in Settings (a gateway address saved by an older version is ignored). You sign in with Steam there; the Workbench never asks for an API key of your own.
Pitfalls
- Leaving the page without Save discards the changes (the Workbench asks before quitting).
- Pointing the game folder at DayZ Server, or at the
!Workshopfolder: the line says the folder is found but something is missing in it. - Secrets (gateway token, API keys, Discord webhooks) stay in the settings file. They are never sent to a model and never part of what a page tells the assistant.
For agents
- Settings are in
settings.jsonunder the user's config folder (dz-workbench-enhanced);dztreads the same file, so tools use the same game folder and workspaces. - The tabs' buttons carry
settings-tab-<general|paths|assistant|privacy|about>; a tour clicks one before pointing at a section in it. - The page context only says whether there are unsaved changes. Install folders and workspaces are part of every page's context; secrets are part of none.
- Do not ask the user for keys or tokens; point them at this page instead.