PreventBuild

Minecraft 版本： 1.21.9 1.21.10 1.21.11

平台： fabric

标签： utility

PreventBuild

Adds control to prevent the player from performing certain actions that are set in configs. Configs, in turn, have a very flexible structure that allows you to build complex logical conditions describing what actions the mod should prevent.

Original purpose of creating this mod was enhancing experience of hand-building map-arts without using any printers and easy-place mode. But now it's more than just preventing placing and breaking: you can prevent any right- or left-click actions, just make sure there is a suitable condition.

This mod is just cancelling the player's actions, so it's fully client-side.

Known issues

Since the latest PreventBuild's versions, I've been working on other projects and didn't have enough time to maintain the mod. I have major rewriting in plans to improve the code and fix some stuff I'm unable to fix easily in the current state. Here are issues I know about:

• The last block you attacked before enabling the condition(s) can be attacked again and destroyed until you attack any another block allowed by the conditions, regardles of whether the enabled conditions allows it;

• Quick change of the holding items may lead to incorrect condition check;

  (For example, RMB clicked with an empty hand and then changed to a block. It may lead to ignore the block placement prevention rules and the block will be placed)

• Condition files parsing can be buggy, incomprehensible or easy-to-break. I can't outline specific issues, but the file format will most likely be changed.

How to use the mod

It's almost necessary to visit the Wiki to understand how to write a config, because there is no other way to write it except by hand.

There are a few files in config/preventbuild/:

• conditions/ - contains config .cfg files
• condition_configs.json - defines which configurations are active by its individual name
• ore_dictionaries.json - defines custom ore dictionary lists for using in configs

Once you have created/updated your configs, you should update configs in the game using commands. Also configs are updating automatically when the player joins a world.

(For developers) Also you can find out how to create and register your own conditions that you will be able to use in the same config files.

Commands

• /pb config list - display a list of configs with their status
• /pb config switch - enable/disable config by name
• /pb config update - reload all configs

Server restrictions of the conditions

Since I'm trying to keep gameplay fair and rules-friendly, I decided to give server owners the ability to restrict
some conditions that they can consider as "cheating-like" actions.

For now, there's only a few of such restrictions. To use them, you need to add the following strings to the plugin
message via the "preventbuild:restrictions" channel and send it to players on PlayerRegisterChannelEvent:

NoItemDamage - Disables all the "Item Damage" and "Item Durability" conditions

NoBlockState - Disables the "Block State" condition

NoAgeBlockState - Disables only the use of the "age" state in the "Block State" condition

ResetAll - Resets all restrictions

Example:

@EventHandler
public void onRegisterChannelJoin(PlayerRegisterChannelEvent event) {
    if (event.getChannel().equals("preventbuild:restrictions")) {
        Player player = event.getPlayer();
        ByteArrayDataOutput out = ByteStreams.newDataOutput();
        out.writeUTF("NoItemDamage NoAgeState");
        player.sendPluginMessage(this, event.getChannel(), out.toByteArray());
    }
}

Contacts

If you have some issues with the mod, any questions or just want to leave feedback, you are always welcome:

• GitHub: https://github.com/Redheris/PreventBuild/issues
• Discord: Server or @redheris

Note

Well, this is my first relatively serious mod and especially the first one for public use. Thanks for visiting :)