isaacscript-common 25.2.0 → 25.3.0

package/dist/index.rollup.d.ts

@@ -12737,6 +12737,22 @@ declare class PreventGridEntityRespawn extends Feature {
 /** Helper function to print whether something was enabled or disabled to the in-game console. */
 export declare function printEnabled(enabled: boolean, description: string): void;
 
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `Mod.AddPriorityCallback`.
+ *
+ * @ignore
+ */
+export declare function PriorityCallback<T extends ModCallback>(modCallback: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `ModUpgraded.AddCallbackCustom`.
+ *
+ * @ignore
+ */
+export declare function PriorityCallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+
 /** Helper type to extract only the public interface of a class. */
 export declare type PublicInterface<T> = Pick<T, keyof T>;
 

package/dist/isaacscript-common.lua

@@ -1,6 +1,6 @@
 --[[
 
-isaacscript-common 25.2.0
+isaacscript-common 25.3.0
 
 This is the "isaacscript-common" library, which was created with the IsaacScript tool.
 
@@ -50554,11 +50554,15 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
         if not isNumber(nil, modCallback) then
             error("Failed to get the callback number from the callback tuple for class: " .. tstlClassName)
         end
-        local callback = callbackTuple[2]
+        local priority = callbackTuple[2]
+        if not isNumber(nil, priority) then
+            error("Failed to get the callback priority from the callback tuple for class: " .. tstlClassName)
+        end
+        local callback = callbackTuple[3]
         if not isFunction(nil, callback) then
             error("Failed to get the callback function from the callback tuple for class: " .. tstlClassName)
         end
-        local parameters = callbackTuple[3]
+        local parameters = callbackTuple[4]
         if not isArray(nil, parameters, false) then
             error("Failed to get the callback parameters from the callback tuple for class: " .. tstlClassName)
         end
@@ -50570,6 +50574,7 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
                 modFeatureConstructor,
                 mod,
                 modCallback,
+                priority,
                 callback,
                 parameters,
                 vanilla
@@ -50585,7 +50590,7 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
         end
     end
 end
-function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, callback, parameters, vanilla)
+function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, priority, callback, parameters, vanilla)
     local function wrappedCallback(____, ...)
         local conditionalFunc = modFeature.shouldCallbackMethodsFire
         if conditionalFunc ~= nil then
@@ -50615,14 +50620,16 @@ function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback,
         wrappedMethodsMap:set(modCallbackCustom, wrappedCallback)
     end
     if vanilla then
-        mod:AddCallback(
+        mod:AddPriorityCallback(
             modCallback,
+            priority,
             wrappedCallback,
             table.unpack(parameters)
         )
     else
-        mod:AddCallbackCustom(
+        mod:AddPriorityCallbackCustom(
             modCallback,
+            priority,
             wrappedCallback,
             table.unpack(parameters)
         )
@@ -51093,17 +51100,19 @@ return ____exports
  end,
 ["src.functions.decorators"] = function(...) 
 local ____exports = {}
+local ____CallbackPriority = require("lua_modules.isaac-typescript-definitions.dist.src.enums.CallbackPriority")
+local CallbackPriority = ____CallbackPriority.CallbackPriority
 local ____ModFeature = require("src.classes.ModFeature")
 local MOD_FEATURE_CALLBACKS_KEY = ____ModFeature.MOD_FEATURE_CALLBACKS_KEY
 local MOD_FEATURE_CUSTOM_CALLBACKS_KEY = ____ModFeature.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
 local ____tstlClass = require("src.functions.tstlClass")
 local getTSTLClassName = ____tstlClass.getTSTLClassName
-function ____exports.Callback(self, modCallback, ...)
+function ____exports.PriorityCallback(self, modCallback, priority, ...)
     local optionalArgs = {...}
     return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        local callbackTuple = {modCallback, method, optionalArgs}
+        local callbackTuple = {modCallback, priority, method, optionalArgs}
         local constructor = target.constructor
         if constructor == nil then
             local tstlClassName = getTSTLClassName(nil, target) or "Unknown"
@@ -51116,12 +51125,12 @@ function ____exports.Callback(self, modCallback, ...)
         callbackTuples[#callbackTuples + 1] = callbackTuple
     end
 end
-function ____exports.CallbackCustom(self, modCallbackCustom, ...)
+function ____exports.PriorityCallbackCustom(self, modCallbackCustom, priority, ...)
     local optionalArgs = {...}
     return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        local callbackTuple = {modCallbackCustom, method, optionalArgs}
+        local callbackTuple = {modCallbackCustom, priority, method, optionalArgs}
         local constructor = target.constructor
         if constructor == nil then
             local tstlClassName = getTSTLClassName(nil, target) or "Unknown"
@@ -51134,6 +51143,12 @@ function ____exports.CallbackCustom(self, modCallbackCustom, ...)
         callbackTuples[#callbackTuples + 1] = callbackTuple
     end
 end
+function ____exports.Callback(self, modCallback, ...)
+    return ____exports.PriorityCallback(nil, modCallback, CallbackPriority.DEFAULT, ...)
+end
+function ____exports.CallbackCustom(self, modCallbackCustom, ...)
+    return ____exports.PriorityCallbackCustom(nil, modCallbackCustom, CallbackPriority.DEFAULT, ...)
+end
 return ____exports
  end,
 ["src.functions.globals"] = function(...) 

package/dist/src/classes/ModFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAc;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;OAKG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,WAAW,EAAE,IAAI,UAAO;IAQzC;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;OAKG;IACI,MAAM,IAAI,IAAI;CAGtB"}
+{"version":3,"file":"ModFeature.d.ts","sourceRoot":"","sources":["../../../src/classes/ModFeature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAS/D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,eAAO,MAAM,yBAAyB,gBAAgB,CAAC;AACvD,eAAO,MAAM,gCAAgC,sBAAsB,CAAC;AAyBpE;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,qBAAa,UAAU;IACrB,OAAO,CAAC,GAAG,CAAc;IAEzB;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,SAAS,CAAC,yBAAyB,EAC/B,CAAC,CAAC,CAAC,SAAS,OAAO,EACjB,OAAO,EAAE,CAAC,EACV,WAAW,EAAE,CAAC,SAAS,IAAI,GAAG,WAAW,GAAG,iBAAiB,EAC7D,GAAG,YAAY,EAAE,OAAO,EAAE,KACvB,OAAO,CAAC,GACb,IAAI,CAAQ;IAEhB;;;;;OAKG;IACI,WAAW,UAAS;gBAEf,GAAG,EAAE,WAAW,EAAE,IAAI,UAAO;IAQzC;;;;;OAKG;IACI,IAAI,CAAC,IAAI,UAAO,GAAG,IAAI;IAqB9B;;;;;OAKG;IACI,MAAM,IAAI,IAAI;CAGtB"}

package/dist/src/classes/ModFeature.lua

@@ -31,11 +31,15 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
         if not isNumber(nil, modCallback) then
             error("Failed to get the callback number from the callback tuple for class: " .. tstlClassName)
         end
-        local callback = callbackTuple[2]
+        local priority = callbackTuple[2]
+        if not isNumber(nil, priority) then
+            error("Failed to get the callback priority from the callback tuple for class: " .. tstlClassName)
+        end
+        local callback = callbackTuple[3]
         if not isFunction(nil, callback) then
             error("Failed to get the callback function from the callback tuple for class: " .. tstlClassName)
         end
-        local parameters = callbackTuple[3]
+        local parameters = callbackTuple[4]
         if not isArray(nil, parameters, false) then
             error("Failed to get the callback parameters from the callback tuple for class: " .. tstlClassName)
         end
@@ -47,6 +51,7 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
                 modFeatureConstructor,
                 mod,
                 modCallback,
+                priority,
                 callback,
                 parameters,
                 vanilla
@@ -62,7 +67,7 @@ function initDecoratedCallbacks(self, modFeature, constructor, tstlClassName, va
         end
     end
 end
-function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, callback, parameters, vanilla)
+function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback, priority, callback, parameters, vanilla)
     local function wrappedCallback(____, ...)
         local conditionalFunc = modFeature.shouldCallbackMethodsFire
         if conditionalFunc ~= nil then
@@ -92,14 +97,16 @@ function addCallback(self, modFeature, modFeatureConstructor, mod, modCallback,
         wrappedMethodsMap:set(modCallbackCustom, wrappedCallback)
     end
     if vanilla then
-        mod:AddCallback(
+        mod:AddPriorityCallback(
             modCallback,
+            priority,
             wrappedCallback,
             table.unpack(parameters)
         )
     else
-        mod:AddCallbackCustom(
+        mod:AddPriorityCallbackCustom(
             modCallback,
+            priority,
             wrappedCallback,
             table.unpack(parameters)
         )

package/dist/src/functions/decorators.d.ts

@@ -20,6 +20,7 @@
  * @module
  */
 import { ModCallback } from "isaac-typescript-definitions";
+import { CallbackPriority } from "isaac-typescript-definitions/dist/src/enums/CallbackPriority";
 import { ModFeature } from "../classes/ModFeature";
 import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { AddCallbackParametersCustom } from "../interfaces/private/AddCallbackParametersCustom";
@@ -38,4 +39,18 @@ export declare function Callback<T extends ModCallback>(modCallback: T, ...optio
  * @ignore
  */
 export declare function CallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `Mod.AddPriorityCallback`.
+ *
+ * @ignore
+ */
+export declare function PriorityCallback<T extends ModCallback>(modCallback: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParameters[T]>): <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `ModUpgraded.AddCallbackCustom`.
+ *
+ * @ignore
+ */
+export declare function PriorityCallbackCustom<T extends ModCallbackCustom>(modCallbackCustom: T, priority: CallbackPriority | int, ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>): <Class extends ModFeature, Fn extends AddCallbackParametersCustom[T][0]>(target: Class, propertyKey: string, _descriptor: TypedPropertyDescriptor<Fn>) => void;
 //# sourceMappingURL=decorators.d.ts.map

package/dist/src/functions/decorators.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/functions/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EACL,UAAU,EAGX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;GAKG;AAEH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,WAAW,EAAE,CAAC,EACd,GAAG,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,kGAIvC,MAAM,+CAElB,IAAI,CA6BR;AAED;;;;;GAKG;AAEH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,iBAAiB,EAAE,CAAC,EACpB,GAAG,YAAY,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,wGAO7C,MAAM,+CAElB,IAAI,CA6BR"}
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../../src/functions/decorators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8DAA8D,CAAC;AAChG,OAAO,EACL,UAAU,EAGX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mDAAmD,CAAC;AAChG,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGnD;;;;;GAKG;AAGH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,WAAW,EAC5C,WAAW,EAAE,CAAC,EACd,GAAG,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,4JAOvD;AAED;;;;;GAKG;AAGH,wBAAgB,cAAc,CAAC,CAAC,SAAS,iBAAiB,EACxD,iBAAiB,EAAE,CAAC,EACpB,GAAG,YAAY,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,kKAO7D;AAED;;;;;GAKG;AAEH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,EACpD,WAAW,EAAE,CAAC,EACd,QAAQ,EAAE,gBAAgB,GAAG,GAAG,EAChC,GAAG,YAAY,EAAE,WAAW,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,kGAIvC,MAAM,+CAElB,IAAI,CA6BR;AAED;;;;;GAKG;AAEH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,iBAAiB,EAChE,iBAAiB,EAAE,CAAC,EACpB,QAAQ,EAAE,gBAAgB,GAAG,GAAG,EAChC,GAAG,YAAY,EAAE,WAAW,CAAC,2BAA2B,CAAC,CAAC,CAAC,CAAC,wGAO7C,MAAM,+CAElB,IAAI,CA6BR"}

package/dist/src/functions/decorators.lua

@@ -1,19 +1,21 @@
 local ____exports = {}
+local ____CallbackPriority = require("isaac-typescript-definitions/dist/src/enums/CallbackPriority")
+local CallbackPriority = ____CallbackPriority.CallbackPriority
 local ____ModFeature = require("src.classes.ModFeature")
 local MOD_FEATURE_CALLBACKS_KEY = ____ModFeature.MOD_FEATURE_CALLBACKS_KEY
 local MOD_FEATURE_CUSTOM_CALLBACKS_KEY = ____ModFeature.MOD_FEATURE_CUSTOM_CALLBACKS_KEY
 local ____tstlClass = require("src.functions.tstlClass")
 local getTSTLClassName = ____tstlClass.getTSTLClassName
 --- A decorator function that signifies that the decorated class method should be automatically
--- registered with `Mod.AddCallback`.
+-- registered with `Mod.AddPriorityCallback`.
 -- 
 -- @ignore
-function ____exports.Callback(self, modCallback, ...)
+function ____exports.PriorityCallback(self, modCallback, priority, ...)
     local optionalArgs = {...}
     return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        local callbackTuple = {modCallback, method, optionalArgs}
+        local callbackTuple = {modCallback, priority, method, optionalArgs}
         local constructor = target.constructor
         if constructor == nil then
             local tstlClassName = getTSTLClassName(nil, target) or "Unknown"
@@ -30,12 +32,12 @@ end
 -- registered with `ModUpgraded.AddCallbackCustom`.
 -- 
 -- @ignore
-function ____exports.CallbackCustom(self, modCallbackCustom, ...)
+function ____exports.PriorityCallbackCustom(self, modCallbackCustom, priority, ...)
     local optionalArgs = {...}
     return function(____, target, propertyKey, _descriptor)
         local methodName = propertyKey
         local method = target[methodName]
-        local callbackTuple = {modCallbackCustom, method, optionalArgs}
+        local callbackTuple = {modCallbackCustom, priority, method, optionalArgs}
         local constructor = target.constructor
         if constructor == nil then
             local tstlClassName = getTSTLClassName(nil, target) or "Unknown"
@@ -48,4 +50,18 @@ function ____exports.CallbackCustom(self, modCallbackCustom, ...)
         callbackTuples[#callbackTuples + 1] = callbackTuple
     end
 end
+--- A decorator function that signifies that the decorated class method should be automatically
+-- registered with `Mod.AddCallback`.
+-- 
+-- @ignore
+function ____exports.Callback(self, modCallback, ...)
+    return ____exports.PriorityCallback(nil, modCallback, CallbackPriority.DEFAULT, ...)
+end
+--- A decorator function that signifies that the decorated class method should be automatically
+-- registered with `ModUpgraded.AddCallbackCustom`.
+-- 
+-- @ignore
+function ____exports.CallbackCustom(self, modCallbackCustom, ...)
+    return ____exports.PriorityCallbackCustom(nil, modCallbackCustom, CallbackPriority.DEFAULT, ...)
+end
 return ____exports

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "isaacscript-common",
-  "version": "25.2.0",
+  "version": "25.3.0",
   "description": "Helper functions and features for IsaacScript mods.",
   "keywords": [
     "isaac",

package/src/classes/ModFeature.ts

@@ -1,4 +1,5 @@
 import { ModCallback } from "isaac-typescript-definitions";
+import { CallbackPriority } from "isaac-typescript-definitions/dist/src/enums/CallbackPriority";
 import { ModCallbackCustom } from "../enums/ModCallbackCustom";
 import { isArray } from "../functions/array";
 import {
@@ -191,14 +192,21 @@ function initDecoratedCallbacks(
       );
     }
 
-    const callback = callbackTuple[1];
+    const priority = callbackTuple[1];
+    if (!isNumber(priority)) {
+      error(
+        `Failed to get the callback priority from the callback tuple for class: ${tstlClassName}`,
+      );
+    }
+
+    const callback = callbackTuple[2];
     if (!isFunction(callback)) {
       error(
         `Failed to get the callback function from the callback tuple for class: ${tstlClassName}`,
       );
     }
 
-    const parameters = callbackTuple[2];
+    const parameters = callbackTuple[3];
     // We must pass false as the second argument to `isArray` since the callback parameters may not
     // necessarily be contiguous. (They might be separated by `undefined` values.)
     if (!isArray(parameters, false)) {
@@ -216,6 +224,7 @@ function initDecoratedCallbacks(
         modFeatureConstructor,
         mod,
         modCallback, // eslint-disable-line isaacscript/strict-enums
+        priority,
         callback,
         parameters,
         vanilla,
@@ -236,6 +245,7 @@ function addCallback(
   modFeatureConstructor: ModFeatureConstructor,
   mod: ModUpgraded,
   modCallback: ModCallback | ModCallbackCustom,
+  priority: CallbackPriority | int,
   callback: Function, // eslint-disable-line @typescript-eslint/ban-types
   parameters: unknown[],
   vanilla: boolean,
@@ -281,14 +291,16 @@ function addCallback(
   }
 
   if (vanilla) {
-    (mod.AddCallback as AnyFunction)(
+    (mod.AddPriorityCallback as AnyFunction)(
       modCallback,
+      priority,
       wrappedCallback,
       ...parameters,
     );
   } else {
-    (mod.AddCallbackCustom as AnyFunction)(
+    (mod.AddPriorityCallbackCustom as AnyFunction)(
       modCallback,
+      priority,
       wrappedCallback,
       ...parameters,
     );

package/src/functions/decorators.ts

@@ -21,6 +21,7 @@
  */
 
 import { ModCallback } from "isaac-typescript-definitions";
+import { CallbackPriority } from "isaac-typescript-definitions/dist/src/enums/CallbackPriority";
 import {
   ModFeature,
   MOD_FEATURE_CALLBACKS_KEY,
@@ -38,19 +39,58 @@ import { getTSTLClassName } from "./tstlClass";
  * @ignore
  */
 // We tell TypeDoc to ignore this function because it generates a bunch of spam.
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
 export function Callback<T extends ModCallback>(
   modCallback: T,
   ...optionalArgs: AllButFirst<AddCallbackParameters[T]>
+) {
+  return PriorityCallback(
+    modCallback,
+    CallbackPriority.DEFAULT,
+    ...optionalArgs,
+  );
+}
+
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `ModUpgraded.AddCallbackCustom`.
+ *
+ * @ignore
+ */
+// We tell TypeDoc to ignore this function because it generates a bunch of spam.
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+export function CallbackCustom<T extends ModCallbackCustom>(
+  modCallbackCustom: T,
+  ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>
+) {
+  return PriorityCallbackCustom(
+    modCallbackCustom,
+    CallbackPriority.DEFAULT,
+    ...optionalArgs,
+  );
+}
+
+/**
+ * A decorator function that signifies that the decorated class method should be automatically
+ * registered with `Mod.AddPriorityCallback`.
+ *
+ * @ignore
+ */
+// We tell TypeDoc to ignore this function because it generates a bunch of spam.
+export function PriorityCallback<T extends ModCallback>(
+  modCallback: T,
+  priority: CallbackPriority | int,
+  ...optionalArgs: AllButFirst<AddCallbackParameters[T]>
 ) {
   return <Class extends ModFeature, Fn extends AddCallbackParameters[T][0]>(
     target: Class,
     propertyKey: string,
     _descriptor: TypedPropertyDescriptor<Fn>,
   ): void => {
-    // First, prepare the arguments for the `Mod.AddCallback` method.
+    // First, prepare the arguments for the `Mod.AddPriorityCallback` method.
     const methodName = propertyKey as keyof Class;
     const method = target[methodName] as AddCallbackParameters[T][0];
-    const callbackTuple = [modCallback, method, optionalArgs];
+    const callbackTuple = [modCallback, priority, method, optionalArgs];
 
     // Since the decorator runs prior to instantiation, we only have access to get and set static
     // properties, which are located on the "constructor" table. Thus, we store the callback
@@ -84,8 +124,9 @@ export function Callback<T extends ModCallback>(
  * @ignore
  */
 // We tell TypeDoc to ignore this function because it generates a bunch of spam.
-export function CallbackCustom<T extends ModCallbackCustom>(
+export function PriorityCallbackCustom<T extends ModCallbackCustom>(
   modCallbackCustom: T,
+  priority: CallbackPriority | int,
   ...optionalArgs: AllButFirst<AddCallbackParametersCustom[T]>
 ) {
   return <
@@ -99,7 +140,7 @@ export function CallbackCustom<T extends ModCallbackCustom>(
     // First, prepare the arguments for the `Mod.AddCallbackCustom` method.
     const methodName = propertyKey as keyof Class;
     const method = target[methodName] as AddCallbackParametersCustom[T][0];
-    const callbackTuple: unknown[] = [modCallbackCustom, method, optionalArgs];
+    const callbackTuple = [modCallbackCustom, priority, method, optionalArgs];
 
     // Since the decorator runs prior to instantiation, we only have access to get and set static
     // properties, which are located on the "constructor" table. Thus, we store the callback