OpenStarbound

<details> <summary><b>What is this?</b></summary>

tl;dr: OpenStarbound is a mod of the latest version of Starbound, 1.4.4. It fixes many bugs, adds many new features and improves performance.

By a truly unbelievable coincidence, I was recently out for a walk when I saw a small package fall off a truck ahead of me. As I got closer, the typeface slowly came into focus: Starbound. Inside, I found a submachine gun, a fursuit (tells you something about their audience I guess!), and the latest version of the Starbound source code.

</details>

You must own a copy of Starbound. Base game assets are not provided for very obvious reasons.

The code is worked on whenever I feel like it. Contributions are welcome!

Installation

Download the latest stable release.

The latest stable release is recommended, as the nightly build can have bugs.

At the moment, you must copy the game assets (packed.pak) from your normal Starbound install to the OpenStarbound assets directory before playing. Optionally copy the user folder in the same directory as packed.pak to move the vanilla playable instrument songs over.

OpenStarbound is a separate installation/executable than Starbound. You can copy your storage folder from Starbound to transfer your save data and settings. Launching OpenStarbound with Steam open will load your subscribed Steam mods. If you have any locally installed non-Steam mods, you may want to copy the mods folder as well.

An installer is available for Windows. otherwise, extract the client/server zip for your platform and copy the game assets (packed.pak) to the OpenStarbound assets folder.

</details> <details> <summary><b>Nightly Builds</b></summary>

These link directly to the latest build from the Actions tab.

Windows Installer, Client, Server

Linux Client, Server

macOS Intel, ARM

All Nightly Builds

</details>

Changes

Note: Not every function from StarExtensions has been ported yet, but near-full compatibility with mods that use StarExtensions features is planned.

Lighting

The lightmap generation has been moved off the main thread, and supports higher color range.

• Point lights are now additive, which is more accurate - you'll notice that different lights mix together better!
• Object spread lights are auto-converted to a hybrid light which is 25% additive.

Assets

• Assets can now run Lua scripts on load, and after all sources have been loaded.
  • These scripts can modify, read, patch and create new assets!
• Lua patch files now exist - .patch.lua
  • These can patch JSON assets, as well as images!

Commands

View OpenStarbound commands with /help! You can also view them here

• Changes to vanilla commands:
  • /settileprotection
    • You can now specify as many dungeon IDs as you want: /settileprotection 69 420 false
    • You can now specify a range: /settileprotection 0..65535 true

Bug Fixes

• Invalid character inventories are updated when loading in, allowing players to swap inventory mods with pre-existing characters.
• Fix vanilla world file size bloating issue.
• Modifying a single status property no longer re-networks every status property on the entity (server and client must be running at least OpenStarbound 0.15)

Misc

• Player functions for saving/loading, modifying the humanoid identity, manipulating the inventory. Documentation

• Character swapping (rewrite from StarExtensions, currently command-only: /swap name case-insensitive, only substring required)

• Custom user input support with a keybindings menu (rewrite from StarExtensions)

• Positional Voice Chat that works on completely vanilla servers, uses Opus for crisp, HD audio (rewrite from StarExtensions)

  • Both menus are made available in the options menu in this fork rather than as a chat command.

• Multiple font support (switch fonts inline with ^font=name;, .ttf and .woff2 assets are auto-detected)

  • .woff2 fonts are much smaller than .ttf, here's a web conversion tool!

• Experimental changes to the storage of directives in memory to reduce copying - can reduce their impact on frametimes when very long directives are present

  • Works especially well when extremely long directives are used for "vanilla multiplayer-compatible" creations, like generated clothing or custom items/objects.

• Perfectly Generic Items will retain the data for what item they were if a mod is uninstalled, and will attempt to restore themselves if re-installed.

• Musical instruments have their own volume slider in the options menu.

• Players can use items while lounging

• Client-side tile placement prediction (rewrite from StarExtensions)

  • You can also resize the placement area of tiles on the fly.

• Support for placing foreground tiles with a custom collision type (rewrite from StarExtensions, requires OpenSB server)

  • Additionally, objects can be placed under non-solid foreground tiles.
  • Admin characters have unlimited and unobstructed interaction/placement ranges

