Big news! The Core now uses Spigot's mappings to map methods of versions 1.18 and higher. This means that unless a method/constructor changes parameters or its logic an update to the Core shouldn't be necessary to keep it functioning with the new version. This requires an internet connection as they are pulled from a website, a way to feed the mappings as a file will be added in the future.
The ProGuard Mappings parser will be made open-source Soon™.
The Wiki is also coming Soon™.

If you notice any bugs, hiccups or anything out of place feel free to PM me or to report it in the Discussion page.

Now the boring changelog:

And more less memorable changes.

Bug fixes (high priority):
Fixed a bug that has been introduced in a previous version (1.3.5) making it so some versions would be incorrectly detected as higher than some others (e.g. version "1.12.2" being detected as higher than "1.17") - this could prevent the plugin from working on such versions (complaining about the MinecraftKey class not existing of something of the likes)

——————————————
Developer API additions

PluginHandler:
+ Added database into PluginHandler

CoreItemStack
+ Added Javadoc for #setMirror(boolean)
+ Added #isMirror()

Inventory
+ Added #fillInventory(Material)

ParticleData:
+ Added "data"/extra to ParticleData
+ Made it so data isn't final anymore and can be changed

BodyPart:
+ Added #setPose(ArmorStand, double, double) to use raw yaw and pitch instead of EulerAngle

ArmorStandUtils:
+ Added #disableEquipmentInteraction(ArmorStand, boolean), this method sets an NBT into an ArmorStand's helmet
+ Added #isEquipmentInteractionDisabled(ArmorStand) that checks an armorstand's helmet for the NBT tag.

PlayerListener:
+ Added a listener to prevent players from interacting with an armorstand's equipment if ArmorStandUtils#isEquipmentInteractionDisabled(ArmorStand) returns true.

LocationUtils:
+ Added a way to get the default world for a specific environment (NORMAL, NETHER and END) with LocationUtils#getDefaultWorldByEnvironment(Environment), LocationUtils#getDefaultWorld(), LocationUtils#getDefaultNetherWorld() and LocationUtils#getDefaultEndWorld().

Fixed a bug with hex colours
Changed the CPacketEvents once again, they can now be fired both sync and async depending on the circumstances.
Added some more CMaterials
Added a toggle for CoreItemStacks to mirror the item rather than copying it to a new one
More bugfixes

Fixed version check (used to know if a Minecraft version is higher or lower than another one, say checking if the current version is higher than or equal to 1.13), this also fixes the update checker not properly detecting updates on SpigotMC

CPacketEvents are now async events, they are now fired from the actual Netty thread of the packet's context, this fixes some possible bugs (like items being invisible when dropped on certain versions).
This may break some plugins using this Core, if that's the case contact their author linking to this update notes, you will know this is the cause as the console error may talk about "asynchronous events" or "CPacket"s. If I'm the author of said plugin just message me and I will fix it.

Added a couple of CMaterials
Made it so if a CMaterial cannot be found from its name it will check normal Materials (fixes possible exception with materials from config)
Added some SkullMeta wrappers to get and set the owner

Fixed a bug introduced in 1.3.1 that would cause the player's language to be null (causing null pointer exceptions when trying to send a message to any player)

Minor additions

Added 1.19 support!
Added MongoDB database type (in beta). For more information about this database type and its configuration visit the documentation page
Added support for RGB colors in configuration files (e.g.: "&#34eb6eLime text") and gradients (e.g. "<#34aeeb>Text with gradient<#9f34eb>")
Fixed some rare networking issues (players would be kicked out on join for no apparent reason and no stacktrace in the console)
Added CMaterial class for cross compatibility with old material/damage materials (e.g. green wool)
Added some sounds to SoundData
Now shading MongoDB's driver again (updated version)

CoreItemStack, added a way to serialize and deserialize itemstacks
Added an update check on start-up
Added some CPackets
Renamed "Players2" -> "Players"
Renamed "Titles2" -> "Titles"
Updated the shaded Java-BetterReflection
Fixed some bugs
Added some SoundMappings
Removed/modified some legacy code
Does not shade javax.mail, any Apache Commons library and mongo-java-driver anymore
Some more breaking changes

Fixed some mappings, calling CPacketEvents synchronously and created "SoundMappings", which can link 1.8, 1.9 and 1.13+ sounds together, making it easy to load a sound from configuration files or use a specific sound without having to worry about what the sound name actually is for the version you're working on.

Overhaul of the plugin, many classes have been rewritten, the library's way more powerful now (and has a lot of legacy code waiting to be removed)

+ Added new constructors and now it actually sends HTML emails when enabled.
+ Created a wiki for the Email Manager with all the informations!

