Add EvtEntityLunge and ExprLungePower

[vuxeim]

Problem

This adds syntax to work with Paper event EntityLungeEvent as requested in #8586.
As well as expression to get/set/add/remove lunge power inside of the event.

Solution

I've added EvtEntityLunge.java and ExprLungePower.java so that working with lunge event is possible from Skript land.
Event: [%-entitytypes%] lunge
Expression: [the] [event-]lunge power
Example:

on lunge:
    set lunge power to 4

Testing Completed

I managed to successfully run both ./gradlew clean quickTest and ./gradlew build test.
(In new test environment java25/paper-26.1.2.json)

And I did manual in-game testing with this script:

on entity lunge with priority monitor:
    broadcast "Entity: %event-entitytype% (%event-entity%) Power: %lunge power%"
 
on skeleton lunge with priority monitor:
    if the lunge power is 1, 2 or 3:
        broadcast "Normal lunge power"
    else if the lunge power is greater than 3:
        broadcast "Overpowered lunge power"
 
on player lunge:
    set event-lunge power to 10
 
command spawn-opponent [<text="skeleton">] [<boolean=true>]:
    trigger:

        set {_loc} to location of block above player's target block
        set {_weapon} to diamond spear of lunge 3 if arg 2 is true else air

        if arg 1 is "skeleton":
            spawn skeleton at {_loc}:
                set tool of last spawned entity to {_weapon}

        else if arg 1 is "all":
            loop all entity types:
                set {_loc} to location of block above player's target block
                spawn loop-value at {_loc}:
                    set tool of last spawned entity to {_weapon}
                wait 1 tick

        else if arg 1 is "duel":
            spawn skeleton at {_loc}:
                set tool of last spawned entity to {_weapon}
            spawn iron golem at {_loc} ~ vector(2, 0, 2)

        else if arg 1 is "ravi":
            spawn ravager at {_loc}:
                set tool of last spawned entity to {_weapon}

Supporting Information

I had to bump version of Paper API to 26.1.2 - EntityLungeEvent was made available in that version.
I've added test environment java25/paper-26.1.2.json.

I also want to propose additional changes:

• add/remove to/from lunge power
  • add 1 to lunge power
  • EDIT I have added it in subsequent commit
• expression to get lunge item (or lunge weapon) in entity lunge event

  • on lunge:
        if event-lunge item is enchanted with mending:
            cancel event
            send "Where did you get that spoon o.O"
    

  • Can this item ever be null?

But I would like some feedback on what I already introduced in this PR. As #8586 was marked good first issue I wanted to try and contribute to the Skript project. I did my best to make this a reasonable contribution.

It is worth mentioning that entity has to hold a weapon (e.g. a spear enchanted with lunge enchantment) (event if that weapon isn't visibly equipped) in order to perform lunge attack that fires this EntityLungeEvent, but this isn't true for every mob type. (e.g. Zombies can't preform lunge attack at all)
A list of entities that in general can perform lunge attack consists of (but is probably not limited to):

See the list

% zcat logs/2026* | grep 'INFO]: Entity: ' | cut -d" " -f 4- | grep 3 | sort | uniq 
Entity: blaze (blaze) Power: 3
Entity: bogged (bogged) Power: 3
Entity: cat (cat) Power: 3
Entity: cave spider (cave spider) Power: 3
Entity: cold frog (frog) Power: 3
Entity: creaking (creaking) Power: 3
Entity: drowned (drowned) Power: 3
Entity: elder guardian (elder guardian) Power: 3
Entity: enderman (enderman) Power: 3
Entity: endermite (endermite) Power: 3
Entity: guardian (normal guardian) Power: 3
Entity: killer rabbit (rabbit) Power: 3
Entity: ocelot (ocelot) Power: 3
Entity: parched (parched) Power: 3
Entity: phantom (phantom) Power: 3
Entity: piglin brute (piglin brute) Power: 3
Entity: player (vuxeim) Power: 3
Entity: polar bear (polar bear) Power: 3
Entity: ravager (ravager) Power: 3
Entity: red fox (fox) Power: 3
Entity: skeleton (skeleton) Power: 3
Entity: snow fox (fox) Power: 3
Entity: spider (spider) Power: 3
Entity: stray (stray) Power: 3
Entity: vex (vex) Power: 3
Entity: vindicator (vindicator) Power: 3
Entity: warden (warden) Power: 3
Entity: wither skeleton (wither skeleton) Power: 3
Entity: wolf (wolf) Power: 3

---

Completes: #8586
AI assistance: Copilot was active during development of this PR mainly for generating documentation part (@Description([...]), @Example([...])). Though the rest of the code I wrote is based on classes that already exist: ExprLungePower from ExprLocation and EvtEntityLunge from EntityTeleport.

[erenkarakal]

looks fine, thank you for contributing!

[APickledWalrus]

Good work so far!

[APickledWalrus]

Nearly ready 🙂

[APickledWalrus]

It'll be better to format this as two distinct examples:

Suggested change

	.examples("on lunge:",
	"\tset lunge power to 4",
	"on ravager lunge:",
	"\tcancel event"
	)
	.examples(
	"""
	on lunge:
	set lunge power to 4
	""",
	"""
	on ravager lunge:
	cancel event
	"""
	)

[APickledWalrus]

Suggested change

	EntityLungeEvent lungeEvent = (EntityLungeEvent) event;
	if (entityTypes == null) {
	return true;
	}
	if (entityTypes == null) {
	return true;
	}
	EntityLungeEvent lungeEvent = (EntityLungeEvent) event;

[APickledWalrus]

You can also use appendIf to simplify this

Suggested change

	SyntaxStringBuilder builder = new SyntaxStringBuilder(event, debug);
	if (entityTypes != null) {
	builder.append(entityTypes).append(" ");
	}
	builder.append("lunge");
	return builder.toString();
	return new SyntaxStringBuilder(event, debug)
	.appendIf(entityTypes != null, entityTypes)
	.append("lunge")
	.toString();

Another nice benefit of SSB is that you do not need to worry about appending spaces, it's handled internally.

[APickledWalrus]

Should be placed immediately after init

[APickledWalrus]

I think it's worth avoiding the overhead here and just doing

((EntityLungeEvent) event).getLungePower();