# Project Bodycam v1.1 - GUI 2.0 Update

Major GUI overhaul focused on scalability, user experience, and bug fixes. This update completely redesigns the interface for better compatibility across different screen resolutions.

**Version**: 1.1 | **Release Date**: 2025 | **Status**: Released

---

🎨 GUI 2.0 - Complete Interface Redesign

Scalability Improvements
- **Dynamic Scaling System**: Optimized for 1920x1080 as baseline with adaptive scaling
- **Responsive Design**: All UI elements now scale properly across different resolutions
- **Fixed Container Sizing**: Resolved issues with squished/stretched elements
- **Improved Font Scaling**: Terminal fonts now scale correctly with screen size

## Toggle & Control Fixes
- **Toggle Visibility**: Fixed toggle controls being cut off or misaligned
- **Proper Positioning**: Toggles now center vertically within their containers
- **Container Sizing**: Adjusted control containers for different element types
- **Button Heights**: Increased heights for better readability and interaction

### Ragdoll Collision Setting
- **Fixed Snapping Issue**: Resolved toggle reverting to previous state
- **Network Synchronization**: Improved client-server communication for admin settings
- **Temporary Value Handling**: Added proper state management during updates
- **Debug Commands**: Added `bodycam_debug_ragdoll` for troubleshooting

### Crosshair System Overhaul
- **Three New Styles**:
- **Frame**: Camera autofocus style with corner brackets
- **Dot**: Simple dot with reload indicator
- **Default**: Classic cross design
- **Dynamic Behavior**:
- Blinks orange during reload
- Turns red when targeting enemies
- Size adjustment slider (0.5x - 2.0x)
- **Reload Ammo Display**: Shows bullet count (e.g., "15/30") during reload
- **Style-Specific Indicators**: Each crosshair has unique reload animations

### ADS/Zoom System
- **New Feature**: Aim Down Sights functionality
- **Dynamic Centering**: Zooms to crosshair position, not screen center
- **Configurable Settings**:
- ADS Key binding (default: Right Mouse)
- Zoom FOV (20-90 degrees)
- Zoom Speed (1.0-20.0)
- **Smooth Transitions**: Uses interpolation for natural zoom feel

### HUD Modernization
- **New Color Scheme**: Modern gray-blue palette with Half-Life orange accents
- **Redesigned Panels**: Health, Armor, and Ammo displays with:
- Gradient overlays
- Icon headers (heart, shield, gun)
- Large centered numbers
- Segmented progress bars
- Status indicators (CRITICAL, LOW, RELOAD)
- **Glow Effects**: Dynamic borders for critical states
- **Improved Layout**: Better spacing and positioning at 1920x1080

### Key Binding System
- **Visual Redesign**:
- Blue/cyan color scheme for key binding buttons
- Taller buttons (50px scaled) for better visibility
- Keyboard icon (⌨) on hover
- Inverted text color on highlight
- **Mouse Button Support**:
- Custom key mapping for MOUSE1-5, MWHEELUP/DOWN
- Workaround for Garry's Mod input limitations (Might still not work) (I'm not sure why)
- Multiple input formats supported (e.g., "mouse2", "MOUSE2", "rightclick")
- **Improved Dialog**:
- Larger popup (450x220px)
- Modern styling with gradient overlay
- Better placeholder text and examples
- Foldable key list with categories

### Preset System Fixes
- **Save Display Issue**: Fixed saved presets not appearing immediately
- **Auto-Refresh**: Presets now refresh and display after saving
- **Tab Switching**: Automatically switches to local tab after saving
- **Scroll Position**: Scrolls to top to show newly saved presets
- **Directory Fix**: Changed from "lua/presets" to "bodycam_presets" for proper DATA directory usage
- **File Extension**: Changed to .json for clarity
- **Debug Commands**: Added `bodycam_debug_presets` and `bodycam_refresh_presets`

---

## 🔧 Technical Improvements

### Color Definitions
- Added missing color definitions (BORDER_INACTIVE, KEY_BINDING colors)
- Fixed SetDrawColor calls using Color objects incorrectly
- Consistent color scheme throughout interface

### Error Handling
- Fixed nil value errors in popup dialogs
- Resolved invalid key code warnings
- Better validation for network messages

### Performance
- Optimized refresh cycles
- Reduced redundant redraws
- Improved timer management

---

## 🐛 Bug Fixes
- Fixed toggle controls not saving properly for server-side settings
- Resolved key binding buttons being invisible at certain resolutions
- Fixed preset compatibility warnings showing when disabled
- Corrected mouse button key codes (hardcoded values to prevent errors)
- Fixed scrollbar styling in various panels
- Resolved text wrapping issues in setting descriptions
- Fixed Resolution Scaling issues

---

