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, improved dropped-item displays, 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.
• Create custom tree definitions with configurable logs, leaves, radius, height, and size limits.
• Glow the whole tree while breaking the tree.
• Support custom trees from the 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, advanced item rules, and many custom-item plugins.

Better Drop Display

• Transforms settled dropped items into clean ItemDisplay visuals while preserving the real item entity and its normal pickup behavior.
• Automatically restores vanilla item rendering whenever an item starts moving and reapplies the display after it settles.
• Lays dropped items flat on the ground with configurable scale, translation, and X, Y, and Z rotation.
• Supports a stable randomized yaw for each dropped item, giving item piles a more natural appearance.
• Automatically calculates the correct surface height using collision shapes.
• Correctly positions items on snow layers, carpets, slabs, trapdoors, and other non-full blocks.
• Optional floating label displays the item's native or custom name and stack amount.
• Configure settling delay, movement threshold, full-bright rendering, view range, interpolation, shadow radius, and shadow strength.

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 custom 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.
• Configure independent world whitelists or blacklists for every tweak.
• Reload the main config, tweaks, tree definitions, 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.
• Advanced item matching supports materials, tags, names, lore, enchantments, rarity, NBT, custom-item plugins, 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, chance, delay, and conditional execution.
• Combine reusable rules to make each tweak behave differently for specific players, worlds, or situations.