Overview

"Just follow the instructions and save the argument for later." — Czerka Domestic Flatpack Solutions

The StoryForce documentation is task orientated in an attempt to help guide users through everything they want to do within the mod rather than just dump information that isn't relevant.

With over 182 pages of documentation, it's advised to Start Here or use the tool below.

Use the tool below to help find what you're looking for

Start here 5
  • install StoryForceDownload the client, extract it into your Jedi Academy GameData folder and start the game with StoryForce already loaded.
  • join a serverConnect to a StoryForce server, meet the login screen that opens on arrival, and find out what you can and cannot do before you log in.
  • create my first characterFill in an id and a full name in the New Character wizard, then join the scene playing them.
  • understand the different menusWhat each button on the in-game bar opens, why some of them are missing, and how to leave a server.
  • play my first sceneSpeak in character, describe what you do, play an emote, and read what a storyteller puts on your screen.
Characters 19
  • create an account and log inRegister where a server allows it, log in, and save your details so the next login arrives filled in.
  • manage my accountRead your standing on the server, change your password, and log out without losing your place in the scene.
  • create a characterFill in the New Character wizard, and the limits the server puts on ids, names and how many characters you hold.
  • read my character screenA numbered guide to the Current screen, covering your character's identity, progression, appearance, notes and gear.
  • switch and manage charactersChange who you are playing, set a login default, edit a character's record, and delete one for good.
  • play a quick extraTake a disposable body for a crowd scene, name it, resize it and hand it back. Nothing about an extra is saved.
  • play a community characterTake one of the server's shared characters for a scene, then go back to your own.
  • ride as a passengerBoard a vehicle with another player, look around from your seat and get off again.
  • change my modelPick a player model from the grid, preview it, set its team colour and apply it to the character you are playing.
  • use sfpk3 asset packsConvert a character pack to sfpk3, install it with the matching StoryForce engine and use its models in game.
  • build a custom characterAssemble a body from head, torso and leg parts, tint the skin from a swatch or a hex code, and wear the result.
  • build my sabersChoose single, dual or staff, pick a hilt for each blade, set the colour and save the loadout to your character.
  • choose a gun skinPreview a cosmetic gun variant, equip it and return to Stock without changing the weapon’s stats.
  • position holstered weaponsPlace sheathed sabers and stowed guns on your model, save their positions and share the layout with other players.
  • attach models, effects and soundsFill your character's 4 attachment slots with a prop, an effect, a light or a sound, then place each one on the body.
  • change how my character walksSwap your walking animation from the Current screen, and see which styles slow you down.
  • wear gear, a comlink and a hologramSwitch on a breather, translator or glowrod, set your comlink state and render your character as a hologram.
  • set my identity and statusRename your character, set a status, resize your model and change the language you speak, all from the Current screen.
  • tell others about my characterWrite a public note, add nearby details with optional skill gates, and choose what /inspect reveals about your character.
Chat and languages 10
  • speak in characterWhat the chat key sends, what /me sends, and the gesture and the audience that come with them.
  • whisper and shoutThe 2 chat shortcodes that change your volume, how far each band carries, and what Diplomacy adds.
  • speak out of characterDouble brackets, the team chat key and a private message, and who each of them really reaches.
  • speak another languageSet which of your character's languages they speak, type either of its names, and look up every language StoryForce ships.
  • understand what others are sayingThe 3 ways a foreign line arrives in plain words, what a garbled one is made of, where the real text goes, and how a character learns a tongue.
  • look up a languageFind every language StoryForce ships, the name to type, and how Basic and custom languages fit alongside them.
  • call someone on your comlinkSend a comlink message to one person or to every set at once, answer without typing a name, and know who else reads it.
  • change how chat looks and reaches youSet how far a line carries before it fades, which bubble draws over a character's head, and how the chat box is sized and placed.
  • read and save a scene's chatRead back through the console, save its text to a file, and find the copy on your computer.
  • colour your namePreview colour codes in your display name and copy the /name command that applies it.
