This serves as the central class which loads mods. It contains many static fields and methods related to mods and their contents. More...

Collaboration diagram for Terraria.ModLoader.ModLoader:

Static Public Member Functions
static bool	FileExists (string name)

static byte[]	GetFileBytes (string name)

static string[]	GetLoadedMods ()

static Mod	GetMod (int index)

static Mod	GetMod (string name)
	Gets the instance of the Mod with the specified name. More...

static Music	GetMusic (string name)

static SoundEffect	GetSound (string name)

static Texture2D	GetTexture (string name)

static bool	IsSignedBy (TmodFile mod, string xmlPublicKey)

static bool	MusicExists (string name)

static bool	SoundExists (string name)

static bool	TextureExists (string name)

Static Public Attributes
static readonly int	beta = 0

static readonly string	branchName = ""

static readonly string	compressedPlatformRepresentation = Platform.IsWindows ? "w" : (Platform.IsLinux ? "l" : "m")

static Version	LastLaunchedTModLoaderVersion

static readonly bool	linux = Platform.IsLinux

static readonly bool	mac = Platform.IsOSX

static bool	ShowFirstLaunchWelcomeMessage

static readonly Version	version = new Version(0, 11, 8, 9)

static readonly string	versionedName

static readonly string	versionTag

static readonly bool	windows = Platform.IsWindows

Properties
static string	CompressedPlatformRepresentation `[get]`

static Mod[]	LoadedMods `[get]`

static int	ModCount `[get]`

static string	ModPath `[get]`

static Mod[]	Mods = new Mod[0] `[get, private set]`

Static Private Member Functions
static void	DisplayLoadError (string msg, Exception e, bool fatal, bool continueIsRetry=false)

static void	do_Unload ()

static void	DotNet45Check ()

static void	Load (CancellationToken token=default)

static bool	Unload ()

static void	WarnModsStillLoaded ()

Static Private Attributes
static HashSet< string >	_enabledMods
	A cached list of enabled mods (not necessarily currently loaded or even installed), mirroring the enabled.json file. More...

static bool	_needsSavingEnabledMods

static bool	_pauseSavingEnabledMods

static bool	isLoading = false

static readonly IDictionary< string, Mod >	modsByName = new Dictionary<string, Mod>(StringComparer.OrdinalIgnoreCase)

static string	steamID64 = ""

static WeakReference[]	weakModReferences = new WeakReference[0]

Detailed Description

This serves as the central class which loads mods. It contains many static fields and methods related to mods and their contents.

Definition at line 28 of file ModLoader.cs.

Member Function Documentation

◆ DisplayLoadError()

static void Terraria.ModLoader.ModLoader.DisplayLoadError	(	string	msg,
		Exception	e,
		bool	fatal,
		bool	continueIsRetry = `false`
	)

staticprivate

Definition at line 272 of file ModLoader.cs.

        {
            msg += "\n\n" + (e.Data.Contains("hideStackTrace") ? e.Message : e.ToString());
 
            if (Main.dedServ) {
                Console.ForegroundColor = ConsoleColor.Red;
                Console.WriteLine(msg);
                Console.ResetColor();
 
                if (fatal) {
                    Console.WriteLine("Press any key to exit...");
                    Console.ReadKey();
                    Environment.Exit(-1);
                }
                else {
                    Reload();
                }
            }
            else {
                Interface.errorMessage.Show(msg,
                    gotoMenu: fatal ? -1 : Interface.reloadModsID,
                    webHelpURL: e.HelpLink,
                    continueIsRetry: continueIsRetry,
                    showSkip: !fatal);
            }
        }

References Terraria.ModLoader.Console, and Terraria.ModLoader.Environment.

Referenced by Terraria.ModLoader.ModLoader.Load(), and Terraria.ModLoader.ModLoader.Unload().

Here is the caller graph for this function:

◆ do_Unload()

static void Terraria.ModLoader.ModLoader.do_Unload ( )

staticprivate

