A Complete Portal Module

[NotSoDelayed]

Problem

Skript is lacking a few portal related features, while some still consists of legacy code.

Solution

This PR adds some missing portal related features (refer to section below), enhances existing ones, and finally they all reunite into its a single module as part of modernizing Skript registrations.

Changes

• Adds a new classinfo: PortalType -- an enum of portal types, to differentiate the portal type in all portal events (except 'portal exit') via event-portaltype
• Adds support of 'End Gateway' into existing portal event
• Adds event values into existing 'Portal Create' event: event-location, event-portaltype
• Adds 'Portal Exit' event and its event values: (values inherited from EntityTeleportEvent), past event-vector, event-vector (mutable)
• Renamed ExprPortal to ExprPortalBlocks due to former name was ambiguous
• Optimizes existing portal related features to current Skript standards

Testing Completed

JUnit tests were implemented at EvtPortalTest.java and PortalTest.sk, covering every portal related events and expressions supported.

Supporting Information

At this date of PR creation, this PR was designed ahead of time with proposed Skript 2.14 standards, which includes dropping Spigot support and Minecraft versions below 1.21, which is why tests below 1.21 will fail.

---

Completes: none
Related: none

[NotSoDelayed]

Sovde's request on converting to EVE

[sovdeeth]

needs explanation for what event-vector is

[sovdeeth]

Suggested change

	Skript.registerEvent("Portal / End Gateway", EvtPortal.class, events, "[player] portal", "entity portal")
	.description(
	"Called when a player or an entity uses a nether portal, end portal or end gateway. Note that events with keyword 'entity' does not apply to players.",
	"<a href='#EffCancelEvent'>Cancel the event</a> to prevent the entity from teleporting."
	).keywords(
	"player", "entity"
	).examples(
	"on portal:",
	"\tbroadcast \"%player% has entered a %event-portaltype%!\"",
	"",
	"on player portal:",
	"\tplayer's world is world(\"wilderness\")",
	"\tset world of event-location to player's world",
	"\tadd 9000 to x-pos of event-location",
	"",
	"on entity portal:",
	"\tbroadcast \"A %type of event-entity% has entered a portal!"
	).since("1.0, 2.5.3 (entities), INSERT VERSION (location changers, end gateway)");
	Skript.registerEvent("Portal / End Gateway", EvtPortal.class, events, "[player] portal", "entity portal")
	.description(
	"Called when a player or an entity uses a nether portal, end portal or end gateway. Note that events with keyword 'entity' does not apply to players.",
	"<a href='#EffCancelEvent'>Cancel the event</a> to prevent the entity from teleporting.")
	.keywords("player", "entity")
	.examples(
	"on portal:",
	"\tbroadcast \"%player% has entered a %event-portaltype%!\"",
	"",
	"on player portal:",
	"\tplayer's world is world(\"wilderness\")",
	"\tset world of event-location to player's world",
	"\tadd 9000 to x-pos of event-location",
	"",
	"on entity portal:",
	"\tbroadcast \"A %type of event-entity% has entered a portal!")
	.since("1.0, 2.5.3 (entities), INSERT VERSION (location changers, end gateway)");

you should also use the """ text blocks here to clean it up.

[sovdeeth]

Suggested change

	""")
	""")