decay-upkeep

劣化と維持費

サバイバルゲーム向けのタイマー式建築物劣化とリソースベースの維持費です。

クイックスタート

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

リファレンス

以下については references/decay-upkeep-advanced.md を参照してください。

• 素材ごとの劣化率の計算式
• ツールカップボードの仕組み（Rust のパターン）
• 拠点の規模に応じた維持費のスケーリング
• サーバーのパフォーマンス上の利点
• 襲撃防止の遅延の仕組み

スクリプト

• scripts/decay-manager.js - ティックベースの劣化、素材ごとの率、ダメージ状態
• scripts/upkeep-system.js - リソースの消耗、計算、UI データ
• scripts/tool-cupboard.js - 保護範囲、認証、リソース保管
• scripts/cleanup-scheduler.js - 放棄された建築物をサーバー側でクリーンアップ

劣化モード

• Rust：素材に応じて 8〜24 時間かけて線形に劣化し、ツールカップボードによって防止されます
• ARK：劣化がより遅く（数日から数週間）、トライブベースの保護があります
• Minecraft：劣化なし（クリエイティブ／サバイバル）。MOD を使って任意に追加できます

設計理念

劣化はサバイバルゲームで二つの役割を果たします。ゲームプレイのバランス調整（無限のため込みを防止）と、サーバーのパフォーマンス向上（放棄された拠点を撤去）です。ツールカップボードのパターンはこの両方を巧みに結び付けます。プレイヤーは拠点を積極的に維持する必要があり、活動していないプレイヤーの建築物は自動的にクリーンアップされます。