mcpField
D
decay-upkeep

decay-upkeep

github.com/bbeierle12Development952 installsUpdated 1d ago
Repository

About decay-upkeep

decay-upkeep provides JavaScript systems for timer-based structure decay and resource-based upkeep in survival games. Its scripts cover material decay, protection, resource drain, and cleanup.

Key features

  1. 01Tick-based structure decay
  2. 02Material-specific decay rates
  3. 03Resource upkeep calculations
  4. 04Tool Cupboard protection and authorization
  5. 05Cleanup scheduling for abandoned structures

Use cases

  1. 01Implementing decay in a survival game
  2. 02Managing base upkeep and protection
  3. 03Removing abandoned structures from a server

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill decay-upkeep

After installing, type/decay-upkeepin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

_meta.json
references/
decay-upkeep-advanced.md
scripts/
cleanup-scheduler.js
decay-manager.js
tool-cupboard.js
upkeep-system.js

Details

From the project README

Decay & Upkeep

Timer-based building decay and resource-based upkeep for survival games.

Quick Start

import { DecayManager } from './scripts/decay-manager.js';
import { UpkeepSystem } from './scripts/upkeep-system.js';
import { ToolCupboard } from './scripts/tool-cupboard.js';

// Decay without protection
const decay = new DecayManager({ 
  mode: 'rust',
  decayMultiplier: 1.0 
});
decay.addPiece(piece);
decay.tick(deltaTime); // Called every frame/tick

// Tool Cupboard protection
const tc = new ToolCupboard({
  radius: 30,
  upkeepCost: { wood: 100, stone: 50 }
});
tc.setPosition(position);
tc.depositResources({ wood: 500, stone: 250 });
// Protected pieces won't decay while upkeep is paid

Reference

See references/decay-upkeep-advanced.md for:

  • Decay rate formulas by material
  • Tool Cupboard mechanics (Rust pattern)
  • Upkeep scaling with base size
  • Server performance benefits
  • Anti-raid delay mechanics

Scripts

  • scripts/decay-manager.js - Tick-based decay, material rates, damage states
  • scripts/upkeep-system.js - Resource drain, calculation, UI data
  • scripts/tool-cupboard.js - Protection radius, authorization, resource storage
  • scripts/cleanup-scheduler.js - Server-side cleanup of abandoned structures

Decay Modes

  • Rust: Linear decay over 8-24 hours (material dependent), prevented by Tool Cupboard
  • ARK: Slower decay (days to weeks), tribe-based protection
  • Minecraft: No decay (creative/survival), optional via mods

Design Philosophy

Decay serves dual purposes in survival games: gameplay balance (prevents infinite hoarding) and server performance (removes abandoned bases). The Tool Cupboard pattern elegantly ties both together—players must actively maintain bases, and inactive players' structures automatically clean up.

Comments

Markdown supported