Feature defaults

Most of what follows is a switch in hyperspace.xml, shipped inside Hyperspace.ftl. The values quoted are what Mod Files/data/hyperspace.xml sets, so a plain install behaves this way until a mod says otherwise. The More Info button is the only thing that overrides the file, and the last tables cover what the file does not decide at all.

This page covers every switch the parser reads and the shipped file defines. Content blocks that describe ships, crew, events, augments, drones, rewards, sectors, stores and the like are out of scope. Read hyperspace.xml for those.

It is possible to manually modify hyperspace.xml by unpacking Hyperspace.ftl (it’s just a ZIP) and editing the file.

Rows are written tag.attribute, so advancedCrewTooltips.ally is the ally attribute of <advancedCrewTooltips>. Values are the literal ones in the file.

Features

Attribute	What it sets	Default
`seeds.enabled`	Starts a run on a chosen seed, so two players can race the same map	`true`
`seeds.allowUnlocks`	Whether unlocks count during a seeded run	`false`
`seeds.allowAchievements`	Whether achievements count during a seeded run	`false`
`seeds.allowMetaVars`	Whether metavariable changes stick during a seeded run	`false`
`hullNumbers.enabled`	Prints exact hull point counts for your ship, the enemy and the flagship	`true`
`hullBars.type`	Hull bar style: `0` vanilla, `1` stacking bars, `2` bars capped at `maxHull` and shrinking proportionally	`0`
`hullBars.maxHull`	Hull points the bar draws before it caps	`22`
`hullBars.maxHullBoss`	Same, for ships with a boss box	`22`
`alternateCrewMovement.enabled`	Sends crew to the exact tile you clicked. Crew already standing there step aside if the room has space	`false`
`rightClickDoorOpening.enabled`	Right-clicking a door opens it. Set it off and doors are left-click only. It interacts with the row above: tile movement only runs when no door is selected	`true`
`droneSelectHotkeys.enabled`	Crew number hotkeys also select controllable crew drones	`false`
`droneSaveStations.enabled`	Controllable crew drones save and return to stations with the rest of the crew	`false`
`disableLazyImageLoading.enabled`	Goes back to preloading every image at launch. Left off, images load when they are needed, which cuts loading time to almost nothing and uses about a quarter of the RAM	`false`

Tooltips and display

Set by the More Info button

More Info is a button in the ship status UI during a run. Press it at any time to switch these attributes between the two states below.

The button is on when the game starts, every time, and nothing remembers your last choice. If you prefer it off, you press it again each session.

Attribute	What it sets	XML	More Info off	More Info on
`advancedCrewTooltips.ally`	Lists powers when hovering crew you own	`false`	`false`	`true`
`advancedCrewTooltips.enemy`	Lists powers when hovering enemy crew	`false`	`false`	`true`
`advancedCrewTooltips.rounding`	Decimal places on crew health	`2`	`2`	`2` *
`redesignedWeaponTooltips.enabled`	Lists hull, system and crew damage separately	`false`	`false`	`true`
`redesignedDroneTooltips.enabled`	Adds weapon stats to space drone tooltips	`false`	`false`	`true`
`redesignedAugmentTooltips.enabled`	Adds the scrap cost to augment tooltips	`false`	`false`	`true`
`showNumericalWeaponCooldown.enabled`	Prints the remaining cooldown as a number above each weapon box	`false`	`false`	`true`
`showReactor.enabled`	Shows maximum reactor power in the hangar	`false`	`false`	`true`
`showAllConnections.enabled`	Draws every beacon connection on the sector map	`false`	`false`	`true` **
`alternateOxygenRendering.enabled`	Alternate colour scheme for oxygen levels, with an optional `<gradient>` child. Not a tooltip, and the one thing the button switches off rather than on	`false`	`false`	`false`

The button does not turn these features on and off. It picks where their values come from:

