All Mods Resource Packs Data Packs Shaders Modpacks Plugins
PVP Tweaks

PVP Tweaks

by ViperT • Downloads: 0 • Followers: 0
Description
Gallery
Changelog
Versions

⚔️ PVP Tweaks (in development, beta)

PVP Tweaks consolidates essential combat, HUD, and visual utilities into one high-performance, client-side mod for Minecraft 1.21.4–26.X.

Clicking the in-game "PVP Tweaks" button opens a dedicated hub screen with intuitive tabs for Item Sizes, Visuals, HUD, Sounds, Optimization, Profiles, and Info. Fine-tune totems, shield positioning, fire overlays, crystals, respawn anchors, animations, particles, sounds, custom crosshairs, and more-all from one clean interface.

⚠️ Note to Players & Server Admins: This mod is designed purely for Quality-of-Life (QoL). 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 configured keybind to open the PVP Tweaks hub screen.
  • Mod Menu: Select PVP Tweaks from your mods list and click Configure.
  1. HUD Adjuster: Click Adjuster buttons inside the config to drag and reposition HUD elements freely on your screen.
  2. Sound Picker: Open the Sound Picker in any category, preview or search for sounds (or import your own), adjust pitch, and save.
  3. Profiles: Save your entire setup and easily share it using clipboard import/export strings.

✨ Core Features

📊 HUD Utilities

Fully customizable HUD elements with real-time editing:

  • CPS HUD: Left/Right CPS tracker with custom scale, position, color, text shadow, and a "Smart Rainbow" mode.
  • Armor Durability HUD: Tracks worn armor and held items. Includes low-durability blink alerts and custom sound triggers.
  • Coordinates & Potion Effects: Displays current position and active status effects with full scale/position adjustments.
  • Crosshair Editor: Custom crosshairs with color, size, opacity, outlines, and crosshair code import support (e.g., CS2 codes).
  • Item Background: Toggle and customize background rendering in inventory slots.
  • Hotbar Slot Labels: Display keybind hints or numbers directly on hotbar slots.
  • Live Adjusters: Drag and drop HUD elements anywhere on screen with interactive visual editors.
🔊 Audio & Visual Control
  • Sound Profiles: Profile-based sound replacement system with an integrated picker and per-profile sound packs.
  • Sound Picker: In-game browser for all vanilla sound events with live previewing and pitch adjustments (Explosions, Combat, Misc, and Custom).
  • Custom Sounds: Directly import .mp3, .ogg, .wav, or .flac audio files without creating a resource pack. (Note: Legacy versions ≤1.4.8 require ffmpeg installed).
  • Durability Alerts: Set custom sound warnings for low-durability armor and tools.
  • Per-Event Volume Sliders: Independent volume controls for End Crystals, Respawn Anchors, TNT, hits, and other actions.
  • Explosion Particles: Fine-tune particle opacity/count for TNT, Creepers, Beds, Ghasts, and Wind Charges.
👁️ Visual Adjustments
  • Fire Block Height: Preset heights (Vanilla, Mid, Low, Flat, or None).

  • Fire Overlay: Adjust the screen fire overlay scale from 0% to 200%.

  • Fullbright: Integrated gamma customization screen for clear visibility in dark areas.

  • Pumpkin Blur: Toggle the carved pumpkin screen overlay.

  • Shield Adjuster: Real-time positioning and rotation tweaking for held shields.

  • Plants Control: Client-side rendering controls for tall grass and plants.

  • Entity & Animation Scaling:

  • Totem pop animation scale (0–200%).

  • End Crystal entity scale (25–300%).

  • Potion Color Override: Change indicator colors for active potion effects.

  • GUI Tweaks: Toggle background blur and enable smooth scrolling in menus.

🛡️ Item Sizes & Custom Scaling
  • Global Scale: Master scale slider for all held items (25-300%).
  • Per-Item Sliders: Individual scaling for Swords, Axes, Maces, Tridents, Shields, Armor, Bows, Crossbows, Totems, Golden Apples, Respawn Anchors, and Misc items.
  • Flexible Scaling Modes:
  • Listed Mode: Only scales items explicitly configured.
  • Unlisted Mode: Scales everything except configured exceptions.
  • Custom Mode: Interactive per-item search and configuration screen.
🎨 Modern UI & Experience
  • Hub Screen: Sleek, tabbed interface with clean rounded panels and controls (8px border radius).
  • Zoom Utility: Configurable smooth or instant zoom with customizable FOV and scroll sensitivity.
  • Profile System: Save, load, import, and export entire configurations via system clipboard or the dedicated profiles folder.
🚀 Performance Optimizers (Experimental feature)

Designed to mitigate ping and latency effects for a smoother combat experience:

  • Crystal Optimizer: Client-side immediate removal of End Crystal entities upon attack, allowing for zero-delay re-placement.
  • Anchor Optimizer: Instantly replaces exploded Respawn Anchors with a client-side placeholder (Fern) to keep the coordinate clear for immediate placement before server confirmation.
  • Fairness Guarantee: Strictly visual and client-side collision tweaks that do not interfere with server-side logic.

