ItemRecycler 1.4.5
Recycle/uncraft the items you don't need.
(Plugin created by NickDEV, maintained by Ultimate_Hand)
ItemRecycler is a light-weight plugin for recycling/uncrafting unwanted items. It's extremely easy to use. Recommended for semi-vanilla, survival servers. It supports the recyclement of more than 150 items, and it has 2 types of anti-duplication security. The plugin is also very customizable. You can change all the messages and edit the GUIs. You can also recycle worn items and the plugin will automatically calculate the outcome. The plugin supports permission based success-rate (donators can have a higher chance of success). You can also change the % of the returned ingredients. The recycler block can also be spawned or crafted and then right-clicked.
Here's a quick preview of how it works:
a) Simple recyclement
b) A bit more complex recyclement
Recycler block is a skull/block that can be either spawned or crafted. When you right-click the recycler block the recycler opens if you have the sufficient permissions. You can also change the skull's texture if you don't like the default one.
The recycler can also be crafted, using the following recipe:
(This feature is disabled by default, in order to enable it set recycler-block.craftable to true)
How to create a Recycler Sign:
On the first line of the sign, type [Recycler].
When you right-click the sign, the Recycler GUI will open.
On the first line of the sign, type [Recycler].
When you right-click the sign, the Recycler GUI will open.
/itemrecycler - Default plugin command.
/recycler | <player> - Opens the recycler or opens the recycler to the specified player.
/recycler get - Gives you the recycler block.
/recycler give <player> - Gives a recycler block to the specified player.
/recycler reload - Reload plugin
You can also use the following aliases for the recycler command:
recycle, rec, uncraft
itemrecycler.open - Allows you to open the Recycler GUI.
itemrecycler.open.other - Allows you to open Recycler GUI to other players.
itemrecycler.give - Allows you to spawn a recycler block.
itemrecycler.give.other: Allows you to spawn a recycler block in target's inventory.
itemrecycler.block.interact - Allows you to right-click the recycler block to open the recycler.
itemrecycler.reload - Allows use of the /recycler reload command
itemrecycler.successrate.%team% - Sets the success rate percentage for the specified team. Each team can have a different success rate depending on this permission.
itemrecycler.admin - Allows the player to use command tab completion.
If you want to grant player all the plugin's permissions use:
itemrecycler.*
If you want to use colors in the config use &<number>
Example: &cThis text is going to be light red.
If you need help with color formatting use this site:
There are 4 config files:
- config.yml (General configuration: language, security, success-rate, gui)
- blocked-items.yml (Allows you to block items from being recycled)
- allowed-items.yml (Allows you to add items to be recycled)
- locations.yml (Keeps all the recycler block locations)
In messages you can use chat colors as described above. The plugin also uses Materials if you want to allowed/block an item from being recycled. List of all the materials can be found here:
There are also multiple types of one material for example MINECART (MINECART, STORAGE_MINECART, POWERED_MINECART, EXPLOSIVE_MINECART, HOPPER_MINECART)
You can even enchant the items in the GUI by setting:
enchanted: true
config.yml
# _____ _____ _ __ ____
# |_ _| __ \ | | /_ | |___ \
# | | | |__) |___ ___ _ _ ___| | ___ _ __ __ _| | __) |
# | | | _ // _ \/ __| | | |/ __| |/ _ \ '__| \ \ / / | |__ <
# _| |_| | \ \ __/ (__| |_| | (__| | __/ | \ V /| |_ ___) |
# |_____|_| \_\___|\___|\__, |\___|_|\___|_| \_/ |_(_)____/
# __/ |
# Recycle/uncraft the items that you don't need.
# Coded by duplxey
#
# |-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-|
# | Thanks for purchasing the plugin. If you find any bugs or |
# | have any questions, please send me a PM on spigot. Enjoy! |
# |-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-*-|
#
# -------------------------------------------------------------
# Introduction to config
# -------------------------------------------------------------
# Colors:
# You can use chat colors in the messages, with symbol &.
# target-message: "&cThis message will be red."
# (All the chat colors are listed here: https://tinyurl.com/mcc-colors)
# -------------------------------------------------------------
# Plugin's prefix
# prefix - will be used in the messages
prefix: "&c[ItemRecycler] "
# -------------------------------------------------------------
# Security
# -------------------------------------------------------------
security:
# Anti-duplication
# Protect your server from users duplicating items. There can only be one anti-duplication
# security running at a time.
#
# Types:
# - ALLOWED_LIST (only allows the items in allowed-items.yml.yml to be recycled) (High security)
# - BLOCKED_LIST (blocks items in blocked-items.yml from being recycled) (Medium security)
# - NONE (means that security is disabled) !!! HIGHLY UNRECOMMENDED !!!
duplication: ALLOWED_LIST
# Non-allowed notification
# Send a message to the player when an item is either blocked or not allowed.
notify-player: false
# Durability
# Make items recycable/non-recycable depending on items's durability.
#
# Types:
# - ONLY_NON_USED (allows users to recycle only non-used items)
# - SMART_DURABILITY (calculates outcome)
# - NONE (ignores durability)
durability: SMART_DURABILITY
# Rounding
#
# Types:
# - NICE (still returns all the components if an item is on 85% or more)
# - HARSH (uses smart durability if an item is on less than 85%)
rounding: HARSH
# Enchantments
# If false, enchanted items will not be recycled.
enchanted: true
# Custom names
# If false, items with custom names will not be recycled.
custom-named: true
# -------------------------------------------------------------
# Misc
# -------------------------------------------------------------
# Success rate
# Enables success rate depending on the player's permission. If the player has permission
# itemrecycler.successrate.team1 <- he has 50% chance of the recyclement to be successful
# itemrecycler.successrate.team2 <- he has 25% chance of the recyclement to be successful
#
# In case player doesn't have any successrate permission, this function will be ignored
# for that player.
#
# You can add more teams. The teams don't need to be named teamX, you can make
# custom names like vip, pro, master or something like that. The permission would then
# be itemrecycler.successrate.vip
success-rate:
enable: false
# Result
#
# Types:
# - RETURN (returns the items back to the player when the recyclement fails)
# - DELETE (delete's the player's items when the recyclement fails)
type: RETURN
permissions:
# Permission syntax is: itemrecycler.successrate.%name%
team1: 50
team2: 25
# Success out
# Determines what % of the ingredients are returned.
success-out:
enable: false
percentage: 50
# -------------------------------------------------------------
# GUI
# -------------------------------------------------------------
gui:
input:
name: "Recycler | Input"
size: 27
buttons:
confirm:
material: GREEN_WOOL
data: 13
amount: 1
meta:
name: "&aConfirm"
lore:
- "&7Click to recycle the items."
cancel:
material: RED_WOOL
data: 14
amount: 1
meta:
name: "&cCancel"
lore:
- "&7Click to cancel the recyclement."
output:
name: "Recycler | Output"
size: 54
buttons:
recycleAgain:
material: ORANGE_WOOL
data: 1
amount: 1
meta:
name: "&6Recycle again"
lore:
- "&7Click to to recycle again."
disable-recycle-again: false
# -------------------------------------------------------------
# Sound
# -------------------------------------------------------------
# Sound settings
# enable - Enables sounds.
# List of all the sounds can be found here: https://www.spigotmc.org/wiki/cc-sounds-list/
# WARNING: If you're running Spigot under 1.9, change the sounds accordingly!!
sound:
enable: true
action:
# open - Sound that is played when recycler is opened.
# close - Sound that is played when recycler is closed.
# success - Sound that is played on successful recyclement.
# fail - Sound that is played on failed/cancelled recyclement.
open: BLOCK_CHEST_OPEN # 1.8: CHEST_OPEN
close: BLOCK_CHEST_CLOSE # 1.8: CHEST_CLOSE
success: BLOCK_NOTE_BLOCK_PLING # 1.8: NOTE_PLING
fail: BLOCK_NOTE_BLOCK_BASS # 1.8: NOTE_BASS
# -------------------------------------------------------------
# Recycler block
# -------------------------------------------------------------
recycler-block:
# enable - Allows you to open the recycler with right-clicking on the recycler block.
# texture - Represents the head's texture (textures can be found here: https://minecraft-heads.com/custom/heads).
# craftable - Allows the players to craft the recycler block. Recipe:
# PPP P = plank C = coal
# PFP F = furnace
# ICI I = iron ingot
enable: true
texture: eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMTgxMTkxN2M2NDRmMDRmNTZiNjhjOWM3MWIzM2FjMDgyYzI2MDFjMjQ0MDliZTc4YzIwNjNkNGRmMmE4NjUyNSJ9fX0=
craftable: true
signs:
recycler:
first_line: "&a[Recycler]"
second_line: "&fRight Click"
third_line: ""
fourth_line: ""
If you find any bugs please report them as soon as possible. Don't report them in the comment/review section, because I won't respond to bug reports there. Instead report them on our discord: https://discord.gg/kvBdgP2. We'll do our best to resolve the issues as soon as possible!
We can improve the plugin together contact me and send me your ideas. If the idea is good it will be added in the new version.
- German language support
- + Your ideas
Do you have any problems, questions or suggestions? Feel free to join my discord server.
Terms of Service
By using this plugin, you agree to the following terms, which may be updated by the author at any time.
- All payments are final and non-refundable.
- Redistribution or resale of this plugin is prohibited.
- You are not permitted to modify, decompile, or extract any part of the plugin's source code.
- Support is provided exclusively to legitimate customers. We cannot offer support for plugins obtained through unauthorized or illegal means.