+ Added version compatibility to the following Minecraft versions:
‌‌ ‌‌ * 1.8.8
‌‌ ‌‌ + 1.9
‌‌ ‌‌ + 1.9.2
‌‌ ‌‌ + 1.9.4
‌‌ ‌‌ + 1.10
‌‌ ‌‌ + 1.10.2
‌‌ ‌‌ + 1.11
‌‌ ‌‌ + 1.11.1
‌‌ ‌‌ + 1.11.2
‌‌ ‌‌ + 1.12
‌‌ ‌‌ + 1.12.1
‌‌ ‌‌ + 1.12.2
‌‌ ‌‌ + 1.13
‌‌ ‌‌ + 1.13.1
‌‌ ‌‌ + 1.13.2
‌‌ ‌‌ + 1.14


Other minor updates in the PlayerEvents and CorePlayer.

* SchedulerManager:
‌‌ + runTaskLater(Runnable runnable, long ticks)
‌‌ + runTaskLaterAsynchronously(Runnable runnable, long ticks)
‌‌ + getBukkitScheduler() - Returns the Bukkit scheduler used
‌‌ + cancelAllTasks()


* PlayerEvents:
‌‌ + #onBlockPlace(BlockPlaceEvent event, Block block, CorePlayer player)
‌‌ + #onBlockBreak(BlockBreakEvent event, Block block, CorePlayer player)


* CorePlayer:
‌‌ + #getItemInHand()
‌‌ + #addPotionEffect(PotionEffect potionEffect)
‌‌ + #addPotionEffect(PotionEffectType potionEffectType, int duration, int amplifier)
‌‌ + #removePotionEffect(PotionEffectType potionEffectType)


* Config:
‌‌ + #setSerializedLocation(Location location)
‌‌ + #getSerializedLocation(String key)


+ Email Manager:
‌‌ ‌‌ The Email Manager allows you to send email.
‌‌ It also needs the javax.mail dependecy. Official Download
‌‌ ‌‌ Constructors:
‌‌ ‌‌ ‌‌ ‌‌ Initialize: new EmailManager(String host, String password, boolean auth, boolean starttls)
‌‌ ‌‌ ‌‌ ‌‌ Send Email: emailManager.sendEmail(Email email)
‌‌ ‌‌ ‌‌ ‌‌ Send Email alternative 1: emailManager.sendEmail(String from, String to, String subject, String body)
‌‌‌‌ ‌‌ ‌‌ ‌‌ Send Email alternative 2: emailManager.sendEmail(String from, String to, String subject, String body, EmailPriority priority)
‌‌ ‌‌ ‌‌ ‌‌ (If the EmailPriority is not specified, it is going to be normal)

WebServer

WebServer {
+ Added MIME (content type) support for:
CSS files;
JavaScript files;
PNG Files;
JPG Files;
GIF Files;
WEBP Files;
SVG Files;
ICO Files;


* Modified the constructor to: #WebServer(int port, File webRoot, String fileNotFound, String methodNotSupported, boolean verbose, boolean debugging).
+ When the url does NOT end with a slash, it now checks if it's a file or a folder, if it's a folder then it treates it a s a folder and searches for the index file.

+ Fixed the Verbose messages on-website not working if there is no #onError(WebServerInfo webServerInfo) method in the WebServer class.
+ Added the comments. If the line (trimmed) starts with "//" the line is going to be ignored
* Fixed ArrayIndexOutOfBounds if there are too many arguments.
+ Added #include(String fileName) and #required(String fileName) - they work with HTML files, UC files etc. The #include(String fileName) method will try to include the file (so copy all the text of the file, and if it is an UC file parse it), and in case of file not found or any other error it's going to verbose (if enabled) and continue. The #required(String fileName) instead, if the file is not found, is going to verbose and die.

+ Added trim to the UC tags (this means you can now put spaces before the opening and closing tags).
+ Added variables!
+ Added PlaceHolders!
+ Added #redirect(String location, int time), which is going to redirect to a specific URL or file, after #time seconds.

Variables {

Declare variable: #variables.set(String variableName, String value, boolean global)
Unset variable: #variables.unset(String variableName, boolean global)

The variable can be used almost everywhere in the UC code, and to call it you must write: G_name (where "name" is the name of the variable) in case the variable is global (which means can be called in the whole project after being declared), or V_name (where "name" is the name of the variable) in case the variable is not global (keep in mind that if it is not global you can NOT call it from other UC files).

}

Placeholders {
PlaceHolders are default "variables" you can use in your code. Since you can not use methods inside of other methods (yet), they have been added and will be replaced with their value.
To call a placeholder this is the syntax: "{placeholder}". A list of the placeholders follows.

coreVersion - returns the version of the Core in use.
fileName - returns the name of the file.
requestedFileName - returns the name of the requested file.
clientAddress - returns the address of the client.
clientPort - returns the port of the client.
localAddress - returns the local address.
localPort - returns the local port.
onlinePlayers - returns the number of the online players.
maxPlayers - returns the number of the max players that can join the server.
serverName - returns the name of the server (the one set in the server.properties).
motd - returns the motd of the server (the one in the server.properties).
serverVersion - returns the Minecraft version of the server.
bukkitVersion - returns the version of Bukkit the server is running.
serverAddress - returns the address of the server (the one in the server.properties).
serverPort - returns the port the server is running on.
}

}


