mcpField
T
terrain-integration

terrain-integration

github.com/bbeierle12开发963 次安装今天更新
代码仓库

关于 terrain-integration

用于将地形分析与修改集成到建造系统中的技能，提供坡度与可建性检查、地基放置模式、地形整形和支撑柱生成，并可连接 `structural-physics`。

主要功能

  1. 01分析坡度和可建性
  2. 02按 Valheim、Rust、ARK 模式放置地基
  3. 03平整、抬高或降低地形
  4. 04为不平坡面生成支撑柱
  5. 05将接地地基接入稳定性计算

适用场景

  1. 01检查地形位置是否适合建造
  2. 02按游戏规则放置地基
  3. 03调整建筑区域周围的地形
  4. 04为不平地面添加支撑柱

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/bbeierle12/skill-mcp-claude --skill terrain-integration

安装后在 Claude Code 中输入/terrain-integration确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

_meta.json
references/
terrain-integration-advanced.md
scripts/
foundation-placer.js
pillar-generator.js
terrain-analyzer.js
terrain-modifier.js

详细介绍

地形集成

为建筑系统提供地基放置、坡度处理和地形修改功能。

快速开始

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);
}

评论

支持 Markdown