ValorlessUtils [1.18-1.21.4] icon

ValorlessUtils [1.18-1.21.4] -----

Utility library for easier plugin development.




The Translator function no longer contains language files needed to translate,
but will instead download the desired language from github, for the specific version of the server.
This not only lowers the overall ValorlessUtils file size, but also provides language files
specifically for the server's version, instead of universal file.

Once the desired language has been downloaded, it's stored in ValorlessUtils' plugin data folder for later use.
In case the download fails, a fallback en_us language file is used.

--- Other Stuff ---

Added: ValorlessUtils.GetServerVersionString(), returns the server's version as a string. (e.g. "1_21_4")

Fixed: ValorlessUtils.GetServerVersion() now correctly returns the server version.

Commit: c5f0f5a
----------, Apr 6, 2025

Fixed: An error when playing sounds.
----------, Mar 6, 2025

Added: ItemUtils.GetItemModel() & ItemUtils.SetItemModel().

Changed: The native version of the plugin has been changed from 1.21-R0.1 to 1.21.4-R0.1

Changed: Updated language files for 1.21.4.
----------, Mar 1, 2025

Added: Failsafe for HavenBags.
Should HavenBags for what ever reason be disabled or removed.
This failsafe will prevent bags from being placed, so long as a valid HavenBags config file is found.

Fixed: Language files are now replaced when loaded, so old files don't remain and cause errors.

Commit: 4c7e952
----------, Feb 26, 2025

Updated internal libraries to support 1.21.4.
----------, Dec 17, 2024

Changed: The api version of the plugin has been changed 1.21-R0.1 instead of 1.19.4-R0.1.

Changed: Tags has yet again been marked as Deprecated, but a new class was added in its place under valorless.valorlessutils.tags.Tags.

Added: ItemUtils - Utility class to get certain ItemMeta values on versions < 1.20.5.
Remember that the server still has to run 1.20.5+ in order to use these utils, but the plugin calling them does not.
----------, Nov 29, 2024

Updated internal libraries to their latest updates, which should support 1.21.1-1.21.3
----------, Nov 3, 2024

Added: If a config file is found invalid, the file will now be backed up before getting reset!
Code (Text):
[02:22:15 ERROR]: [ValorlessUtils] Invalid plugins\HavenArena\config.yml detected. Creating a backup and resetting to default.
[02:22:15 ERROR]: [ValorlessUtils] org.bukkit.configuration.InvalidConfigurationException: while scanning a quoted scalar
in 'reader', line 59, column 12:
      formula: '(%wave% + 1.5) * %players%''
               ^
found unexpected end of stream
in 'reader', line 92, column 1:

    ^

[02:22:15 INFO]: [ValorlessUtils] Backup created: config.yml_2024-10-03_02-22-15.yml

Changed: Config validation will no longer spam with "Config value 'XXXX' is missing, fixing.", and will instead say "New or missing config values have been added." when done.

Changed: Config validation will no longer say "Validating Config", and will instead say "Validating %file%".
%file% being like config.yml or lang.yml.
----------, Oct 3, 2024

Fixed: The following error:
Code (Text):
[ValorlessUtils] Failed to resolve server version, some functions might not work correctly.
Fixed: Forgot to update language files.
----------, Aug 21, 2024

Added: 1.21.1 Support.

Changed: ValorlessUtils.Tags are no longer marked deprecated.

Fixed: Utils.Chance() no longer returns errors, and should work correctly.
----------, Aug 21, 2024

Added: 1.21 Support.

Changed: NBT data is handled differently.
No need to perform changes, as it's still used the same way.
----------, Jun 28, 2024

Added: NBT.SetStringList(ItemStack item, String key, List<String> value) & NBT.GetStringList(ItemStack item, String key)
The string list is saved as a single string on the item.
The symbol
'◊' is used to section the different strings from each other.
----------, May 12, 2024

Added: Support for Minecraft 1.17.
This is still very early, and may contain errors.

Added: SFX can now be played at a location.
Code (Text):
SFX.Play(String sound, float volume, float pitch, Location location);
Changed: SFX.Play() now shows a different message, when the sound doesn't exist.
----------, Apr 23, 2024

