summaryrefslogtreecommitdiff
path: root/src/SMAPI/Events/AssetLoadPriority.cs
diff options
context:
space:
mode:
Diffstat (limited to 'src/SMAPI/Events/AssetLoadPriority.cs')
-rw-r--r--src/SMAPI/Events/AssetLoadPriority.cs19
1 files changed, 19 insertions, 0 deletions
diff --git a/src/SMAPI/Events/AssetLoadPriority.cs b/src/SMAPI/Events/AssetLoadPriority.cs
new file mode 100644
index 00000000..e07b5a40
--- /dev/null
+++ b/src/SMAPI/Events/AssetLoadPriority.cs
@@ -0,0 +1,19 @@
+namespace StardewModdingAPI.Events
+{
+ /// <summary>The priority for an asset load when multiple apply for the same asset.</summary>
+ /// <remarks>If multiple non-<see cref="Exclusive"/> loads have the same priority, the one registered first will be selected. You can also specify arbitrary intermediate values, like <c>AssetLoadPriority.Low + 5</c>.</remarks>
+ public enum AssetLoadPriority
+ {
+ /// <summary>This load is optional and can safely be skipped if there are higher-priority loads.</summary>
+ Low = -1000,
+
+ /// <summary>The load is optional and can safely be skipped if there are higher-priority loads, but it should still be preferred over any <see cref="Low"/>-priority loads.</summary>
+ Medium = 0,
+
+ /// <summary>The load is optional and can safely be skipped if there are higher-priority loads, but it should still be preferred over any <see cref="Low"/>- or <see cref="Medium"/>-priority loads.</summary>
+ High = 1000,
+
+ /// <summary>The load is not optional. If more than one loader has <see cref="Exclusive"/> priority, SMAPI will log an error and ignore all of them.</summary>
+ Exclusive = int.MaxValue
+ }
+}