Definition at line 244 of file ModLoader.cs.

        {
            Logging.tML.Info("Unloading mods");
            if (Main.dedServ) {
                Console.WriteLine("Unloading mods...");
            }
            else {
                Interface.loadMods.SetLoadStage("tModLoader.MSUnloading", Mods.Length);
            }
 
            ModContent.UnloadModContent();
            Mods = new Mod[0];
            modsByName.Clear();
            ModContent.Unload();
 
            MemoryTracking.Clear();
            Thread.MemoryBarrier();
            GC.Collect();
        }

References Terraria.ModLoader.Console, Terraria.ModLoader.ModLoader.Mods, and Terraria.ModLoader.ModLoader.modsByName.

Referenced by Terraria.ModLoader.ModLoader.Unload().

Here is the caller graph for this function:

◆ DotNet45Check()

static void Terraria.ModLoader.ModLoader.DotNet45Check ( )

staticprivate

Definition at line 196 of file ModLoader.cs.

        {
            if (FrameworkVersion.Framework != Framework.NetFramework || FrameworkVersion.Version >= new Version(4, 5))
                return;
 
            var msg = Language.GetTextValue("tModLoader.LoadErrorDotNet45Required");
#if CLIENT
            Interface.MessageBoxShow(msg);
            Process.Start("https://dotnet.microsoft.com/download/dotnet-framework");
#else
            Console.ForegroundColor = ConsoleColor.Red;
            Console.WriteLine(msg);
            Console.ResetColor();
            Console.WriteLine("Press any key to exit...");
            Console.ReadKey();
#endif
            Environment.Exit(-1);
        }

References Terraria.ModLoader.Console, Terraria.ModLoader.Environment, Terraria.ModLoader.FrameworkVersion.Framework, and Terraria.ModLoader.FrameworkVersion.Version.

Referenced by Terraria.ModLoader.ModLoader.GetLoadedMods().

Here is the caller graph for this function:

◆ FileExists()

static bool Terraria.ModLoader.ModLoader.FileExists ( string name )

static

◆ GetFileBytes()

static byte[] Terraria.ModLoader.ModLoader.GetFileBytes ( string name )

static

◆ GetLoadedMods()

static string[] Terraria.ModLoader.ModLoader.GetLoadedMods ( )

static

References Terraria.ModLoader.ModLoader.DotNet45Check().

Here is the call graph for this function:

◆ GetMod() [1/2]

static Mod Terraria.ModLoader.ModLoader.GetMod ( int index )

static

◆ GetMod() [2/2]

static Mod Terraria.ModLoader.ModLoader.GetMod ( string name )

static

Gets the instance of the Mod with the specified name.

Definition at line 90 of file ModLoader.cs.

        {
            modsByName.TryGetValue(name, out Mod m);
            return m;
        }

References Terraria.ModLoader.ModLoader.modsByName.

Here is the caller graph for this function:

◆ GetMusic()

static Music Terraria.ModLoader.ModLoader.GetMusic ( string name )

static

◆ GetSound()

static SoundEffect Terraria.ModLoader.ModLoader.GetSound ( string name )

static

◆ GetTexture()

static Texture2D Terraria.ModLoader.ModLoader.GetTexture ( string name )

static

◆ IsSignedBy()

static bool Terraria.ModLoader.ModLoader.IsSignedBy	(	TmodFile	mod,
		string	xmlPublicKey
	)

static

Definition at line 300 of file ModLoader.cs.

        {
            var f = new RSAPKCS1SignatureDeformatter();
            var v = AsymmetricAlgorithm.Create("RSA");
            f.SetHashAlgorithm("SHA1");
            v.FromXmlString(xmlPublicKey);
            f.SetKey(v);
            return f.VerifySignature(mod.hash, mod.signature);
        }

◆ Load()

static void Terraria.ModLoader.ModLoader.Load ( CancellationToken token = default )

staticprivate

