Terrain System API

getHeightAt(worldX: number, worldZ: number): number

const terrainSystem = world.getSystem('terrain') as TerrainSystem;
const height = terrainSystem.getHeightAt(100, 200);
console.log(`Terrain height at (100, 200): ${height}m`);

getProceduralHeightAt(worldX: number, worldZ: number): number

registerFlatZone(zone: FlatZone): void

terrainSystem.registerFlatZone({
  id: 'player_house_1',
  centerX: 50.0,
  centerZ: 50.0,
  width: 10.0,
  depth: 10.0,
  height: 42.5,
  blendRadius: 1.0,
});

unregisterFlatZone(id: string): void

isInFlatZone(worldX: number, worldZ: number): boolean

getTerrainColorAt(worldX: number, worldZ: number): { r: number; g: number; b: number } | null

prefetchTile(tileX: number, tileZ: number): void

getTerrainGenerator(): TerrainGenerator

isReady(): boolean

getTileSize(): number

getBiomeData(biomeId: string): BiomeData | null

export interface NoiseLayerDef {
  scale: number;
  weight: number;
  octaves?: number;
  persistence?: number;
  lacunarity?: number;
  iterations?: number;  // For erosion noise only
}

export const CONTINENT_LAYER: NoiseLayerDef = {
  scale: 0.0008,
  octaves: 5,
  persistence: 0.7,
  lacunarity: 2.0,
  weight: 0.35,
};

export const RIDGE_LAYER: NoiseLayerDef = {
  scale: 0.003,
  weight: 0.15,
};

export const HILL_LAYER: NoiseLayerDef = {
  scale: 0.02,
  octaves: 4,
  persistence: 0.6,
  lacunarity: 2.2,
  weight: 0.25,
};

export const EROSION_LAYER: NoiseLayerDef = {
  scale: 0.005,
  iterations: 3,
  weight: 0.1,
};

export const DETAIL_LAYER: NoiseLayerDef = {
  scale: 0.04,
  octaves: 2,
  persistence: 0.3,
  lacunarity: 2.5,
  weight: 0.08,
};

export const ISLAND_RADIUS = 350;
export const ISLAND_FALLOFF = 100;
export const ISLAND_DEEP_OCEAN_BUFFER = 50;
export const BASE_ELEVATION = 0.42;
export const OCEAN_FLOOR_HEIGHT = 0.05;
export const HEIGHT_TERRAIN_MIX = 0.2;

export const POND_RADIUS = 50;
export const POND_DEPTH = 0.55;
export const POND_CENTER_X = -80;
export const POND_CENTER_Z = 60;

export const COASTLINE_CIRCLE_SAMPLE_RADIUS = 2;

export const COAST_LARGE = {
  octaves: 3,
  persistence: 0.5,
  lacunarity: 2.0,
  weight: 0.2,
};

export const COAST_MEDIUM = {
  freqMultiplier: 3,
  octaves: 2,
  persistence: 0.5,
  lacunarity: 2.0,
  weight: 0.08,
};

export const COAST_SMALL = {
  freqMultiplier: 8,
  weight: 0.02,
};

export const MOUNTAIN_BOOST_MAX_NORM_DIST = 2.5;
export const MOUNTAIN_BOOST_GAUSSIAN_COEFF = 0.3;

export function buildGetBaseHeightAtJS(): string

function getBaseHeightAt(worldX, worldZ) {
  var cN = noise.fractal2D(worldX * 0.0008, worldZ * 0.0008, 5, 0.7, 2.0);
  var rN = noise.ridgeNoise2D(worldX * 0.003, worldZ * 0.003);
  var hN = noise.fractal2D(worldX * 0.02, worldZ * 0.02, 4, 0.6, 2.2);
  // ... (full implementation with all constants injected)
  return height * MAX_HEIGHT;
}

// Increase hill prominence
export const HILL_LAYER: NoiseLayerDef = {
  scale: 0.02,
  octaves: 4,
  persistence: 0.6,
  lacunarity: 2.2,
  weight: 0.35,  // Increased from 0.25
};

// Make island larger
export const ISLAND_RADIUS = 500;  // Increased from 350

const terrainSystem = world.getSystem('terrain') as TerrainSystem;

// Get height at position
const height = terrainSystem.getHeightAt(100, 200);

// Check if in flat zone
const inFlatZone = terrainSystem.isInFlatZone(100, 200);

// Get terrain color for grass matching
const color = terrainSystem.getTerrainColorAt(100, 200);
if (color) {
  console.log(`Terrain color: rgb(${color.r}, ${color.g}, ${color.b})`);
}

// Prefetch tiles for smooth streaming
terrainSystem.prefetchTile(5, 5);

// Register flat zone for a building
terrainSystem.registerFlatZone({
  id: 'castle_courtyard',
  centerX: 250,
  centerZ: 300,
  width: 50,
  depth: 50,
  height: 45,
  blendRadius: 5,
});

// Check if position is in flat zone
const zone = terrainSystem.getFlatZoneAt(250, 300);
if (zone) {
  console.log(`In flat zone: ${zone.id}`);
}

// Remove flat zone when building destroyed
terrainSystem.unregisterFlatZone('castle_courtyard');