Force and skills 15
  • check my XP and levelRead your character's XP and level, see where awards and pending XP come from, and understand what spending changes.
  • plan a character buildSet a rank on every Force power and skill against an XP total, check the prerequisites, and read what the build costs before you buy it.
  • raise a Force powerBuy, lower and apply Force power ranks on the FORCE POWERS screen, and switch Telekinesis between lifting a target and choking one.
  • know what a Force power rank doesCompare all 18 Force powers by rank, including their range, duration, targets and effects on players and NPCs.
  • mark allies and enemiesTell your Force powers who to help and who to target, then list or clear the marks you hold.
  • set a Mind Trick disguiseChoose the model, name and size a Mind Trick victim sees instead of your own, from the popup or from the console.
  • use Force WanderLeave your meditating body with Sense 5, explore as a spirit and return before your Force runs out.
  • learn a skillBuy skill ranks, check their XP prices and prerequisites, and apply your choices.
  • know what each skill rank doesCompare each skill rank, from reading hidden clues to handling weapons, recovering health and driving vehicles.
  • choose how my skills behaveTurn the automatic part of Force Attunement, Wallgrab, Ledgegrab and Scout on or off for your own game, without losing the rank.
  • climb walls and ledgesCling to a wall, jump higher from it, or catch a ledge and pull yourself onto the surface.
  • choose a martial arts stylePick which unarmed style your character fights in, and see what Hand to Hand and owning a style are actually worth.
  • use my Tech skillsLearn Binary with Tech 1, lock and unlock doors with Tech 2, and listen in on nearby comlink traffic with the Tech 3 scanner.
  • recover and help a downed playerSee how First Aid changes your recovery, then use it to bring a nearby downed player back to their feet.
  • disarm a mine or detpackUse Artisan 2 to disarm a deployed trip mine or detpack and recover the device for your own inventory.
Building the world 33
  • find the building toolsOpen the Design menu, read what every row leads to, and tell a rank problem from the tool lock.
  • move around while I buildFly through walls, turn invisible, stop blocking people and stop NPCs noticing you, so you can reach the spot you are dressing.
  • show markers and boundaries in the worldSwitch on the director overlays that draw boxes, numbers and labels over everything the game normally leaves invisible.
  • place a modelBrowse the model tree, preview an md3 or a glm character, then stamp it into the world at the size and angle you want.
  • find a model to placeEvery model the picker can place, shown as itself — search by name or path, narrow by group and set, and click to copy the command that places it.
  • place an effectBrowse the effects tree, watch the real effect play at your crosshair, then leave it running there on the cadence you want.
  • find an effect to placeEvery effect path StoryForce and the base game ship, most of them playing as themselves, with the path to copy into the console.
  • place a soundAudition a sample from the browser, place it in the world as a point source, and set whether it loops, plays once or re-fires.
  • light a sceneDial a coloured light against a live preview, give it a flicker, and place darkness the same way you place light.
  • place background weapon firePlace invisible shooters for incoming bolts, tune their cadence and aim, then start or stop the firefight from one roster.
  • browse placed entitiesRead the roster of every model, light, effect and lock on a map, narrow it to one kind, and teleport yourself to any row.
  • move and change a placed thingShift, turn, resize and retarget anything already on the map, from the roster's own editor or from the console.
  • remove something I placedTake one entity out of the world, clear everything on a filter behind a confirmation, and step back through your own last 8 placements.
  • move things together as a groupBind placed things into one named group, capture new placements into it, and move or turn the whole set at once.
  • save and stamp a propTurn a group you have built into a saved prop, then stamp it again anywhere, on any map. The library ships empty, so start by saving one.
  • dress a player or NPCHang a model, effect, light or sound on a connected player or a world NPC, and tune the fit from an in-world editor.
  • dress a character who is not hereDress somebody who is offline, then save their costume until they are playing that character when the scene loads.
  • clear the map for a sceneStrip a map back to a bare stage before you dress it, or move the whole server to a different map, and know what each one takes with it.
  • retexture the mapSwap a wall, a floor or any other surface for a different texture, try it privately first, then put the original back.
  • find a replacement textureReplacement textures drawn as themselves, searchable by name or folder and narrowed by type, with the path to copy into the console.
  • place spawn pointsDecide where people arrive on a map, keep a point for one rank only, and clear the map's own arrival points before a scene.
  • lock doors and triggersSeal a door to everybody or hold it for a rank, choose what a blocked player hears and reads, and open it again.
  • add weatherStart rain, snow, sand, fog, wind or a lightning storm over the whole map, tune how hard it comes down, and clear it again.
  • flood the map with waterSet one water level across the map, preview its height and appearance, then apply it for everyone or drain it again.
  • change gravity and tilt the worldFloat through a scene, roll the view, preview a tilt and restore normal gravity for everyone.
  • shelter a room from the weatherDraw a dry volume so rain stops at a doorway, and draw the opposite where a map wrongly reads as roofed.
  • turn off the storm flashA photosensitivity switch: stop the lightning flash, its light and the thunder on your own screen, without stopping the rest of the storm.
  • push a full-screen overlayTint every screen on the server, or one person's, with a filter and an intensity you choose, then take it away again.
  • save a placemarkName the spot you are standing on so you can return to it, re-face it, rename it, and use it in place of coordinates.
  • teleport to a placemarkPut yourself, or somebody else, exactly where you want them, using a saved mark, a player or a set of coordinates.
  • place a readable screenPlace a datapad or console, write its text and choose who can read it.
  • place a point of interestLeave a marker in the world that shows itself only to the players you choose, and tells each of them as much as they have earned.
  • change or remove a point of interestFind a placed marker's id, rewrite what it says, move it, retune its gate and range, or take it off the map.
