Description

This Rust mod, AdditionalUpkeep, significantly enhances the Tool Cupboard (TC) upkeep system by providing more granular control over resource management and maintenance costs. It automatically tracks block types (Wood, Stone, Metal, Armored) and calculates their individual upkeep costs. All resource consumptions are in addition to the default rust TC upkeep rates. Here’s a detailed breakdown of the mod’s features:

Key Features:

1. Automated Resource Management:
   • Automatically calculates the upkeep cost per second for each resource (Wood, Stone, Metal, Armored) based on the block types associated with the Tool Cupboard (TC).
   • Sets timers that deduct resources from the TC at calculated intervals, ensuring regular upkeep without manual intervention.
2. Customizable Upkeep Settings:
   • Supports configurable upkeep thresholds and rates, allowing server owners to define custom upkeep requirements for different block types.
   • Integrates logic to group materials with similar upkeep intervals, reducing unnecessary timer executions.
   • Minimum upkeep timer intervals are enforced (e.g., no timer can be shorter than 600 seconds).
3. Advanced Timer and Resource Handling:
   • Automatically adjusts timers based on resource availability and block count.
   • If the time to deduct 1 unit of a resource exceeds a set threshold, the timer is skipped to optimize performance.
   • Supports grouping of materials with close upkeep intervals, combining upkeep processes to avoid redundant timers.
4. Maintenance Cost Display:
   • Displays detailed maintenance cost information to players, including the time it will take for resources in the TC to deplete, using formulas that calculate consumption time based on current resource amounts and maintenance costs.
   • Currently only displays updates on TC and Player up for a short period.  Players will need to check TC to view the corrected time for resources consumption rates.
5. Performance Optimization:
   • Upkeep calculations are optimized to handle large bases and extensive block counts efficiently, without causing server lag or performance degradation.
   • Delays are applied to block recalculation processes triggered by building events (e.g., structure upgrades, demolitions, or deaths) to prevent excessive processing.

Technical Details:

• Upkeep Calculation:
  • Determines how much time remains before the TC runs out of resources, grouping materials and calculating resource consumption intervals.
  • Ensures the upkeep time is calculated by determining the shortest resource consumption time across materials and adds this to the overall maintenance cycle.
• Block-Specific Upkeep:
  • Treats different block grades uniquely, allowing differentiation between Wood, Stone, Metal, and Armored blocks for upkeep purposes.

Additional Features:

• The ability to handle multiple TCs with independent upkeep calculations.
• Full support for dynamic block recalculation and upkeep adjustments when TC-affiliated blocks are changed or destroyed.