⚔️ 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
- 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.
- HUD Adjuster: Click Adjuster buttons inside the config to drag and reposition HUD elements freely on your screen.
- Sound Picker: Open the Sound Picker in any category, preview or search for sounds (or import your own), adjust pitch, and save.
- 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.flacaudio 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%to200%. -
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
- Download and install Fabric Loader.
- Download and place Fabric API into your
.minecraft/modsfolder. - Place
pvp-tweaks.jarinto your.minecraft/modsfolder.
| 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
💡 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 |
|---|---|---|---|---|---|
| 20d ago | 1 | ||||
| 20d ago | 1 | ||||
| 21d ago | 1 | ||||
| 2mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 3mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 4mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 5mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 6mo ago | 1 | ||||
| 7mo ago | 1 | ||||
| 7mo ago | 1 |
### 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
### 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
(experimental)
(experimental)
### 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)
### 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.
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.
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
## 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.
- 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 custom sound handling and added support for additional audio formats:
.mp3, .wav, .flac, .aac.
🛡 Fixed the Shield screen, improving layout and stability.