1. Welcome to the official Starbound Mod repository, Guest! Not sure how to install your mods? Check out the installation guide or check out the modding help thread for more guides.
    Outdated Mods have been moved to their own category! If you update your mod please let a moderator know so we can move it back to the active section.
    Dismiss Notice

Combinable Augments Version 2.1

1 augment to rule them all!

  1. C0bra5
    legendary.png
    Combinable Augments
    Combinable augments allows you to combine all of your augments, collars and fishing lures into a single piece of mastery.

    1 Augment to rule them all, this is the goal of this mod.

    What can you do?
    • Combine epp augments together
    • Combine epps together to merge epps or upgrate to a new level of epp (the output epp type corresponds to the epp on the right)
    • Combine epps with augments to give them more augments
    • Combine collar augments together
    • Combine filled capture pod with collars to give them more collars
    • Extract augments or collars out of epps, filled capture pods, combined augments or combined collars
    • Extract specific augments or collars out of epps, filled capture pods, combined augments or combined collars
    • Extract all augments or collars out of epps, filled capture pods, combined augments or combined collars
    • Manage augments from armors when using mods that add augment slots to armors
    • Create combined lures and reels at the survival/farming crafting table

    How to get started
    You'll have to craft an augment combiner.
    You'll need a fully upgraded inventor table (architect table)

    To craft it you'll need:
    - 10 durasteel bars
    - 5 silver bars
    - 2 silicone board
    - 10 wire
    - 1 battery

    Can i combine/extract from augment comaptible armors from mod X
    yes

    is this compatible with augments from X mod?
    the short answer is yes,
    When it comes to combining non-vanilla augments:
    There should never be any issue.

    When it comes to extracting non-vanilla augments from combined augments:
    There should never be any issue.

    When it comes to extracting non-vanilla augments which were applied using a right-click:
    When a player applies an augment, collar, reel or lure to an item using a right-click, the game does not save any identifying reference to the applied item. It does save some information, but the information saved cannot be used to guarantee an identification. Our solution to this problem is simple: using some of the information saved to by the game, we make a guess on which augment it's most likely to be. To accomplish this, we have combed though vanilla and modded assets to find as many augments to create an index which contains information which is unique to most augments. If we cannot establish a match though our index, we create a "vanilla compatible item". For all intent and purposes the created augment will be identical to the original item. The only issue which may arise from these vanilla compatible items occurs when you uninstall the mod which added the original augment. Since the image asset and status effect provided for the item no longer exist, this may cause them to turn into Perfectly Generic Item. This is an edge case which is unlikely to occur, but we prefer warning users of this potential issue.


    Is this mod configurable?
    Using a separate mod one may apply non-standard configurations to combinable augments. Right now one may apply a limit on the maximum number of augments in a single combined augment and apply modifications to the recuperation index.

    Settings
    Combinable Augments provides a settings file. This file goes over how they are used.

    **Please note that server settings take priority over client settings.**

    _________________________________________________________________________________________________________

    table limits
    This table two numeric properties, `augment` and `collar`.
    As the name implies, these properties limit the number of augments that can be
    installed on a piece of equipment. If the value of a property is set to 0, no
    limit will be applied, allowing for infinite combining.

    Default value:
    Code:
    "limits" : {
        "augment" : 0,
        "collar" : 0
    }

    _________________________________________________________________________________________________________

    ANY SETTINGS BEYOND THIS POINT ARE ONLY USEFUL TO MOD DEVELOPERS
    _________________________________________________________________________________________________________

    table recuperationConfig
    When a player applies an augment to a piece of equipment, the item id of the
    augment isn't saved. This table is used to properly identify and extract
    augments that have been applied using the vanilla technique. Since all augments
    store a `name` and a `displayName` value, we have settled on using these values
    to properly identify augments. If the combiner encounters an unrecognized
    augment it will create a vanilla compatible version that has the same effects
    as the unrecognized augment.


    Default Value:
    Code:
    "recuperationConfig" : {
        "augment" : {
            "damage1|Damage I" : "damageaugment1",
            "damage2|Damage II" : "damageaugment2",
            "name|displayName" : "itemId",
            "...|..." : "..."
        }
        "collar" : {
            "bouncycollar|Bouncy" : "bouncycollar",
            "damage1|Damage I" : "damagecollar1",
            "name|displayName" : "itemId",
            "...|..." : "..."
        }
    }
    _________________________________________________________________________________________________________

    Modifying the default settings
    To modify the settings from combinable augments, you will need to create a mod
    which applies a patch to said settings. This section will guide you though
    create the mod and explain what each setting does.

    We recommend using a raw text editor like notepad++ or gedit to endit files in
    the steps described below.

    _________________________________________________________________________________________________________

    Creating the basic mod
    1. Create a folder in your mods folder. Name it what ever you feel like.
    2. Create a file with the following name: `_metadata`.
    3. Open the `_metadata` in a text editor.
    4. Enter this code, replacing `[YourNameHere]` with your name, then save the file.
    Code:
    {
        "author" : "[YourNameHere]",
        "description" : "Sets a limit on augment combinations",
        "friendlyName" : "[YourNameHere]'s CA limiter",
        "includes" : ["Combinable Augments"],
        "name" : "[YourNameHere]'s CA limiter"
    }
    5. In the folder you created in step 1, create a file with the following name:
    `combinableaugments.config.patch`
    6. Open the `combinableaugments.config.patch` file in a text editor.
    7. Enter the following code and then save the file:
    Code:
    {
        //insert patches here
    }
    8. Insert any patches described below between the two curly braces.
    9. Save the file.
    10. Launch the game to verify you didn't make any errors.

    _________________________________________________________________________________________________________

    Setting the combination limits
    To set the combination limit for augments and/or collars copy the following patches
    to your patch file, replacing the values with your desired settings.
    Code:
    [
       { "op" : "replace", "path" : "/limits/augment", "value" : 1 },
       { "op" : "replace", "path" : "/limits/collar", "value": 1 }
    ]
    _________________________________________________________________________________________________________

    Adding augments to the recuperation config
    To add augments to the recuperation table, past the following code, making sure
    to replace `[name]`, `[displayName]` and `[itemId]` with your own values:

    For epp augments:
    Code:
    [
        { "op": "test", "path": "/recuperationConfig/augment/[name]|[displayName]", "inverse" : true },
        { "op": "add", "path": "/recuperationConfig/augment/[name]|[displayName]", "value": "[itemId]" }
    ]
    For collars:
    Code:
    [
        { "op": "test", "path": "/recuperationConfig/collar/[name]|[displayName]", "inverse" : true },
        { "op": "add", "path": "/recuperationConfig/collar/[name]|[displayName]", "value": "[itemId]" }
    ]
    _________________________________________________________________________________________________________

    Example of a full patch file
    Code:
    [
        { "op" : "replace", "path" : "/limits/augment", "value" : 3 },
        { "op" : "replace", "path" : "/limits/collar", "value": 2 },
        [
            { "op": "test", "path": "/recuperationConfig/augment/[name]|[displayName]", "inverse" : true },
            { "op": "add", "path": "/recuperationConfig/augment/[name]|[displayName]", "value": "[itemId]" }
        ],
        [
            { "op": "test", "path": "/recuperationConfig/collar/[name]|[displayName]", "inverse" : true },
            { "op": "add", "path": "/recuperationConfig/collar/[name]|[displayName]", "value": "[itemId]" }
        ]
    ]


    ps: this does not make you augments stronger of you combine 2 smaller ones, we still want some balance in here

    back.png crafting.png interface.png ingame.png
    Mod Pack Permissions:
    You must get the author's consent before including this mod in a compilation.
    Mod Assets Permissions:
    Do not alter or redistribute the assets included in this mod.
    SANEK1, J_Verdad, Lehanson and 3 others like this.

Recent Updates

  1. Version 2.1
  2. Hotfix 2.0.7
  3. Hotfix 2.0.6

Recent Reviews

  1. nicjona41
    nicjona41
    5/5,
    Version: Version 2.1
    ...
  2. Ashtar084
    Ashtar084
    5/5,
    Version: 2.0.7
    beautiful mod, compatible with FU?
  3. ShinyBox
    ShinyBox
    5/5,
    Version: 2.0.7
    Very cool
  4. enimorf
    enimorf
    5/5,
    Version: 2.0.7
    Amazing
  5. Predilecta
    Predilecta
    5/5,
    Version: 2.0.7
    I liked it, very complete.
  6. artguk
    artguk
    5/5,
    Version: 2.0.7
    Thank you!
  7. lbqt99
    lbqt99
    5/5,
    Version: 2.0.7
    Very useful
  8. LMasterGame
    LMasterGame
    5/5,
    Version: 2.0.7
    Very useful mod
  9. Lockin_Nekerein
    Lockin_Nekerein
    5/5,
    Version: 2.0
    This Perfect
  10. Sock_Bunny
    Sock_Bunny
    5/5,
    Version: 2.0
    Amazing mod, amazing interface, amazing everything