Fractal Softworks Forum

Please login or register.

Login with username, password and session length
Advanced search  

News:

Starsector 0.97a is out! (02/02/24); New blog post: Simulator Enhancements (03/13/24)

Pages: [1] 2

Author Topic: Readme & Feedback  (Read 35622 times)

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Readme & Feedback
« on: November 18, 2012, 03:04:21 PM »

This board contains the official modding documentation.

I'll be adding to it over time (likely very gradually). The documentation found here will be more technical, not going to the step-by-step level of some of the guides found in the Modding Resources forum.

The posts with the actual documentation will be locked, in the interest of keeping things neat and tidy. If you spot an error or have a comment, please post in this thread.
Logged

silentstormpt

  • Admiral
  • *****
  • Posts: 1060
    • View Profile
Re: Readme & Feedback
« Reply #1 on: November 19, 2012, 05:20:45 AM »

You can leave this to us, unless we're missing something, for that please "reply what's missing"/"correct what's wrong".
Logged

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Re: Readme & Feedback
« Reply #2 on: November 19, 2012, 09:01:42 AM »

The point of this is there are things you'd never know about in the first place, unless I mention them somewhere. There are also things I've told one or two people because they asked about them via PM, but hadn't gotten around more broadly than that. This forum is already a great source of information for modding, but I think an official reference would be useful to augment what's already here. Like I said, though, it's likely to grow very gradually.
Logged

TheHappyFace

  • Admiral
  • *****
  • Posts: 1168
  • The critic
    • View Profile
Re: Readme & Feedback
« Reply #3 on: November 19, 2012, 10:14:55 PM »

+1 for this great idea.
Would make it a lot more easy for people like me.  ;D
Logged
Fractalsoftworks limited edition ban hammer.

Hyph_K31

  • Admiral
  • *****
  • Posts: 1605
  • O' Hear My Name and Tremble! Ug Ug.
    • View Profile
Re: Readme & Feedback
« Reply #4 on: November 20, 2012, 09:01:46 AM »

+? from me.

I literally can't wait for more information :)
Logged

"GEDUNE, stop venting in front of your classmates!"

Piroton

  • Ensign
  • *
  • Posts: 19
    • View Profile
Re: Readme & Feedback
« Reply #5 on: November 21, 2012, 06:56:39 PM »

Awesome!

I was afraid to mod Starfarer because I'm hopeless at java and scripting, so any documentation would be greatly appreciated!

+1
Logged

Cycerin

  • Admiral
  • *****
  • Posts: 1665
  • beyond the infinite void
    • View Profile
Re: Readme & Feedback
« Reply #6 on: November 25, 2012, 07:23:04 PM »

This is great and you're great.
Logged

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Re: Readme & Feedback
« Reply #7 on: December 07, 2012, 10:04:50 PM »

Because I'm, um, so great (thanks, by the way :)), added a new section - this one with details on the mod structure, and specifically on how the game decides what files to merge, and how. I think there may be some surprises there. Hopefully good ones. Please let me know if you think I missed something.
« Last Edit: December 07, 2012, 10:06:53 PM by Alex »
Logged

LazyWizard

  • Global Moderator
  • Admiral
  • *****
  • Posts: 1363
    • View Profile
    • GitHub Profile
Re: Readme & Feedback
« Reply #8 on: December 08, 2012, 06:13:23 PM »

For the Mod Structure & File Merging thread, what about the behavior of class files in a jar and identically-named java files outside of it?
Logged

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Re: Readme & Feedback
« Reply #9 on: December 08, 2012, 08:10:04 PM »

Good call - added to the mod_info.json thread, though, in the jar file section. (The answer is it'll prefer stuff from a jar, btw.)
Logged

xenoargh

  • Admiral
  • *****
  • Posts: 5078
  • naively breaking things!
    • View Profile
Re: Readme & Feedback
« Reply #10 on: March 19, 2016, 10:37:17 AM »

I would really like to understand how CSV merging prioritizes what gets to modify.  If two mods attempt to change X line, which one gets priority, and why?  It doesn't appear to be load-order and using Replace means I'll be breaking things (or get overridden by further mods), so what's the mechanism?

On a related note, it'd be nice if mod load order was able to be explicitly dealt with; right now, it feels like it's a hodge-podge of rulesets covering things that modify core files, things that add new code, etc., and it'd be nice to have some control, so that mods that mod mods can be a thing.
Logged
Please check out my SS projects :)
Xeno's Mod Pack

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Re: Readme & Feedback
« Reply #11 on: March 19, 2016, 10:51:58 AM »

Pretty sure it *is* load order, with the first mod to do it taking priority. Don't remember what the reason was for doing that instead of letting the last mod do it; probably wasn't an accident though. In any case, I'd consider mods trying to change the same thing to be incompatible. (This probably belongs as a question in the modding subforum, though, perhaps even in the misc questions thread.)
Logged

xenoargh

  • Admiral
  • *****
  • Posts: 5078
  • naively breaking things!
    • View Profile
Re: Readme & Feedback
« Reply #12 on: March 19, 2016, 11:06:11 AM »

<tests> OK, so the first mod to change a key in CSVs wins the fight, based on the mod's name, which determines the load order.  Does this also apply to modifications of other core files (i.e., hull and proj, etc.?)
Logged
Please check out my SS projects :)
Xeno's Mod Pack

Alex

  • Administrator
  • Admiral
  • *****
  • Posts: 23986
    • View Profile
Re: Readme & Feedback
« Reply #13 on: March 20, 2016, 01:00:32 PM »

*Fairly* sure it's the opposite for .json files, with the last one winning. Might clean that up at some point (if anything, it seems like the last one should always win? But not sure why the csv loader is specifically coded against that; don't think I'd do that for no reason).
Logged

xenoargh

  • Admiral
  • *****
  • Posts: 5078
  • naively breaking things!
    • View Profile
Re: Readme & Feedback
« Reply #14 on: March 23, 2016, 02:04:56 PM »

It'd be nice if it was consistent, too, so that if you want to do both, you don't have to release two mods ;)
Logged
Please check out my SS projects :)
Xeno's Mod Pack
Pages: [1] 2