On: ignore the XML and apply the button’s own values. That is true for everything above except alternateOxygenRendering, which it sets to false.
Off: use the XML values.

Since it starts on, a fresh session ignores your XML for these attributes. That gives one rule:

In the XML	Button on	Button off
`true`	on	on
`false`	on	off

true always applies. false applies only with the button off, so <redesignedWeaponTooltips enabled="false"/> looks like it does nothing: every run starts with the button on, and the reworked tooltips appear anyway. Press More Info off and it takes effect.

A mod can switch these on permanently. It cannot switch them off. alternateOxygenRendering runs the other way, since the button forces it false: a mod can switch that one off permanently but not on.

* advancedCrewTooltips.rounding is a number rather than a switch. The button raises it to 2 only when the XML says 0 or 1, and leaves any other value alone:

In the XML	Button on	Button off
`0`	`2`	`0`
`1`	`2`	`1`
`2`	`2`	`2`
`3`	`3`	`3`

The shipped value is 2, which is why all three columns match in the table above.

** Unless splitAllNodeView is on: then this toggle moves to its own button on the sector map and More Info has no effect on it.

Not affected by the button

The value in hyperspace.xml is what runs, whichever way More Info is set.

Attribute	What it sets	Default
`advancedCrewTooltips.enabled`	Hovering a crew member shows name and species, exact health as `x/y (z%)`, the clone bay death timer and remaining stun time	`true`
`insertNewlineForMultipleCrewTooltips.enabled`	Puts a blank line between crew descriptions when several crew are fighting on one tile	`false`
`extraShipInfo.missileCount`	Missile count for the selected ship in the hangar	`false`
`extraShipInfo.droneCount`	Drone count for the selected ship in the hangar	`false`
`extraShipInfo.crewLimit`	Crew limit for the selected ship in the hangar	`false`
`showDummyEquipmentSlots.enabled`	Draws faded weapon and drone slots under SYSTEM NOT INSTALLED, so you can count them before buying the system	`false`
`showDummyEquipmentSlots.opacity`	How faint those slots are drawn	`0.2`
`showScrapCollectorScrap.enabled`	Shows scrap rewards with the scrap recovery arm bonus already applied	`false`

extraShipInfo has no enabled of its own, so its three readouts are switched one by one.

advancedCrewTooltips.enabled is the one XML false the button cannot override. Set it off and ally, enemy and rounding are not even parsed, and the tooltip is skipped before the button’s values are ever consulted. The power list itself is not part of it: that comes from ally and enemy, so with the button off a plain install shows no powers on any crew.

Bug fixes

Attribute	What it fixes	Default
`hackingDroneFix.enabled`	Destroys the hacking drone if hacking is depowered while the drone is still in flight, closing the power-depower trick that slipped it past defence drones. A drone that has already attached is unaffected	`true`
`repairDroneRecoveryFix.enabled`	Removes an active repair drone on jump, so you cannot take the repair and keep the parts with the recovery arm	`true`
`crystalShardFix.enabled`	Counts crystal shards as player projectiles, so friendly defence drones stop shooting them down	`true`
`defenseDroneFix.enabled`	Bases defence drone firing range on the ship layout and shield ellipse, which removes the blind spot. Range is unlimited against enemy combat drones	`true`
`hackingIonFix.enabled`	Applies the normal 20 second lock when hacking is ionised, closing the 5 second self-ionisation trick	`false`
`droneIonDodgeFix.enabled`	Lets enemy ion projectiles stun and destroy unpowered drones	`false`
`controllableIonDroneFix.enabled`	Puts a player-controlled ion drone’s ion blast on a timer, so it does not fire the moment you order the drone to move. Only bites once a mod has made boarding drones controllable	`false`
`controllableIonDroneFix.ionDelay`	Seconds on the ion blast timer	`6`
`controllableIonDroneFix.ionDelayInitial`	Seconds on the timer when the drone launches	`6`
`playerHpColorFix.enabled`	Colours the player HP bar by thirds of max hull	`false`
`enemyPreigniterFix.enabled`	Lets enemy ships use the weapon pre-igniter augment	`false`
`artilleryGibMountFix.enabled`	Stops artillery with linked gibs vanishing when a ship explodes	`false`
`warningLightPositionFix.enabled`	Moves fire and breach warning lights off doors and walls, into the room	`false`
`hideHullDuringExplosion.enabled`	Stops the hull image drawing over the gibs during a ship explosion	`false`
`cloakRenderFix.enabled`	Fixes cloaked player ship rendering when nobody is aboard	`false`
`multiShipFix.enabled`	Allows more than one ship to be loaded per beacon	`false`
`teleporterHackFix.enabled`	Makes teleporter hacks land regardless of how enemy crew are spread across their ship, and with a cloak active	`false`
`energyBypassTeleportRecall.enabled`	Stops enemy ships ignoring their own energy shield bypass when they evacuate crew by teleporter	`false`

