terrain-integration

地形統合

建築システム向けの基礎設置、傾斜への対応、地形の変更。

クイックスタート

import { TerrainAnalyzer } from './scripts/terrain-analyzer.js';
import { FoundationPlacer } from './scripts/foundation-placer.js';

// Analyze terrain at build location
const analyzer = new TerrainAnalyzer(terrainMesh);
const slopeData = analyzer.analyzeSlope(position, { radius: 4 });
// slopeData: { angle: 15, normal: Vector3, canBuild: true }

// Place foundation with auto-leveling
const placer = new FoundationPlacer({ 
  mode: 'valheim', // or 'rust', 'ark'
  maxSlope: 30,
  autoLevel: true 
});
const result = placer.place(foundationPiece, position, analyzer);
// result: { valid: true, height: 2.3, pillarsNeeded: 2 }

リファレンス

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

• 傾斜分析アルゴリズムとしきい値
• 基礎の固定パターン（Valheimの地面接触ルール）
• 自動水平化の戦略
• 地形変更のネットワーク処理
• 不均一な地形に対応する柱の生成

スクリプト

• scripts/terrain-analyzer.js - 傾斜の検出、建築可能性の確認、地形のサンプリング
• scripts/foundation-placer.js - Valheim／Rust／ARKモードでの基礎設置
• scripts/terrain-modifier.js - 地形を平坦化、上昇、下降させる操作
• scripts/pillar-generator.js - 傾斜地向けの支柱を自動生成

基礎モード

• Valheim：地面に接触すると安定性が100％になり、基礎は地形に接している必要があります
• Rust：基礎はグリッドにスナップし、設置後は地形を無視します
• ARK：自動支柱に対応した柔軟な設置で、中程度の傾斜まで許容します

統合

安定性の計算にはstructural-physicsを使用します。地面に固定された基礎は、最大の安定性を持つルートノードとして支持グラフに組み込まれます。

// Integration example
const grounded = placer.place(foundation, pos, analyzer);
if (grounded.valid) {
  foundation.isGrounded = true;
  foundation.stability = 1.0; // Feed to structural-physics
  validator.addPiece(foundation);
}