3DItems
No dependencies required.
No item mechanics changed (optional).
No game play interference.
No Duplication glitches
How it works:
Items are disguised as armor stands holding the specific item. Because of this, server-side performance issues with this plugin are minimized. Items are not changed in any way in terms of mechanics (server-side), unless the “manual-pickup” parameter is enabled in the config. Which means the items will still behave as they normally would. That is to say, item physics are still the same (falling and water flow), interactions with blocks such as hoppers and interactions with entities such as mobs and players are unaffected.
The armor stands are completely client-side using play-out packets; therefore, they don’t actually exist in the server, and no duplication glitches are possible. The armor stands are offset depending on the location of the held item relative to the actual location of the item itself in order to display the 3D item where the item really is. This took a LOT of intensive calibration.
The armor stands will
not interfere with any game play, players cannot right-click or left-click them (optional). The armor stands will
not prevent players from placing blocks either.
Commands:
/itemsreload
– Reloads the config.
/toggle3ditems
– Toggles the 3DItems effects for the user
Permissions:
3ditems.command.reload
– For using /itemsreload
3ditems.command.toggle
– For using /toggle3ditems
3ditems.bypass
– Disables the effect for players who have this permission.
Note that the 'use-bypass-permission' option must be set to 'true' in the config for this to work
3ditems.pickup.right
- Permission to pickup items by right-clicking them
(Only when "use-manual-pickup" is enabled)
3ditems.pickup.left
- Permission to pickup items by left-clicking them
(Only when "use-manual-pickup" is enabled)
3ditems.pickup.normal
- Permission to pickup items normally (standing on them)
(Only when "use-manual-pickup" is enabled)
Config:
Code (Text):
#Use /itemsreload for changes to take effect
#Should this plugin change the appearance of items?
enabled: true
#Max amount of items that can be be visible as 3D
max-visible-items: 20
#When enabled, players that have the permission 3ditems.bypass will see items normally
use-bypass-permission: false
#Item appearances will not be changed in these worlds
disabled-worlds:
- world1
- world2
#Smooth animation for when items spawn
use-smooth-landing: true
#When enabled, items will be luminescent which will prevent items from becoming dark
luminescent-items: false
#WARNING: This option changes the picking up mechanics of items!!!!!
#When enabled, players will need to have the following permissions to pick up items:
# 3ditems.pickup.right - permission to pickup items by right-clicking them
# 3ditems.pickup.left - permission to pickup items by left-clicking them
# 3ditems.pickup.normal - permission to pickup items normally (standing on them)
use-manual-pickup: false
Known Glitches:
- 3D items in water tend to ‘jump up’ before returning back down. This is because the items are being ‘refreshed’ which resets the offset of the armor stands.
- Weapons and tools may ‘darken’ when thrown into a corner of a wall (Can be resolved by enabling "luminescent-items" in config)
Note: some items are not properly oriented. These will be fixed soon
This plugin may NOT work for players joining with versions before 1.16 through ViaVersion