• Some minor polish to UI

• The Skybox's sun now matches the system type you're currently in.

  • Previously generated planets will not have this feature and will display the default sun.
  • Modded system types require a patch to display their custom sun.
  • You can also access the skybox sun scale and its default ray colors. For more details see, sky.config.patch.

Discord: To prevent spam, paste these directives after /render in-game to obtain the invite code.

<details> <summary>Directives</summary>

?crop=0;0;1;1?multiply=0000?replace;0000=4444?border=1;ccc0;0000?scale=.8;.6?replace;0000=00e178;4440=00e188;8881=001e88;9990=001e78?scale=194.50038;1?crop=0;0;195;2?replace;002078=001f78;002088=001f88;002978=002676;002988=002686;002c78=002b79;002c88=002b89;003078=002577;003088=002587;003478=003378;003488=038;003b78=002676;003b88=002686;003c78=002a78;003c88=002a88;003d78=002b78;003d88=002b88;003e78=002b79;003e88=002b89;004178=002f78;004188=002f88;004278=002577;004288=002587;004678=004578;004688=004588;005178=004779;005188=004789;005978=003677;005988=003687;006078=003677;006088=003687;006e78=003677;006e88=003687;007178=007078;007188=007088;007878=007778;007888=078;007b78=007078;007b88=007088;007d78=004577;007d88=004587;007e78=002577;007e88=002587;008278=002b73;008288=002b83;008378=002b74;008388=002b84;008478=002b75;008488=002b85;008578=002b76;008588=002b86;008678=002b77;008688=002b87;008778=002b78;008788=002b88;008878=002b79;008d78=00357a;008d88=00358a;009178=009078;009188=009088;009778=00357a;009788=00358a;009878=008e78;009888=008e88;009978=008f78;009a78=009078;009a88=009088;009b78=009078;009b88=009088;009c78=009278;009c88=009288;009d78=009378;009d88=009388;00a778=004779;00a788=004789;00b378=004578;00b388=004588;00b478=004578;00b488=004588;00c178=00337b;00c188=00338b;00cd78=00cc78;00cd88=0c8;00cf78=00ce78;00cf88=00ce88;00d478=007778;00d488=078;00d578=007778;00d588=078;00da78=004779;00da88=004789;088=002b89;098=008f88;002278=000;002378=000;002388=001;002d78=002;002d88=003;002e78=002;002e88=003;003f78=002;003f88=003;004078=002;004088=003;004878=000;004888=001;004978=000;004988=001;004a78=004;004a88=005;004b78=006;004b88=007;004c78=008;004c88=009;004f78=00a;004f88=00b;005078=00a;005088=00b;005278=000;005288=001;005378=000;005388=001;005478=004;005488=005;005578=006;005678=008;005688=009;005a78=00a;005a88=00b;005f78=00a;005f88=00b;006678=00c;006778=00c;006788=00d;006878=00c;006888=00d;006f78=00a;006f88=00b;007378=002;007388=003;007978=00c;007988=00d;007a78=00c;007a88=00d;008978=002;008988=003;009478=008;009488=009;009e78=008;009e88=009;00a578=00a;00a588=00b;00a678=00a;00a688=00b;00a878=000;00a888=001;00a978=000;00a988=001;00aa78=004;00ab78=006;00ab88=007;00ac78=008;00ac88=009;00b778=008;00b788=009;00b878=006;00b888=007;00b978=004;00b988=005;00ba78=000;00ba88=001;00bb78=000;00bc78=004;00bc88=005;00bd78=006;00bd88=007;00be78=008;00be88=009;00c278=004;00c288=005;00c378=000;00c388=001;00c478=000;00c488=001;00c578=004;00c588=005;00c678=006;00c688=007;00c778=008;00c788=009;00d878=00a;00d888=00b;00d978=00a;00d988=00b;00db78=000;00db88=001;00dc78=000;00dc88=001;00dd78=004;00de78=006;00de88=007;00df78=008;00df88=009;028=001;058=007;068=00d;0a8=005;0b8=001;0d8=005?replace;000=002178;001=002188;002=002b7a;003=002b8a;004=002478;005=002488;006=002578;007=002588;008=002678;009=002688;00a=003578;00b=003