fix error at startup when PlaceholderAPI exists

fixed version check from EffectsAPI
removed extraneous debug logs
fixed nullpointerexception in logger when getting a null message
changed some exception handling back to printstacktrace

fixed weird behavior with chunkyborder causing RTP to use the wrong shape

all chunky integrated shapes now use a prefix "chunky_"

also added additional logs for certain edge case selection failures

fix reload command not always working for the base config files

also changed reload command to only update references for modified files

temporary solution to biome parameter causing lag if the biome is not discovered yet and if the server requires chunk load on biome get, via extra option in performance.yml

typo fix in regions/default.yml comments

also one memory leak fix, probably. It will take a long time to verify.

fix titles and subtitles not formatting correctly

rtp.other permission not working as intended

also a partial implementation of a new option to make console commands easier

user requested feature, unordered commands with arguments can (less efficiently) work without the argument names

`/rtp [player] [region]` teleports player to region
`/rtp [region] [player]` also teleports player to region

I don't see much benefit from this, but it wasn't hard to implement based on what I already had so far.

if an input is not a subcommand, attempts to resolve the text against available parameters under the current command, sorting by integer priority (all 0 atm).

I did not apply this to tabcompletion (yet), because there would be too many options before typing

changed selection fail message to represent fail conditions better
changed selection fail message to a lighter aqua color
made load/reload not save files after loading
fixed some more nag messages in exceptional circumstances (like shutdown within 20s of startup)
catch and log any exceptions from runnables in any pipelines
re-implemented placeholders in post-teleport commands

sometimes a region cache execution would be skipped with the old floating point period calculation.

changed the math to guarantee each is called and in the correct order.

forgot to subtract 1 for negative coordinates.

when the server version is lower than 1.13 or after any biome lookup in a loaded chunk did not match correctly, get the biome via block check instead of world.getBiome(x,y,z)

fixed console log spacing in 1.8-1.12

stripped color from logs in 1.8-1.12

fixed effects exception in 1.8

include the standing block during y level correction, to fix standing one above water.

fixed RTPLocation.getBlock() to get the block from the correct chunk

initial biome check was checking the wrong coordinate, so I changed it.
also added support for commas as decimals in numbers.
changed platform method to load the chunk if it got unloaded for whatever reason.

had the code, forgot to use it.
also changed requireskylight to false by default because giving support for the same lack of reading is tedious

fix wrong file upload

this is no different from the prior upload, I just put the wrong plugin here

fix cancel message triggered when clearing weather
shorten clear weather duration to vanilla values
remove apache lang dependency

fix 1.12 compatibility

modified biome check reflective calls to accept a world input
fixed one of the world lookup checks
added iris integration example on github

changed the biome validity check to keep invalid biomes, to improve biome parameter usage
fixed some biome lookup code
removed apache text to reduce file size, replaced the calls with patterns and matchers
fixed cloned shapes copying references
a bunch of miscellaneous fixes.
cleaned up a lot of the code

this seems stable enough.

automatically add non-overlapping chunky shapes via reflection, using rectangle as a base type
fixed update command not updating name fields
fixed overlapping fill task and database task calls
fixed case on parameter lookups
readded world save to fill command
removed effect permissions registering due to time cost

(reupload to remove debug log)

automatically add non-overlapping chunky shapes via reflection, using rectangle as a base type
fixed update command not updating name fields
fixed overlapping fill task and database task calls
fixed case on parameter lookups
readded world save to fill command

fixed teleporting during reload via busy message
fixed shape configurations overlapping
added rotate() method to shape class
added 3 more shapes

• CIRCLE_NORMAL - circle with normal (Gaussian) distribution

• SQUARE NORMAL - square with normal (Gaussian) distribution

• RECTANGLE - shape defined by width, height, and rotation

fixed chunkyborder addon on github

do not use on a production server without extensive testing

major code update, mostly for devs

• split config.yml into appropriately named files
• redesigned configuration for custom language mappings
• redesigned region structure and commands for adding shapes and safety checks at runtime
• redesigned command structure for easier command addition
• rewrote data storage to use sqlite for player data, all async
• removed softdependencies to allow compiling in java 8, moved safety checks outside the main plugin
• added optional logging
• fixed update commands
• fixed some nag messages
• changed how teleporting works when there are no prepared locations
• reflection for biome functions and a few more things

