RentingCraft
THIS PLUGIN IS STILL BEING DEVELOPED. ANY IDEAS ARE WELCOME
What is RentingCraft
Always had the feeling like you found some diamond ore and you wished you could rent someones pickaxe with the looting enchantment? Well then RentingCraft will help you. RentingCraft is a plugin that adds a system to rent your tools, armor or other stuff with usages to other players and get paid for it.
This plugin requires Vault. Click here to download Vault
Commands
- /rent: use this to open the rent gui and find tools or other stuff you can rent.
permission: RC.rent
- /offer: use this to add one of your tools to the renting system.
permission: RC.offer
- /price: use this to set a price after running /offer.
permission: RC.offer
- /myoffer: use this to see what offers you are running and stop offers.
permission: RC.offer
Possibilities
- Server owners can decide what items can be rented.
- Server owners can decide what language the plugins uses if supported (translations needed).
- Uses the Essentials economy system as economy base.
- People who rent stuff can decide the price.
- You can rent per usage and pay per usage.
- Stuff can only be rented by one player at the same time.
- Saves Enchantments.
- Saves durability.
- Rented items cannot be dropped, moved out of inventory and will stay in the inventory after death
- more to come soon.
Installation
- Download the plugin jar on the side and place it in the plugin folder of your server.
- Make sure Vault and a supported Economy plugin are also installed on the server!
- Reload or restart the server
- Setup all the files as explained bellow
- Do a reload/restart again
- Plugin ready to be used
Files
config.yml
This file stores all the basic settings. At the moment it is a very short list
- Settings.Enabled: if this is set to true the plugin will be enabled and users can run the command. if set to false the plugin will load but players cannot run any commands.
- Settings.Language: This tells the plugin what language file to use. More info in the language part.
- Settings.AutoPrice: This is the price the plugin uses as automatic price when a player adds a tool but doesn't set a price.
- Settings.Currency: This is the currency symbol the plugin needs to use. (Preffered to be the same as the essentials settings).
Tools.yml
This file contains a list of all the items supported by the plugin. You will see that default all items are set to true. If you set the value to false players cannot rent/offer these items on the server. !! Don't delete any line because this will break the plugin. If you accidentally did this delete the file and restart/reload the server and the plugin will restore the default file !!
Players.yml
This file will save the most important part of the plugin. You have two main sections and an info section:
- Info section: This will just store the next ID the plugin has to take when someone adds a new offer
- Tools section: This will store all the offers and the needed info ordered by the type of item.
- Players section: This will save all the ID + Type of item a player is offering
Messages_§§.yml
These are all the language files the plugin supports. To say the plugin what file to use you have to set Settings.Language in the config.yml file to the two letters indicated after the "_". For example you want to use the English language file called Messages_EN.yml you have to set Settings.Language to "EN". If you set this wrong or a to a language that doesn't exist the plugin will load the English file.
GUI's
The plugin is made as easy as possible although it is a very complicated system. I used as much GUI's as I could to make it as easy as possible for the players to use the plugin.
Offer GUI
HOW TO OPEN: By running the command /offer
PURPOSE: GUI to let the player select the item he wants to offer by placing the item in the free slot in the top inventory.
ITEMS:
- EYE_OF_ENDER: This item has to be clicked to confirm the offer.
- STAINED_GLASS_PANE: Just to fill the slots so the player places the item he wants to offer in the correct slot.
- COMPASS: This item has to be clicked to close the menu.
SetPrice GUI
HOW TO OPEN: By running the command /price
PURPOSE: GUI to let the player set the price for the item he just offered.
ITEMS:
- FIRST SLOT: Item that the player just offered and is setting the price of
- GOLD: This item displays the current price for the item
- EMERALD: This item adds 1 to the price of the item
- EMERALD_BLOCK: This item adds 5 to the price of the item
- REDSTONE: This item removes 1 from the price of the item
- REDSTONE_BLOCK: This item removes 5 from the price of the item
- COMPASS: This item has to be clicked to close the menu.
SelectTool GUI
HOW TO OPEN: By running the command /rent
PURPOSE: GUI that show all the items that can be rented/offered on the server
ITEMS:
- FIRST 45 SLOTS: Item that can be offered/rented on the server. By clicking one the player will see all available items of that kind.
- COMPASS: This item has to be clicked to close the menu.
- PAPER: This item has to be clicked to view next/previous page.
RentTool GUI
EXAMPLE OF DIAMOND_SWORD!
HOW TO OPEN: By clicking an item in the ToolSelect GUI
PURPOSE: GUI that show all the available items for the item the player just clicked
ITEMS:
- FIRST 45 SLOTS: Items available of that kind. By clicking a player chooses that item to rent.
- GOLD_INGOT: Show the amount of money a player has.
- COMPASS: This item has to be clicked to close the menu.
- PAPER: This item has to be clicked to view next/previous page.
AmountUsesSelect GUI
EXAMPLE OF DIAMOND_SWORD!
HOW TO OPEN: By clicking an item in the RentTool GUI
PURPOSE: GUI that allows player to choose amount of uses he wants to rent the item for.
ITEMS:
- FIFTH SLOT: Item the player wants to rent.
- FIRST GOLD_INGOT: Show the current price of the item
- SECOND GOLD_INGOT: Show the amount of money a player has.
- EMERALD: Adds 1 use to the amount of uses.
- EMERALD_BLOCK: Adds 5 uses to the amount of uses.
- ENCHANTED_BOOK: Show the amount of uses.
- REDSTONE: Removes 1 use of the amount of uses.
- REDSTONE_BLOCK: Removes 5 uses of the amount of uses.
- EYE_OF_ENDER: Confirms the rent
- COMPASS: This item has to be clicked to close the menu.
MyTools GUI
EXAMPLE AFTER OFFERING A LOT OF ITEMS
HOW TO OPEN: By running the command /myoffer
PURPOSE: GUI that show all the items a player is offering.
ITEMS:
- FIRST 45 SLOTS: Item that a player is offering. By clicking one the player can stop offering that item.
- COMPASS: This item has to be clicked to close the menu.
- PAPER: This item has to be clicked to view next/previous page.
StopOffer GUI
EXAMPLE OF A DIAMOND SWORD
HOW TO OPEN: By clicking an item in the MyTools GUI
PURPOSE: GUI that show all the items a player is offering.
ITEMS:
- EYE_OF_ENDER: Item to confirm to stop the offer
- FIFTH SLOT: Item the player is going to stop offering
- PLAYER_HEAD: Will only be visible if that item is in rent by an other player.
- COMPASS: This item has to be clicked to close the menu.
Supported Languages
- English
- Dutch
Do you want me to help by translating the messages to other languages? Feel free to contact me!
BUGS
Durability bug on armor and some items.When the last use of an item is used it sometimes doesn't drop the blocks.- If you find more bugs make a ticket and explain the bug. (print screens can be helpful).
Ideas
Do you have more ideas for the plugin? Well feel free to post below, PM me or mail me at: [email protected]
Metrics
This plugin utilises Hidendra's plugin metrics system, which means that the following information is collected and sent to mcstats.org:
- A unique identifier
- The server's version of Java
- Whether the server is in offline or online mode
- The plugin's version
- The server's version
- The OS version/name and architecture
- The core count for the CPU
- The number of players online
- The Metrics version
> Opting out of this service can be done by editing plugins/Plugin Metrics/config.yml and changing opt-out to true.
Tutorial videos
LtJim007:
@ExiLyOCraftYT
Hey,
Sorry for the late response. That would be awesome to have a video on the plugin. If you make it make sure to send me a link and I'll place a link in the descriptions.
Also if you ever translate the plugin to spanish make sure to send me the translation and I'll add it to the plugin.
@huntershenep
Hey,
Sorry for the late respone but have been very busy the past weeks. Try version 1.1.1 or version 1.1.1 2nd once bukkit releases them and see if you still get the errors.
Message in Spanish
hola buenas. Soy español y no hablo mucho ingles, ya que me gusta tu plugin lo quiero subir a mi canal, por si quieres poner en la pagina el video para que se haga mas conocido. Mi canal https://www.youtube.com/channel/UCt84xds7YUv79xgmpaqKg_A
Message in English
hello good. I am Spanish and I do not speak much English, since I like your plugin I want to upload to my channel if you want to put on the page the video so that it becomes better known. my channel https://www.youtube.com/channel/UCt84xds7YUv79xgmpaqKg_A
Getting lots of errors. First was when I typed /offer, put in a diamond Pickaxe, clicked confirm. Typed /price 20, error. Found out this was the wrong usage. So I typed /price.. Nothing. Put in a new diamond pickaxe without enchantments.. Typed /price .. Set it to $20 .. There's no confirm button so I just went ahead and exited the dialogue. Typed /rent, clicked pickaxe http://puu.sh/goiyI/a8b918f63c.png
--- Okay so I've narrowed it down. It's enchanted items only!