pvp tweaks

PVP Tweaks consolidates essential combat, and visual utilities into one high-performance, client-side mod for Minecraft 1.21.4–1.21.11. This mod adds a button called "pvp tweaks", and clicking on it will take you to a dedicated hub screen with categories for Item Sizes, Visuals, HUD, Sounds, Optimization, Profiles, and Info. You can tweak everything related to PVP — totems, shield position, fire display, fire height, crystals, anchors, animations, particles, sounds, item display size, crosshair, and more.

The mod also adds special features, such as Armor HUD, zoom, custom crosshair, and the ability to choose custom sounds for in-game events, and also import your own sounds.

Note to Players & Server Admins: This mod is designed purely for quality-of-life. It does not provide any "cheats," automation, or unfair advantages. It simply allows you to fine-tune your client's visuals and responsiveness to ensure your game runs smoothly in competitive environments.

🕹️ How to Use

1. Accessing the Config:

   • In-Game: Press the config keybind to open the PVP Tweaks hub screen.
   • Mod Menu: If installed, go to your Mods list, select PVP Tweaks, and click the Configure button.

• HUDs: Use the Adjuster buttons inside the config to drag elements on-screen.

• Sounds: Open the Sound Picker in any category, search for a sound or import one of your own, adjust pitch, and click save.

• Profiles: Save your full setup and share it via clipboard import/export.

⚔️ Core Features

🚀 Performance Optimizers Designed to mitigate PING and latency effects for a smoother combat experience:

• Crystal Optimizer: Immediate client-side removal of End Crystal entities upon attack, allowing for zero-delay re-placement.
• Anchor Optimizer: Replaces exploded Respawn Anchors with a client-side placeholder (Fern) instantly, keeping the coordinate clear for immediate placement before server confirmation.
• Fairness Guarantee: These features do not interact with server-side logic; they are strictly visual/client-side collision tweaks to ensure your client's view matches the game's state.

📊 HUD Utilities Fully customizable HUD elements with real-time editing:

• CPS HUD: Left/Right CPS tracker with customizable scale, position, color, shadow, and a "Smart Rainbow" mode.
• Armor Durability HUD: Track armor and hand items. Includes low-durability blink alerts and custom sound triggers.
• Coordinates & Potion Effects: Display your position and active effects with adjustable scale and position.
• Crosshair Editor: Custom crosshair with color, size, transparency, outline, and the ability to import crosshair codes from other games (like CS2).
• Item Background: Toggle and configure item background rendering in your inventory.
• Hotbar Slot Labels: Display keybind hints or numbers on hotbar slots.
• Live Adjusters: Use dedicated screens to drag and drop HUD elements anywhere on your screen.

🔊 Audio & Visual Control

• Sound Profiles: Profile-based sound replacement with a built-in picker, import/export, and per-profile sound packs.
• Sound Picker: Built-in browser for all vanilla sound events with live preview and pitch control. Organized into Explosions, Combat, Misc, and Custom categories.
• Custom Sounds: Import .mp3, .ogg, .wav, or .flac files directly without creating a resource pack.
• Durability Alert: Choose a custom sound for low-durability warnings.
• Per-Event Volume: Independent sliders for End Crystals, Respawn Anchors, TNT, hits, and more.
• Explosion Particles: Per-type sliders to control TNT, Creeper, Bed, Ghast, and Wind Charge particles.

👁 Visuals

• Fire Block Height: Cycle through Vanilla, Full, Mid, Low, Flat, or None presets to control the fire block's rendered height.
• Fire Overlay: Adjust the scale of the fire overlay effect on your screen (0-200%).
• Fullbright: Dedicated screen with gamma settings for brightening dark areas.
• Pumpkin Blur: Toggle the pumpkin overlay on/off.
• Shield Adjuster: Real-time shield position and rotation configuration.
• Plants Control: Client-side adjustment of plant and tall grass rendering.
• Totem Animation Size: Scale the totem pop animation (0-200%).
• Crystal Entity Size: Scale end crystal entities (25-300%).
• Potion Color Override: Change potion effect indicator colors.
• Menu Background Blur: Toggle the background blur effect in GUIs.
• Smooth Scrolling: Enable smooth scrolling in menus.
• Item Tooltip Scaling: Adjust tooltip text size.

🛡 Item Sizes

• Global Scale: Master slider controlling all held items (25-300%).
• Per-Item Sliders: Individual scaling for Sword, Axe, Mace, Trident, Shield, Armor, Bow, Crossbow, Totem, Golden Apple, Respawn Anchor, and Misc items.
• Search Mode: Find and customize scale for any item in the game.
• Scaling Modes: Listed mode - only affect items you configure; Unlisted mode - affect everything except what you configure; Custom mode - show a per-item search screen; Off.

🎨 Modern UI

• Hub Screen: A clean tab-based interface with all the categories and rounded corners (radius 8) on every button, slider, and panel.

🎯 Zoom

• Configurable zoom (smooth or instant) with adjustable FOV and scroll sensitivity.

📁 Profiles & Presets

• Built-in "Competitive" preset for one-click high-performance optimization.
• Profile System: Save, load, import, and export full config setups via the system clipboard.
• Keybind import/export: Share your keybinding setup separately.
• Profiles Folder: One-click button to open your profiles folder in the file manager.

📥 Installation

1. Install Fabric Loader
2. Install Fabric API.
3. Place pvp-tweaks.jar into your mods folder.

Version dependencies: Fabric Loader ≥0.18.4 (all versions) Fabric API (all versions) Cloth Config (optional) Mod Menu (optional - adds config button in mods list)

Note: The mod was tested primarily on version 26.2 (linux Mint, gnome, x11) , So all other versions are in beta, And not all the features listed will exist on them, but should work fine.

Note: MP3/WAV import functionality in old versions of the mod (1.4.8 and below) requires ffmpeg (https://ffmpeg.org) installed on your system.

I am a solo developer, and while I strive for stability, bugs can occasionally slip through.

• Where to Report: Please Open an issue on GitHub (https://github.com/viper-trick/pvp-tweaks/issues). Include your log file (.minecraft/logs/latest.log) and a description of the issue.
• Support: You can also reach out via email: [email protected].

PS, to make the work on the project easier, AI was used in the project, the code was tested and verified (L.B.L) by a human.

📌 License & Code Usage

This mod is released under All Rights Reserved. I work hard to keep this project organized and stable. If you would like to use this code for other projects or integrate it elsewhere, please email me at [email protected] to ask first. I am open to requests,And I'll probably agree most of the time. but I do not permit reuploads of this mod or modified versions to any platform (Modrinth, CurseForge, etc.) without explicit permission.

Thank you for respecting the time and effort put into this project.