NPCs 16
  • find an NPC and take it off the mapRead the NPC roster, work out what each row is telling you, pick one body out of a crowd, and clear a single NPC or the whole cast off the map.
  • spawn an NPCFill in the spawn form, pick a body from the model browser, and drop a new character into the map where you are aiming.
  • name an NPCGive an NPC the display name it needs before it can speak, add a public note anyone can read, and find out where a targetname really comes from.
  • spawn a vehicleSwitch the NPC panel to its Vehicle kind, land one on the floor in front of you, and learn what a vehicle can never be given.
  • seat NPCs in vehiclesGroup NPCs with vehicles, seat drivers and passengers, move them along a route and set them down again.
  • move an NPC into placeTeleport a standing NPC to a saved placemark, to typed coordinates, or straight to where you are.
  • send an NPC walking a routeDraw a numbered path through a map, set how it repeats, and put one or more of the cast on it.
  • move NPCs in formationGroup NPCs around one routed leader so they keep their places while the unit moves.
  • set an NPC's look and behaviourHold a pose on an NPC, cuff it, hand it a weapon, render it as a hologram or cloak it, and set how it walks and who it looks at.
  • stage NPC combatChoose an NPC’s target, stage gunfire or saber attacks, and control how much damage it deals.
  • make an NPC speakPut one line in an NPC's mouth, set it repeating on a timer, and choose the language it speaks in.
  • speak as my own NPCGive a walk-on a name and a shortcode, then voice them from the chat line without putting a body in the world.
  • hide a clue on an NPCAttach a point of interest only players with the right skill can read, and learn what the rest of the room actually sees.
  • cast an NPC as an AI characterTurn a spawned NPC into a character an outside service answers for, set the scene it shares, and understand what leaves your server when you do.
  • save a persona an NPC can keepKeep a cast character between maps, load one onto a standing NPC, and see what it writes to the server's disk about the people it meets.
  • talk to an AI characterWhere your words go when you speak to or near one, how to tell which NPCs they are, and what nobody in the game can switch off for you.
Cameras, triggers and animations 12
  • build a camera trackEight shared tracks, eight waypoints each. Stamp them from where you stand, pick the curve, set the holds, and lock a subject in frame.
  • fly a track for the whole roomFly a built track for everyone in the room, rehearse it privately first, and know what your audience sees and cannot decline.
  • hold the view on one spotPark everyone's view on one waypoint, or loop it around a whole track, and release it again when the moment has passed.
  • blur and refocus a shotSet the blur, the focus distance and the foreground softness on each waypoint, and know which viewers will actually see them.
  • keep a moving subject framedAim a travelling camera at a player or NPC, rehearse the shot, and return to the angles you captured.
  • make something I placed moveGive a model, light, sound or effect up to twelve poses and play them back as keyframed motion, on a loop or once.
  • move a whole group as oneKeyframe a whole named group around one pivot so every member sweeps the same arc, and re-seat the members when you move them.
  • mark a spot that reactsMark out an invisible volume in the world, set who can trip it and how often, and find it again on the trace overlay.
  • control animations from a boxBind placed animations to one box, then restart them or pause and resume them each time someone trips it.
  • decide what a box doesStore an ordered list of cues on a box, from the 30 verbs it accepts, and know what each one does to whoever walks in.
  • build a cue from the panelPick what should happen, fill in the blanks, and watch the stored line turn red when the box will refuse it.
  • record a sequence into a boxPerform the sequence once and let the box keep it, then read the box back and rehearse it before anybody walks in.
