NyaaUtils | A bunch of useful features

NyaaUtils is the gaming utilities/helpers used in NyaaCat Minecraft Server.

This plugin add a lot of small but useful and extensive/customized features to your server. It's a bit geeky style, many functions can be used only via command. But it's quite convenient, if you have used to it.

Please note this plugin is originally designed just for our server. Suggestions and bug reports are welcome, but we may not accept new feature request according to our server policy.

Source code hosted on GitHub, and published under MIT license.

===== Installation =====

Make sure you are using spigot, NyaaUtils can't be used on Bukkit or other server software.

1. Install dependencies (you should have most of them already)
   • Latest version of Essentials, or EssentialsX
   • Latest version of LuckPerms, GroupManager or PEX
   • Vault > 1.6.6
   • WorldEdit
   • LangUtils -> Download here
   • NyaaCore -> Download here
2. Install the latest version of NyaaUtils, find the download here.
3. Stop, and start your server. reload command will not work.

===== Configuration =====

Edit NyaaUtils/config.yml as your needs, then type "/nu reload" in game or console.

To customize/translate messages:

1. Make a copy of en_US.yml and save as your language, e.g., zh_CN.yml or ja_JP.yml
2. Edit in the new file, you may use section sign "§" to use formatting codes. Please make sure your file is in valid YAML format or the plugin will crash.
3. Edit config.yml and set the "language" value to your filename, e.g., if you saved as ja_JP.yml then set this value to "ja_JP", and type "/nu reload" in game or console.

===== Functions and Usage =====

There're a lot of functions, and each one have its own config section, permission, usage and can be enabled/disabled separately. Please go through the documentation carefully.

• Access Control List - ACL is to block certain item from being enchanted or repaired using /nu enchant or /nu repair command.
• Command Receiver and Language file - For developers to use this plugin API or general players to type command correctly, like how to insert space in arguments.
• Attack Stats - Record the K/A stats for a player, used for internal functions and can be invoked by other plugins.
• Elytra Enhance - Unlimited elytra gliding with fuel item, plus fuel and elytra durability notifications.
• Elytra Launcher - Make airports! Launch players into sky and open elytra automatically then boost! Jets taking off!
• Enchantment - Special customized Enchant books now get more RPG-like. Specify enchantment and level, with 4 result possibilities all customizable.
• Experience Capsule - Let players store their exp in an item and restore or trade later.
  
• Formatting Codes -
  Are you still searching for hard-to-remember formatting codes on Minecraft Wiki every time you need it? Simply type "/nu format" then go. No configuration needed.
• Item show - Just a simple show command to allow the server check out your new findings.
• Loot Protection - Protect mob loots for real fighters. Control mob loot goes to the last killer or the most damage dealt player's inventory, or his ender chest.
• Mailbox - Just another mailbox function but with full functionality. Send item in hand, or send a chest. Handling fees can be customized in configuration. Even with LockettePro support.
• Museum Exhibition - Protect and lock item frames from bears. No one can steal your item from locked item frame, but only read information stored in it.
• Particle - Want some particles when gliding with elytra, shooting arrows and snowballs, or even with you all the time? Here's the solution, and highly customizable for all.
• Prefix and Suffix - Let players set their prefix and suffixes on their own. Reduce admin works. Allowed formatting codes, word blacklist and costs can be customized.
• Project - Launch player fast! This is the launcher dedicated from Elytra Launcher and does not require an elytra worn. Often used in minigames or custom maps.
• Realm notification - Set a region on-screen title to let others know where they have entered, in a RPG-ive style.
• Rename and Lore - You don't need another rename plugin. Renaming items, set lore, sign books, all in one with costs customizable.
• Repair - Enhanced Repair allows you to repair item without anvil, and with different materials and costs.
• SignEdit - Yet another SignEdit plugin, but with different implementation.
• Teleport - Tired of flat-fee for home/back/spawn? This function calculates teleport fee based on distance.
• Timer - Making racing games now easier with timer function.
• Mention - Mention and notify other players with customizable sounds and on-screen title displays in chat.

This plugin can be integrated easily with other plugins, like RPGitem, or HamsterEcoHelper (a multi-function signshop/global shop/system balance/auction and requisition plugin, find it on GitHub).

We are continuing to add more functions in this plugin, check back often or reach our developers at GitHub if you have questions.