there is a known bug that triggers a nullpointerexception when a datapack provides the server an invalid biome. I added a catch for that so that RTP should log the first biome exception but continue to operate as if every biome were PLAINS.

I also removed a debug log that crept into the last update.

biome parameter price fix - changed rtp.biome.free permission to rtp.free.biome because luckperms handles the regex in rtp.biome.* and I want to use them separately

also changed rtp.near.free to rtp.free.near for a consistent format

fixed a stray exception on join event

I don't recommend using old server versions and there's probably a few missing method handles that were introduced in newer APIs, but I made at least startup and teleportation work in 1.8-1.12.

added support for adding various worldborders

ChunkyBorder example here

also hotfix for that world name placeholder

also fixed centerX and centerZ using chunk coordinates

starting with a world name other than "world" would cause errors with the default configuration. This update makes that first startup easier.

• implemented world number placeholder for world names
• changed the default configuration to use world 0
• added extra error handling on rtp command for bad world names

added %rtp_teleport_biome% to PAPI placeholders

just uses biome name.

softdepends forced me to update to java 16.

removed the minecraft version check from the api because apparently it doesn't work correctly and I don't need it yet.

adding to the todo list: 3D biome checks

invulnerable players could end up permanently invulnerable if the server crashed, so I fixed it.

you can use UnsetInvulnerable to automatically amend offline player data.

the plugin would sometimes queue a given location multiple times because counting asynchronously is hard, so I replaced the counter.

A free-for-all every 10s is a headache and a half, so I made a per-region player queue to teleport players in the order they input a command. It should be somewhat of a UX upgrade.

double pass on chunk prep to ensure that every chunk within view distance is loaded before teleporting.

pre-check for claims at the midpoint between minY and maxY before waiting on a chunk, to speed up that case.

I now trust people a bit less to read before deploying, so I've updated the default configuration settings to optimize solely for teleport time and memory usage.

added info command for checking current region settings

fixed placeholderapi parsing

added some extra config settings for testing and optimization

the fill task was struggling with chunks coming in too rapidly with iris, so I had to add mutexes to atomics.

I've also switched some Player.hasPermission() checks to ensure that rtp.onevent permissions require explicit setting, even if a user gives themselves *. It isn't the fastest permission check but it's harder to break.

a user-requested feature




also fixed note instrument parsing

rewrote firework format for types and power


format is detailed here

potions, notes, sounds, particles, and fireworks, on event, using permissions.




see here for formatting

I'm not sure how to reproduce the error but maybe this'll help somehow.

edit - it did

bStats' Metrics got accidentally deleted when I was adding hook functions. This update just restores it.

for the purpose of supporting arbitrary location checking functions, e.g. Domain's Check.inField()

also added async TeleportCommandSuccessEvent

added GriefDefender support
added Lands support

fixed needless cancellation messages on random teleport
fixed the personal queue length check

added more API events (see here for some basic usage)

• RandomSelectPlayerEvent
  
• RandomSelectQueueEvent
• LoadChunksPlayerEvent
• LoadChunksQueueEvent
  
• RandomPreTeleportEvent

implemented RTP.getRegion and RTP.setRegion methods

added number of tries to RandomTeleportEvent

fixed some biome detection code for picking up biomes during selection
implemented region expansion for alternate placement modes

added support for:

• Factions (and any factions plugins using massivecraft.factions as a base)
• TownyAdvanced
• HuskTowns

alternate placement-fixing modes for optimization options





also re-enabled the tps check while filling and turned the iterator down to 2500, to let the server catch up.

made the fill messages reference lang.yml

this one took a stupidly long time because of health issues.

relies on running "/rtp fill" beforehand.

• added rtp biome parameter with its own price
• added rtp.biome, rtp.biome.[biome], rtp.biome.free, and rtp.biome.* permissions and checks
• increased fill iterator from 1000 to 5000
• took off the tps wait on fill
  • it's supposed to be a single-pass command for a region, so it's better to do on a side server or outside of player activity.
• changed /fill to clear previous data before running
• changed next fill task to be scheduled from an earlier chunk, to fix a bug from parallelism.
• fixed price checking on near parameter
• fixed some price values in the default config that should have been floating point