Gameplay

Attribute	What it sets	Default
`preIgniteChargers.enabled`	Charger weapons gain all their charges when pre-ignited instead of one	`true`
`resistsMindControlStat.enabled`	Makes `resistsMindControl` a crew stat separate from `isTelepathic`	`true`
`oxygenWithoutSystem.enabled`	Lets oxygen work on a ship with no oxygen system	`false`
`shieldWithoutSystem.enabled`	Lets supershields work with no shield system in the blueprint	`false`
`dualMedical.enabled`	Medbay and clonebay stop being mutually exclusive, so a ship can carry both	`false`
`targetableArtillery.enabled`	Manual artillery control for every ship. Leave it off and give a ship the `ARTILLERY_ORDER` augment to enable it one ship at a time	`false`
`targetableArtillery.xOffset`	Horizontal offset of the artillery button	`0`
`targetableArtillery.yOffset`	Vertical offset of the artillery button	`0`
`targetableArtillery.fixedYPos`	Pins the button’s vertical position instead of stacking it under the power boxes and system icons	`false`
`scaleSlugGel.enabled`	Slug repair gel speed scales with the augment value. The vanilla `SLUG_GEL` value is 0.25	`false`
`multipleOverCapacity.enabled`	The over-capacity box holds several items and you choose which to keep	`false`
`infinite.enabled`	The game’s built-in infinite mode	`false`
`forceDlc.enabled`	Stops Advanced Edition being toggled off	`false`
`disableDefaultTutorial.enabled`	Stops the vanilla tutorial progressing, so a Lua tutorial can replace it	`false`

UI and presentation

