Blocking Components #8217

Absolutionism · 2025-10-02T02:59:48Z

Problem

Skript does not have support for Blocking Components, otherwise known as BlocksAttacks. Skript should include this since it's vanilla.

Solution

Adds BlockingWrapper that extends ComponentWrapper and handles modifying data of the underlying BlocksAttacks component.
Adds DamageFunctionWrapper that wraps ItemDamageFunction. This handles changing data of the wrapped ItemDamageFunction. This can be created with a parenting BlockingWrapper to specify that any changes made to the underlying ItemDamageFunction should take place on the BlockingWrapper. Using the wrapper to change the ItemDamageFunction of any BlockingWrapper should not presume to be the parent, as it can and should be used on multiple BlockingWrappers.
Adds DamageReductionWrapper that wraps DamageReduction. This handles changing data of the wrapped DamageReduction. This can be created with a parenting BlockingWrapper to specify that any changes made to the underlying DamageReduction should take place on the BlockingWrapper. Using the wrapper to change the DamageReductions of any BlockingWrapper should not presume to be the parent, as it can and should be used on multiple BlockingWrappers.

Adds builders for BlocksAttacks, ItemDamageFunction, and DamageReduction as there was no way to convert an existing finalized object back into the builder provided by Paper.

Adds BlockingExperimentalSyntax for all related syntax elements. This component, just like every other, are experimental.

Adds all syntax elements that correlate to retrieving and modifying BlockingWrappers, DamageFunctionWrappers, and DamageReductionWrappers

Testing Completed

BlockingComponents.sk

Supporting Information

N/A

Completes: none
Related: none

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/resources/lang/default.lang

…leComponents # Conflicts: # src/main/java/ch/njol/skript/util/slot/EquipmentSlot.java

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/java/ch/njol/skript/bukkitutil/SoundUtils.java # src/main/resources/lang/default.lang

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/java/ch/njol/skript/util/slot/EquipmentSlot.java # src/main/resources/lang/default.lang

…leComponents # Conflicts: # src/main/resources/lang/default.lang

…leComponents # Conflicts: # src/main/java/ch/njol/skript/registrations/Feature.java # src/main/resources/lang/default.lang

…Component # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/java/ch/njol/skript/classes/data/BukkitClasses.java # src/main/java/ch/njol/skript/lang/function/Function.java # src/main/java/ch/njol/skript/registrations/Feature.java # src/main/java/ch/njol/skript/util/ItemSource.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/ComponentUtils.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/ComponentWrapper.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/ItemComponentModule.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/EquippableModule.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/EquippableWrapper.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/CondEquipCompDamage.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/CondEquipCompDispensable.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/CondEquipCompInteract.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/CondEquipCompShearable.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/CondEquipCompSwapEquipment.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/EffEquipCompDamageable.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/EffEquipCompDispensable.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/EffEquipCompInteract.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/EffEquipCompShearable.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/EffEquipCompSwapEquipment.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompCameraOverlay.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompEntities.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompEquipSound.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompModel.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompShearSound.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquipCompSlot.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprEquippableComponent.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/equippable/elements/ExprSecBlankEquipComp.java # src/main/java/org/skriptlang/skript/bukkit/itemcomponents/generic/ExprItemCompCopy.java # src/main/resources/lang/default.lang

sovdeeth · 2025-11-07T05:09:45Z

.../java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprBlockCompBypass.java

