Skip to content

Latest commit

 

History

History
125 lines (114 loc) · 9 KB

[Settings]-Compatibility.md

File metadata and controls

125 lines (114 loc) · 9 KB
Raw

This section of the configuration file provides you with additional settings to improve overall compatibility stuff.

Exemptions

Option Meaning
wildcard default metadata active TODO
wildcard default metadata keys TODO
wildcard npc TODO
npc active TODO
npc bukkitnpc TODO
npc metadata active TODO
npc metadata keys TODO
remove join TODO
remove leave TODO

Server

Option Meaning
cbdedicated If true, NoCheatPlus will use its dedicated module for the detected server version, only for 1.4.5 to 1.12.2.
cbreflection Resort to the BukkitAPI if no dedicated module is present. Applies from MC 1.13+ and on.

Blocks

Option Meaning
breakingtime Enables you to override the breaking time of a block for specific side conditions. An entry in this section maps a condition definition to the breaking time in milliseconds. Definitions for side conditions can be: BLOCK_TYPE:TOOL_TYPE:TOOL_MATERIAL_BASE:EFFICIENCY_LEVEL.
allowinstabreak Blocks entered here will not be monitored by the FastBreak check, meaning the player will be able to mine them at whichever speed.

Example of breakingtime:
SAND:AXE:DIAMOND:0: 10000
(Changes the breaking time for sand with a diamond axe with no efficiency enchantment to 10 seconds, thus fastbreak will trigger).

Use of breakingtime parameters:
BLOCK_TYPE: Bukkit block names. Currently no extras are possible, such as data values/variants.

TOOL_TYPE: NONE, SWORD, SHEARS, SPADE, AXE, PICKAXE, HOE

TOOL_MATERIAL_BASE: NONE, WOOD, STONE, IRON, DIAMOND, NETHERITE, GOLD

EFFICIENCY_LEVEL: Level of the efficiency enchantment.

Option Meaning
overrideflags This section allows you to tell NCP how to interpret the shape of blocks (if you can walk on them, walk through them and the like) by using flags. Using the default flag will let NCP use the flags that have already been initialized, useful in the case you only want to add one specific flag for a block (Use where you know what it means, set checks.blockbreak.debug to true, in order to dump the flags that NCP is using internally to the log-file).