Attribute	What it sets	Default
`altCreditSystem.enabled`	Uses the XML credits rather than the hardcoded vanilla ones, and fixes the empty crew section on auto ships	`true`
`dismissSound.enabled`	Plays a sound when crew are dismissed	`true`
`dismissSound.sound`	Which sound that is	`airLoss`
`console.enabled`	The in-game command console	`true`
`console.invertCaps`	Swaps the case of everything you type into the console, so lower case keys enter upper case commands	`true`
`titleScreen.enabled`	Custom title screen background, logo and splash images	`true`
`titleScreen.logo_x`	Horizontal position of the FTL logo	`862`
`titleScreen.logo_y`	Vertical position of the FTL logo	`7`
`customChoiceColors.enabled`	Replaces the vanilla event choice text colours, each colour set as an r/g/b/a child tag	`true`
`customTextStyle.enabled`	Inline `[style[color:RRGGBB]]` markup inside text strings	`false`
`customTabs.enabled`	Extra tabbed windows driven by Lua, with their own background and optional undo button	`false`
`splitAllNodeView.enabled`	Gives the all-connections view its own button on the sector map, instead of following More Info	`false`
`showShipAchievements.enabled`	Shows ship achievements in the hangar for custom ships instead of custom victories	`true`
`showShipAchievements.toggle`	Lets the player switch between ship achievements and victories	`false`
`showShipAchievements.hideIfMissing`	Hides the section for ships that have no achievements	`false`
`showShipAchievements.id`	Text id for the section heading	`hangar_achievements_title_default`
`altLockedMiniships.enabled`	Locked miniships prefer the image with the `_base` suffix	`false`
`renameShipInRun.enabled`	Lets you rename your ship during a run	`false`
`renameShipInRun.allowButton`	`true` puts renaming behind a button in the upgrade menu, `false` puts it on the ship name itself	`false`
`allowRenameInputSpecialCharacters.enabled`	Allows special characters in ship and crew name input	`false`
`systemNoPurchaseThreshold.enabled`	Replaces system upgrade costs at or above `threshold` with a placeholder. Visual only, the purchase still goes through if you have the scrap	`false`
`systemNoPurchaseThreshold.threshold`	The cost at which the replacement kicks in	`9999`
`systemNoPurchaseThreshold.replace`	The string shown in place of the cost	`--`
`purchaseLimitNumber.fontSize`	Font size of the store purchase limit number. The tag has no `enabled`: leaving it out keeps the old position, which overlaps the current shopping cart image	`0`
`purchaseLimitNumber.x`	Horizontal position of that number	`-16`
`purchaseLimitNumber.y`	Vertical position of that number	`106`
`ships.hideFirstShipPage`	Hides the first page of the ship select screen	`false`
`victories.noFlagship`	Suppresses the automatic `flagship` victory type that custom victory achievements otherwise generate	`true`

Not set by hyperspace.xml

These have no value to quote, because hyperspace.xml does not decide them.

Feature	What it does	Controlled by
Boarding drone control	Select and order boarding drones the way you order crew	The crew race a mod defines. There is no global switch: the mod sets `<controllable>true</controllable>` on the `BOARDER` or `BOARDER_ION` race
Event tooltips	Hovering an event choice shows the info box for what that choice rewards	Nothing. It is hardcoded on. `<eventTooltips enabled="false"/>` parses but is never read, so setting it has no effect
Redesigned crew tooltips	Nothing visible	Nothing. `<redesignedCrewTooltips enabled="..."/>` parses, but the only code that would read it is commented out. The tag is not in the shipped file either
Crew colours after a transform	How a crew member’s colours carry over when a mod turns them into another race	Hyperspace itself. It always uses the built-in `KEEP_INDICES`, which keeps their colour slots so they take the new race’s colours. The `transformColorMode` tag is not usable, its current implementation is broken
Discord rich presence	Shows the ship you are flying and your progress	The build. Compiled into Windows builds and compiled out on Linux and macOS, so the `discord` flag exists on Windows only

Editing the file by hand

A few things to know if you want unpack Hyperspace.ftl and edit hyperspace.xml directly:

Deleting an attribute crashes the game on load. Most tags read their attributes without first checking they are there, so set enabled="false" rather than removing enabled= altogether. extraShipInfo needs all three of missileCount, droneCount and crewLimit. A few attributes are checked before they are read and can be left out, ionDelay among them.

ionDelay overwrites ionDelayInitial. Setting ionDelay assigns its value to both timers, and only an explicit ionDelayInitial after it takes effect. Writing ionDelay="10" alone gives an initial delay of 10, not 6. Both attributes are read only when controllableIonDroneFix.enabled is already true.

advancedCrewTooltips.enabled="false" discards its own attributes. ally, enemy and rounding are parsed inside the enabled check, so switching the tag off throws all three away rather than just disabling the base tooltip.

Leaving seeds.allowMetaVars out turns metavariables on, not off. The built-in default is true while the shipped file sets false, so a mod that replaces hyperspace.xml without the attribute gets the opposite of stock behaviour. Separately, a metavariable marked force="true" applies during a seeded run whatever the setting says.

dronesCanTeleport does not exist. Both the parser block and the code that would read it are commented out. It appears in searches of the source but has no effect.