+			infoBuilder(
+				ExprBlockCompBypass.class,
+				DamageType.class,
+				"[blocking] damage type bypass[es]",


Suggested change

"[blocking] damage type bypass[es]",

"bypassing damage type[s]",

sovdeeth · 2025-11-07T05:12:04Z

.../java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprBlockCompBypass.java

+
+@Name("Blocking Component - Damage Type Bypass")
+@Description("""
+	The damage type that can bypass when the item is blocking.


Suggested change

The damage type that can bypass when the item is blocking.

The damage type that can bypass the damage reduction from blocking with this item.

sovdeeth · 2025-11-07T05:26:58Z

...n/java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprBlockCompDelay.java

+
+@Name("Blocking Component - Delay Time")
+@Description("""
+	The amount of time before an item can block an attack after starting to block.


does this affect the blocking animation speed? If so I think that should be mentioned. No clue if it does.

sovdeeth · 2025-11-07T05:27:45Z

...n/java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprBlockCompDelay.java

+	public static void register(SyntaxRegistry registry) {
+		registry.register(
+			SyntaxRegistry.EXPRESSION,
+			infoBuilder(ExprBlockCompDelay.class, Timespan.class, "blocking delay time[s]", "blockingcomponents", true)


Suggested change

infoBuilder(ExprBlockCompDelay.class, Timespan.class, "blocking delay time[s]", "blockingcomponents", true)

infoBuilder(ExprBlockCompDelay.class, Timespan.class, "blocking delay [time[s]]", "blockingcomponents", true)

sovdeeth · 2025-11-07T05:34:08Z

...g/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprBlockCompDamageFunction.java

+@Example("set the item damage function of {_item} to a custom damage function")
+@RequiredPlugins("Minecraft 1.21.5+")
+@Since("INSERT VERSION")
+public class ExprBlockCompDamageFunction extends SimplePropertyExpression<BlockingWrapper, DamageFunctionWrapper> implements BlockingExperimentalSyntax {


remove concept of damage function as discussed

sovdeeth · 2025-11-07T06:17:53Z

.../org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprReductionDamageTypes.java

+			infoBuilder(
+				ExprReductionDamageTypes.class,
+				DamageType.class,
+				"[damage] reduction damage types",


Suggested change

"[damage] reduction damage types",

"(reduced|blocked) damage types",

sovdeeth · 2025-11-07T06:18:50Z

.../java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprReductionFactor.java

+	set {_reductions::*} to the damage reductions of {_item}
+	set {_amounts::*} to the reduction factor amounts of {_reductions::*}
+	""")
+@Example("set the damage reduction factor of (the damage reductions of {_item}) to 0.5")


Suggested change

@Example("set the damage reduction factor of (the damage reductions of {_item}) to 0.5")

@Example("set the damage reduction factor of (the damage reductions of {_item}) to 50%")

sovdeeth · 2025-11-07T06:19:45Z

.../java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprReductionFactor.java

+			infoBuilder(
+				ExprReductionFactor.class,
+				Float.class,
+				"[damage] reduction factor [amount[s]]",


Suggested change

"[damage] reduction factor [amount[s]]",

"(proportional|percentage) [damage] reduction[s]",

sovdeeth · 2025-11-07T06:20:24Z

...ava/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprSecBlankBlockComp.java

+
+@Name("Blank Blocking Component")
+@Description("""
+	Gets a blank blocking component.


need to mention the defaults! Also not sure this should be "blank" if it's full of default values?

sovdeeth · 2025-11-07T06:21:36Z

...ain/java/org/skriptlang/skript/bukkit/itemcomponents/blocking/elements/ExprSecReduction.java

+
+@Name("Custom Damage Reduction")
+@Description("""
+	Gets a custom damage reduction.


Absolutionism and others added 30 commits November 4, 2024 01:39

Starter Commit

2cd6021

PR ready

feede48

remove "runtime"

1c22720

Changes

6736a9d

Merge branch 'dev/feature' into dev/EquippableComponents

92e8162

Merge branch 'dev/feature' into dev/EquippableComponents

15d5fd7

Update

01b3fe7

Merge branch 'dev/feature' into dev/EquippableComponents

70c7186

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

d78a8f2

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/resources/lang/default.lang

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

2500976

…leComponents # Conflicts: # src/main/java/ch/njol/skript/util/slot/EquipmentSlot.java

Merge branch 'dev/feature' into dev/EquippableComponents

8f944a2

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

256781a

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/java/ch/njol/skript/bukkitutil/SoundUtils.java # src/main/resources/lang/default.lang

Update

e250c95

Merge branch 'dev/feature' into dev/EquippableComponents

7e59693

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

cc57b63

…leComponents # Conflicts: # src/main/java/ch/njol/skript/Skript.java # src/main/java/ch/njol/skript/util/slot/EquipmentSlot.java # src/main/resources/lang/default.lang

Overhaul

2c2cc84

Update CondEquipCompInteract.java

e889044

Requested Changes

96c2481

Partial Changes

b51820a

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

9b46199

…leComponents # Conflicts: # src/main/resources/lang/default.lang

Update EquippableComponents.sk

f312699

revert

29e19b0

Record Usage

675c6b1

Merge branch 'dev/feature' into dev/EquippableComponents

5536e9b

Partial Changes

e6f13bf

Merge remote-tracking branch 'upstream/dev/feature' into dev/Equippab…

a9f7382

…leComponents # Conflicts: # src/main/java/ch/njol/skript/registrations/Feature.java # src/main/resources/lang/default.lang

More Changes

3394d3d

Changes

df55cc3

Requested Changes

024a0e1

Update EquippableComponents.sk

ab5ad52

Absolutionism and others added 19 commits July 18, 2025 21:13

Fix ItemType

5bc5797

Revert Misc Changed Files

63e05f8

Source Retainability

76e97a6

Update EquippableComponents.sk

7adea5c

Update ExprEquippableComponent.java

53681d7

Requested Changes

29d6648

Merge branch 'dev/feature' into dev/EquippableComponents

21f02d9

Update Wrapper

3e79e27

ComponentUtils

eb322ab

Docs Update

3a48edb

Initial Commit

47e77d3

Syntax Docs

6e53ad8

Javadocs

9dc3bbb

Test

c2c8a8e

Merge dev/feature

c7a5ddd

Update ExprReductionDamageTypes.java

49caf92

Update BlockingComponents.sk

2003cd0

Update

3ad1861

Absolutionism requested a review from a team as a code owner October 2, 2025 02:59

Absolutionism added the feature Pull request adding a new feature. label Oct 2, 2025

Absolutionism added this to 2.14 Releases Oct 2, 2025

Absolutionism requested review from Burbulinis and erenkarakal and removed request for a team October 2, 2025 02:59

Merge branch 'dev/feature' into dev/BlockingComponent

7894c7f

Absolutionism moved this to In Review in 2.14 Releases Oct 2, 2025

Absolutionism added the 2.14 Targeting a 2.14.X version release. label Nov 2, 2025

sovdeeth requested changes Nov 7, 2025

View reviewed changes

skriptlang-automation bot added the needs reviews A PR that needs additional reviews label Nov 7, 2025

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Uh oh!

Blocking Components #8217

Blocking Components #8217

Uh oh!

Absolutionism commented Oct 2, 2025 •

edited

Loading

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

sovdeeth Nov 7, 2025

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

	"[blocking] damage type bypass[es]",
	"bypassing damage type[s]",

	The damage type that can bypass when the item is blocking.
	The damage type that can bypass the damage reduction from blocking with this item.

	infoBuilder(ExprBlockCompDelay.class, Timespan.class, "blocking delay time[s]", "blockingcomponents", true)
	infoBuilder(ExprBlockCompDelay.class, Timespan.class, "blocking delay [time[s]]", "blockingcomponents", true)

	"[damage] reduction damage types",
	"(reduced\|blocked) damage types",

	@Example("set the damage reduction factor of (the damage reductions of {_item}) to 0.5")
	@Example("set the damage reduction factor of (the damage reductions of {_item}) to 50%")

	"[damage] reduction factor [amount[s]]",
	"(proportional\|percentage) [damage] reduction[s]",

Uh oh!

Blocking Components #8217

Are you sure you want to change the base?

Blocking Components #8217

Uh oh!

Conversation

Absolutionism commented Oct 2, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Problem

Solution

Testing Completed

Supporting Information

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Absolutionism commented Oct 2, 2025 •

edited

Loading