About NightProtection
Night Protection
Overview
Night Protection is a premium Rust plugin that provides enhanced protection for structures during specified hours. This plugin is perfect for servers that want to reduce offline raiding during nighttime hours while still keeping the core gameplay mechanics intact.
Features
- Time-Based Protection: Set specific UTC time periods when structure protection is active
- Customizable Damage Reduction: Configure how much damage reduction should be applied (default 50%)
- Visual UI Indicator: Players see a shield icon with a countdown timer when protection is active
- Interactive UI: Players can click on the shield icon to get detailed information
- Fully Customizable UI: Adjust position (top-right or top-left), scale, colors, icon, text labels, and now precise screen position with offset values
- Multi-language Support: Built-in support for English and Turkish languages
- Admin Controls: Easy-to-use commands for server admins to adjust settings
How It Works
When the protection is active:
1. All structures (building blocks, doors, deployables, etc.) take reduced damage (configurable percentage)
2. Players see a shield icon with a countdown timer showing the remaining protection time
3. Players attempting to damage protected structures receive a notification message
4. Admins can adjust protection hours and damage reduction percentage via commands
Configuration
json { "Start Hour (UTC)": 22, "Start Minute (UTC)": 0, "End Hour (UTC)": 6, "End Minute (UTC)": 0, "Damage Reduction Percentage": 50.0, "UI Update Interval (seconds)": 1.0, "Enable Debug Mode": false, "UI Position": "TopRight", "UI Scale": 1.2, "UI Text Color": "1 1 1 1", "UI Icon URL": "https://cdn.nesko-dev.com/shield-check.png", "UI Label Text": "Night Protection", "UI Offset X": 0.0, "UI Offset Y": 0.0 }
Configuration Options
- Start Hour/Minute: The UTC time when protection begins (24-hour format)
- End Hour/Minute: The UTC time when protection ends (24-hour format)
- Damage Reduction Percentage: How much damage reduction to apply to structures (0-100%)
- UI Update Interval: How often the countdown timer updates (in seconds)
- Enable Debug Mode: Enables additional console logging for troubleshooting
- UI Position: Position of the UI on screen ("TopRight" or "TopLeft")
- UI Scale: Size scaling factor for the UI (default: 1.2)
- UI Text Color: Color of the text elements in "R G B A" format (values 0-1)
- UI Icon URL: URL to the shield icon image
- UI Label Text: Text displayed on the UI (default: "Night Protection")
- UI Offset X: Horizontal offset for the UI panel (positive = right, negative = left, default: 0.0)
- UI Offset Y: Vertical offset for the UI panel (positive = up, negative = down, default: 0.0)
UI Customization
The plugin offers extensive UI customization options to match your server's style:
Position
Choose between:
- Top-right corner (default)
- Top-left corner
Size
Adjust the scale to make the UI larger or smaller:
- Scale values range from 0.1 (very small) to 2.0 (very large)
- Default scale is 1.2
Offsets
Fine-tune the UI position on the screen:
- UI Offset X: Move the UI horizontally. Example: `0.02` moves right, `-0.02` moves left.
- UI Offset Y: Move the UI vertically. Example: `0.03` moves up, `-0.03` moves down.
- Offsets are in normalized screen units (0.0 to 1.0 is the full screen width/height).
Colors
Customize text colors using RGBA values (0-1):
- White: "1 1 1 1" (default)
- Red: "1 0 0 1"
- Blue: "0 0 1 1"
- Green: "0 1 0 1"
- Transparency can be adjusted by changing the alpha value
Text and Icons
- Change the displayed text using the UI Label Text option
- Use a custom shield icon by providing a URL in UI Icon URL
Commands
Admin Commands
- /nightprotection - Shows available commands
- /nightprotection status - Shows if protection is currently active
- /nightprotection time - Shows configured protection times and current UTC time
- /nightprotection setstart <hour> <minute> - Sets protection start time (UTC)
- /nightprotection setend <hour> <minute> - Sets protection end time (UTC)
- /nightprotection reduction <percentage> - Sets damage reduction percentage
- /nightprotection ui position <topleft|topright> - Sets UI position
- /nightprotection ui scale <value> - Sets UI scale (default: 1.2)
- /nightprotection ui color <r> <g> <b> <a> - Sets UI text color (0-1 values)
- /nightprotection ui text <text> - Sets UI label text
- nightprotection.admin - Required to use admin commands
Installation
1. Download the NightProtection.cs file
2. Upload it to your server's `oxide/plugins` directory
3. Restart your server or use the `oxide.reload NightProtection` command
4. Configure the plugin settings using the config file or admin commands
Support
For support requests, please contact us through Discord.gg/EdAMQmHHdX
- This plugin was built with the help of NS-AI Artificial Intelligence. ask us for detailed information.