Running a scene 21
  • find the directing toolsOpen the Direct menu, read what its 6 rows lead to, and tell a row your rank cannot reach from one a director has taken.
  • take the director's chairGo into director mode, learn what it takes away from everybody else while you hold it, and find out who is directing right now.
  • set the sceneGive players a title, briefing and objectives in the ESC menu, then mark objectives complete or failed.
  • track mission progressShow a shared progress counter, advance its beats by hand or from a trigger, and keep it with your scene.
  • save and load a sceneKeep a dressed map as a file, load it back on demand, and pick the scene a map opens with on its own.
  • dim the map for a sceneBrighten, dim or tint a map's built-in light for everyone, and keep the cast readable in the dark.
  • keep one room litDraw a box that holds its own lighting, so a doorway, a corridor or a single room can stay bright while the rest of the map goes dark.
  • play music for the sceneBrowse the game's music folder and start, loop or stop a track that everybody on the server hears.
  • fade the screenTake everyone's screen to black in one of 9 styles, bring it back in a different one, and reveal onto the scene's title card.
  • play an opening crawlWrite and preview an opening crawl, play it for everyone and choose the music or reveal that follows.
  • play a cinematicPlay a fullscreen video to the whole server or a private vision to one player, and know what it takes away from everyone watching.
  • announce a message on screenPut a timed message in the centre of everyone's screen, or one player's, and retract it again when the beat is over.
  • dress the knockdownChoose the pose a downed character holds and the line they read while they wait, so going down looks like your scene instead of the default.
  • restrain and release a playerApply handcuffs or a blindfold to yourself or another player, understand their limits, and remove them when the scene is over.
  • talk on a director channelJoin an out-of-character notes channel from the console or the panel, post to it, and hand your team chat key back when you leave.
  • write the scene scriptShare a planning document with your Director Notes channel and read it from the scoreboard.
  • write a stunt cue sheetBuild a file of scene cues, chain commands with waits, and mark cues that need confirmation or should stay ready to fire again.
  • run a stunt cue sheetBrowse the sheets in your stunts folder, load one, and step a scene's beats from keys you set yourself.
  • film a sceneFly a damped spectator camera for recording: free, on a straight track, or craning up and down.
  • play a game of chanceRoll a die, flip a credit or draw a Pazaak card from the Character menu, and learn where the game answers when it refuses you.
  • drop what you're carryingThrow down the weapon in your hands, and learn why a gun becomes a pickup while your saber hilt waits where it falls.
Emotes 8
  • look up every emoteEvery emote StoryForce ships, shown as itself — 190 poses to search, filter by group and click to copy the command.
  • play an emoteOpen the picker, start a pose on your own character, and get out of it again when the scene moves on.
  • keep favourite emotesKeep the poses you use often in Favourites, and gather the ones you need for a scene in Current.
  • play a raw animationPose a character on any animation its model carries, by name or by frame number, and know which ones are out of reach.
  • meditateSettle your character into meditation, and decide whether the camera swings around in front of them while they do.
  • play a voice linePlay an audible line from your character’s voice set and choose which extra voice lines you hear.
  • talk while you hold a poseFour held poses keep gesturing while you speak. The rest hold still.
  • sit, kneel and lie downGet your character off their feet, and tell apart the poses that hold still from the ones that keep moving.