Definition at line 120 of file ModLoader.cs.

        {
            try {
                if (isLoading)
                    throw new Exception("Load called twice");
                isLoading = true;
 
                if (!Unload())
                    return;
 
                var modInstances = ModOrganizer.LoadMods(token);
 
                weakModReferences = modInstances.Select(x => new WeakReference(x)).ToArray();
                modInstances.Insert(0, new ModLoaderMod());
                Mods = modInstances.ToArray();
                foreach (var mod in Mods)
                    modsByName[mod.Name] = mod;
 
                ModContent.Load(token);
 
                if (OnSuccessfulLoad != null) {
                    OnSuccessfulLoad();
                }
                else {
                    Main.menuMode = 0;
                }
            }
            catch when (token.IsCancellationRequested) {
                // cancel needs to reload with ModLoaderMod and all others skipped
                skipLoad = true;
                OnSuccessfulLoad += () => Main.menuMode = Interface.modsMenuID;
 
                isLoading = false;
                Load(); // don't provide a token, loading just ModLoaderMod should be quick
            }
            catch (Exception e) {
                var responsibleMods = new List<string>();
                if (e.Data.Contains("mod"))
                    responsibleMods.Add((string)e.Data["mod"]);
                if (e.Data.Contains("mods"))
                    responsibleMods.AddRange((IEnumerable<string>)e.Data["mods"]);
                responsibleMods.Remove("ModLoader");
 
                if (responsibleMods.Count == 0 && AssemblyManager.FirstModInStackTrace(new StackTrace(e), out var stackMod))
                    responsibleMods.Add(stackMod);
 
                var msg = Language.GetTextValue("tModLoader.LoadError", string.Join(", ", responsibleMods));
                if (responsibleMods.Count == 1) {
                    var mod = ModOrganizer.FindMods().FirstOrDefault(m => m.Name == responsibleMods[0]); //use First rather than Single, incase of "Two mods with the same name" error message from ModOrganizer (#639)
                    if (mod != null && (mod.tModLoaderVersion.Major != version.Major || mod.tModLoaderVersion.Minor != version.Minor || mod.tModLoaderVersion.Build != version.Build))
                        msg += "\n" + Language.GetTextValue("tModLoader.LoadErrorVersionMessage", mod.tModLoaderVersion, versionedName);
                }
                if (responsibleMods.Count > 0)
                    msg += "\n" + Language.GetTextValue("tModLoader.LoadErrorDisabled");
                else
                    msg += "\n" + Language.GetTextValue("tModLoader.LoadErrorCulpritUnknown");
 
                if (e is ReflectionTypeLoadException reflectionTypeLoadException)
                    msg += "\n\n" + string.Join("\n", reflectionTypeLoadException.LoaderExceptions.Select(x => x.Message));
 
                Logging.tML.Error(msg, e);
 
                foreach (var mod in responsibleMods)
                    DisableMod(mod);
 
                isLoading = false; // disable loading flag, because server will just instantly retry reload
                DisplayLoadError(msg, e, e.Data.Contains("fatal"), responsibleMods.Count == 0);
            }
            finally {
                isLoading = false;
                OnSuccessfulLoad = null;
                skipLoad = false;
                ModNet.NetReloadActive = false;
            }
        }

References Terraria.ModLoader.ModLoader.DisplayLoadError(), Terraria.ModLoader.ModLoader.isLoading, Terraria.ModLoader.ModLoader.Load(), Terraria.ModLoader.ModLoader.Mods, Terraria.ModLoader.ModLoader.modsByName, Terraria.ModLoader.ModLoader.Unload(), Terraria.ModLoader.ModLoader.version, Terraria.ModLoader.ModLoader.versionedName, and Terraria.ModLoader.ModLoader.weakModReferences.

Referenced by Terraria.ModLoader.ModLoader.Load().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ MusicExists()

static bool Terraria.ModLoader.ModLoader.MusicExists ( string name )

static

◆ SoundExists()

static bool Terraria.ModLoader.ModLoader.SoundExists ( string name )

static

◆ TextureExists()

static bool Terraria.ModLoader.ModLoader.TextureExists ( string name )

static

◆ Unload()

static bool Terraria.ModLoader.ModLoader.Unload ( )

staticprivate

