Skip to main content

Characters & Outfits

The most popular mods are the ones where you modify existing characters. Everyone wants to make Queen's boobs bigger, now you can! Character assets are heavily reliant on file name and file paths. Character assets are also reliant on things called atlas files, but follow this guide, and you'll understand what to do.

warning

Please read this guide thoroughly and do not skip parts!

Download Assets

You can find .psd files for all characters here.

Layer Structure

Queen's Brothel characters have a very strict structure and naming scheme. If you mess this part up, your mod will not work. Fortunately for you, I've created an app to help you export your characters from your .psd file. Below is the layer structure:

* {OUTFIT_ID}
* Variants
* Default
* Cum
* Pussy
* 3
* 2
* 1
* Chest
* 3
* 2
* 1
* Face
* 3
* 2
* 1
* Messy Hair
* Dick
* Cum
* Dick
* Hair Bangs
* Faces
* Seduce
* Unimpressed
* Disgust
* Orgasm
* Surprise
* Angry
* Sad
* Happy
* Neutral
* Makeup Smears
* Blush
* Body

Every character must follow this layer structure. You are able to add any amount of variants you want in the Variants layer group, but there must be one named Default. You are allowed to leave layers blank, if you do not need them, for example the Hair Bangs layer.

Modify Existing Character

Create New Outfit

Let's make an outfit for Queen. Download the Queen .psd file from here.

  1. Select the Default layer group and make a duplicate of it (Ctrl + J in Photoshop)
  2. Rename the new layer group to Tutorial
  3. Click the Tutorial/Variants/Default layer
  4. Use the brush tool to scribble over Queen's body
  5. Create a new layer next to Tutorial/Variants/Default and name it MyVariant
  6. Hide the Tutorial/Variants/Default layer
  7. Click your new Tutorial/Variants/MyVariant layer
  8. Use the brush tool to scribble over Queen's body

The steps above will create a new outfit named Tutorial with two variants, the default one and one named MyVariant. You are not allowed to change the name of Default, but you are able to change the name of any other variants.

warning

Variant names must not have special characters or spaces. Treat them like IDs.

  1. Save your .psd
  2. Use the Character Tool to export your character assets
  3. Follow the instructions here to copy your assets into your mod files

Now that we have our assets into our mod file system, we can tell Queen's Brothel that our outfit exists.

  1. Open res://mods/{MOD_ID}/init.gd
  2. Add an addOutfit function
    1. QB.character.getCharacter("Queen").addOutfit("Tutorial", "My Outfit", "A nice looking outfit!", true)

The code above will put our new outfit in the game and will unlock it by default, so you can boot up the game and find it in your house without having to buy it from Cassie's shop.

Create New Character

We recommend copying an existing .psd to start. Download the Queen .psd file from here. For this example, we're going to assume your character's ID is Suzie.

PSD File

Erase every layer in the Default layer group before getting started. You don't want to accidentally have lingering Queen assets in there.

There are many layers that you will need to create. You have existing .psd files to use as reference for your characters.

After you are done creating your character .psd file, you must save the .psd file as the ID of your character. For example, if you are going to set the ID of your character to Suzie then your .psd file must be named Suzie.psd.

Follow the instructions here to copy your assets into your mod files.

Create Character Script

Now that we have our character's assets into the game, we can tell Queen's Brothel that our character exists.

Create a new .gd script file in res://characters/ with the ID of your character. res://characters/Suzie.gd

Initialize your Character script with this script:

extends Character


func _init().("Suzie", "Suzie"):
pass

If you want your character to always have a dick, you can set the dick to true using setDick(true).

  1. Open the res://mods/{MOD_ID}/init.gd script
  2. Add an addCharacter function
    1. QB.character.addCharacter('Suzie')

Add Assets Into Game

This part is important. Make sure you follow these instructions carefully.

  1. Extract character assets using the Character Tool
  2. Move character folders to res://assets/dialogue/character
    1. Example: res://assets/dialogue/character/Queen

The character tool will create an Outfits folder in the output directory that will have previews for your outfits. These files are important for main characters, not NPCs. If you are making an outfit for an NPC, you can delete those preview files.

If you are creating an outfit for a main character:

  1. Move the Outfits folder to res://assets/dialogue
    1. Example: res://assets/dialogue/Outfits

Atlas File

Now, we have to create an atlas file for your character outfit. Atlas files help increase performance and are mandatory to keep low memory usage.

info

Queen's Brothel characters have a minimum of 27 layers. Each layer is 1000x1080. A 1000x1080 texture is 4.11mb in RAM. 27 layers would mean it costs 111mb to display a character on the screen. If we were to load 10 characters for a dialogue scene, that would cost 1.1gb of RAM.

Atlas files shrink our 27+ layers into one file. It does this by removing all transparency from your file and then telling the engine how to display the image when it is called. Meaning, we just turned 27 images into 1 and are now loading one ~8mb file.

  1. To create an atlas file, select your outfit's assets in the Godot FileSystem.
    1. Selecting Outfit Assets
  2. In the top left of the Godot engine click the Import tab
  3. Select TextureAtlas
  4. Click the folder icon next to Atlas File and save your atlas in res://assets/dialogue/Atlases
    1. For best practice, name your atlas file {CHARACTER_ID}-{OUTFIT_ID}
      1. Ex: Queen-Default.png
      2. Ex: Suki-Cheerleader.png
      3. Ex: Suzie-Default.png
  5. Click ReImport (*)
  6. Godot will have to restart to finish this step. Click Save Scenes, Re-Import, and RestartImport TextureAtlas

File Path Summary

Outfits

res://assets/dialogue/character/{CHARACTER_ID}/{OUTFIT_ID}

Atlases

res://assets/dialogue/Atlases/{CHARACTER_ID}-{OUTFIT_ID}.png res://assets/dialogue/Atlases/Queen-Maid.png res://assets/dialogue/Atlases/MyCharacter-Default.png