## 📝 Usage Notes
- Menu key remains `H` by default (configurable)
- All settings properly scale at 1920x1080 baseline
- Mouse buttons can now be bound using MOUSE1-5 notation
- Preset warnings can be permanently disabled via checkbox

Changelog – Update 1.0.1

- Fixed: Admin-only settings were not changeable even for admins or in singleplayer mode.

- Fixed: Minor GUI issues.

- Fixed: Crouch speed was locked and extremely slow.

- Added: Experimental NPC & Effects Module (disabled by default; not intended for regular use).

- Improved: Movement behavior — enhanced inertia transitions, acceleration, and deceleration. Greater body weight
influence and extensive customization options.

- Removed: Unnecessary and unwanted functions.

- Refactored: Animation speed variables have been moved from the Movement section to a new dedicated tab.

# Project Bodycam Version 1.0 Beta Release Notes

## **🎊🎉 Major Release - Complete Rewrite🎉🎊**

I'm excited to announce the release of **Project Bodycam v1.0 Beta** - a complete ground-up rewrite of Garry's Mod bodycam addon. This version represents continuing the addon and development focused on stability, compatibility, and user experience.

---

## ☝**What's New**

### **Complete Architecture Overhaul**

- **Modular System**: Built from scratch with a robust modular architecture
- **Error Recovery**: Advanced error handling with graceful degradation - the game continues even if modules fail
- **Fail-Safe Mechanisms**: Critical errors disable affected features while maintaining core functionality
- **Performance Optimization**: Efficient caching, reduced overhead, and optimized rendering

### **Enhanced Compatibility**

- **Multiplayer Ready**: Full client-server synchronization with seamless multiplayer support
- **Addon Integration**: Active compatibility support for popular weapon bases:
- ARC9 Base
- TFA Base
- Customizable Weaponry 2.0
- M9K Weapon Base
- FAS:2 (Firearms: Source 2)
- Default HL2/GMod weapons
- **Player Model Support**: Enhanced bone detection with fallback systems for custom player models

### **Redesigned User Interface**

- **Modern GUI**: Completely redesigned interface with improved usability
- **Intuitive Navigation**: Streamlined settings organization with tabbed interface
- **Real-time Preview**: Instant visual feedback for configuration changes
- **Accessibility**: Better contrast, readable fonts, and clear visual hierarchy

### **Advanced HUD System**

- **Redesigned HUD**: New visual style with smooth animations and effects
- **Customizable Elements**: Configurable colors, opacity, and positioning
- **Dynamic Crosshair**: Smart crosshair that adapts to weapon aim direction
- **Status Indicators**: Real-time health, armor, and ammunition display
- **Boot Sequence**: Immersive system initialization animation

### **Preset Management**

- **Local Presets**: Save and organize your favorite configurations
- **Preset Browser**: Easy-to-use interface for managing saved settings
- **Online Sharing**: Share presets with other players on the same server
- **Import/Export**: Backup and transfer configurations between installations
- **Security**: Automatic sanitization of admin-only settings when sharing

### **Enhanced Camera System**

- **Physics-Based Movement**: Preserves the unique engine physics that give the addon its signature feel
- **Improved Smoothing**: Better interpolation algorithms for more natural camera movement
- **Weapon Integration**: Enhanced weapon positioning and recoil simulation
- **Bone Detection**: Robust head bone finding with fallback support for custom models
- **Stability Options**: Configurable stabilization and roll compensation

---

## 🔧☝ **Technical Improvements**

### **Robust Module System**

- **Dependency Management**: Automatic loading order based on module dependencies
- **Hot Reloading**: Reload individual modules without restarting the game
- **Status Monitoring**: Real-time module health checking and reporting
- **Graceful Degradation**: Modules can fail independently without breaking the entire system

### **Configuration System**

- **Validation**: Input validation with proper type checking and range limits
- **Persistence**: Reliable configuration saving and loading
- **Migration**: Automatic handling of configuration updates between versions
- **Admin Controls**: Separate admin-only settings with proper permission checking

### **Performance Enhancements**

- **Efficient Rendering**: Optimized HUD drawing with reduced draw calls
- **Smart Caching**: Cached materials, fonts, and calculations
- **Memory Management**: Proper cleanup and resource management
- **Network Optimization**: Minimal network traffic for multiplayer synchronization

---

## ☝**Key Features**

### **Core Functionality**

- **Realistic Bodycam Effect**: Signature physics-based camera movement
- **Weapon Positioning**: Dynamic camera positioning based on weapon handling
- **Movement Simulation**: Authentic body weight and momentum simulation
- **Shake Effects**: Configurable camera shake for added realism *(may or may not be working correctly)*

### **Customization Options**

