Settings

"There is a setting for that. There is a setting for everything. That is the problem." — Clerk Second Class Umi Dray

Verified

Every StoryForce setting, with the default the code actually ships. Search by name or by what it does, or filter to one group.

Server settings are set by the person running the server, usually in storyforce_server.cfg. Client settings are yours, set in your own console or through the menus.

5 settings ship with one value compiled into the game and a different value in storyforce_server.cfg. The table shows the config file value, because that is the intended one. See server configuration.

Setting	Default	Side	What it does
`sf_allowvisitortoregister`	0	Server	Lets players create their own accounts. Off by default, so staff create accounts instead.
`sf_registercooldown`	10	Server	Minutes an address must wait after registering successfully. 0 switches it off.
`sf_registerfailcooldown`	45	Server	Seconds an address must wait after a failed registration. Throttles username probing. 0 switches it off.
`sf_logincooldown`	3	Server	Seconds an address must wait after a failed login.
`sf_logoutspecdelay`	20	Server	Seconds you stay in the world after logging out, so you can swap accounts without respawning.
`sf_charsperaccount`	10	Server	Characters a member can hold, from 1 to 30. Guests always get exactly 1.
`sf_membershiponcreation`	0	Server	Membership level given to accounts made with the admin create command.
`sf_seedaccount`	storyforce	Server	Username of the first account, created only on an empty database.
`sf_seedaccountpass`	admin	Server	Password for that first account. The default is public, so set your own before first boot. Changing it later does nothing.
`sf_startingxp`	50	Server	XP a new character begins with.
`sf_onlycomadmingivexp`	0	Server	Requires community admin to award XP, rather than any full member.
`sf_allowguestcomchars`	0	Server	Lets guests play community characters.
`sf_allowformermemcomchars`	0	Server	Lets former members play community characters.
`sf_formercanusemynpc`	0	Server	Lets former members use companion personas.
`sf_surfaceoffset`	16	Client	Fallback amount a seated character is lowered by, used until their own value arrives.
`sf_unauthcanchat`	1	Server	Lets people talk before logging in. Set to 0 to stop anonymous chat.
`sf_emotesyntax`	\|\|	Server	Characters wrapped around action text. Speech inside them is not counted for talk animations.
`sf_blockslashchat`	1	Server	Swallows a mistyped slash command in chat instead of broadcasting it.
`sf_commonlanguages`	huttese,rodese,binary,bocce	Server	Trade tongues a character with Diplomacy 3 understands.
`sf_chatprotection`	1	Server	Makes a player immune to damage while the chat bubble is up. Environmental damage still applies.
`sf_chatdistance`	1	Client	How distant speech fades. 0 off, 1 fade, 2 fade with a hard cut, 3 hard cut only.
`sf_chatdistance_percent`	10	Client	Lowest opacity distant speech fades to.
`sf_mergeteamsay`	0	Client	Routes team chat through the shortcode parser.
`sf_chatbubble`	1	Client	Shows a bubble above someone who is typing.
`sf_resultsperpage`	10	Client	Rows in a paginated list. The server limits this to 100.
`sf_downedstate`	1	Server	Incapacitates a character at low health instead of killing them.
`sf_downedhp`	25	Server	Health at which a character goes down rather than dying.
`sf_weaponsuseammo`	1	Server	Weapons consume ammunition. Set to 0 for unlimited.
`sf_spawnunarmed`	1	Server	Spawns players in the relaxed lowered-weapon stance.
`sf_hitboxscale`	0	Server	Scales the hit box with the model. Off by default.
`sf_tkrange`	1024	Server	Reach of the telekinesis lift.
`sf_forcemarkduration`	0	Server	Minutes a Force mark lasts. 0 means it lasts the whole map. Capped at 60.
`sf_dropforce`	300	Server	How hard a dropped item is thrown forward.
`sf_interceptrange`	2000	Server	Reach of comlink interception. 0 switches interception off.
`sf_allowledgegrab`	1	Server	Allows ledge grabbing at all. Combined with each player's own setting.
`sf_comadmincmds`	270549387263	Server	Commands community admins can use, as a bit mask. Set by the shipped config.
`sf_clericaladmincmds`	279173920768	Server	Commands clerical admins can use. Additive on top of community.
`sf_leadercmds`	549771542528	Server	Commands leadership can use. Additive on top of clerical.
`sf_storytools`	-1	Server	Which tools count as story tools at all. The master gate for both lock types.
`sf_storytoolsblock`	65510	Server	Tools that lock to the director while any director is active.
`sf_directorrequired`	804	Server	Tools that always require director mode, whatever the admin rank.
`sf_directorpersist`	1	Server	Director mode survives a map change.
`sf_status1` to `sf_status8`	empty	Server	Names for the eight character status labels.
`sf_faction1` to `sf_faction8`	empty	Server	Names for the eight faction labels.
`sf_rank1` to `sf_rank8`	empty	Server	Names for the eight ranks. Rank 1 is the highest standing.
`sf_clanname`	empty	Server	Community name shown on the About screen.
`sf_claninfo1` to `sf_claninfo3`	empty	Server	Three lines of community information on the About screen.
`sf_clanshortname`	storyforce	Server	Key clients use to match saved login details to this server.
`sf_dbbackup`	1	Server	Takes automatic database snapshots.
`sf_dbbackupinterval`	24	Server	Hours between snapshots. Below 1 disables automatic backups.
`sf_dbbackupretention`	7	Server	Days a snapshot is kept before being deleted.
`sf_d1sync`	0	Server	Mirrors accounts and characters to a Cloudflare D1 database.
`sf_d1syncinterval`	0	Server	Seconds between mirror pushes. 0 pushes at map start and shutdown only.
`sf_d1syncpassword`	0	Server	Includes password hashes in the mirror. Off by default, and toggling it re-pushes every account.
`sf_d1account`	empty	Server	Cloudflare account identifier. Never saved to disk by the game.
`sf_d1database`	empty	Server	Cloudflare database identifier. Never saved to disk by the game.
`sf_d1token`	empty	Server	Cloudflare API token. Never saved to disk by the game.
`sf_kickbantime`	10	Server	Minutes a kicked player cannot reconnect. Lost when the server restarts.
`sf_llmnpc`	0	Server	Master switch for AI-voiced NPCs. Every reply is a paid request.
`sf_llmnpc_token`	empty	Server	API key. Never saved to disk by the game.
`sf_llmnpc_model`	claude-haiku-4-5	Server	Which model answers.
`sf_llmnpc_budget`	0	Server	Requests allowed per map. 0 means unlimited, so set this to cap spending.
`sf_llmnpc_cooldown`	3	Server	Seconds a player must wait between messages to an AI NPC.
`sf_llmnpc_maxtokens`	160	Server	Reply length limit sent to the model, from 16 to 1024.
`sf_llmnpc_maxchars`	130	Server	Characters of reply actually shown, from 20 to 149.
`sf_llmnpc_history`	12	Server	Conversation turns remembered.
`sf_llmnpc_range`	400	Server	How close a player must be to trigger a reply.
`sf_llmnpc_overhear`	300	Server	Radius within which an NPC silently hears nearby talk. 0 switches it off.
`sf_llmnpc_delay`	4	Server	Seconds before a reply appears, so it reads as thinking.
`sf_llmnpc_crosshair`	1	Server	Routes speech to whichever NPC you are looking at.
`sf_llmnpc_autosummary`	1	Server	Condenses an NPC's memory automatically as it fills.
`sf_disablechatemote`	0	Client	Stops your character animating while you type.
`sf_disablechatfacemovement`	0	Client	Stops your character's face moving while you type.
`sf_crouchtoggle`	0	Client	Makes crouch a toggle rather than a held key.
`sf_automove`	0	Client	Walks forward while the chat box is open.
`sf_meleestyle`	auto	Client	Unarmed fighting style. Resets each session.
`sf_floatmed`	1	Client	Opts in to the floating meditate pose at high Attunement.
`sf_meditatecamera`	1	Client	Pulls the camera back when you meditate.
`sf_holsteredweapons`	2	Client	Shows sheathed weapons. 0 nobody, 1 yourself only, 2 everyone.
`sf_rgb1`	0,100,255	Client	Colour of your first saber blade.
`sf_rgb2`	0,100,255	Client	Colour of your second saber blade.
`sf_griptotk`	1	Client	Turns a held grip into a telekinetic lift rather than a choke.
`sf_holo_method`	0	Client	How holograms are drawn. 0 standard, 2 fallback for models that stay solid.
`sf_forcefx`	1	Client	StoryForce force power visuals. 0 off, 1 full, 2 shaders only, which keeps the body shells and domes but stops every particle. Use 2 if effects elsewhere in the game start disappearing.
`sf_forcedomes`	1	Client	Shows the field bubbles around Absorb, Protect, Team Heal and Battle Meditation. 0 hides all four.
`sf_forcegrade`	100	Client	Strength of the full-screen washes from Force Sense, Force Wander and Mind Trick, from 0 to 100.
`sf_mindtrickmodel`	empty	Client	Model your Mind Trick level 4 disguise uses.
`sf_mindtrickname`	empty	Client	Name your Mind Trick level 4 disguise shows.
`sf_mindtrickscale`	100	Client	Size of your Mind Trick level 4 disguise, as a percentage.
`sf_ledgegrab`	1	Client	Uses ledge grabbing, if the server allows it and you have the skill.
`sf_quietsteps`	0	Client	Quietens your footsteps. Needs Scout 1 to do anything.
`sf_scoutwaypoints`	0	Client	Shows where NPCs are heading. Needs Scout 2 to do anything.
`sf_useraccent`	empty	Client	Your own interface accent colour as a hex value, e.g. 3AA6E8. Empty follows whatever the server sets. Dark shades are refused because the accent is drawn over a dark panel.
`sf_storyforcehud`	1	Client	Shows the StoryForce status row.
`sf_storyforcehudstyle`	0	Client	Lays the status row out horizontally or vertically.
`sf_storyforcehud_posx`	5	Client	Horizontal position of the status row.
`sf_storyforcehud_posy`	470	Client	Vertical position of the status row.
`sf_crosshairnamesize`	1.0	Client	Size of the name above whoever you are looking at.
`sf_crosshairnamedist`	1	Client	Fades that name with distance.
`sf_fyiundername`	0	Client	Shows an indicator when someone has notes worth reading.
`sf_shieldindicator`	1	Client	Shows the [Shielded] cue while you stand inside an absorb or protect field.
`sf_npcscoreboard`	0	Client	Lists NPCs on the scoreboard.
`sf_letterbox`	0	Client	Draws cinematic black bars.
`sf_loadscreen`	1	Client	Uses the StoryForce loading screen.
`sf_radialmenu`	1	Client	Enables the radial command wheels.
`sf_loginmenu`	1	Client	Opens the login screen automatically when you join.
`sf_loginautofill`	1	Client	Fills in saved login details.
`sf_loginautosubmit`	0	Client	Logs you in automatically on connecting.
`sf_loginremember`	0	Client	Saves your account details for next time.
`sf_photo_cleanshot`	0	Client	Hides the interface for a screenshot. Resets on map change.
`sf_photo_vignette`	0	Client	Darkens the frame edges, from 0 to 100.
`sf_photo_grain`	0	Client	Adds film grain, from 0 to 100.
`sf_photo_haze`	0	Client	Adds atmospheric haze. Console only, with no menu row.
`sf_photo_filter`	0	Client	Colour grade. 0 none, 1 warm, 2 cool, 3 night, 4 sepia, 5 holocam.
`sf_gimbal`	0	Client	Camera movement mode. 0 off, 1 free, 2 horizontal dolly, 3 vertical dolly.
`sf_gimbal_speed`	400	Client	How fast the camera moves, from 50 to 400.
`sf_killcamera`	0	Client	Refuses all director camera takeovers on your screen.
`sf_weathermaxparticles`	800	Client	Particle limit for weather, up to 1000. Lower it if weather costs you frames.
`sf_weatherroof`	1	Client	Stops weather falling through ceilings.
`sf_weathernative`	1	Client	Uses the map's own weather system where the map has one. 0 never, 1 detect it, 2 always.
`sf_modeltaglights`	1	Server	Creates lights automatically from markers built into a model.