AtomicTorch Studio Forums

CryoFall => Modding info => Topic started by: defe on May 17, 2019, 02:26:59 PM

Title: Documentation?
Post by: defe on May 17, 2019, 02:26:59 PM
I've seen mention of documentation for the non-open parts, but haven't been able to actually find any source for it.  I've got several mods planned, and have started really tearing apart the available source, but if external method calls and their arguments aren't enough to make clear what's going on, then I find it hard to keep finding the thread of what I need to figure out to do what I want.

Are the docs just not available yet?  If so, is there any idea when we might be able to expect them?  Or am I just missing the link somewhere?

Thanks!

- DJ DefE D
Title: Re: Documentation?
Post by: ai_enabled on May 18, 2019, 02:27:08 PM
Hello!

Unfortunately, the documentation is not yet ready.
We've tried to keep API reasonably simple and add comments to most of the methods. If you're using Visual Studio you could use Object Browser to explore CryoFall scripting API. IntelliSense for autocomplete should also display the comments.

Regards!
Title: Re: Documentation?
Post by: defe on November 04, 2019, 07:14:27 PM
It has been close to six months, has there been any progress on documentation?  It's easy enough to read the documentation in the parts where I have the source, but the closed parts of the API are a bit more black box than I can sort out for the types of things I'm looking to do. 

Is it perhaps possible to just get documentation for that part of the API if it's a matter of scheduling?  I really want to get busy on some heavy duty modding, but I just do not have enough information to do anything but simple mods at this point.
Title: Re: Documentation?
Post by: ai_enabled on November 05, 2019, 02:33:07 AM
defe, no progress was made in this regard as we're focusing on adding more features and content into the game.
Have you tried "Object Browser" in Visual Studio 2019 as was suggested before? We've provided comments to the most methods in API and they should be browsable from there.

Regards!
Title: Re: Documentation?
Post by: defe on November 05, 2019, 04:33:12 AM
I have looked at the DLLs and such with the object browser, but comments on compiled code does not show there.  It gives me an idea of the shape of it all, but not the function.
Title: Re: Documentation?
Post by: ai_enabled on November 05, 2019, 04:42:48 AM
We're shipping accompanying XML files for .NET assemblies (DLLs) with VS-formatted XML documentation.
If you load the csproj in VS you can inspect the project references and open Objects Browser for any of the API assemblies. Here is a screenshot of how it looks (https://atomictorch.com/Files/Images/CryoFall_VS_ObjectBrowser.png).

Regards!
Title: Re: Documentation?
Post by: defe on November 05, 2019, 03:36:36 PM
Ah, great, I'll give that a try.

Thanks!
Title: Re: Documentation?
Post by: mav on December 29, 2019, 10:30:43 PM
I am getting the error message: "Value does not fall within expected range."

Where am I messing up? :)


Edit:
I started with a fresh slate; created a new CryoFall Mod Project and added a reference to CoreMod.

There I can use the view in object browser option.

If I open a solution file in Core.cpk or Editor.mpk directly, trying to view the documentation, it's giving me the error message.