Added: You can set the amount of an ingredient required for shapeless recipes.

Fixed: Shapeless recipes work again.
----------, Mar 9, 2024

Added language ' pl_pl' "Polish"
----------, Mar 3, 2024

Added language ' en_pt' "Pirate Speak"

Added package ' valorless.valorlessutils.text'
Added ' TextFeatures' in the package, with the following functions:
  • CreateBar(double progress, double total, int barLength);
    "Creates a progress bar with specified parameters."
    A duplicate function with additional parameters exists.
  • LimitCharacters(String text, int length);
    "Limits the characters in a text to a specified length."
  • LimitDecimal(String text, int length);
    "Limits the decimal places in a number to a specified length."
[​IMG]
----------, Feb 28, 2024

Permissions on recipes should now be correctly registered to the server.
----------, Feb 5, 2024

You can now use ValorlessUtils to create custom vanilla-like crafting recipes.
A more advanced system may be created in the future.
Click here to read more about it.
----------, Jan 29, 2024

Vector2 and Vector3 are now supported in valorlessutils.config.
----------, Jan 23, 2024

!! This update only provides additional functions to the plugin, and not optimizations.
!! Unless your plugin uses these functions, there is no reason to update to 1.5.1

Additonal information regarding new features, can be found on GitHub.

Added functions:
  • Utils.Clamp()
  • Utils.Clamp01()
  • Utils.Bool.FromValue()
  • Utils.Bool.ToValue()
Added variable types:
  • Vector2
  • Vector3
ValorlessUtils 1.5.1 still works with plugins using 1.5.0.
----------, Jan 5, 2024

Updated to 1.20.4.
Updated language files to 1.20.4
Updated internal dependency to 1.20.4

Added additional functions:
  • Utils.Chance(double)
  • Utils.Percent(double, double)
    Utils.Percent(float,float)
  • Utils.RandomRange(double, double)
    Utils.RandomRange(float, float)
  • Encoder.Encode(String, int)
  • Encoder.Decode(String, int)
  • SFX.Play(String, float, float, Player)
  • ValorlessUtils.bread()
ValorlessUtils 1.5.0 still works with plugins using 1.4.0.
----------, Dec 26, 2023

Updated dependency to 1.20.2.
ValorlessUtils should now work on Minecraft 1.20.2 without issues.

File size has been heavily reduces, by removing unused variables from the language files.
----------, Nov 21, 2023

This version works with plugins compatible with v1.1.1.104 and up.

ValorlessUtils can now translate items and blocks using Translation Keys.

Supported languages:
  • en_us - English (US)
  • en_gb - English
  • da_dk - Danish
  • de_de - German
  • es_es - Spanish
  • fr_fr - French
  • tr_tr - Turkish
  • nl_nl - Dutch
  • ja_jp - Japanese
  • ko_kr - Korean
  • zh_cn - Chinese (Simplified)
  • ru_ru - Russian
----------, Jun 26, 2023

Added a new extra config functions for an upgrade to HavenBags.
If you're not using HavenBags, you have no reason to update to this version.
----------, Jun 19, 2023

Added bStats to the plugin.
----------, Jun 18, 2023

Big update to ValorlessUtils in preperation for a new plugin release.
ValorlessUtils v1.2.0.123 will work with plugins using ValorlessUtils 1.1.1.104.

- Added valorless.valorlessutils.nbt
Future replacement for valorless.valorlessutils.tags

- Added valorless.valorlessutils.uuid
Another way to fetch player UUIDs or names, should Bukkit.GetPlayer() fail.
----------, Jun 12, 2023

Fixed an issue with the config validation system causing it to work incorrectly, or not at all.
Compatible with plugins using ValorlessUtils v1.1.0.96 or newer.
----------, May 24, 2023

Resource Information
Author:
----------
Total Downloads: 6,330
First Release: May 1, 2023
Last Update: Apr 6, 2025
Category: ---------------
All-Time Rating:
0 ratings
Find more info at discord.gg...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings