LootModifierManager
Link to lootmodifiermanager
Manager for loot modifiers.
An instance of this manager can be obtained via the LootManager.
The main usage of this manager is for registering "global loot modifiers", also known as "loot modifiers" for short. A global loot modifier runs on the loot drop of every loot table (unless otherwise specified by conditions) and is as such able to modify it according either to predetermined parameters (e.g. replacing items) or via completely customized code that leverages the dropping context.
For more information, refer to ILootModifier.
Importing the class
Link to importing-the-class
It might be required for you to import the package if you encounter any issues (like casting an Array), so better be safe than sorry and add the import at the very top of the file.
ZenScript Copyimport crafttweaker.api.loot.modifiers.LootModifierManager;
Methods
Link to methods
Name: getAll
Gets a list containing all currently registered loot modifiers.
Returns: A list containing all currently registered loot modifiers.
Return Type: stdlib.List<ILootModifier>
ZenScript Copy// LootModifierManager.getAll() as stdlib.List<ILootModifier>
loot.modifiers.getAll();
Name: getAllNames
Gets a list of all the names of the currently registered loot modifiers.
Returns: A list with all the names of the currently registered loot modifiers.
Return Type: stdlib.List<string>
ZenScript Copy// LootModifierManager.getAllNames() as stdlib.List<string>
loot.modifiers.getAllNames();
Name: getByName
Gets the loot modifier with the given name, if it exists.
If no loot modifier with that name exists, a default no-op instance is returned.
Returns: The ILootModifier with the given name, or a default one if no such instance exists.
Return Type: ILootModifier
ZenScript CopyLootModifierManager.getByName(name as string) as ILootModifier
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description The name of the loot modifier. |
Name: register
Registers a new global loot modifier with the given name.
The loot modifier will be run only when all conditions registered within the LootConditionBuilder pass, effectively as if they were merged with an 'AND' condition.
This method is to be preferred instead of the method that takes a raw ILootCondition array.
It is suggested to provide a list of conditions that match as closely as possible the desired conditions rather than checking them manually in the modifier itself, since the game may perform additional optimizations.
Return Type: void
ZenScript CopyLootModifierManager.register(name as string, builder as LootConditionBuilder, modifier as ILootModifier) as void
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description The unique identifier for the loot modifier. It must be all lowercase and devoid of both spaces and colons. |
Parameter builder | Type LootConditionBuilder | Description A LootConditionBuilder representing a list of conditions that should be merged together via 'AND'. |
Parameter modifier | Type ILootModifier | Description The loot modifier itself. It may be created via CommonLootModifiers. |
Name: register
Registers a new global loot modifier with the given name.
The loot modifier will be run only when all conditions pass, effectively as if they were merged with an 'AND'
condition. An empty condition array (or a null
one) indicates a lack of conditions, meaning that the
loot modifier will be run on every loot table.
It is nevertheless suggested to provide a list of conditions that match as closely as possible the desired conditions rather than checking them manually in the modifier itself, since the game may perform additional optimizations.
Return Type: void
ZenScript CopyLootModifierManager.register(name as string, conditions as ILootCondition?[], modifier as ILootModifier) as void
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description The unique identifier for the loot modifier. It must be all lowercase and devoid of both spaces and colons. |
Parameter conditions | Type ILootCondition?[] | Description A set of conditions that restrict the context in which the loot modifier applies. It can be empty or null , which indicates a lack of conditions. The conditions are all merged together with an 'AND' connector. |
Parameter modifier | Type ILootModifier | Description The loot modifier itself. It may be created via CommonLootModifiers. |
Name: registerUnconditional
Registers a new global loot modifier with the given name without providing any conditions.
The loot modifier will be run for every loot table rolled in the entire game. It is thus suggested to use this method sparingly and to implement a very fast loot modifier.
Return Type: void
ZenScript CopyLootModifierManager.registerUnconditional(name as string, modifier as ILootModifier) as void
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description The unique identifier for the loot modifier. It must be all lowercase and devoid of both spaces and colons. |
Parameter modifier | Type ILootModifier | Description The loot modifier itself. It may be created via CommonLootModifiers. |
Name: removeAll
Removes all loot modifiers that have been registered up to this point.
Return Type: void
ZenScript Copy// LootModifierManager.removeAll() as void
loot.modifiers.removeAll();
Name: removeByModId
Removes all loot modifiers that have been registered by the mod with the given ID.
Return Type: void
ZenScript CopyLootModifierManager.removeByModId(modId as string) as void
Parameter | Type | Description |
---|---|---|
Parameter modId | Type string | Description The mod ID. |
Name: removeByName
Removes the loot modifier with the given name.
The name may either contain a colon or not. If no colon is present, it is assumed that the loot modifier name is one of the modifiers that have been already registered in a script.
Return Type: void
ZenScript CopyLootModifierManager.removeByName(name as string) as void
Parameter | Type | Description |
---|---|---|
Parameter name | Type string | Description The name of the loot modifier to remove. |
Name: removeByRegex
Removes all loot modifiers whose name matches the given regular expression.
The entire name is taken into consideration for the match, effectively matching the format of a MCResourceLocation.
Return Type: void
ZenScript CopyLootModifierManager.removeByRegex(regex as string) as void
Parameter | Type | Description |
---|---|---|
Parameter regex | Type string | Description The regular expression to match. |