Config

This is the main configuration file for CatzUtils. It controls the plugin's core modules, anti-farming systems, and other general settings.

General Settings

These settings are at the top level of the config.yml file.

Setting	Description
license		Required. Your unique license key to activate the plugin.
prefix	The global prefix displayed before all plugin messages sent in the chat.
disabled-worlds	A list of world names where CatzUtils will be completely inactive. No rewards of any kind will be given in these worlds.

Reward Modules (settings)

This section allows you to enable or disable the main reward-giving features of the plugin individually.

PvP Settings (pvp)

Setting
enabled	If true, players can receive rewards for killing other players.
cooldown	seconds a player must wait before they can receive another PvP kill reward.

Mob Kill Settings (mob-kills)

Setting
enabled	If true, players can receive rewards for killing mobs.
ignore-spawner-mobs	If true, mobs that originate from a monster spawner will not give rewards. This is a key anti-farming feature.
ignore-spawn-egg-mobs	If true, mobs that originate from a spawn egg will not give rewards.

Fishing Settings (fishing)

Setting
enabled	If true, players can receive special rewards while fishing.

Block Breaking Settings (block-breaking)

Setting
enabled	If true, players can receive rewards for breaking blocks.
ignore-player-placed	If true, blocks that have been placed by players will not give rewards when broken. This module relies on the block-tracker system below.

Block Tracker System (block-tracker)

This is a powerful backend system designed to prevent players from farming rewards by placing and breaking blocks repeatedly.

Setting	Description
enabled	If true, the system will track blocks placed by players. This is required for ignore-player-placed to work.
max-blocks.per-world	The maximum number of player-placed blocks to track in each world to prevent performance issues. The oldest blocks are removed first if the limit is reached.
cleanup. interval	The interval in minutes for the plugin to automatically run a cleanup task, removing old block data to save space and maintain performance.
excluded-materials	A list of materials that the tracker will completely ignore. These blocks will never be tracked as player-placed.
always-player-placed	A list of materials (like crops) that are always considered player-placed for the purpose of giving rewards, bypassing the database check for better performance on farmable blocks.