Starbound

Starbound

73 ratings
B.Y.O.S. addon the Avali race (and tutorial)
   
Award
Favorite
Favorited
Unfavorite
File Size
Posted
Updated
191.488 KB
9 Aug, 2016 @ 9:14am
12 Aug, 2016 @ 11:26pm
3 Change Notes ( view )

Subscribe to download
B.Y.O.S. addon the Avali race (and tutorial)

Description
This mod extends the BYOS functionality to custom races. Note: Felin are now a seperate addon mod

Required: BYOS 1.3 or higher, as well as the original mod for the race you want to use.

Use notepad++, or your plain text editor of choice. No Word, wordpad or similar office products, basic notepad will work if you don't have anything else.

Stuff in between <> will need to be replaced.
<racename> = the name of the race as it is used in the the ships folder
<modname> = the name of the custom race mod, as defined in the .modinfo of the original mod.
<enter your name here> = i think you know what to do.

Have the following files in your mod folder (starbound/mods/byoscr<racename>):

.metadata
universe_server.config.patch
/ships/<racename>/blockkey.config
/quests/story/bootship.questtemplate.patch

Note that to make the .metadata file in windows, don't call it .metadata, but add in an extra . at the end, so .metadata.
The dot will disappear, and the file is now in place. Turn off the option hide known extensions in windows explorer. If you do not know how to do that, google it or click here.

One last note before we go into the actual files. The mod included in this tutorial is open to use as reference for what I'm telling below. Use it as an example or a base to edit from, but do NOT keep the blockkey.config, as that one is race specific. Instructions will follow when we get there.

Multiple races within a single mod DO work, as long as all the races are installed. My advice would be to do a seperate mod for each race.

.metadata contents


{
"includes" : ["byos", "<modname>"],
"author" : "Enter your own name",
"description" : "A custom race extension for Amber Talamasca's BYOS, adding <racename> support",
"friendlyName" : "B.Y.O.S. addon for race <racename>",
"name" : "byos<racename>",
"version" : "1.0"
}

universe_server.config.patch contents:

[ { "op" : "add", "path" : "/speciesShips/<racename>/-", "value" : "/ships/byos/byos.structure" } ] /quests/story/bootship.questtemplate.patch Code: [ { "op": "replace", "path": "/completionText", "value": "There's no repairing this old SAIL anymore. The shiplocker is gone too, you will need to replace them. Use these." }, { "op": "add", "path": "/rewards/0/-", "value": [ "<racename>techstation", 1 ] }, { "op": "add", "path": "/rewards/0/-", "value": [ "<racename>shiplocker", 1 ] } ] /ships/<racename>/blockkey.config This is the only file you will not write yourself, but take from the original mod and adjust. so find the blockkey.config in the original mod, and copy it to this mods ships/<racename> folder There are 2 steps to editing this file. 1: Find any mention of residual, and change its value from true to false. So "objectResidual" : true becomes "objectResidual" : false and "foregroundResidual" : true becomes "foregroundResidual" : false 2: Find the shiplocker entry. Not the shiplockerTier0 entry, but the one without Tier0 in its name. Now change the value of "object" : "<racename>shiplocker", to "object" : "", save your files and start your game. Congratulations! You have just extended the BYOS mod with the custom race of your choosing. Feel free to share the made mod.
83 Comments
Dreamscarf 4 Jan @ 1:21pm 
what to do if there is no “ship” folder in the original mod folder. This particular situation happened with the "Mechineki" race, since it is an addition to the "Neki" mod
Amber Talamasca  [author] 17 Nov, 2022 @ 8:40am 
@Hyperspec dont worry about it.. although i cant help you, i hope you find the FU variant!
Hyperspec 17 Nov, 2022 @ 5:56am 
i am sorry if i made you sigh i ant that thoughtfull when i type most of the time and i hope i can find my fu avali fix i cant seem to find any also i dont have the spriting skills to make my own race
Amber Talamasca  [author] 14 Nov, 2022 @ 9:02am 
@HyperSpec, that is correct, this is not for FU. This is for my BYOS, which came first. The FU creating just nicked the name. The above manual is for if people want to add their own races to the mods compatibility.You can just install this for the avali to be added, but if you want to make your own race, the text above is for how to do that
Hyperspec 13 Nov, 2022 @ 6:06am 
also i dont think this is for fu byos... it sais nothing about fu....
Hyperspec 13 Nov, 2022 @ 6:03am 
I wish it just worked like any other mod and just did its thing before anything
also yes i moved the spawnpoint or verry someties when i make a large ship i just build over it but i am gonna look for simpeler option and i hope i can find one but prob not.... i dont know
Orchid the Dragon 26 Aug, 2022 @ 4:57pm 
Idk if this is necroposting, but I cannot for the life of me figure out this insane tutorial. I can't find out where I'm supposed to find things like "<racename>" or "<modname>", and I think this guide might be out of date? in my workshop folder, all my mods only have an obfuscated/encrypted "contents.pak" file. Help, please!
doomderp 11 Aug, 2022 @ 3:07pm 
thank you for the tutorial, you're an absolute legend.
Amber Talamasca  [author] 20 Jul, 2021 @ 12:16pm 
@ibfolk2c Do the troubleshooting section of the main byos mod. this happens because you installed the mod after the character was created. following the troubleshooting section will fix it.
ibfolk2c 20 Jul, 2021 @ 12:13pm 
I have an issue, it might very well be a mod i have but when i finished the quest my old shiplocker and a drone charging dock remained floating in the air, and i cant remove them even when trying to turn off tile protection via commands