The ConfigsManager class has been renamed to ConfigManager.

The UltraCode has been totally rewritten, and a Tokenizer has been added.

The syntax has also been changed. Now, all the parameters in a method MUST be inside of double quotes.


A known issue is that you can't write more than one method PER LINE. And that the uc open and close tag ("<uc>" and "</uc>") can NOT be in the same line of the method, so no way to make the code
compact, or fit in just one line. For now


Some of the existing methods' structure has been modified. And some new has been implemented. Here following, the list of all the methods!




+ = added
- = removed
* = modified
| = same as the older version.

The package name has been changed from it.ultracore.* to shop.ultracore.*

- Removed the String index from the WebServer Class Builder.

A new "programming language" has been added to the WebServer, since PHP is not an option
This "programming language" as now comprehends this "methods":
The code must be inside of the tags "<uc>" and "</uc>". And the begin and end tags must be on different lines.
Also, the file name must end with ".uc" instead of ".html". The Strings also mustn't be inside of the quotes (""), example:


* Other minor changes.

* Other minor things

IMPORTANT bug fixes:

The PlayersManager and the EventsManager have been updated. Now you can set custom infos on the player join. (And more things you couldn't do before, because the CorePlayer object didn't get updated).

// Click on the update title for more.

* CorePlayer




Minor bug fixes

* Config Object
  * The method #addDefault(String path, Object value, Type type) is now deprecated. It is going to be removed in the next version.
  + Added the method #addDefault(String path, String value)
  + Added the method #addDefault(String path, int value)
  + Added the method #addDefault(String path, boolean value)
  + Added the method #addDefault(String path, float value)
  + Added the method #addDefault(String path, double value)
  + Added the method #addDefault(String path, World value)
  + Added the method #addDefault(String path, Location value)

Attention: Please update your code, since in the next versions the #addDefault() how you know it is not going to be there anymore!


* Other minor changes

+ Blocks class
 + #isStairs(Block block) - returns whether the Block block is stairs or not
 + #isSlab(Block block) - returns whether the Block block is slab or not
 + #isFence(Block block) - returns whether the Block block is a fence or not
 + #isPlate(Block block) - returns whether the Block block is a plate or not

* CorePlayer
 + #getYaw() - returns the yaw of the player (from it's location)
 + #getPitch() - returns the pitch of the player (from it's location)
 + #getDirection() - returns the Vector direction of the player (from it's location)
 + #getPlayerFacing() - returns the facing direction as enum FacingType.* (where * could be NORTH, SOUTH, EAST, WEST, north, south, east, west).
 + #getBlockBehindPlayer() - returns the block behind of the player
 + #getBlockBehindPlayerGround() - returns the block behind the player under his feet
 + #getBlockInFrontOfPlayer() - returns the block in front of the player
 + #getBlockInFrontOfPlayerGround() - returns the block in front of the player under his feet
 * renamed #getBlockUnder() to #getBlockUnderPlayer()
 * renamed #getBlockAbove() to #getBlockAbovePlayer()

* CorePlayer Object
+ Added the method #getBlockAbove(), it's gonna return the block above the player
+ Added the method #getBlockUnder(), it's gonna return the block under the player
+ Added the method #playSound(Location location, Sound sound, float volume, float pitch).


* Other minor things

I noticed, thanks to the user yorik100, that I uploaded an old version of the Core, which gave problems with the plugin ChatPing.
This is the actual latest version, and doesn't bring any actual update of the Core.

+ Added the event AsyncPlayerChatEvent (onChatPlayer(AsyncPlayerChatEvent event, CorePlayer player)) to the PlayerEvents class.


* All of the events, besides the onChatPlayer one, have been deprecated. Since the Event and the Player are going to be switched (actual syntax: event(CorePlayer player, Event event), new syntax: event(Event event, CorePlayer player)).

