Blocking Items

By
StarkyMods

Block certain items from being used to your liking, even per world/instance. Also block crafting recipes.

BLOCKING ITEMS

You can block items globally or per instance/world to your liking.
(Commands only for OP players)
(Config files only accessible for server owners)
This mod does not modidy any vanilla items/assets.
Can block/unblock custom items from other mods!

This can be useful for quests rewards or similar, where the item should
remain blocked for everyone but unblocked for the player/s that completed the quest.
Also good for in-game shops.

Includes translations for the warning messages players will receive if they have a blocked item
(English, Spanish, German & Portuguese) [Editable in JSON}.

Blocking an item will instantly block the chosen item live ingame,
no restart needed!

Is compatible with LuckPerms mod.

How does it block it?

It will automatically swap to another hotbar slot when
players try to swap into this blocked item.

It will also automatically move the blocked item out of the hotbar into the inventory,
the player will not be able to keep it in the hotbar if its blocked.
(Item will be dropped on ground if there is no room in the inventory)
(This also works with equipped armor and left hand slots)

Also, any started interactions of the blocked item, will stop/cut when this
system swaps to another hotbar slot and moves the blocked item.

And also, the crafting recipe of the blocked item will also get blocked.
Or you can just block the crafting recipe of an item.

You can also delete/remove items from all players.
In this case, all players will get this deleted item removed from their inventories,
and after a sync command, all containers & offline players will also be purged.,

The mod does nothing if you don't block any item.

You have the JSON config files in the "BlockingItems_Starky" folder in "mods",
but I highly recommend using all the commands and UI I made for it!!!

NOTE: There are commands for unblock, undelete or unblockcraft.
But it's much easier to do this in the UI Menu.

UI MENU

Manage all your blocked/deleted items in one place, much easier control.

OP BYPASS

By default, OP players bypass the block of any item.
But you can always edit "blockingitemsconfig.json" to toggle this OP bypass off.
Also I added the commands "/biop" or "/blockingitemsop" to toggle this OP bypass.

BLOCKING ITEMS GLOBALLY

"/blockitem <itemID>"
"/bi <itemID>"
This will block globally (all instances) the item you want.

"/unblockitem <itemID>"
"/ubi <itemID>"
This will unblock globally (all instances) the item you want (if its already blocked).

"/blockitem"
"/bi"
(with no extra arguments)
This will block globally (all instances) the item
IN YOUR MAIN HAND.

"/unblockitem"
"/ubi"
(with no extra arguments)
This will block globally (all instances) the item
IN YOUR MAIN HAND.

BLOCKING ITEMS PER INSTANCE/WORLD

This commands are prepared to work with
custom modded dungeons (normally are temporary dungeons).
Uses <instanceID> to identity that instance and all instances with that "prefix".

"/blockitem <itemID> <instanceID>"
"/bi <itemID> <instanceID>"
This will block the item you want in the instance you want.

"/unblockitem <itemID> <instanceID>"
"/ubi <itemID> <instanceID>"
This will unblock the item you want in the instance you want (if its already blocked).

"/blockitemhere"
"/blockiteminstance"
"/bii"
"/bih"
This will block the item
IN YOUR MAIN HAND IN THE INSTANCE YOU ALREADY ON!

"/unblockitemhere"
"/unblockiteminstance"
"/ubii"
"/ubih"
This will unblock the item
IN YOUR MAIN HAND IN THE INSTANCE YOU ALREADY ON!

BLOCKING ITEMS PER PLAYER

NOTE: If target player is offline, it will save its name and
re-apply the block/unblock when that player joins the server.

"/blockitemplayer <player> <itemID>"
"/bip <player> <itemID>"
Blocks the item only for this player in all instances/worlds.
"/unblockitemplayer <player> <itemID>"
"/ubip <player> <itemID>"
Unblocks the item only for this player in all instances/worlds.

Can be used without arguments:
"/blockitemplayer" OR "/bip"
"/unblockitemplayer" OR "/ubip"
It will choose the player executing the command and the item in main hand.

BLOCKING ITEMS PER PLAYER & PER INSTANCE/WORLD

"/blockiteminstanceplayer <player> <itemID> <instanceID>"
(same with "/blockitemhereplayer", "/biip" and "/bihp")
Blocks the item for this player in that instance/world (works with prefix).

"/unblockiteminstanceplayer <player> <itemID> <instanceID>"
(same with "/unblockitemhereplayer", "/ubiip" y "/ubihp")
Unlocks the item for this player in that instance/world (works with prefix).

