Off Hand [Experimental] Experimental Add-on for Minecraft Bedrock Edition

# Off-Hand [Experimental]
# Created: 28/04/2023 [dd/mm/yyyy]
# Author: FoxyNoTail
# Version: 0.0.3
# Made for Minecraft Bedrock Edition 1.19.80
# For more info visit www.foxynotail.com

WHAT'S NEW IN v0.0.3
------
- Improved placement from the off-hand so that it's more reliable.
- Added some more functionality with some items.
- Added entity detection if there's an entity in the way of where you're wanting to place a block to prevent swap spamming.

Known Issues:
For this to work on touch screen devices, you need to enable the "Joystick & aim crosshair" control scheme.

WHAT'S NEW IN v0.0.2
------
Major update. The system will now momentarily swap the off-hand item into the main hand to use / place the block which means this add-on can now place all block types and use a large number of items from the off-hand.
It still cannot use items that aren't being used directly on a block from the off-hand, like rockets for flying or eating, but most items that interact with blocks can now be used.

Fixes:
- Stack sizes no longer decrease in creative mode
- Blocks can't be placed from the off-hand in adventure mode
- Shulker boxes no longer lose their contents
- Items lose durability rather than dissapearing on use
- Optimized the code for better performance
- Blocks make the correct sound on placing
- Block directions no longer needs calculating due to being placed by the main-hand momentarily
- Block variations now work due to being placed by the main-hand momentarily

Notable Issues:
- Items / blocks in the off-hand will momentarily switch to the main hand on use which will be seen visually on the hotbar as well as on the player.
- Lag may cause items / blocks to not place from the off-hand.

------
This add-on allows the player to swap items into their off-hand by "triple crouching".
Triple crouching is crouching quickly 3 times. This should swap the item in your main hand to your off hand.

- All blocks and items can be held in the off-hand.
- All off-hand blocks can be placed from the off-hand.
- The main-hand should always have priority over the off-hand.
- Food cannot be eaten from the off-hand, but most other items can be used.
- Rockets cannot be used for flight in the off-hand.
- Projectiles cannot be thrown from the off-hand.
- Tools & Weapons cannot be used in the off-hand.
- It is still not possible to manually place items into the off-hand slot that aren't able to in vanilla.
- Weapons, tools and armor with mending will mend in the off hand, so you can mend two weapons / tools at once.


README
------
EXPERIMENTAL PACK WARNING
=========================
This won't work without the "Beta APIs" Experiments Toggle selected in your world.
These experimental features should work on realms and servers if you create the world in single player first and enable the experimental features before uploading it to the realm or server.
=========================

CONFLICTS
=========
This pack should not conflict with other add-ons.

HOW TO USE
==========
1. Add this pack to your world or server.
2. Triple crouch to place your main-hand item into your off-hand
3. If your main hand is free, or your main hand item can't be used on a block, the off-hand item should be placed.

- Change Item Swap Detection
1. Rename any item to "offhand".
2. Click with the item to open a form.
3. Choose from "Triple Sneak", "Double Sneak" or Typing a "." (period) into the chat to trigger swapping items.

If you want to change the sensitivity of the sneak detection, you can use the 4th button to open a new form with a slider. Lower numbers mean you have to sneak faster, higher numbers mean you don't have to sneak as fast.

FAQ
===
Q. The block in my off-hand didn't place.
A. Is your world lagging? Also, there are a lot of mechanics this add-on tries to be aware of in order to make sure the off-hand doesn't take priority from the main hand. For example, you can't place a block from your off-hand on top of grass if you're holding a shovel in your main-hand, as the shovel is designed to turn the grass into grass path.

Q. I can't crouch fast enough to swap items
A. Turn off toggle crouch in the game settings. Or, rename any item to "offhand" and click with it. This will open up a form with settings allowing you to change the detection type and set the maximum number of ticks between sneaks in order to give you more time.


HELP & SUPPORT
------
For help and questions about Foxy's packs, please join the discord via the link below

LINKS
------
Discord: discord.gg/BqGKecr
YouTube: youtube.com/foxynotail
Twitch: twitch.tv/foxynotail
Twitter: twitter.com/FoxyNoTail
Website: www.foxynotail.com