- **Field of View**: Adjustable FOV (50-120 degrees)
- **Camera Positioning**: Fine-tune camera offsets and angles
- **Movement Settings**: Customize walk/run speeds and jump height (admin)
- **Visual Effects**: Vignette, scanlines, and other cinematic effects
- **Preset Configuration**: Save, Import, Share.

### **User Experience**

- **Intuitive Controls**: Easy-to-use menu system ***(default: H key)***
- **Real-time Feedback**: Instant preview of setting changes
- **Help System**: Comprehensive tooltips and descriptions
- **Console Integration**: Full console command support for advanced users

---

## 🔧 **Console Commands**

- `bodycam_menu` - Open the settings interface
- `bodycam_enable 0/1` - Toggle bodycam system on/off
- `bodycam_reload [module]` - Reload all modules or specific module
- `bodycam_status` - Display module status information

---

## 🌐 **Multiplayer Support**

- **Server Synchronization**: Seamless multiplayer experience
- **Preset Sharing**: Share configurations with other players
- **Admin Controls**: Server administrators can manage movement settings
- **Performance Scaling**: Optimized for multiple players

---

## ⚠️☝ **Important Notes**

### **Beta Release Notice**

This is a **1.0 Beta release** and does not represent the final version. While tested, some features may undergo further refinement based on community feedback and or are not working as envisioned.

### **Compatibility Warning**

**Older version presets are not compatible with version 1.0** due to the complete rewrite. If you wish to continue using the previous version, you can download it from the changelog section on the workshop page.

### **Version Migration**

Users upgrading from older versions will need to reconfigure their settings. I recommend starting with the default configuration and adjusting as needed.

---

## 🐛 **Known Issues**

I'm aware of the following minor issues that are currently being addressed:

1. **Search Functionality**: In the settings menu, pressing Enter after searching may not immediately update results. **Workaround**: Switch tabs back and forth to refresh the search results.
2. **Reload Spinner**: The reload spinner may occasionally get stuck in the loading state. This is not severe and will resolve when firing the weapon again.
3. **Addon Detection**: Some weapon addons may not be immediately detected on first load. Reloading the bodycam modules usually resolves this.

**Note**: These issues are minor and do not affect core functionality. Future updates will address these remaining bugs as testing continues.

---

## 🚀 **Future Development**

- **Expanded Compatibility**: Additional weapon and player model support
- **Advanced Effects**: Visual effects and customization options
- **Performance Improvements**: Continued optimization based on user feedback
- **Community Features**: Enhanced preset sharing and community integration

---

## 📥 **Installation**

1. Subscribe to the addon on the Steam Workshop
2. Restart Garry's Mod or change maps
3. Press **H** to open the settings menu (configurable)
4. Configure your preferences and enjoy!

---

## 🔄 **Upgrade Path**

If you prefer to stay with the previous version, you can find older releases in the changelog section of the workshop page. However, we strongly recommend upgrading to experience the improved stability and new features.

---

## 🙏 **Acknowledgments**

Thank you to the community for your patience during development and for providing valuable feedback during testing. This rewrite represents a significant improvement in stability, compatibility, and user experience.

---

**Version**: 1.0 Beta
*

- removed "Disable default hud" option (not needed)

- small hud fix

- Added and Fixed camera not attaching to different Player models properly

**Update Log:**",
"• Fixed camera issues during HL2 level transitions (still not working, arc9 throwing the error not me)\n",
"• Improved addon weapon compatibility (ARC9, TFA, etc.)\n",
"• Added automatic camera reset when loading new levels\n",
"• Fixed camera position after respawning with different player models\n",
"• Added Camera damping system (not implemented properly yet)\n",
"• Added safety checks for invalid weapon states\n",
"• Fixed viewmodel position after level transitions\n",
"• Added compatibility mode for addon weapons\n",
"• Fixed head bone tracking after respawns\n",
"• Fixed missing ConVars\n",
"• Fixed ARC9 flashlight issue\n",
"• added proper menu key handling / Fixed menu key issue (should be default to H now)\n\n",
"**Known Issues:**\n",
"• ARC9 weapons still have visual glitches & or glitching out the camera completely during level transitions with the weapon out.\n",
"• Please report any bugs on the workshop page: [Workshop Page](https://steamproxy-script.pipiskins.com/sharedfiles/filedetails/?id=2920296299)/n"

• Added Vertical Angle Offset slider in camera settings
- Allows for more precise control of your bodycam view
- Adjust the up/down angle of your camera independently

• Fixed camera bugging out when reviving
• Resolved movement issues when entering/exiting noclip
• Improved angle lerp function for smoother gameplay
• Adjusted camera handling and escapes for better workability

1. Open Bodycam Settings menu
2. Find the new "Vertical Angle Offset" slider under Camera settings
3. Adjust to your preference for the perfect view

Make sure to resave your presets to adjust for the new update!