Can be used without arguments too:
"/blockiteminstanceplayer" (or "/blockitemhereplayer", "/biip" y "/bihp")
"/unblockiteminstanceplayer" (or "/unblockitemhereplayer", "/ubiip" y "/ubihp")
It will choose the player executing the command, the item in main hand and
the instance you currently at (works with prefix).

DELETE/REMOVE ITEM GLOBALLY

NOTE: After deleting an item,
run "/syncremoveditems" to also purge offline players and all containers
(or "/syncdeleteditems").

"/deleteitem <itemID>"
"/di <itemID>"
"/removeitem <itemID>"
This will remove globally (all instances) the item you want from all players.

"/undeleteitem <itemID>"
"/udi <itemID>"
"/restoreitem <itemID>"
This will restore globally (all instances) the item you want (if its already deleted).
Will not give the previously deleted item back to the players that had it.

"/deleteitem"
"/di"
"/delitem"
"/removeitem"
(with no extra arguments)
This will remove globally (all instances, from all players) the item
IN YOUR MAIN HAND.

"/undeleteitem"
"/udi"
"/undelitem"
"/restoreitem"
(with no extra arguments)
This will restore globally (all instances) the item
IN YOUR MAIN HAND.
Will not give the previously deleted item back to the players that had it.

BLOCKING CRAFTING RECIPE GLOBALLY

"/blockitemcraft <itemID>"
"/bic <itemID>"
This will block globally (all instances) the crafting recipe of the item you want.

"/unblockitemcraft <itemID>"
"/ubic <itemID>"
This will unblock globally (all instances) the crafting recipe of the item you want (if its already blocked).

"/blockitemcraft"
"/bi"
(with no extra arguments)
This will block globally (all instances) the crafting recipe of the item
IN YOUR MAIN HAND.

"/unblockitemcraft"
"/ubic"
(with no extra arguments)
This will block globally (all instances) the crafting recipe of the item
IN YOUR MAIN HAND.

BLOCKING CRAFTING RECIPE PER INSTANCE/WORLD

This commands are prepared to work with
custom modded dungeons (normally are temporary dungeons).
Uses <instanceID> to identity that instance and all instances with that "prefix".

"/blockitemcraft <itemID> <instanceID>"
"/bic <itemID> <instanceID>"
This will block the crafting recipe of the item you want in the instance you want.

"/unblockitemcraft <itemID> <instanceID>"
"/ubic <itemID> <instanceID>"
This will unblock the crafting recipe of the crafting recipe of the item you want in the instance you want (if its already blocked).

"/blockitemcrafthere"
"/blockitemcraftinstance"
"/bici"
"/bich"
This will block the crafting recipe of the item
IN YOUR MAIN HAND IN THE INSTANCE YOU ALREADY ON!

"/unblockitemcrafthere"
"/unblockitemcraftinstance"
"/ubici"
"/ubich"
This will unblock the crafting recipe of the item
IN YOUR MAIN HAND IN THE INSTANCE YOU ALREADY ON!

BLOCKING CRAFTING RECIPE PER PLAYER

NOTE: If target player is offline, it will save its name and
re-apply the block/unblock when that player joins the server.

"/blockitemcraftplayer <player> <itemID>"
"/bicp <player> <itemID>"
Blocks the crafting recipe of the item only for this player in all instances/worlds.
"/unblockitemcraftplayer <player> <itemID>"
"/ubicp <player> <itemID>"
Unblocks the crafting recipe of the item only for this player in all instances/worlds.

Can be used without arguments:
"/blockitemcraftplayer" OR "/bicp"
"/unblockitemcraftplayer" OR "/ubicp"
It will choose the player executing the command and the crafting recipe of the item in main hand.

BLOCKING CRAFTING RECIPE PER PLAYER & PER INSTANCE/WORLD

"/blockitemcraftinstanceplayer <player> <itemID> <instanceID>"
(same with "/blockitemcrafthereplayer", "/bicip" and "/bichp")
Blocks the crafting recipe of the item for this player in that instance/world (works with prefix).

"/unblockitemcraftinstanceplayer <player> <itemID> <instanceID>"
(same with "/unblockitemcrafthereplayer", "/ubicip" y "/ubichp")
Unlocks the crafting recipe of the item for this player in that instance/world (works with prefix).

Can be used without arguments too:
"/blockitemcraftinstanceplayer" (or "/blockitemcrafthereplayer", "/bicip" y "/bichp")
"/unblockitemcraftinstanceplayer" (or "/unblockitemcrafthereplayer", "/ubicip" y "/ubichp")
It will choose the player executing the command, the crafting recipe of the item in main hand and
the instance you currently at (works with prefix).