Definition at line 223 of file ModLoader.cs.

        {
            try {
                // have to move unload logic to a separate method so the stack frame is cleared. Otherwise unloading can capture mod instances in local variables, even with memory barriers (thanks compiler weirdness)
                do_Unload();
                WarnModsStillLoaded();
                return true;
            }
            catch (Exception e) {
                var msg = Language.GetTextValue("tModLoader.UnloadError");
 
                if (e.Data.Contains("mod"))
                    msg += "\n" + Language.GetTextValue("tModLoader.DefensiveUnload", e.Data["mod"]);
 
                Logging.tML.Fatal(msg, e);
                DisplayLoadError(msg, e, true);
 
                return false;
            }
        }

References Terraria.ModLoader.ModLoader.DisplayLoadError(), Terraria.ModLoader.ModLoader.do_Unload(), and Terraria.ModLoader.ModLoader.WarnModsStillLoaded().

Referenced by Terraria.ModLoader.ModLoader.Load().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ WarnModsStillLoaded()

static void Terraria.ModLoader.ModLoader.WarnModsStillLoaded ( )

staticprivate

Definition at line 265 of file ModLoader.cs.

        {
            badUnloaders = weakModReferences.Where(r => r.IsAlive).Select(r => ((Mod)r.Target).Name).ToList();
            foreach (var modName in badUnloaders)
                Logging.tML.WarnFormat("{0} not fully unloaded during unload.", modName);
        }

References Terraria.ModLoader.ModLoader.weakModReferences.

Referenced by Terraria.ModLoader.ModLoader.Unload().

Here is the caller graph for this function:

Member Data Documentation

◆ _enabledMods

HashSet<string> Terraria.ModLoader.ModLoader._enabledMods

staticprivate

A cached list of enabled mods (not necessarily currently loaded or even installed), mirroring the enabled.json file.

Definition at line 324 of file ModLoader.cs.

◆ _needsSavingEnabledMods

bool Terraria.ModLoader.ModLoader._needsSavingEnabledMods

staticprivate

Definition at line 311 of file ModLoader.cs.

◆ _pauseSavingEnabledMods

bool Terraria.ModLoader.ModLoader._pauseSavingEnabledMods

staticprivate

Definition at line 310 of file ModLoader.cs.

◆ beta

readonly int Terraria.ModLoader.ModLoader.beta = 0

static

Definition at line 38 of file ModLoader.cs.

◆ branchName

readonly string Terraria.ModLoader.ModLoader.branchName = ""

static

Definition at line 36 of file ModLoader.cs.

◆ compressedPlatformRepresentation

readonly string Terraria.ModLoader.ModLoader.compressedPlatformRepresentation = Platform.IsWindows ? "w" : (Platform.IsLinux ? "l" : "m")

static

Definition at line 57 of file ModLoader.cs.

◆ isLoading

bool Terraria.ModLoader.ModLoader.isLoading = false

staticprivate

Definition at line 119 of file ModLoader.cs.

Referenced by Terraria.ModLoader.ModLoader.Load().

◆ LastLaunchedTModLoaderVersion

Version Terraria.ModLoader.ModLoader.LastLaunchedTModLoaderVersion

static

Definition at line 32 of file ModLoader.cs.

◆ linux

readonly bool Terraria.ModLoader.ModLoader.linux = Platform.IsLinux

static

Definition at line 52 of file ModLoader.cs.

◆ mac

readonly bool Terraria.ModLoader.ModLoader.mac = Platform.IsOSX

static

Definition at line 54 of file ModLoader.cs.

◆ modsByName

readonly IDictionary<string, Mod> Terraria.ModLoader.ModLoader.modsByName = new Dictionary<string, Mod>(StringComparer.OrdinalIgnoreCase)

staticprivate

Definition at line 63 of file ModLoader.cs.

Referenced by Terraria.ModLoader.ModLoader.do_Unload(), Terraria.ModLoader.ModLoader.GetMod(), and Terraria.ModLoader.ModLoader.Load().

◆ ShowFirstLaunchWelcomeMessage

bool Terraria.ModLoader.ModLoader.ShowFirstLaunchWelcomeMessage

static

Definition at line 34 of file ModLoader.cs.

◆ steamID64

string Terraria.ModLoader.ModLoader.steamID64 = ""

staticprivate

Definition at line 69 of file ModLoader.cs.