This is much more than a simple biome check and retry. Thanks to how the regions work, I now have the plugin mapping out relative biome locations during the fill task and getting an approximate nearest specific biome on location selection, which is giving me super-fast biome selection, with practically no difference in load times compared to other unqueued selections.

another user-requested feature

• added a check for a "rtp.cooldown.[x]" variable among CommandSender permissions
• added a check for a "rtp.delay.[x]" variable among CommandSender permissions
  
• added rtp.cooldown to plugin.yml
• added rtp.delay to plugin.yml

store cooldowns on shutdown, retrieve cooldowns on startup

• added hex color format (#xxxxxx) to string parsing
• changed message delivery everywhere to support hex colors
  • it'll still translate hex codes pre-1.16, but might not read out right
• ensured any configured commands run after teleportation
• ensured teleport delay consistency on server startup

• fixed a bug regarding placement in nether ceilings (as far as I can tell)
• added checks to not send a message if it equals "" or has been removed from its configuration file
  
• replaced liquid check option with a bukkit material blacklist I called "unsafeBlocks"
  • besides WATER and LAVA, also added MAGMA, TNT, FIRE to the default list
• added player invulnerability timer on teleport, if player is not already invulnerable
• added blindness timer on teleport for effect
• added configurable title card on teleport for effect
• added platform creation in a square around the location, on teleport
  • including block breakage to make air (may cause lighting bugs)
• added block checking in a square around the location, on selection
• added random teleport event for developers
• changed fill task to not wait for 0 players online.
  • still waits for a high enough TPS before doing the next set
• changed fill task to send its status message to any players that have the rtp.fill permission

%rtp_teleport_world%
%rtp_teleport_x%
%rtp_teleport_y%
%rtp_teleport_z%

using current selection if currently teleporting
using last completed teleport otherwise

fixed cooldown time following the switch to nanoseconds

added a fail message for when a player tries to teleport when they're already teleporting.

added a message for when the plugin starts loading chunks before teleporting.

added in a PAPI expansion

• %rtp_player_status% - player's current teleport status
• %rtp_total_queue_length% - total number of locations available to a player in the region that "/rtp" would get
• %rtp_public_queue_length% - number of locations available to everyone in the region that "/rtp" would get
  
• %rtp_personal_queue_length% number of locations allocated specifically to a player in the region that"/rtp" would get

I don't want to do these by hand, so I used PlaceholderAPI.

see https://www.spigotmc.org/wiki/placeholderapi-tutorial/ for PAPI usage

using player expansion for testing,


I can use any installed placeholders


and it works

I misread the initial request, so here's an option to teleport to a random player (that isn't the command sender and doesn't have the rtp.near.notme permission), using the rtp.near.random permission.

run commands on teleport




near parameter with corresponding rtp.near and rtp.near.other permissions

this one works the exact same way as other rtp parameter inputs, just with its own permissions, though I decided to make the settings world-specific because the height range matters for the nether

This unfortunately means config file updates. Sorry (not sorry, these are good features).

fill cancel
not a user request, but I wanted to add it because the fill command is also a basic world loader for teleport regions and world loaders usually have stop/cancel commands.

By the way, I'm using PlaceholderAPI and its Player expansion for coordinates.

fixing a bug in time representation that was showing larger times in milliseconds than it was actually taking.

time test:

• immediately teleport if a location is queued, rather than scheduling a task to run in the next gametick
  • massive command response speedup
• added viewDistance setting to config.yml, to give some finer control over memory usage
• changed queueing to finish once the chunks are loaded rather than once the location is selected, improving queue usage.
• added experimental fill command to check every possible location in a region and do any relevant learning.
  • removed chunk load event because the fill command does the same job but better.
• set up a rtp.personalQueue permission to queue a next location for any player with the permission
• minor improvement to selection algorithm

added Vault as a softdepend and added region prices.
updated config files
added PlaceholderAPI as a softdepend.

Fixed some of the nag messages but there's still an edge case I can't seem to pin down.
Fixed queuePeriod zero check.
Added setRegion and setWorld to the help menu according to permissions
Fixed a few of the boolean region parameters not having boolean tabcompletion

Added plaintext region data files to store/retrieve learned data between restarts.

also fixed a memory leak.

stress test:

it should divide by 16 to get the radius in chunks

Optimizations -

• switching to purely chunk locations speeds up location checking and slightly reduces memory usage.
  • UPDATE YOUR REGIONS SETTINGS
  • using x,z = 7,7 in each chunk
• using ChunkSnapshot.getBlockType(x,y,z) seems to be faster than using Location.getBlock()
• returning early from location checks if they approach maxY speeds up selection noticeably.
• also significantly sped up chunk checking on load event.

Fixes -

• fixed extra message on no queued location
• Adding 0.000069 (nice) seems to fix a floating point error in circle location that was shifting selections by a few units.
  
• fixed timers running too close together
• switched an int to a long to fix an integer overflow issue with large radii

switched to java 8 and spigot 1.13 api to support earlier server versions.

also fixed occasional unintended behavior on teleport cancel.

added GriefPrevention as a softdepend
added config option

updated config version

added worldguard as a softdepend
added a config value to do/don't reroll if the selection is in a WorldGuard region

fixed/enabled first join and world change events that weren't firing

switching from chunk curve to location curve, to ensure no placement attempts outside of curve. It's a little extra, but it's hard to notice.

also fixed a piece of the learning algorithm in the process.

lots of changes since last week

• added unique location setting to regions.yml, to ensure each randomization lands in a new spot
• added expand option to config, to extend the selection range as chunks are eaten.
• added onEvent permissions for random teleportation on various movement events and/or respawn event.
  • join
  • respawn
  • changeWorld
  • move (this one's hilarious)
  • teleport (recursive, useful for stress testing)
• added unqueued permission to control who can generate a new (not queued) location for a teleportation, thereby limiting default users' control over server performance.
• added an async location queue task after teleportation, to line up a next teleport on a low-priority task, rather than rely solely on a timer.
• cleaned up a lot of the code

Thanks to the plugin's design, the new region options won't impact the number of rerolls, which I'm super proud of.

tilde usage broke because I moved it

quick fix

changed some stuff to make independent teleport regions a thing

/rtp set is now split into /rtp setWorld and /rtp setRegion

regions can be created or updated by the /rtp setRegion command
updating a region will clear its data
multiple regions can be created in each world, though only one can be the world's default region.
there's now a region parameter available for console and player commands, for teleporting to a selected region

each world is now linked to a region in regions.yml
world settings can be updated with /rtp setWorld
world name placeholders are now represented correctly in commands

rtp.instant permission is now split into rtp.noDelay and rtp.noCooldown

semi-stable foundational update, but a big step in the direction I want to go.

I thought of a method to learn from bad placements, lowering the number of retries as more bad placements are detected.

I'd call it machine learning, but it isn't a traditional ML model.

Also added /rtp parameters to generate a random location based on inputs

because apparently the other one didn't work

players shouldn't be teleported into lava or the void (changed max attempt check)
added tps prerequisite for queue attempts
queued chunks stay loaded until the teleport happens
queues reset on both world setting update and reload

Made teleportation wait on async chunk loading to improve UE
Added async location & chunk caching, from a timer and from cancelled teleports
Added tabcompletion for true/false values in /rtp set
Added worldBorderOverride value for vanilla world border settings
Fixed integer overflow for supermassive teleportation radii, at the expense of computation time on selection if the radius is over ~1.5 billion

I'm seeing an occasional error on server reload/restart where an async chunk is loading, even if I track and cancel() every task and chunk. I've been at it for a while, so I doubt I'm going to fix it without another set of eyes.

I thought I should add this.
on /rtp set, for coordinate settings, tilde will use your current location, plus or minus whatever number

added '/rtp set' for updating world parameters by command
tab for parameters
tabComplete rewritten
added weight parameter to world config
made teleport task immediately schedule if delay is 0
try/catch in a few places to make unit tests possible

I think replacing world settings with region settings will be pretty easy later with these methods, since a few people seem to be looking for that. It's on the todo list.

fixed centering
made a new square-donut randomization algorithm
added world and player teleport options, as well as perms for managing who can do that
added override world to worlds.yml, removed default world from config.yml
removed world name placeholder for now