UltimateTweak

A powerful, modular, and highly customizable quality-of-life plugin for modern Minecraft servers.

UltimateTweak is an advanced gameplay enhancement framework for Spigot, Paper, and Folia, built to improve everyday survival gameplay without forcing server owners into a fixed setup.

Every tweak has its own configuration file and can be enabled, disabled, and customized independently. From automatic tool selection and vein mining to animated tree cutting, dynamic lighting, and custom automation, UltimateTweak gives you full control over how each feature behaves.

Unlike basic tweak plugins, UltimateTweak focuses on deep configuration, custom-item compatibility, protection support, and reusable action and condition systems, allowing every feature to fit naturally into your server.

Features

Animated Tree Cutter

• Detect and cut entire trees with one configurable mining process
• Built-in falling-tree animation with configurable direction, duration, glow, and view distance
• Optional falling-tree damage for nearby players and entities
• Configurable mining time based on the number of logs in the tree
• Optionally break leaves when the player uses a matching item
• Run custom actions while damaging the tree or after it is completely cut
• Includes definitions for common Overworld trees, Nether fungi, and custom-tree examples
• Glow the whole tree while breaking the tree
• Create custom tree definitions with configurable logs, leaves, radius, height, and size limits
• Support custom tree from CraftEngine plugin
• Built-in debug command helps explain why a tree definition passes or fails

Vein Mining

• Mine connected ore veins in one operation
• Configure which tools and blocks can trigger each vein-mining rule
• Supports diagonally connected blocks and configurable search limits
• Configurable mining-time scaling keeps large veins balanced
• Use glow effects to preview the blocks being mined
• Supports custom actions, conditions, custom tools, and custom blocks

Best Tool Selection

• Automatically selects the most effective tool for the block being mined
• Choose whether to search the player's hotbar or entire inventory
• Scores tools using destroy speed, Efficiency, preferred-tool status, and Fortune
• Configure detection cooldowns and Fortune scoring behavior
• Supports custom conditions and actions after switching tools

Dynamic Light

• Creates real-time light near players based on held items
• Checks both the main hand and off hand
• Configure independent item-matching rules and light levels from 0 to 15
• Supports vanilla items, saved items, advanced item rules, and many custom-item plugins

Double Door

• Open and close matching double doors together with one right-click
• Detects paired doors by type, facing direction, and opposite hinge side
• Optional smooth BlockDisplay door animation with configurable duration, interval, and view distance
• Can also animate single wooden doors when enabled in the tweak configuration
• Respects configured conditions and supported protection plugins before allowing door interaction

Biome Announcer

• Notify players when they enter a new biome
• Configure which biomes should trigger announcements, or leave the list empty to support all biomes
• Use global or per-biome messages, including ready-to-use Terralith biome examples
• Supports custom conditions and actions when the player's biome changes
• Provides placeholders such as {biome}, {from-biome}, {to-biome}, and translated biome names on Paper

Structure Announcer

• Notify players when they enter generated structures such as villages, monuments, mineshafts, trial chambers, and more
• Configure which structures should trigger announcements, or leave the list empty to support all structures
• Supports namespaced IDs such as minecraft:village_plains and datapack structure IDs
• Use global or per-structure messages, with built-in examples for vanilla and Terralith structures
• Run custom conditions and actions when entering a structure, with placeholders such as {structure}, {from-structure}, and {to-structure}

Structure Auto Protection

• Automatically creates protection regions for generated structures around online players
• Uses each structure's real bounding box and supports configurable vertical expansion
• Choose the protection hook used to create regions, including supported region protection plugins
• Configure structure filters, scan intervals, generated region ID prefixes, and debug output
• Helps protect villages, dungeons, ruins, and custom datapack structures without manual region setup

Automatic Tree Replanting

• Automatically plants dropped saplings when they land on valid soil
• Configure sapling items, placed blocks, valid soils, check intervals, and wait times
• Includes ready-to-use rules for common Overworld trees, mangroves, azaleas, and more
• Supports custom saplings and custom blocks for deeply customized servers

Entity Vehicle Restriction

• Prevent matched living entities from entering boats or minecarts
• Enable restrictions independently for supported vehicle types
• Use advanced entity matching to target only the mobs your server needs
• Supports vanilla entities and integrations such as MythicMobs and LevelledMobs

Modular Configuration

• Every tweak has its own clean configuration file and independent enabled option
• Enable only the gameplay improvements that fit your server
• Configure cooldowns, triggers, matching rules, limits, animations, effects, and behavior
• Reload the main config, tweaks, tree definitions, saved items, and languages with one command
• Advanced language management system

Powerful Item & Block Compatibility

• Direct custom-item support for ItemsAdder, Oraxen, Nexo, MMOItems, EcoItems, EcoArmor, MythicMobs, ExecutableItems, CraftEngine, NeigeItems, eco, and more
• Custom-block support for CraftEngine, Oraxen, Nexo, ItemsAdder, and vanilla blocks
• Save items in-game and reuse them in configuration files
• Generate detailed ItemFormat data directly from the item in your hand
• Advanced item matching supports materials, tags, names, lore, enchantments, rarity, saved items, ItemFormat, NBT, and logical rules

Protection Plugin Support

• Automatically respects supported region and claim protection plugins
• Supports WorldGuard, Residence, Towny, Lands, PlotSquared, GriefPrevention, HuskClaims, HuskTowns, Dominion, SuperiorSkyblock2, and BentoBox
• Includes a dedicated bypass permission for trusted players and administrators

Action & Condition Engine

• Add custom behavior to supported tweaks without writing code
• Conditions can check biomes, permissions, placeholders, worlds, ANY logic, and NOT logic
• Actions support messages, titles, action bars, particles, sounds, effects, commands, teleporting, entity spawning, item drops, item giving, chance, delay, and conditional execution
• Combine reusable rules to make each tweak behave differently for specific players, worlds, or situations