◆ version

readonly Version Terraria.ModLoader.ModLoader.version = new Version(0, 11, 8, 9)

static

Definition at line 30 of file ModLoader.cs.

Referenced by Terraria.ModLoader.ModLoader.Load().

◆ versionedName

readonly string Terraria.ModLoader.ModLoader.versionedName

static

Initial value:

= $"tModLoader v{version}" +
                                                      (branchName.Length == 0 ? "" : $" {branchName}") +
                                                      (beta == 0 ? "" : $" Beta {beta}")

Definition at line 41 of file ModLoader.cs.

Referenced by Terraria.ModLoader.ModLoader.Load().

◆ versionTag

readonly string Terraria.ModLoader.ModLoader.versionTag

static

Initial value:

= $"v{version}" +
                                                    (branchName.Length == 0 ? "" : $"-{branchName.ToLower()}") +
                                                    (beta == 0 ? "" : $"-beta{beta}")

Definition at line 45 of file ModLoader.cs.

◆ weakModReferences

WeakReference [] Terraria.ModLoader.ModLoader.weakModReferences = new WeakReference[0]

staticprivate

Definition at line 64 of file ModLoader.cs.

Referenced by Terraria.ModLoader.ModLoader.Load(), and Terraria.ModLoader.ModLoader.WarnModsStillLoaded().

◆ windows

readonly bool Terraria.ModLoader.ModLoader.windows = Platform.IsWindows

static

Definition at line 50 of file ModLoader.cs.

Property Documentation

◆ CompressedPlatformRepresentation

string Terraria.ModLoader.ModLoader.CompressedPlatformRepresentation

staticget

Definition at line 59 of file ModLoader.cs.

◆ LoadedMods

Mod [] Terraria.ModLoader.ModLoader.LoadedMods

staticget

Definition at line 99 of file ModLoader.cs.

◆ ModCount

int Terraria.ModLoader.ModLoader.ModCount

staticget

Definition at line 102 of file ModLoader.cs.

◆ ModPath

string Terraria.ModLoader.ModLoader.ModPath

staticget

Definition at line 61 of file ModLoader.cs.

◆ Mods

Mod [] Terraria.ModLoader.ModLoader.Mods = new Mod[0]

staticgetprivate set

Definition at line 85 of file ModLoader.cs.

85{ get; private set; } = new Mod[0];

Referenced by Terraria.ModLoader.ModLoader.do_Unload(), Terraria.ModLoader.IO.TagSerializer< T, S >.GetType(), Terraria.ModLoader.ModLoader.Load(), Terraria.ModLoader.ModContent.LoadModContent(), Terraria.ModLoader.ModNet.OnModsDownloaded(), Terraria.ModLoader.ModNet.ReadNetIDs(), and Terraria.ModLoader.ModContent.RefreshModLanguage().

Static Public Member Functions

Static Public Attributes

Properties

Static Private Member Functions

Static Private Attributes

Detailed Description

Member Function Documentation

◆ DisplayLoadError()

◆ do_Unload()

◆ DotNet45Check()

◆ FileExists()

◆ GetFileBytes()

◆ GetLoadedMods()

◆ GetMod() [1/2]

◆ GetMod() [2/2]

◆ GetMusic()

◆ GetSound()

◆ GetTexture()

◆ IsSignedBy()

◆ Load()

◆ MusicExists()

◆ SoundExists()

◆ TextureExists()

◆ Unload()

◆ WarnModsStillLoaded()

Member Data Documentation

◆ _enabledMods

◆ _needsSavingEnabledMods

◆ _pauseSavingEnabledMods

◆ beta

◆ branchName

◆ compressedPlatformRepresentation

◆ isLoading

◆ LastLaunchedTModLoaderVersion

◆ linux

◆ mac

◆ modsByName

◆ ShowFirstLaunchWelcomeMessage

◆ steamID64

◆ version

◆ versionedName

◆ versionTag

◆ weakModReferences

◆ windows

Property Documentation

◆ CompressedPlatformRepresentation

◆ LoadedMods

◆ ModCount

◆ ModPath

◆ Mods