Example to both pass through and stand on:
default+ign_passable+ground_height
(It's recommended to set dimensions too, if possible.)

Currently, NoCheatPlus supports the following flags:

Flag Meaning
F_STAIRS Indicator flag for stairs.
F_LIQUID Indicator for all liquid types.
F_POWDERSNOW Like powder snow, which has special onGround properties.
F_BLUE_ICE Like blue ice, more slipperiness.
F_WATER_PLANT Like water plants (1.13+).
F_WATER Like water.
F_LAVA Like lava.
F_CARPET Inidicator flag for carpets.
F_COBWEB Like cobwebs, adhesive.
F_COBWEB2 Like berry bushes, which behaves similarly to webs.
F_SOULSAND Like soulsand. Ensures slower speed if walking on this block with this flag.
F_BUBBLECOLUMN Like bubblec column, which allows the player to move faster vertically.
F_STICKY Like honey block, sticky. Landing on this block will half fall damage.
F_RAILS All rails types a minecart can move on.
F_ICE Like ice, which will allow the player to slide on it, increasing their horizontal speed.
F_LEAVES Indicator flag for all leaves.
F_SLIME Indicator flag for slime, just to distinguish it from other bouncy blocks, like beds.
F_ANVIL Indicator flag for anvils.
F_THIN_FENCE Indicator flag for panes and iron bars.
F_THICK_FENCE Indicator flag for walls and fences (e.g.: cobblestone wall).
F_FAKEBOUNDS Meta-flag used to activate a workaround for the edges of thin fences (iron bars and glass panes) on 1.8 servers (which are bugged and would trigger the Passable check when colliding on them XZ).
F_SOLID Result of Minecraft's isSolid. Used for setting the ground flag.
F_IGN_PASSABLE Indicate that this block is fully passable (used for compatibility).
F_GROUND The player can stand on this block sneaking or not.
F_HEIGHT_100 This block is 1 block high.
F_HEIGHT_150 This block is 1.5 blocks high, like fences.
F_CLIMBABLE This block is climbable, which currently will allow to land without taking fall damage, like ladders and vines.
F_CLIMBUPABLE This block is climbable upwards under special conditions like vines, which are climbable only if attached to a block.
F_ CLIMBLIQ This block is climbable in water, used for 1.13 kelp plants.
F_VARIABLE The block can change shape.
F_XZ100 The block has full xz(horizontal)-bounds, like a normal block (eg.: stone).
F_GROUND_HEIGHT This flag indicates that everything between the minimum ground height and the height of the block can also be stood on. In addition this flag directly triggers a passable workaround for otherwise colliding blocks.
F_HIGHT_8SIM_DEC The height is assumed to decrease from 1.0 with increasing data value from 0 to 0x7, with 0x7 being the lowest. (repeating till 0x15)). 0x8 means falling/full block. This is meant to model flowing water/lava. However the hit-box for collision checks will be set to 0.5 height or 1.0 height only.
F_HEIGHT_8SIM_INC The height is assumed to increase with data value up to 0x7, repeating up to 0x15. However the hit-box for collision checks will be set to 0.5 height or 1.0 height only, as with the 1.4.x snow levels.
F_HEIGHT_8_INC The height increases with data value (8 heights). This is for MC 1.5 snow levels.
F_COLLIDE_EDGES Meta-flag to indicate that the (max.-) edges should mean a collision.
F_PASSABLE_X4 At its 0x04 status, this block is fully passable, like fence gates.
F_BOUNCE25 Bouncy block. Bounce back 25% of fall height without taking fall damage.
F_FACING_LOW3D2_NSWE The facing direction is described by the lower 3 data bits in order of NSWE, starting at and defaulting to 2, which includes invalid states. Main purpose is ladders, no guarantees on defaults for other blocks yet.
F_ATTACHED_LOW2_SNEW The direction the block is attached to is described by the lower 2 bits in order of SNEW.
F_ALLOW_LOWJUMP Allow players to low jump on this block, possibly allowing them to cheat.
F_HEIGHT8_1 One eighth block height (0.125).
F_FALLDIST_HALF Fall distance is divided by 2, if a move goes through this medium (currently only supports liquid).
F_FALLDIST_ZERO Fall distance is set to zero, if a move goes through this medium (currently only supports liquid).
F_MIN_HEIGHT16_15 Minimum height 15/16 (0.9375 = 1 - 0.0625). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_14 Minimum height 14/16 (0.8750). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_13 Minimum height 13/16 (0.8125). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_11 Minimum height 11/16 (0.6875). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT8_5 Minimum height 5/8 (0.625). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_9 Minimum height 9/16 (0.5625). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_7 Minimum height 7/16 (0.4375). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_5 Minimum height 5/16 (0.3125). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT4_1 Minimum height 1/4 (0.25). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT8_1 Minimum height 1/8 (0.125). Only applies with F_GROUND_HEIGHT set.
F_MIN_HEIGHT16_1 Minimum height 1/16 (0.0625). Only applies with F_GROUND_HEIGHT set.
F_VARIABLE_USE Block change tracking: ordinary right click interaction (use) can change the shape.
F_VARIABLE_REDSTONE Block change tracking: block redstone events can change the shape.
F_HEIGHT16_15 Height 15/16 (0.9375 = 1 - 0.0625).
Option Meaning
minimalworldY Alter the the minimal y coordinate a block can be at (non air). Original intention is to provide compatibility for datapacks (1.17+).

Changetracker

This section allows you to alter some option concerning NoCheatPlus' block change tracker system, which allows the moving checks to account for moving blocks (eg.: with pistons).

Option Meaning
active Should the change tracker system be active at all? Without it, moving blocks will cause false positives.
pistons Should pistons be covered by the tracker?
maxageticks Maximum age in ticks for which entries will be purged by the tracker system.
perworld maxentries Maximum entries per world allowed before being removed.

Related