📥 Installation & Dependencies
  1. Download and install Fabric Loader.
  2. Download and place Fabric API into your .minecraft/mods folder.
  3. Place pvp-tweaks.jar into your .minecraft/mods folder.
Dependency Required / Optional Notes
Fabric Loader Required Version ≥0.18.4
Fabric API Required All supported MC versions
Mod Menu Optional Adds a "Configure" button directly in your Mods list
Cloth Config Optional Additional configuration backend support

🛠️ Issues, Support & Development
  • Issue Tracker: Report Issues

  • Direct Contact: Reach out via email at yag.fvt@gmail.com

💡 Notes on AI Development

AI assistance was utilized during development to optimize workflow; all code has been line-by-line reviewed, tested, and verified for security and stability by a human developer.

💡 Notes on Compatibility & Testing

Primary testing is conducted on Minecraft 26.2-1.21.11 (Linux Mint, GNOME, X11). All other supported versions are currently in Beta - while core features should function normally, minor version-specific variations may occur. I need beta testers please contact me on Discord: vipertrick

Note on Development & Release The mod hasn't really been officially released yet, it's still in development. It will only be called "Release" after version 2.0.0 (it will probably be reset to "R1.0.0")


🤙Talk to me

Discord: vipertrick

mail: yag.fvt@gmail.com


📌 License & Code Usage

This project is published under GNU General Public License v3.

Contact me for any further requests.

All Versions

+ Add Version
Name Game version Platforms Published Downloads Actions
1.21.11
Fabric
20d ago 1
26.3
Fabric
20d ago 1
26.3
Fabric
21d ago 1
1.21.11
Fabric
2mo ago 1
26.1.x
Fabric
3mo ago 1
26.2
Fabric
3mo ago 1
26.1.x
Fabric
3mo ago 1
1.21.11
Fabric
3mo ago 1
26.2
Fabric
3mo ago 1
1.21.9
Fabric
4mo ago 1
1.21.10
Fabric
4mo ago 1
1.21.11
Fabric
4mo ago 1
1.21.11
Fabric
4mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.9
Fabric
5mo ago 1
1.21.10
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.8
Fabric
5mo ago 1
1.21.9
Fabric
5mo ago 1
1.21.10
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.11
Fabric
5mo ago 1
1.21.1
Fabric
6mo ago 1
1.21.6
Fabric
6mo ago 1
1.21.5
Fabric
6mo ago 1
1.21.4
Fabric
6mo ago 1
1.21.11
Fabric
6mo ago 1
1.21.11
Fabric
6mo ago 1
1.21.11
Fabric
6mo ago 1
1.21.11
Fabric
7mo ago 1
1.21.11
Fabric
7mo ago 1
fix totem animation
fix totem animation
First port to 26.3
## 1.9.4

### Added
  • Shield Adjuster: sample shield** - "Show Sample Shield" toggle displays a shield in the off-hand while the adjuster is open, so scale/position changes are visible in real time
  • Shield Adjuster: Active Pose** - "Active Pose" toggle shows the sample shield in the blocking pose

### Changed
  • Removed the "Full" fire block height preset (presets are now vanilla/mid/low/flat/none)
  • Updated mod version to 1.9.4 across all supported Minecraft versions

port 1.9.3 to 26.1.X
1.9.3 port to 1.21.11
## 1.9.3

### Added
  • Fire Block Height controls** — presets (vanilla/full/mid/low/flat/none) now directly control fire block height; renamed from "Entity Fire Height" to "Fire Block Height"
  • Disabled widget styling** — buttons and sliders render grayed out when inactive
  • Flash hint on disabled crosshair settings** — clicking a disabled crosshair control briefly highlights the "Custom" toggle

### Changed
  • Fire block height preset changes now only apply via "Save Fire" button or "Done" (no auto-reload on preset cycle)
  • "Save Fire" button now only triggers chunk rebuild (no resource pack reload)
  • Auto-reload tick handler removed (was causing unwanted reloads on preset change)
  • Updated mod version to 1.9.3 across all supported Minecraft versions

### Fixed
  • GUI buttons no longer visible above the title bar when scrolling
  • Crosshair Adjuster: removed the center vertical divider bar
  • Crosshair Adjuster: all settings are locked when Custom is toggled OFF
Compatibility with MC1.21.9
(experimental)
Compatibility with MC1.21.10
(experimental)
## 1.9.1

### Added
  • Modern GUI** — rounded corners (radius 8) across all buttons, sliders, and tabs with proper circular-arc rendering
  • Explosion particle controls** — per-type sliders for TNT, Creeper, Bed, Ghast, and Wind Charge particles
  • Pitch control in sound picker** — pitch/tempo slider moved to the top of the sound picker screen

### Changed
  • Updated mod version to 1.9.1 across all supported Minecraft versions (1.21.4–1.21.11)
## 1.9.0

### Added
  • Crosshair Tweak** (HUD tab) — custom crosshair with color, size, and transparency adjustments; supports importing crosshair codes from other games (e.g. CS2)
  • Info tab** — new tab with mod description, version, author, clickable links (GitHub, Issues, Modrinth), and contact information
  • Global "Item Size" slider** — global item scaling control

