ItemDisplay Release v1.3

This plugin supports JRE6 and JRE7

Note: I am not going to upgrade this plugin anymore. I've started a new project I've been wanting to do for a long time, it's a 2d space shooter game, me and my friend are currently working on it, I might work on this plugin again but it's not likely. Since v1.3.1 is the lastest and most stable version i'll keep the project this way. And last but not least, thank you ALL for your cooperation.

Refer yourselves to http://dev.bukkit.org/profiles/Ryanjh5521/ for possible updates and bug fixes.

Description

This plugin allows you to put any items in your iventory over specified blocks as a display, it also allows you to place items and blocks on the ground to be picked up later. Both displays and drops don't despawn and are fire/lava proff.

Commands

/itemd - Turns itemd mode on/off
/itemd help - Shows help message
/itemd list - Shows a list of all items in a 5 block radius(spherical) around you
/itemd delete ID/(ID1 ~ ID2) - Deletes any item displays/placings that belongs to you with ID or is in range of ID1 to ID2
/itemp - Turns off item placing mode
/itemp #sec - Places an item on the ground, makes it pickable by anyone, protects the item for #sec seconds, prevents despawn and respawn if it dies by lava, fire, etc.

Usage

Using the command "/itemd" gives you the ability to create the displays, left click the block you want the item to stay above, you can click in any face of the block, note that it will alwas stay on TOP of the block you clicked. Using "/itemd" again disbales the mode. Left Clicking and sneaking with the mode enabled you will be able to remove the display.

Using the command "/itemd help" shows a help message with the commands and a brief description.

Using the command "/itemd list" shows a list with every item display/placing around you within a spherical radius of 5 blocks. It also shows the ID's wich can be used with the delete command.

Using the command "/itemd delete ID/ID1ID2" deletes any item displays/placings with ID or is in range of ID1 to ID2 . It'll give the item back if the configuration is set to true, and you won't be able to delete some displays depending on the configuration settings. OP's can always delete any displays/placings.

Using the command "/itemp #" gives you the ability to lay an item on the ground, left click the block you want the item to stay above, you can click in any face of the block, note that it will alwas stay on TOP of the block you clicked. Using "/itemp #" again sets the time protection to #. Left Clicking and sneaking with the mode enabled you will be able to remove the item.

Using the command "/itemp" deactivated the item place mode.

Permissions

• itemdisplay.forcedelete:
  • description: Gives you the permission to force displays deletion
• itemdisplay.basic:
  • description: Basic permissions to create, list and command delete displays
• itemdisplay.nodecrease:
  • description: Does not decrease item stack when placing an item
• itemdisplay.ignoredisplaylimit:
  • description: Let's you create infinite ammounts of displays
• itemdisplay.*:
  • description: Gives you all display permissions
    • default: op
    • children:
      • itemdisplay.forcedelete: true
      • itemdisplay.basic: true
      • itemdisplay.nodecrease: true
      • itemdisplay.ignoredisplaylimit: true
        

Configuration File

version

The version of the file, DO NOT CHANGE IT

decrease_item_stack_on_creation

when set to true, if player is not OP, the itemstack of the item the player is holding will be decreased by 1.

give_item_back_on_deletion

when set to true, the player will receive the item back upon deleting a display

force_public_displays

when set to true, any player can delete any display

max_player_displays

the maximum ammount of displays each player can create. OP's can create as many as they wish

block_default

when set to true, players will be able to create displays on all blocks not specified below

allow_blocks

- COBBLESTONE

- STONE

players will be able to create displays on COBBLESTONE and STONE despite the value of 'block_default'

deny_blocks

- BEDROCK

- SAND

- GRAVEL

players will NOT be able to create displays on BEDROCK, SAND and GRAVEL despite the value of 'block_default'

Notes

The displays are saved and loaded on plugin enable and disable. The items on display are not pickable and will respawn on fire death, they will also try to move to their original location if they are moved. Creating a display will not consume any items.

To Do List

1. [1.2]/itemd instead of /itemd [on/off]
2. [1.3]/itemp # instead of /itemd p #
3. [1.2]Configuration file
   1. [1.3]Allow placement only over specified blocks
   2. [In progress]Allow creation of only specified items
   3. [1.2]Whether or not to decrease the itemstack when creating the display
   4. [1.2]Whether or not to give the item back to the player
   5. [1.2]Allow or deny players to delete other player's displays
   6. [1.2]Allow or deny item pickup (it'll decrease itemstack on creation unless player is op)
   7. [1.3]Limited displays
4. [1.0]Permissions:
   1. [1.2]itemdisplay.forcedelete(You can delete any display)
   2. [1.2]itemdisplay.basic(You can create and delete your own displays)
   3. [1.2]itemdisplay.nodecrease(Your item stack does not decrease upon creating displays or placing items)
   4. [1.3]itemdisplay.ignoredisplaylimit(You can create as many displays as you want)
   5. [1.2]itemdisplay.*(Gives you all the permissions above)
5. [?]More than 1 item per block (that'll be a lot of work and thinking but it'll look awsome)
   1. [?]Chat or command the number to select the slot of the block
   2. [?]Auto-organize on item addition - create up to 9 displays in one block but if you want to remove 1 you'll have to remove all
   3. [?]Create 9 displays ontop of a block with all your inventory items
6. [1.3]Rewrite code to fix bugs, help adding new features and enhance speed
7. [1.3]List and Delete commands(single ID or range)
   
8. [?]Support for items on nether and theend

Known Bugs

Bug: On server start some items over glass/glowstone/slabs/stairs/furnaces may not appear at first

Quick fix: Type "reload" on your server console and it should be ok

Cause: Sometimes the server or the client does not draw the sprite of the item despite it being there, that is, it is there but it's not being rendered.

[FIXED]Bug: When a player activates the mode, all players are able to create display

WARNING: Closing the server inappropriately might cause the items to vanish or be able to pickup, hence duplicating it.

Latest News

20/06 - 05:06(GMT): I'm overloaded with college work, I will release v1.2 as soon as possible, maybe this weekend along with a fresh video for the plugin. Thank you all for the support!

23/06 - 02:25(GMT): Most of the features for 1.2 is already done, it took me a lot more work than what I thought it'd take. My code is really messy, I intended to use it only on my server so I'll probably rewrite it after 1.2 so I can fix the bugs more easily. This is my first plugin so it'll take a lot of getting used to API... But anyways, tomorrow 1.2 will probably be out! Again, Thanks for the support!

24/06 - 00:01(GMT): Plugin is ready! I'm just testing it with a friend on the server, should be up any time soon!

24/06 - 01:01(GMT): Plugin is ready! Just needs approval for you to download!

26/06 - 03:25(GMT): I'm currently rewriting the plugin to enhance speed, fix bugs and add more functionalities, thanks for your patience ;)

28/06 - 02:38(GMT): ItemDisplay 1.3 is out! It just needs approval, I fixed a bunch of errors and added the so much awaited /itemd delete and /itemd list commands to help you with those annoying "undeletable" displays :)

29/06 - 00:21(GMT): ItemDisplay 1.3.1 is ready, waiting approval. I fixed some bugs that allowed items to be picked up, now the plugin ensures no item will be picked no matter what!