* CorePlayer
+ Added the #setHealth(int health) method. (Sets the player's health to the param health)
+ Added the #heal() method. (Sets the player's health to 20)


* The Core PlayersManager is not static anymore. To access it you should use it.ultracore.core.Main.getPlugin(it.ultracore.core.Main.getClass).whatYouNeed. For example, for the PlayersManager the code would be:
it.ultracore.core.Main.getPlugin(it.ultracore.core.Main.getClass).playersManager;

* Config Class
+ Use instanceof check when you generate a config

* MySQL Class
+ Removed the Output line "ID: " + table when you get a value from a database (it was for debugging purposes only)

Minor bug fixes and adds

* CommandManager
* Fixed the bug when you typed "/" in chat, it executed all the registered commands


* other not-so-important bug fixes

* MySQL class
+ Fixed the error "Before start of result set" when using the get method.

* MySQL
+ Added get method with String as query parameter, instead of Query. This way you can do more things, but you won't be able to use the statement.set(#) method (for replace the question mark (?) with a value). This is gonna be implemented in the API soon.

IMPORTANT: When you use the get() method, it's gonna open a connection to the MySQL database. Remember to close it as soon as you finish using the Result of the get(). (Not before, else you won't be able to use the ResultSet coming from Result, since the connection is closed.)

+ Added MySQL support
+ Created the MySQL Object
+ Created openConnection method
+ Created closeConnection method
+ Created get method (For now no Javadocs, coming soon. Also, for now you can only use one "WHERE", there is no "AND".)
+ Created Query object.
+ Created ConnectionInfo object (Required to create the MySQL object)
+ Created Result object (is the result that the get method is gonna return)
+ Created Value object (it's the input for the get method, since it doesn't use a query string too yet).

P.S. the get methods doesn't use a direct query string. It requires a Query object (introduced by the API)
Soon the get with a plain String will be implemented

+ Added Website class (must be accessed in a static way).
+ Added getContet(String url) method. This will return the content of a website


+ Added Shortener class (must be accessed in a static way).
+ Added TinyURL shortener. Example: Shortener.tinyURL(" https://google.com") <-- This will return the shortened URL for Google

+ Inventory Manager
+ Inventory Object

* CorePlayer Object
+ Added openInventory(Inventory inventory) method. (Bukkit inventory)

+ PayPal Link Generator (Accessed in a static way, PayPal.generateLink(String email, String currency, double price, String itemName)

* PlayerEvents
* The methods are now non-abstract anymore. This means you don't have to Override all the methods, but can Override only the ones you need or want to.

+ Multi Language
+ Added a Language Manager
+ Added a Language Object

- Per-Player Configs
- Completely removed
+ Re-created, now the per-player config only contains the player's language

- IP Check

*/- minor bug fixes, adds and removes

* CorePlayer
+ Almost all the class now has Javadocs.
+ #getPingDifference(Player corePlayer) (BETA, not tested yet.), this gets the ping difference between the player and corePlayer.

* Scheduler Manager
+ Added Javadocs to all the methods

+ Schedulers Manager
+ Can register an asyncRepeatedTask
+ Can delete a scheduler by the ID

* CorePlayer Object
+ Added launchProjectile method, that will make the player throw an arrow
+ Added the showPlayer and hidePlayer methods

* Player Events Manager
+ Added the Player Interact Event
+ Added the Player Move Event

* minor bug fixes and minor adds

+ Added JavaDocs to almost half of the CorePlayer class
+ Added #getWorld() to the CorePlayer object.

* Minor bug fixes and changes

* CorePlayer object
+ Added the #getLocation(), #teleport(#player), #teleport(#corePlayer), #teleport(#entity) methods.

* Bug fixes in the per-player configs

+ Adds in the CorePlayer object
+ Added titles, subtitles and action-bar messages methods.

+ Adds in the PlayerEvents:
+ onPlayerDeath
+ onItemPickup
+ onItemDrop

+ Added schedulers
+ With the Schedulers class you can create async repeated schedulers and cancel them through their ID.
# More coming soon

* Some other bug fixes

+ Config file

+ Per player config
If the setting per_player_config is set to true in the config, when a player joins a config file gets generated for him, inside the folder player in the plugin's directory.
What's inside of it is defined in the config.yml with the following syntax:
(value_type is the type, for example int. There are placeholders too for the value!)

(More examples are in the config.yml)
The player's config gets updated every time the player joins.

+ Place holders for the "value" in the per-player configs

+ The PlayerJoinEvent and the PlayerQuitEvent are now passed in the method too.

+ Added listeners for the player's Join and Quit
+ Added an address check with his relative configs.