### Fixed
  • Hotbar labels not displaying correctly
  • Item background rendering
  • Scrolling behavior in menus
  • Various crosshair tweak issues

### Changed
  • Updated mod version to 1.9.0 across all supported Minecraft versions (1.21.4–1.21.11)
  • Bug fixes.
_New features and support for multiple versions will come later._
Compatibility with 1.21.9
Compatibility with 1.21.10
Compatibility with 1.21.8
Compatibility with 1.21.9
Compatibility with 1.21.10
Native Audio Engine: 100% Pure Java audio processing (cuts/speed) with no external dependencies (no FFmpeg).
Pro Sound Editor: New dual-handle Range Slider for visual trimming and a speed slider (0.1x – 3.0x).
Non-Destructive Workflow: Edits are reversible! Original files are backed up so you can "expand" or reset cuts later.
Zero-Lag UI: Audio processing for previews and saves now runs in the background to prevent game freezes.
Dynamic Item Scaling: Search and add any item from the Minecraft registry to set its specific hand scale.
Live UI Updates: All labels (like "Active: ####") now refresh immediately upon saving.
Fixes:
Fixed the bug of playing sound and opening a folder on Windows.
Fixed the problem where text in the sound picker screen tended to overlap each other
Changes:
Built-in sound converter in the mod, no longer need to use ffmpeg
New features:
"Vision" tab, including Fulbright, pumpkin blur removal, and a small client-side version of my existing mod, "Plants Control".
Option to change the size of the armor, in the "Item Size" tab.
Option to prevent low-drivability sound from repeating in the armor
Compatibility with 1.21.1
Compatibility with 1.21.6
Compatibility with 1.21.5
Compatibility with 1.21.4
Add advanced Import/Export with Keybinds and Profile Tracking
# PVP Tweaks Changelog

## 1.4.0 (Performance & HUD Update)

### New Features
  • Optimizers Tab (Competitive Updates)**:
  • Crystal Optimizer**: Instant client-side removal of crystals on attack. This fixes the "ghost crystal" glitch on high-ping servers, allowing for immediate re-placement.
  • Anchor Optimizer**: Replaces exploded Respawn Anchors with a client-side placeholder (Fern). Since the placeholder is "replaceable" by standard block placement, you can now place a crystal in the anchor's coordinate before the server even confirms the explosion.
  • HUD Systems**:
  • CPS HUD**: Added a fully customizable Clicks-Per-Second tracker.
  • Movable via a dedicated **CPS Adjuster Screen**.
  • Supports **Smart Rainbow** mode for smooth color cycling.
  • Adjustable scale, shadow, and color presets (White, Red, Green, etc.).
  • Toggleable L/R labels.
  • Armor Durability HUD**: Added a visual tracker for equipped armor and hand items.
  • Movable via a dedicated **Durability Adjuster Screen**.
  • Customizable alignment (Horizontal/Vertical).
  • Optional low-durability blinking alerts and custom alert sounds.
  • Vanilla Settings Tab**:
  • Renamed from "PvP Presets" and expanded with essential shortcuts:
  • Added **Mouse Sensitivity** slider.
  • Added **Auto Jump** toggle.
  • Added **Fullscreen** toggle.

### Improvements & Fixes
  • Competitive Preset**: Now automatically enables the Crystal and Anchor optimizers.
  • Sound System**: Fixed redundant sound picker logic and improved conversion stability.
  • GUI**: Improved readability of the config screen with clearer category icons.
  • Cleanup**: Removed outdated/redundant mixins (InGameHudMixin, etc.) to improve compatibility with other mods like Sodium and Iris.
  • Version Support**: Optimized for Minecraft 1.21.11.

v1.2.0-beta Changelog
  • New Feature: Profile System — Save and load multiple named configurations directly from the mod menu. Switch between "Casual" and "Hardcore" setups instantly.
  • New Feature: Competitive Preset — A one-click optimized setup for Crystal PVP. Includes silent explosions, 30% totem animation, 5% totem particles, and 5% totem volume.
  • New Feature: Clipboard Sync — Sharing settings is now as easy as Copy & Paste. Export automatically copies your JSON config to the clipboard; Import applies it directly from your clipboard.
  • Smart Import/Export — When sharing settings, your local custom sound paths and presets are preserved, allowing you to sync visuals and scales without breaking your custom audio setup.
  • UI Improvement: Quick Access Button — Added a dedicated "PVP Tweaks" button at the top of the Pause Menu for instant access to settings during a match.
  • Refined Defaults — Default settings are now better aligned with competitive standards (reduced fire overlay, hit crits enabled, optimized item scales).
  • CI/CD Integration — Added automated build and release workflows via GitHub Actions.
🛠 Fixed the three-button issue in the Shield tab.

🔊 Fixed custom sound handling and added support for additional audio formats:
.mp3, .wav, .flac, .aac.

🛡 Fixed the Shield screen, improving layout and stability.
Unreleased version of the mod, in its initial version
PVP Tweaks Icon
Download PVP Tweaks
Select game version
Select platform