Skip to content
Mirror
Clone

Clone over HTTPS

No sign-in. Pulls work; pushes go upstream to the monorepo.

Download .tar.gz

Protocol buffer schemas shared by KBVE services, games and sites.

Last changed in19476db91on

83 lines2.5 KB
APIRaw
syntax = "proto3";

package kbve.map.v1;

import "kbve/common/v1/color.proto";

// Biome classification — drives terrain generation, visuals, and spawn tables
enum Biome {
  BIOME_UNSPECIFIED = 0;
  BIOME_GRASSLAND = 1;
  BIOME_FOREST = 2;
  BIOME_DESERT = 3;
  BIOME_TUNDRA = 4;
  BIOME_SWAMP = 5;
  BIOME_MOUNTAIN = 6;
  BIOME_VOLCANIC = 7;
  BIOME_OCEAN = 8;
  BIOME_CAVE = 9;
  BIOME_DUNGEON = 10;
  BIOME_CITY = 11;
  BIOME_RUINS = 12;
  BIOME_UNDERGROUND = 13;
  BIOME_FLOATING = 14;
  BIOME_VOID = 15;
  BIOME_COASTAL = 16;
  BIOME_RIVER = 17;
  BIOME_DIRT = 18;
  BIOME_SNOW = 19;
  BIOME_STONE = 20;
}

// Terrain band type — height-based visual classification
enum TerrainBand {
  TERRAIN_BAND_UNSPECIFIED = 0;
  TERRAIN_BAND_WATER = 1;
  TERRAIN_BAND_SAND = 2;
  TERRAIN_BAND_GRASS = 3;
  TERRAIN_BAND_DIRT = 4;
  TERRAIN_BAND_STONE = 5;
  TERRAIN_BAND_SNOW = 6;
  TERRAIN_BAND_LAVA = 7;
}

// Terrain generation configuration
message TerrainConfig {
  // Noise parameters
  optional int64 seed = 1;
  optional float noise_scale = 2; // Frequency of terrain variation
  optional int32 octaves = 3; // Noise complexity layers (default 2)
  optional float max_height = 4; // Maximum terrain height in world units
  optional float persistence = 5; // Amplitude decay per octave (0.0–1.0)
  optional float lacunarity = 6; // Frequency growth per octave (default 2.0)

  // Chunk system
  optional int32 chunk_size = 7; // Tiles per chunk side (default 16)
  optional int32 load_radius = 8; // Chunks loaded around player (default 3)
  optional float tile_size = 9; // World units per tile (default 1.0)

  // Height-based terrain bands
  repeated TerrainBandDef bands = 10;
}

// A height-based terrain band with visual properties
message TerrainBandDef {
  TerrainBand type = 1;
  float min_height = 2; // Band starts at this height
  float max_height = 3; // Band ends at this height
  repeated kbve.common.v1.Color colors = 4; // Shade variants for this band
  optional float body_darkness = 5; // Cliff/side darkness factor (default 0.72)
}

// Water configuration
message WaterConfig {
  optional float water_level = 1; // World height of water surface
  optional kbve.common.v1.Color base_color = 2; // Shallow water color
  optional kbve.common.v1.Color deep_color = 3; // Deep water color
  optional float ripple_speed = 4;
  optional float ripple_scale = 5;
  optional float highlight_strength = 6;
  optional float foam_intensity = 7;
  optional bool swimmable = 8; // Can players swim (default true)
  optional int32 drown_damage = 9; // Damage per tick if not swimmable
}