Jump to content

Better Hoppers Plus 1.0.0

$3.99
   (0 reviews)

1 Screenshot

  • 85
  • 3
  • 18.15 kB

About Better Hoppers Plus

BetterHoppersPlus is a Rust plugin that enhances hopper functionality by adjusting item pickup ranges based on player permissions. It provides VIP-tier range adjustments, dynamic speed scaling for longer ranges, intelligent item handling to prevent conflicts between overlapping hoppers, and automatic permission monitoring to ensure ranges stay current with player privileges.

Features

• Permission-based hopper range adjustment (5m to 20m pickup radius)
• VIP tier system with progressively larger ranges
• Dynamic speed scaling - items move faster at longer distances
• Intelligent closest-hopper detection to prevent item conflicts
• Real-time permission change monitoring and updates
• Scheduled hopper range verification every 5 minutes
• Performance optimized with batched processing
• Admin reload command for configuration changes
• Automatic restoration of original values on plugin unload

Quick start

Basic Setup (All Players):

oxide.grant group default hopperrangeplus.use

VIP Tier 1 Setup:

oxide.grant group vip1 hopperrangeplus.vip1

VIP Tier 2 Setup:

oxide.grant group vip2 hopperrangeplus.vip2

VIP Tier 3 Setup:

oxide.grant group vip3 hopperrangeplus.vip3

Admin Setup:

oxide.grant group admin hopperrangeplus.admin

Permissions

This plugin uses the permission system. To assign a permission, use oxide.grant <user or group> <name or steam id> <permission>. 
To remove a permission, use oxide.revoke <user or group> <name or steam id> <permission>.

hopperrangeplus.use -- Basic hopper range enhancement (5m pickup radius).

hopperrangeplus.vip1 -- VIP Tier 1 hopper range (8m pickup radius).

hopperrangeplus.vip2 -- VIP Tier 2 hopper range (12m pickup radius).

hopperrangeplus.vip3 -- VIP Tier 3 hopper range (16m pickup radius).

hopperrangeplus.admin -- Administrator hopper range (20m pickup radius).

Configuration

BetterHoppersPlus comes with several configuration options that allow you to tailor the plugin's behavior to your server's needs:

{
  "DefaultSettings": {
    "HopperRange": 5.0,
    "SpeedMultiplier": 1.5,
    "AdminRange": 20.0
  },
  "VIPSettings": {
    "VIP1Range": 8.0,
    "VIP2Range": 12.0,
    "VIP3Range": 16.0
  }
}

Configuration Sections Explained:

DefaultSettings:
  HopperRange: 5.0
    - Range: 1.0 to 50.0 meters (recommended: 3.0 to 10.0 for balance)
    
  SpeedMultiplier: 1.5
    - Range: 0.5 to 5.0 (recommended: 1.0 to 2.0 for optimal performance)
    - Set to 1.0 to disable speed modifications
    
  AdminRange: 20.0
    - Range: 1.0 to 50.0 meters (recommended: 15.0 to 25.0 maximum)

VIPSettings:
  VIP1Range: 8.0
    - Range: 1.0 to 50.0 meters (recommended: 6.0 to 10.0)
    
  VIP2Range: 12.0
    - Range: 1.0 to 50.0 meters (recommended: 10.0 to 15.0)
    
  VIP3Range: 16.0
    - Range: 1.0 to 50.0 meters (recommended: 14.0 to 18.0)

Dynamic Speed System:
The plugin automatically adjusts item movement speed based on distance from the hopper:

Close Range (0-30% of pickup radius):
  - Items move at 1.5x base speed
  - Maintains vanilla feel for nearby items
  
Medium Range (30-70% of pickup radius):
  - Speed scales from 3.5x to 6x base speed
  - Smooth acceleration for medium distances
  
Far Range (70-100% of pickup radius):
  - Speed scales from 6x to 9x base speed
  - Maximum speed for items at range edges
  - Prevents items from moving too slowly

Final speed calculation: BaseSpeed × DynamicMultiplier × SpeedMultiplier

Closest Hopper Logic:
When multiple hoppers have overlapping ranges:
- System calculates which hopper is closest to each item
- Temporarily disables farther hoppers to prevent conflicts
- Uses 0.5 unit tolerance to prevent constant switching
- Ensures items always go to the most appropriate hopper

Notes

Troubleshooting:
- If hoppers don't update after permission changes, wait up to 5 minutes for scheduled update
- Use /hrr_reload to force immediate configuration application
- Check server console for any error messages
- Ensure permission hierarchy is correctly configured
- Verify hopper ownership matches player with permissions

  • Like 1

ElSalvaje's Collection

User Feedback

1.8m

Downloads

Total number of downloads.

8.5k

Customers

Total customers served.

127.9k

Files Sold

Total number of files sold.

2.7m

Payments Processed

Total payments processed.

×
×
  • Create New...

Important Information

We have placed cookies on your device to help make this website better. You can adjust your cookie settings, otherwise we'll assume you're okay to continue.