StarBound Mod Installer

Discussion in 'Starbound Modding' started by lclc98, Dec 10, 2013.

Thread Status:
Not open for further replies.
  1. lclc98

    lclc98 Intergalactic Tourist

    Hey everyone, i created this starbound mod installer so i could easily install mods for myself and i thought it could help others so i decided i should release it to the public. This has only been tested on windows but it should work on others as i have added support.
    Sorry if its the wrong prefix/ section.

    Usage Guide:
    1. Click to launch it
    2. Browse for the zip file
    3. Browse for the base directory of starbound
    4. Hit load
    5. Done

    Links:
    Download V1.1
    Source

    TODO:
    Keep starbound base directory the same after restart
    Update checker

    FAQ:
    What does this program change?
    This program only edits one file of yours and that is the bootstrap.config. This extracts zip to mods folder inside and then calls it

    Changelog:
    Fixed Loading Bugs

    Credits:
    SethKipz for the mod install tutorial
     
    Last edited: Dec 12, 2013
  2. Halberde

    Halberde Star Wrangler

    Awesome!
    I've got a few questions.
    1. Is it possible to make it manage installed mods (ie. check boxes to add/remove the bootstrap.config entry)?
    2. Is it possible to make it to uninstall mods?
    3. Is it possible to make it edit the player.config file if a mod supplies a file with a series of entries?
    For example, a mod could supply a player.config.mod file, which could contains something like:

    Code:
    "defaultBlueprints" : { "tier1" :  [ { "item" : "cola"}, { "item" : "candispenser"} ] }
    Given this, could it look for "defaultBlueprints", creating it if absent, before then searching inside the brackets for "tier1" (or "tier2" or whatever else), creating if necessary, before finally adding the listed values to the bottom of the list?

    It would then be desirable to make this reversable as well.
     
  3. lclc98

    lclc98 Intergalactic Tourist

    I will try, to do all that stuff
     
  4. Halberde

    Halberde Star Wrangler

    Awesome! I look forward to seeing what you come up with.

    The one other suggestion I would make is changing the mod folder to be '/mods' rather than 'mod', as it matched say, '/assets' in that its plural, and makes more sense if you add multiple mods! :D

    Thanks again.

    EDIT: Also, tried it, worked as advertised.

    EDIT 2: Actually, it doesn't quite work.
    While it unzips the mod into the right place, it doesn't edit the bootstrap.config correctly. For instance, my mod file is CanDispenserMod - v1.1.zip, but the entry in the bootstrap.config is "../mod/mod", where as it would need to be (in my case) "../mods/CanDispenserMod".
     
    Last edited: Dec 10, 2013
  5. lclc98

    lclc98 Intergalactic Tourist

    Sure, that makes more sense
     
  6. lclc98

    lclc98 Intergalactic Tourist

    hmm weird, what os are you on?
     
  7. Halberde

    Halberde Star Wrangler

    Window 8.1 Pro 64 bit

    EDIT: The base directory I've been using is "C:/Program Files (x86)/Steam/SteamApps/common/Starbound/"

    I assume that is the correct folder (and I'd expect it would be, the files themselves are in the right spot. It's just not editing the mod correctly.
     
  8. lclc98

    lclc98 Intergalactic Tourist

    whats the file structure in ur zip?

    EDIT: Yeah thats the correct path
     
  9. Halberde

    Halberde Star Wrangler

    I just worked out that that would be the issue here.

    Before the zip structure was:
    Code:
    Can Dispenser Mod - v1.1.zip
        /CanDispenserMod
            /items
            /objects
            /recipes
        /Can Dispenser Mod Changelog
        /Can Dispenser Mod Readme
    
    I changed it to:
    Code:
    Can Dispenser Mod - v1.1.zip
        /Can Dispenser Mod - v1.1
            /CanDispenserMod
                /items
                /objects
                /recipes
            /Can Dispenser Mod Changelog
            /Can Dispenser Mod Readme
    
    And that now works
     
  10. lclc98

    lclc98 Intergalactic Tourist

    k, good
     
  11. Halberde

    Halberde Star Wrangler

    Oops, sorry, no it doesn't. While that now results in what I'd expect in the bootstrap.config:
    Code:
    {
      "assetSources" : [
        "../assets",
        "../mod/CanDispenserMod"
      ],
      "storageDirectory" : ".."
    }
    It would then not match up directly to the file structure in the "../mod" folder, which would look like:
    C:/.../Starbound/mod/Can Dispenser Mod - v1.1/CanDispenserMod/items

    It means this would only work if for:
    <name1>.zip/<name2>/files
    if name1=name2.

    For me, I'd rather specify version detail in the zip name, but then not worry about it inside necessarily, but have readme's and changelogs in just inside the zip. The bootsrap would only need to be "../mod/<name1>/<name2>/ (for instance, /mod/Can Dispenser Mod - v1.1/CanDispenserMod/ ), but the files help files could then be located in /mod/Can Dispenser Mod - v1.1/.

    I'm not sure what you'd want to do, but you should either stress the point that the names should be the same (ie give a sample file structure for people to copy), or possibly tweak it.

    My vote would be have the file structure as:

    Code:
    /mods
        /MyMod v1.0
            /MyMod
                /items
                /objects
                /recipes
            /readme.txt
            /changelog.txt
    With the the zip like:
    Code:
    /MyMod v1.0.zip
        /MyMod v1.0
            /MyMod
                /items
                /objects
                /recipes
            /readme.txt
            /changelog.txt
    and the bootstrap.conf as:
    CODE]{
    "assetSources" : [
    "../assets",
    "../mod/MyMod v1.0/MyMod"
    ],
    "storageDirectory" : ".."
    }[/CODE]
     
  12. lclc98

    lclc98 Intergalactic Tourist

    k, sure. I will remove the jar til i get it fixed
     
Thread Status:
Not open for further replies.

Share This Page