# Starbecue

Starbecue is an 18+ fetish mod created for starbound that focuses mainly on Vore, Macro/Micro, and Transformation fetish content as well as many adjacent kinks.

The mod has a opt-in based consent system for deciding what sort of actions you are subject to, as well as perform on other characters whether they be player or NPCs. While there is no way to prevent one from viewing other characters performing actions one may not have opted in to, those actions cannot be performed on you by anyone and NPCs will ignore you when seeking out those actions. NPCs can also be configured ingame in much the same way players can configure themselves, however, certain OCs may have certain settings locked to a specific value by their owner.

# Install

Starbecue requires a modified executable that both improves and expands features of the game for modders to take advantage of, most feature changes were to be in service of achieving the intended fetish content in an easier manner, however the changes to the engine itself do not include any fetish specific content, and are not exlusively in service of such content, most overall were meant to improve the game experience for players and modders.

Make sure to delete any previously installed versions of starbecue within the `Starbound/mods/`
This includes any version of `starbecue.pak` and `starboundSpeciesAnimOverrides.pak` or `SBQ_engine_assets.pak`

Latest versions are available on [patreon](https://www.patreon.com/LokiVulpix)

This mod Requires [Stardust Core Lite](https://steamcommunity.com/sharedfiles/filedetails/?id=2512589532) or [Stardust Core](https://steamcommunity.com/sharedfiles/filedetails/?id=764887546)

While not required it is recommended you install the Monster Config Core Loader mods found [here](https://steamcommunity.com/sharedfiles/filedetails/?id=2442860690) and [here](https://steamcommunity.com/sharedfiles/filedetails/?id=2442873217), if you're using Stardust Core then you should get [this](https://steamcommunity.com/sharedfiles/filedetails/?id=2690363974) and if you're using FU you'll also need [this](https://steamcommunity.com/sharedfiles/filedetails/?id=2442880727) because it should fix potential compatibility issues.

Further steps are somewhat OS specific!

## Windows

### Setup Script
Double dlick the provided `setup.bat` file to execute it

The script has will have copied the files into their correct place, you can now play starbound with the mod!

if this didn't work try manual setup, or open the script in a text editor and change the starbound directory path to where yours is located

### Manual Setup
Open the `Starbound` directory by viewing its properties on steam, and clicking `Browse` on the `Installed Files` tab

Place `starbecue.pak` and `SBQ_engine_assets.pak` files within `Starbound\mods\`

if you downloaded the win64 version, you're going to open the `Starbound\win64\` folder

Replace the `starbound.exe` file with the provided version
if you are running a server, also replace `starbound_server.exe` provided seperately

## linux

### Setup Script

Open the diretory containing these files within terminal, this can be done by left clicking the folder and selecting "New Terminal At Folder" or opening terminal and using `cd` to open the directory by typing the path (you can simply drag the folder into terminal rather than typing the path manually)

Input the following commands
`chmod +x ./install.sh`
`./install.sh`

The script should have copied the files into their correct place, you can now play starbound with the mod!

if this didn't work try manual setup, or open the script in a text editor and change the starbound directory path to where yours is located

### Manual Setup

Open the `Starbound` directory by viewing its properties on steam, and clicking `Browse` on the `Installed Files` tab

Place `starbecue.pak` and `SBQ_engine_assets.pak` files within `Starbound/mods/`

Replace the `starbound` file within `Starbound/linux/` with the provided version

Replace the `starbound_server` file within `Starbound/linux/` with the provided version if you are running a server

View the file properties on each executable and enable them as executables

## macOS

### Setup Script
Open the diretory containing these files within terminal, this can be done by left clicking the folder and selecting "New Terminal At Folder" or opening terminal and using `cd` to open the directory by typing the path (you can simply drag the folder into terminal rather than typing the path manually)

Input the following commands
`chmod +x ./setup.sh`
`./setup.sh`

The script should have copied the files into their correct place, you can now play starbound with the mod!

if this didn't work try manual setup, or open the script in a text editor and change the starbound directory path to where yours is located

### Manual Setup

Open the `Starbound` directory by viewing its properties on steam, and clicking `Browse` on the `Installed Files` tab

Place `starbecue.pak` and `SBQ_engine_assets.pak` files within `Starbound/mods/`

Replace the `starbound` file within `Starbound/osx/Starbound.app/Contents/MacOS/` with the provided version (left click and select "Show Package Contents" on Starbound.app)

Replace the `starbound_server` file within `Starbound/osx/` with the provided version if you are running a server

The files are now in the correct place, you can now play starbound with the mod!

## Uninstall

Open the `Starbound` directory by viewing its properties on steam, and clicking `Browse` on the `Installed Files` tab

delete `starbecue.pak` in the `mods` folder

IF you are playing with other players who have the same modified executable, but simply do not wish to have SBQ content, you can stop here

return to the `Installed Files` tab and select `Verify integrity of game files`

Steam will then re-download the unmodified versions of the game executable


# WARNING! the following text explaining how the mod works may be innacurate while we are working on this major rewrite!

# Getting Started

On creation of a new character, a popup menu will open up to allow one to quickly assign the settings. To change those settings and access further settings, then open the toobar and select **Starbecue Settings** to open the settings menu.

To get started with the mod, all you need to do is open your crafting interface, and craft the **SBQ Controller** this is the main item used to perform actions, and can be re-assigned via it's action wheel.

Available actions are determined by your current species, what sort of state you're in, and most importantly, what settings you have enabled.

More content can be found via discovering **Auri's Shop** which you can get to via some mysterious fireplaces you might find on lush planets, they look like this:
![](/fireplace.png)

## Settings Overview
The settings are accessed via the toolbar and selecting **Starbecue Settings**.

The **Main** tab is mostly focused with predator based settings, changing what effects your body has and etc. Some settings are specific to your current species, though most are global. Some settings are also reliant on other preferences to be displayed.
Eg: Cock Vore related settings will not be shown if one has not selected that they are a Cock Vore Pred.

The **Prefs** tab controls consent based settings on what actions you can perform and what can be performed on you, as well as modifiers on how much they might be able to effect you.

The **Help** tab contains general information about the mod, it probably contains the same information in this readme!

Depending on your species, you may also find an additional tab with a manual to explain that species' capabilities!

You can also use the **Nominomicon** to open the settings page for any SBQ NPC or Pred Object to edit their settings and read their manual in the same manner as you would for yourself, however OC NPCs may have certain settings locked to a specific value by their owner.

# Compatible Species
Species which are supported are listed down below, unsupported races will still be able to use the controllers for the default available actions, but will not have any special animations when perfomring most of them.

Most species will only need a simple patch to be made compatible, as well as added to the valid tenant list, a template can be found [here](https://github.com/WasabiRaptor/SBQ-Race-Compatibility-Tempate)

One can also create their own OC for the mod using this template [here](https://github.com/WasabiRaptor/SBQ-NPC-Template)

![](/vehicles/sbq/sbqVaporeon/sbqVaporeon.png)![](/vehicles/sbq/sbqEgg/sbqEgg.png)![](/vehicles/sbq/sbqSlime/sbqSlime.png)![](/vehicles/sbq/sbqXeronious/sbqXeronious.png)![](/vehicles/sbq/sbqAvian/sbqAvian.png)![](/vehicles/sbq/sbqZiellekDragon/sbqZiellekDragon.png)![](/vehicles/sbq/sbqFray_IcyVixen/sbqFray_IcyVixen.png)

### SBQ Special Species
> These species are special species and may possess more abilities or play differently than one's standard state
- Vaporeon
- Kaiju (Xeronious)
- Giant Avian
- Slime
- Ziellek Dragon
- Fray the Vulpix

### SBQ Species
> Races included within SBQ by default
- Vaporeon
- Flareon
- Meowscarada
- Hellhound
- Catfox

### OC NPCs
> These characters cannot be played as, however can be spawned in via the **SBQ Colony Deed** which can be purchased in Auri's shop
- Loki Deerfox (Pred/Prey) LokiVulpix
- Auri Drimyr (Pred/Prey) LokiVulpix
- Socks Flareon (Pred/Prey) LokiVulpix
- Clover Meowscarada (Pred/Prey) LokiVulpix
- Zevi Goocat (Pred/Prey) Zygahedron
- Helena Hellhound (Pred/Prey) FFWizard
- Sandy Floatporeon (Pred/Prey) Fevix
- Batty (Pred/Prey) Xeronious
- Blue the Synth (Pred/Prey) Blueninja (requires [Synth](https://steamcommunity.com/sharedfiles/filedetails/?id=2207290706))
- Akari Kaen
- Ferri Catfox (Pred/Prey) Ferrilata_

### External Compatible Species
> This mod includes patches for the species below to add compatibility, it does not include any of their respective assets.
- Human
- Hylotl
- Floran
- Avian
- Apex
- Glitch
- Novakid
- Fenerox
- [Avali](https://steamcommunity.com/sharedfiles/filedetails/?id=729558042)
- [Novali](https://steamcommunity.com/sharedfiles/filedetails/?id=1386730092)
- [Lucario](https://steamcommunity.com/sharedfiles/filedetails/?id=1356955138)
- [Lycanroc](https://steamcommunity.com/sharedfiles/filedetails/?id=1800401078)
- [Eevee](https://steamcommunity.com/sharedfiles/filedetails/?id=1405822108) (GalaxyFoxes)
- [Eevee](https://steamcommunity.com/sharedfiles/filedetails/?id=1266991719) (Remade)
- [Jolteon](https://steamcommunity.com/sharedfiles/filedetails/?id=2075613227)
- [Espeon](https://steamcommunity.com/sharedfiles/filedetails/?id=1144430324)
- [Umbreon](https://steamcommunity.com/sharedfiles/filedetails/?id=730345787)
- [Glaceon](https://steamcommunity.com/sharedfiles/filedetails/?id=2012704863)
- [Sylveonoid](https://steamcommunity.com/sharedfiles/filedetails/?id=2843385916)
- [Braixen](https://steamcommunity.com/sharedfiles/filedetails/?id=2260578148)
- [Delphox](https://steamcommunity.com/sharedfiles/filedetails/?id=2260578148)
- [Zoroark](https://steamcommunity.com/sharedfiles/filedetails/?id=2811625141)
- [Hisui Zoroark](https://steamcommunity.com/workshop/filedetails/?id=2813977483)
- [Crylan](https://steamcommunity.com/sharedfiles/filedetails/?id=1197335162)
- [Rodent](https://github.com/Zygahedron/StarboundSimpleVoreMod) (Sheights' version of SSVM is broken, this is a fixed fork)
- [Lyceen](https://steamcommunity.com/sharedfiles/filedetails/?id=1360547769)
- [Latex](https://steamcommunity.com/sharedfiles/filedetails/?id=1818502101)
- [Elysian](https://steamcommunity.com/sharedfiles/filedetails/?id=1405822108)
- [Fennix](https://steamcommunity.com/sharedfiles/filedetails/?id=1405822108)
- [Felin](https://steamcommunity.com/sharedfiles/filedetails/?id=729429063)
- [Draconis](https://steamcommunity.com/sharedfiles/filedetails/?id=1370154570)
- [Draconis](https://steamcommunity.com/sharedfiles/filedetails/?id=1226150792) (Full Dragon Reskin)
- [Gnolls](https://steamcommunity.com/sharedfiles/filedetails/?id=1655860448)
- [Argonians](https://steamcommunity.com/sharedfiles/filedetails/?id=740694177)
- [Sergals](https://steamcommunity.com/sharedfiles/filedetails/?id=1420856270) (Most reskins should work too)
- [Familiars](https://steamcommunity.com/sharedfiles/filedetails/?id=729597107)
- [Vulpes](https://steamcommunity.com/sharedfiles/filedetails/?id=1307942879)
- [Kazdra](https://steamcommunity.com/sharedfiles/filedetails/?id=767787220)
- [Elduukhar](https://steamcommunity.com/sharedfiles/filedetails/?id=729480149)
- [Attarran](https://steamcommunity.com/sharedfiles/filedetails/?id=797166006)
- [Neki](https://steamcommunity.com/sharedfiles/filedetails/?id=2611501999)
- [Mechineki](https://steamcommunity.com/sharedfiles/filedetails/?id=2740063170)
- [Lastree](https://steamcommunity.com/sharedfiles/filedetails/?id=1380941596)
- [Synth](https://steamcommunity.com/sharedfiles/filedetails/?id=2207290706)
- [Bunnykin](https://steamcommunity.com/sharedfiles/filedetails/?id=732452461)
- [Yharian](https://www.furaffinity.net/view/47517002/)
- [Spacekidds](https://steamcommunity.com/sharedfiles/filedetails/?id=2790390697)
- [Viera](https://steamcommunity.com/sharedfiles/filedetails/?id=732276079)
- [Everis](https://steamcommunity.com/sharedfiles/filedetails/?id=1117006719)
- [Bossmonster](https://steamcommunity.com/sharedfiles/filedetails/?id=1563090801)
- [Twilit Wolves](https://steamcommunity.com/sharedfiles/filedetails/?id=1818480557)
- [Mons](https://steamcommunity.com/sharedfiles/filedetails/?id=2310314462)
- [Spirit Tree](https://steamcommunity.com/sharedfiles/filedetails/?id=2191906942)
- [Squamaeft](https://steamcommunity.com/sharedfiles/filedetails/?id=2462459956)

# Predator Info

To be a pred, one must have opted in to being pred for the relevant vore type. One can also choose whether other characters must ask consent for the relevant actions.
Eg: If you select Oral Vore pred, but don't require consent, you're allowing prey characters to attempt to force their way inside your mouth. If consent is enabled, then you will recieve a textbox prompt to confirm or deny requests, but you will still be able to attempt the action yourself freely.

To perform predator actions, one requires a **SBQ Controller** these can be crafted for a single pixel. Open the action wheel and assign an action, available actions are determined by what settings you have enabled, as well as what species you are.

The action wheel will also let you release any prey you have eaten, or select a specific prey to perform prey specific actions only available through this menu.

In the bottom right you will have a HUD to show you the health of your current occupants, as well as the progress bar for any extra effects they are currently being subject to. This HUD will also allow you to quickly change the current digest effect for the selected location.

# Prey Info

To be prey, one must have opted in to being prey for the relevant vore type. One can also choose whether other characters must ask consent for the relevant actions.
Eg: if you select Oral Vore prey, but don't require consent, you're allowing pred characters to attempt to eat you without asking. If consent is enabled, you will recieve a textbox prompt to confirm or deny requests, but you will still be able to attempt the action yourself freely.

When you've been eaten a HUD will open up in the bottom right, indicating the directions one can press to cause a struggle animation. The color of the indicator arrow hints at what struggling in that direction might do for you. Holding **Shift** will prevent any actions from occuring from your struggles, only playing the animations, such as if one didn't want to escape.

- Red
> You might be able to escape the pred.
- Blue
> Might make the pred change state.
- Green
> Might make the pred change state, or let you move to another location in the predator's body, regardless it'll be easier for you to escape.
- Cyan
> Might let you move to another location within the predator's body.
- Yellow
> Might get the pred to perform some sort of action on you.

# Support Us!

https://www.patreon.com/LokiVulpix

Vote on what should be the next feature worked on!

## Main Credits

### LokiVulpix / Wasabi_Raptor

Artist, Lua scripting and debugging.

> I take commissions! contact me if I am open!
>
> https://itaku.ee/profile/lokivulpix
> https://twitter.com/LokiVulpix

### Zygan (Zygahedron)

Artist, Lua scripting and debugging.
