summaryrefslogtreecommitdiff
path: root/StardewModdingAPI/Mod.cs
blob: 8d08f8de21ce55aa7df662f4e30e71294dd49eca (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
using System;
using System.IO;

namespace StardewModdingAPI
{
    public class Mod
    {
        /// <summary>
        /// The mod's manifest
        /// </summary>
        public Manifest Manifest { get; internal set; }

        /// <summary>
        /// Where the mod is located on the disk.
        /// </summary>
        public string PathOnDisk { get; internal set; }

        /// <summary>
        /// A basic path to store your mod's config at.
        /// </summary>
        public string BaseConfigPath => PathOnDisk + "\\config.json";

        /// <summary>
        /// A basic path to where per-save configs are stored
        /// </summary>
        public string PerSaveConfigFolder => GetPerSaveConfigFolder();

        /// <summary>
        /// A basic path to store your mod's config at, dependent on the current save.
        /// The Manifest must allow for per-save configs. This is to keep from having an
        /// empty directory in every mod folder.
        /// </summary>
        public string PerSaveConfigPath => Constants.CurrentSavePathExists ? Path.Combine(PerSaveConfigFolder, Constants.SaveFolderName + ".json") : "";

        /// <summary>
        /// A basic method that is the entry-point of your mod. It will always be called once when the mod loads.
        /// </summary>
        public virtual void Entry(params object[] objects)
        {

        }

        private string GetPerSaveConfigFolder()
        {
            if (Manifest.PerSaveConfigs)
            {
                return Path.Combine(PathOnDisk, "psconfigs");
            }
            Log.Error("The mod [{0}] is not configured to use per-save configs.", Manifest.Name);
            return "";
        }
    }
}