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.

This is not an issue any more:

I am guarding the new additions by:
if (Skript.classExists("io.papermc.paper.event.entity.EntityLungeEvent")),
but I believe this sill breaks pre 26.1.2 Paper versions.

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!