Community management 14
  • understand admin ranksWhat a community, clerical or leadership admin can actually do, which tasks need no rank at all, and how membership limits both.
  • create and manage accountsBrowse the account roster, open a new account, move somebody through membership, and hand out or take back an admin rank.
  • disable and restore an accountDisable an account immediately, then restore its membership through the menu or console.
  • edit a character's recordThe staff side of somebody else's character: designations, listed name, life status, mentor, identity fields, languages and spawn gear.
  • assign and change a mentorAssign a character's mentor, hand their pending XP to a new mentor, or graduate them without losing track of outstanding claims.
  • award XPHand XP to a player from the roster on the XP panel, choose the amount, and read the server's record of every award made.
  • award a whole cast at onceMark everyone in a scene, read the overhead ring that says how each mark will land, and pay them all in one press.
  • hold XP back until the work is doneRaise a claim instead of paying now, then approve or cancel it later from the PENDING tab, and know which claims expire.
  • drop an XP pickupLeave a box in the world that pays whoever walks through it, dial what it gives and how often, then take it away again.
  • see who is onlineRead the Online and Origin roster for account names, active characters, client numbers, coordinates and body-state letters.
  • kick or ban a playerRemove somebody from the server for a few minutes, make a permanent connection ban, or lift either one afterwards.
  • build a community characterAdd a shared character to the pool with the staff wizard, edit one later, and delete one when it is finished with.
  • gear up a community characterSet a shared character's sabers and spawn loadout, then hand it the skills, Force powers and XP budget it plays with.
  • fill in a community character's recordWrite the listed name, designations, life state, FYI note and points of interest that anyone playing a shared character carries.
UI 13
  • change my settingsThe Setup panel: which tabs belong to Jedi Academy, which belong to StoryForce, and what Restore Defaults wipes.
  • set up my keysBind StoryForce controls, leave an emote, look around without turning and page through the scoreboard.
  • change the HUD and crosshairPick a HUD, control its fade and indicators, and size the character name shown while you aim.
  • set up the consoleSix Setup rows control the console's key, height, background, opacity, saved history and the length of paginated lists.
  • set up the radial wheelsBind any of 9 wheels, edit radialmenu.cfg to change what each slot runs, and reload it without restarting.
  • arrange my radial wheelsArrange your StoryForce radial wheels, choose emotes and commands, and download a configuration ready for the game.
  • keep favourite and current picksSave choices across the game's pickers, gather what a scene needs in Current, and rename or hide both folders.
  • set up the screen for a sceneSet interface colour, menu sound, camera motion, weather rendering, effect range, favourite-picker labels and model picker icon size.
  • turn down the weather soundsThe rain bed, the wind bed, the thunder and who draws the precipitation, all set from the console because the panel behind them is gated.
  • take a screenshotHide the interface with Clean Shot, set a countdown, and find the .jpg the game writes afterwards.
  • compose a shotField of view, letterbox, vignette, grain, the 6 filters and depth of field, from the Photo Mode panel.
  • fly the photo cameraLift the camera off your body, twist the roll for a dutch angle, lock the focus and snap from anywhere.
  • record and play back a demoRecord a session, turn on automatic recording and play back the saved demo in StoryForce.
Server hosting 16
  • install a StoryForce serverUnpack the server download, meet its prerequisites, start it for the first time and read the boot output it prints.
  • secure a new serverReplace the published root password, harden rcon, control who can join and register, and keep tokens out of files you might share.
  • edit my server configurationWhere the file lives, what overrides it, how a value is written, which values wait for a restart, and which page owns each block.
  • decide who can run each commandUse the calculator to set the three rank masks and three director locks without doing the bit math yourself.
  • run commands over RCONManage accounts, edit characters, award XP and send announcements through the server's remote console.
  • manage characters from the server consoleCreate and edit character records, inspect accepted fields and manage points of interest with full operator access.
  • tune how play works on my serverWhat guests and former members can use, how hitboxes and ammo behave, whether chat protects you, and how emotes and colours are written.
  • tune progressionEdit the level curve, health and Force recovery, rank ceilings and XP prices stored in your server database.
  • name my ranks, factions and statusesFill the 24 label slots a player picks their rank, faction and status from, and rename any of them without a restart.
  • brand my serverSet your community's name, short name, acronym and accent colour, write the three About blocks and the join greeting, and advertise a sister server.
  • read my server's logsThe four log channels, the three directories they land in, and the filters that decide what reaches your console.
  • back up and restore my databaseWhere the database file sits, how rolling local backups work, what they leave out, and the optional Cloudflare D1 mirror.
  • read the Health CheckRead the live entity, asset and sound limits, spot what is nearly full, and open the detailed gamestate budget.
  • read the gamestate budgetRead the budget bar and the rows behind it, work out your headroom, and cut what a busy map is spending.
  • send events to DiscordWebhooks for server events, the test command that proves one works, two-factor login for root, and the way back in when it fails.
  • run LLM NPCsThe API token and model, the caps that bound what it costs, what leaves your server, and the memory files it writes to disk.