First commit
This commit is contained in:
commit
9b0fe9b1b7
126 changed files with 31043 additions and 0 deletions
334
docs/api.md
Normal file
334
docs/api.md
Normal file
|
|
@ -0,0 +1,334 @@
|
|||
# API Reference
|
||||
|
||||
Полный список всех классов и функций пакета `cubiomes`.
|
||||
|
||||
---
|
||||
|
||||
## Перечисления (`cubiomes.enums`)
|
||||
|
||||
### `MCVersion`
|
||||
|
||||
Версии Minecraft. Используйте как целое число везде, где нужна версия.
|
||||
|
||||
| Константа | Значение | Описание |
|
||||
|-----------|---------|---------|
|
||||
| `MC_B1_7` | 1 | Beta 1.7 |
|
||||
| `MC_B1_8` | 2 | Beta 1.8 |
|
||||
| `MC_1_0` … `MC_1_17` | 3–21 | MC 1.0 – 1.17 (последний патч) |
|
||||
| `MC_1_18` | 22 | MC 1.18.2 (новая система биомов) |
|
||||
| `MC_1_19` | 24 | MC 1.19.4 |
|
||||
| `MC_1_20` | 25 | MC 1.20.6 |
|
||||
| `MC_1_21` | 32 | MC 1.21.11 (алиас → последний 1.21.x) |
|
||||
| `MC_26_3` | 35 | MC 26.3 (Chaos Cubed) |
|
||||
| `MC_NEWEST` | 35 | Алиас последней версии |
|
||||
|
||||
### `Dimension`
|
||||
|
||||
| Константа | Значение |
|
||||
|-----------|---------|
|
||||
| `DIM_NETHER` | -1 |
|
||||
| `DIM_OVERWORLD` | 0 |
|
||||
| `DIM_END` | +1 |
|
||||
| `DIM_UNDEF` | 1000 |
|
||||
|
||||
### `BiomeID`
|
||||
|
||||
Все биомы Minecraft. Доступны как современные имена (`windswept_hills`),
|
||||
так и исторические алиасы (`extremeHills`). Значение `NONE = -1` означает
|
||||
«отсутствует». Примеры:
|
||||
|
||||
```python
|
||||
BiomeID.plains # 1
|
||||
BiomeID.mushroom_fields # 14
|
||||
BiomeID.deep_dark # 183
|
||||
BiomeID.pale_garden # 186
|
||||
BiomeID(37).name # "badlands"
|
||||
```
|
||||
|
||||
### `StructureType`
|
||||
|
||||
| Константа | Значение | Примечание |
|
||||
|-----------|---------|-----------|
|
||||
| `Village` | 5 | overworld |
|
||||
| `Monument` | 8 | overworld ocean |
|
||||
| `Mansion` | 9 | overworld dark forest |
|
||||
| `Outpost` | 10 | overworld |
|
||||
| `Ancient_City` | 13 | overworld deep |
|
||||
| `Fortress` | 18 | **nether** |
|
||||
| `Bastion` | 19 | **nether** |
|
||||
| `End_City` | 21 | **end** |
|
||||
| `Trial_Chambers` | 25 | overworld |
|
||||
| `Stronghold` | 27 | overworld |
|
||||
| … | … | см. enums.py |
|
||||
|
||||
### Флаги генератора
|
||||
|
||||
```python
|
||||
LARGE_BIOMES = 0x1 # мир с большими биомами
|
||||
NO_BETA_OCEAN = 0x2
|
||||
FORCE_OCEAN_VARIANTS = 0x4
|
||||
```
|
||||
|
||||
### Флаги BiomeFilter
|
||||
|
||||
```python
|
||||
BF_APPROX = 0x01 # агрессивная фильтрация (возможны false-negative)
|
||||
BF_FORCED_OCEAN = 0x04
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Класс `Generator`
|
||||
|
||||
```python
|
||||
class Generator(mc: int, flags: int = 0)
|
||||
```
|
||||
|
||||
Основной объект генерации биомов. Аллоцирует C-структуру `Generator`
|
||||
(24 КБ) и освобождает её при удалении.
|
||||
|
||||
### Свойства (только чтение)
|
||||
|
||||
| Свойство | Тип | Описание |
|
||||
|---------|-----|---------|
|
||||
| `mc` | `int` | Версия MC |
|
||||
| `dim` | `int` | Текущее измерение |
|
||||
| `seed` | `int` | Текущий сид |
|
||||
| `flags` | `int` | Флаги генератора |
|
||||
|
||||
### Методы
|
||||
|
||||
#### `apply_seed(dim, seed)`
|
||||
|
||||
Привязать сид и измерение. Должен вызываться перед любой генерацией.
|
||||
|
||||
```python
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, 123456789)
|
||||
```
|
||||
|
||||
#### `get_biome_at(x, y, z, scale=4) → int`
|
||||
|
||||
Биом в одной точке. Возвращает `BiomeID` или `-1` при ошибке.
|
||||
|
||||
```
|
||||
scale=1 → x, y, z в блочных координатах (Voronoi, медленнее)
|
||||
scale=4 → x, y, z в биомных координатах (стандарт)
|
||||
```
|
||||
|
||||
#### `gen_biomes(x, z, sx, sz, scale=4, y=0, sy=0) → array.array`
|
||||
|
||||
Генерация карты биомов прямоугольной области. Возвращает плоский
|
||||
`array.array('i')` с `sx × max(sy,1) × sz` элементами.
|
||||
|
||||
**Индексация:**
|
||||
|
||||
- 2D (`sy ≤ 1`): `result[z_i * sx + x_i]`
|
||||
- 3D (`sy > 1`): `result[y_i * sx * sz + z_i * sx + x_i]`
|
||||
|
||||
**Конвертация в NumPy:**
|
||||
|
||||
```python
|
||||
import numpy as np
|
||||
arr = np.array(g.gen_biomes(-128, -128, 256, 256), dtype=np.int32).reshape(256, 256)
|
||||
```
|
||||
|
||||
#### `get_spawn() → tuple[int, int]`
|
||||
|
||||
Точный спавн мира. **Медленно** — итерирует биомы.
|
||||
|
||||
#### `estimate_spawn() → tuple[int, int]`
|
||||
|
||||
Приблизительный спавн. Быстрее `get_spawn`.
|
||||
|
||||
#### `locate_biome(x, y, z, radius, valid_biomes) → tuple[int, int]`
|
||||
|
||||
Найти позицию с заданным биомом в квадратном радиусе. `radius` в масштабе 1:4.
|
||||
|
||||
#### `get_biome_centers(x, z, sx, sz, match, min_size=0, tolerance=4, max_results=256) → list`
|
||||
|
||||
Найти центры патчей биома. Зона задаётся в биомных координатах (scale=4).
|
||||
Возвращает список `(x, z)`.
|
||||
|
||||
#### `check_for_biomes(x, z, sx, sz, scale, dim, seed, biome_filter, y=0, sy=1) → int`
|
||||
|
||||
Многоуровневая проверка зоны на соответствие `BiomeFilter`.
|
||||
|
||||
| Возврат | Значение |
|
||||
|---------|---------|
|
||||
| `0` | не соответствует |
|
||||
| `1` | соответствует (полная проверка) |
|
||||
| `2` | соответствует (неполная) |
|
||||
|
||||
---
|
||||
|
||||
## Класс `BiomeFilter`
|
||||
|
||||
```python
|
||||
class BiomeFilter(mc, required=None, excluded=None, match_any=None, flags=0)
|
||||
```
|
||||
|
||||
Предпочтительный способ создания — через `setup_biome_filter()`.
|
||||
|
||||
---
|
||||
|
||||
## Класс `StrongholdIterator`
|
||||
|
||||
Итератор стронгхолдов. Создаётся через `iter_strongholds()`.
|
||||
|
||||
```python
|
||||
it = iter_strongholds(g, seed)
|
||||
x, z = next(it) # первый стронгхолд
|
||||
it.index # текущий счётчик
|
||||
it.next_approx # приблизительная позиция следующего
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Класс `StructureVariant`
|
||||
|
||||
Метаданные экземпляра структуры. Создаётся через `get_variant()`.
|
||||
|
||||
| Свойство | Тип | Описание |
|
||||
|---------|-----|---------|
|
||||
| `rotation` | `int` | 0=north, 1=east, 2=south, 3=west |
|
||||
| `abandoned` | `bool` | заброшенная деревня |
|
||||
| `giant` | `bool` | гигантский разрушенный портал |
|
||||
| `underground` | `bool` | подземный вариант |
|
||||
| `basement` | `bool` | иглу с подвалом |
|
||||
| `biome` | `int` | биомный вариант |
|
||||
| `pos` | `(x,y,z)` | позиция начала структуры |
|
||||
| `size` | `(sx,sy,sz)` | размер bounding box |
|
||||
|
||||
---
|
||||
|
||||
## Функции поиска структур
|
||||
|
||||
### `get_structure_config(struct_type, mc) → dict | None`
|
||||
|
||||
Конфигурация структуры для версии MC.
|
||||
|
||||
```python
|
||||
cfg = get_structure_config(StructureType.Village, MCVersion.MC_1_21)
|
||||
# {"salt": ..., "region_size": 34, "chunk_range": 8, "dim": 0, "rarity": 0.0}
|
||||
```
|
||||
|
||||
### `get_structure_pos(struct_type, mc, seed, reg_x, reg_z) → tuple | None`
|
||||
|
||||
Блочная позиция попытки генерации структуры в регионе. Возвращает `None`,
|
||||
если структура не может появиться в этом регионе.
|
||||
|
||||
### `is_viable_structure_pos(struct_type, gen, block_x, block_z, flags=0) → bool`
|
||||
|
||||
Проверить биомные требования для структуры. Генератор должен быть
|
||||
инициализирован с правильным сидом и измерением.
|
||||
|
||||
### `is_viable_feature_biome(mc, struct_type, biome_id) → bool`
|
||||
|
||||
Может ли данный биом принять данную структуру.
|
||||
|
||||
### `get_variant(struct_type, mc, seed, block_x, block_z, biome_id=-1) → StructureVariant | None`
|
||||
|
||||
Получить метаданные (поворот, флаги) экземпляра структуры.
|
||||
|
||||
### `get_mineshafts(mc, seed, chunk_x, chunk_z, chunk_w, chunk_h, max_count=1024) → list`
|
||||
|
||||
Позиции шахт в прямоугольной области (в чанках).
|
||||
|
||||
---
|
||||
|
||||
## Функции стронгхолдов и спавна
|
||||
|
||||
### `iter_strongholds(gen, seed48) → StrongholdIterator`
|
||||
|
||||
Итератор точных позиций стронгхолдов (с биомной проверкой).
|
||||
|
||||
### `init_first_stronghold(mc, seed48) → tuple[int, int]`
|
||||
|
||||
Быстрая приблизительная позиция первого стронгхолда (±112 блоков, без биом-чека).
|
||||
|
||||
---
|
||||
|
||||
## Функции биомного фильтра
|
||||
|
||||
### `setup_biome_filter(mc, required=None, excluded=None, match_any=None, flags=0) → BiomeFilter`
|
||||
|
||||
Создать фильтр. Аргументы принимают списки `BiomeID`.
|
||||
|
||||
- `required` — все биомы обязаны присутствовать
|
||||
- `excluded` — ни одного из этих биомов
|
||||
- `match_any` — хотя бы один должен присутствовать
|
||||
|
||||
---
|
||||
|
||||
## Вспомогательные функции
|
||||
|
||||
### Сиды
|
||||
|
||||
| Функция | Описание |
|
||||
|---------|---------|
|
||||
| `is_slime_chunk(seed, chunk_x, chunk_z) → bool` | слайм-чанк |
|
||||
| `get_shadow(seed) → int` | теневой сид; `get_shadow(get_shadow(s)) == s` |
|
||||
| `move_structure(base_seed, reg_x, reg_z) → int` | сдвиг структур на регионы |
|
||||
| `chunk_generate_rnd(world_seed, cx, cz) → int` | ГПСЧ пещер/структур |
|
||||
| `get_population_seed(mc, world_seed, x, z) → int` | сид декораций чанка |
|
||||
|
||||
### Свойства биомов
|
||||
|
||||
| Функция | Описание |
|
||||
|---------|---------|
|
||||
| `biome_exists(mc, biome_id) → bool` | существует ли биом в версии |
|
||||
| `is_overworld_biome(mc, biome_id) → bool` | генерируется ли в Оверворлде |
|
||||
| `get_dimension(biome_id) → int` | измерение биома |
|
||||
| `get_mutated(mc, biome_id) → int` | hills/modified вариант (-1 если нет) |
|
||||
| `get_category(mc, biome_id) → int` | климатическая категория |
|
||||
| `are_similar(mc, id1, id2) → bool` | схожий климат |
|
||||
| `is_mesa(biome_id) → bool` | badlands/mesa тип |
|
||||
| `is_shallow_ocean(biome_id) → bool` | мелкий океан |
|
||||
| `is_deep_ocean(biome_id) → bool` | глубокий океан |
|
||||
| `is_oceanic(biome_id) → bool` | любой океан |
|
||||
| `is_snowy(biome_id) → bool` | снежный биом |
|
||||
|
||||
---
|
||||
|
||||
## Модуль `cubiomes.search`
|
||||
|
||||
Быстрый поиск сидов. Подробности — в [docs/search.md](search.md).
|
||||
|
||||
### Классы данных
|
||||
|
||||
```python
|
||||
@dataclass
|
||||
class BiomeCondition:
|
||||
biome_id: int
|
||||
radius: int = 1024 # в биомных координатах
|
||||
scale: int = 4
|
||||
|
||||
@dataclass
|
||||
class StructureCondition:
|
||||
struct_type: int
|
||||
radius: int = 2048 # в блоках
|
||||
|
||||
@dataclass
|
||||
class SearchCriteria:
|
||||
mc: int = MCVersion.MC_1_21
|
||||
dim: int = Dimension.DIM_OVERWORLD
|
||||
biomes: list[BiomeCondition] = ...
|
||||
structures: list[StructureCondition] = ...
|
||||
slime_chunk: tuple | None = None
|
||||
large_biomes: bool = False
|
||||
spawn_biome: int | None = None
|
||||
```
|
||||
|
||||
### `SeedSearch`
|
||||
|
||||
```python
|
||||
class SeedSearch(criteria: SearchCriteria)
|
||||
```
|
||||
|
||||
#### `check_seed(seed, show_spawn=False, show_strongholds=0) → SeedResult | None`
|
||||
|
||||
Проверить один сид.
|
||||
|
||||
#### `run(seed_range=None, seeds=None, count=1, workers=1, ...) → Iterator[SeedResult]`
|
||||
|
||||
Итерация с параллельной обработкой. Возвращает `SeedResult` по мере нахождения.
|
||||
345
docs/guide.md
Normal file
345
docs/guide.md
Normal file
|
|
@ -0,0 +1,345 @@
|
|||
# cubiomes — руководство пользователя
|
||||
|
||||
**cubiomes** — это Python/Cython-биндинг к библиотеке
|
||||
[cubiomes](https://github.com/xpple/cubiomes), обеспечивающей быструю генерацию
|
||||
биомов и структур Minecraft без запуска самой игры.
|
||||
|
||||
---
|
||||
|
||||
## Установка
|
||||
|
||||
```bash
|
||||
# Зависимости
|
||||
pip install cython
|
||||
|
||||
# Сборка в режиме разработки (in-place)
|
||||
git clone https://github.com/xpple/cubiomes.git _cubiomes_src
|
||||
python setup.py build_ext --inplace
|
||||
pip install -e .
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Концепции
|
||||
|
||||
### Генератор
|
||||
|
||||
Центральный объект — `Generator`. Он настраивается один раз под версию Minecraft,
|
||||
а затем «заполняется» сидом и измерением методом `apply_seed`.
|
||||
|
||||
```python
|
||||
from cubiomes import Generator, MCVersion, Dimension
|
||||
|
||||
g = Generator(MCVersion.MC_1_21) # создать под версию
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, 123456789) # привязать сид
|
||||
```
|
||||
|
||||
Один генератор можно переключать между сидами и измерениями вызовом `apply_seed`.
|
||||
|
||||
### Масштаб координат
|
||||
|
||||
Большинство функций принимают параметр `scale`:
|
||||
|
||||
| scale | что это | когда использовать |
|
||||
|------:|---------|-------------------|
|
||||
| `1` | блочные координаты (Voronoi) | точный биом одного блока |
|
||||
| `4` | биомные координаты (по умолчанию) | карты биомов, поиск |
|
||||
| `16` | крупный масштаб | быстрый обзор |
|
||||
| `64` | очень крупный | проверка температурных зон |
|
||||
| `256` | максимальный | грубая фильтрация |
|
||||
|
||||
> Биомные координаты = блочные ÷ 4. Передавайте `y=63//4=15` для уровня моря
|
||||
> при scale=4.
|
||||
|
||||
---
|
||||
|
||||
## Использование генератора
|
||||
|
||||
### Биом в точке
|
||||
|
||||
```python
|
||||
from cubiomes import Generator, MCVersion, Dimension, BiomeID
|
||||
|
||||
g = Generator(MCVersion.MC_1_21)
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, 123456789)
|
||||
|
||||
# Блочные координаты (точный биом, медленнее)
|
||||
biome = g.get_biome_at(100, 63, 200, scale=1)
|
||||
|
||||
# Биомные координаты ÷4 (стандарт, быстрее)
|
||||
biome = g.get_biome_at(25, 15, 50, scale=4)
|
||||
|
||||
print(BiomeID(biome).name) # → "forest"
|
||||
```
|
||||
|
||||
### Карта биомов региона
|
||||
|
||||
```python
|
||||
# Генерирует плоскую карту 256×256 в биомных координатах
|
||||
ids = g.gen_biomes(x=-128, z=-128, sx=256, sz=256, scale=4)
|
||||
|
||||
# ids — array.array('i') длиной 256*256
|
||||
# Индексирование: ids[z_index * sx + x_index]
|
||||
|
||||
# Конвертация в numpy (опционально):
|
||||
import numpy as np
|
||||
grid = np.array(ids, dtype=np.int32).reshape(256, 256)
|
||||
# grid[z_index, x_index]
|
||||
```
|
||||
|
||||
### Нахождение спавна
|
||||
|
||||
```python
|
||||
spawn = g.estimate_spawn() # быстро, приблизительно
|
||||
spawn = g.get_spawn() # медленно, точно (проверяет траву)
|
||||
print(f"Spawn: {spawn}")
|
||||
```
|
||||
|
||||
### Поиск биома в радиусе
|
||||
|
||||
```python
|
||||
# Найти ближайший mushroom_fields в радиусе 8000 блоков от (0,0,0)
|
||||
pos = g.locate_biome(0, 0, 0, radius=2000, valid_biomes=[BiomeID.mushroom_fields])
|
||||
# radius здесь в биомных координатах (~8000 блоков)
|
||||
```
|
||||
|
||||
### Центры регионов биома
|
||||
|
||||
```python
|
||||
# Найти центры patch'ей biome badlands в области 512×512 биомных клеток
|
||||
centers = g.get_biome_centers(
|
||||
x=-256, z=-256, sx=512, sz=512,
|
||||
match=BiomeID.badlands,
|
||||
min_size=50, # минимум 50 биомных клеток
|
||||
)
|
||||
for x, z in centers:
|
||||
print(f"Badlands patch center at biome coords ({x}, {z})")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Структуры
|
||||
|
||||
### Позиция структуры
|
||||
|
||||
```python
|
||||
from cubiomes import (
|
||||
StructureType, get_structure_pos,
|
||||
is_viable_structure_pos, get_structure_config,
|
||||
)
|
||||
|
||||
seed = 123456789
|
||||
mc = MCVersion.MC_1_21
|
||||
|
||||
# Найти позицию деревни в регионе (0, 0)
|
||||
pos = get_structure_pos(StructureType.Village, mc, seed, reg_x=0, reg_z=0)
|
||||
if pos:
|
||||
print(f"Village generation attempt at {pos}")
|
||||
|
||||
# Проверить биомы (нужен инициализированный генератор)
|
||||
g = Generator(mc)
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, seed)
|
||||
|
||||
if is_viable_structure_pos(StructureType.Village, g, pos[0], pos[1]):
|
||||
print("Village will actually spawn here!")
|
||||
```
|
||||
|
||||
> **Регионы**: Minecraft делит мир на регионы (обычно 32×32 чанка).
|
||||
> Проверяйте несколько регионов вокруг нужной зоны.
|
||||
|
||||
### Перебор регионов в области
|
||||
|
||||
```python
|
||||
import math
|
||||
|
||||
def find_structures_near(seed, mc, struct_type, radius_blocks=2000):
|
||||
"""Найти все структуры в радиусе radius_blocks от (0,0)."""
|
||||
cfg = get_structure_config(struct_type, mc)
|
||||
if not cfg:
|
||||
return []
|
||||
region_blocks = cfg["region_size"] * 16
|
||||
max_reg = math.ceil(radius_blocks / region_blocks) + 1
|
||||
|
||||
g = Generator(mc)
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, seed)
|
||||
results = []
|
||||
|
||||
for rx in range(-max_reg, max_reg + 1):
|
||||
for rz in range(-max_reg, max_reg + 1):
|
||||
pos = get_structure_pos(struct_type, mc, seed, rx, rz)
|
||||
if pos is None:
|
||||
continue
|
||||
x, z = pos
|
||||
if abs(x) > radius_blocks or abs(z) > radius_blocks:
|
||||
continue
|
||||
if is_viable_structure_pos(struct_type, g, x, z):
|
||||
results.append(pos)
|
||||
|
||||
return results
|
||||
|
||||
villages = find_structures_near(123456789, MCVersion.MC_1_21, StructureType.Village)
|
||||
print(f"Villages within 2000 blocks: {villages}")
|
||||
```
|
||||
|
||||
### Вариант структуры
|
||||
|
||||
```python
|
||||
from cubiomes import get_variant
|
||||
|
||||
# Получить поворот, координаты, флаги (заброшенная и т.д.)
|
||||
sv = get_variant(StructureType.Village, mc, seed,
|
||||
block_x=pos[0], block_z=pos[1],
|
||||
biome_id=BiomeID.plains)
|
||||
if sv:
|
||||
print(f"Rotation: {sv.rotation}") # 0=north, 1=east, 2=south, 3=west
|
||||
print(f"Abandoned: {sv.abandoned}")
|
||||
print(f"Bounding box pos: {sv.pos}, size: {sv.size}")
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Стронгхолды
|
||||
|
||||
```python
|
||||
from cubiomes import iter_strongholds, init_first_stronghold
|
||||
|
||||
# Быстрая приблизительная позиция первого стронгхолда (±112 блоков)
|
||||
approx = init_first_stronghold(MCVersion.MC_1_21, seed=123456789)
|
||||
print(f"First stronghold approximately at {approx}")
|
||||
|
||||
# Точные позиции с биомной проверкой
|
||||
g = Generator(MCVersion.MC_1_21)
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, 123456789)
|
||||
|
||||
for i, (x, z) in enumerate(iter_strongholds(g, seed=123456789)):
|
||||
dist = math.sqrt(x**2 + z**2)
|
||||
print(f"Stronghold {i}: ({x}, {z}) ~{dist:.0f} blocks")
|
||||
if i >= 9:
|
||||
break
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Biome Filter (фильтрация сидов)
|
||||
|
||||
`BiomeFilter` + `check_for_biomes` используют многоуровневую фильтрацию
|
||||
(от грубого scale=256 до точного scale=4), что на порядок быстрее простого
|
||||
перебора с `gen_biomes`.
|
||||
|
||||
```python
|
||||
from cubiomes import setup_biome_filter, BiomeID, MCVersion, Dimension
|
||||
|
||||
mc = MCVersion.MC_1_21
|
||||
|
||||
# Все три биома должны присутствовать в области 512×512
|
||||
bf = setup_biome_filter(
|
||||
mc,
|
||||
required=[BiomeID.mushroom_fields, BiomeID.badlands, BiomeID.jungle],
|
||||
)
|
||||
|
||||
g = Generator(mc)
|
||||
|
||||
for seed in range(10_000_000):
|
||||
result = g.check_for_biomes(
|
||||
x=-256, z=-256, sx=512, sz=512, scale=4,
|
||||
dim=Dimension.DIM_OVERWORLD,
|
||||
seed=seed,
|
||||
biome_filter=bf,
|
||||
)
|
||||
if result: # 1 = полная проверка пройдена
|
||||
print(f"Found: {seed}")
|
||||
break
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Вспомогательные функции
|
||||
|
||||
### Слайм-чанки
|
||||
|
||||
```python
|
||||
from cubiomes import is_slime_chunk
|
||||
|
||||
if is_slime_chunk(seed=123456789, chunk_x=0, chunk_z=1):
|
||||
print("Slime chunk!")
|
||||
```
|
||||
|
||||
### Теневой сид
|
||||
|
||||
```python
|
||||
from cubiomes import get_shadow
|
||||
|
||||
shadow = get_shadow(seed)
|
||||
# get_shadow(get_shadow(seed)) == seed — всегда
|
||||
```
|
||||
|
||||
### Перемещение структур
|
||||
|
||||
```python
|
||||
from cumiomes import move_structure
|
||||
|
||||
# Сместить базовый сид так, чтобы структуры сдвинулись на 1 регион по X
|
||||
shifted = move_structure(base_seed, reg_x=1, reg_z=0)
|
||||
```
|
||||
|
||||
### Хелперы биомов
|
||||
|
||||
```python
|
||||
from cubiomes import (biome_exists, is_overworld_biome, get_dimension,
|
||||
is_oceanic, is_mesa, is_snowy, get_category)
|
||||
|
||||
biome_exists(MCVersion.MC_1_20, BiomeID.cherry_grove) # False
|
||||
biome_exists(MCVersion.MC_1_21, BiomeID.cherry_grove) # True
|
||||
|
||||
is_oceanic(BiomeID.deep_ocean) # True
|
||||
is_mesa(BiomeID.badlands) # True
|
||||
is_snowy(BiomeID.snowy_tundra) # True
|
||||
get_dimension(BiomeID.the_end) # 1
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Измерения
|
||||
|
||||
```python
|
||||
# Незер
|
||||
g = Generator(MCVersion.MC_1_21)
|
||||
g.apply_seed(Dimension.DIM_NETHER, seed)
|
||||
biome = g.get_biome_at(0, 64, 0, scale=4)
|
||||
print(BiomeID(biome).name) # → "nether_wastes"
|
||||
|
||||
# Энд
|
||||
g.apply_seed(Dimension.DIM_END, seed)
|
||||
biome = g.get_biome_at(0, 0, 0, scale=4)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Многопоточность и производительность
|
||||
|
||||
- `Generator` **не является потокобезопасным** — создавайте отдельный экземпляр
|
||||
на каждый поток/процесс.
|
||||
- Для параллельного перебора используйте `multiprocessing` (не `threading`, GIL).
|
||||
- `cubiomes.search.SeedSearch` уже делает это через `ProcessPoolExecutor`.
|
||||
- `check_for_biomes` (многоуровневый фильтр) значительно быстрее, чем
|
||||
`gen_biomes` + ручная проверка.
|
||||
|
||||
```python
|
||||
# Пример параллельного поиска
|
||||
from cubiomes.search import SearchCriteria, BiomeCondition, SeedSearch
|
||||
from cubiomes import MCVersion, BiomeID
|
||||
|
||||
criteria = SearchCriteria(
|
||||
mc=MCVersion.MC_1_21,
|
||||
biomes=[BiomeCondition(BiomeID.mushroom_fields, radius=2000)],
|
||||
)
|
||||
search = SeedSearch(criteria)
|
||||
|
||||
for result in search.run(
|
||||
seed_range=(0, 100_000_000),
|
||||
count=10,
|
||||
workers=4, # 4 параллельных процесса
|
||||
batch_size=8192, # зёрна на один батч
|
||||
):
|
||||
print(result.seed, result.biome_positions)
|
||||
```
|
||||
536
docs/search.md
Normal file
536
docs/search.md
Normal file
|
|
@ -0,0 +1,536 @@
|
|||
# cubiomes-search — CLI поиска сидов (с продвинутыми условиями)
|
||||
|
||||
`cubiomes.search` — модуль для поиска Minecraft-сидов, удовлетворяющих
|
||||
условиям по биомам, структурам и прочему. Работает как CLI-утилита и
|
||||
как Python-библиотека.
|
||||
|
||||
---
|
||||
|
||||
## Запуск
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search [OPTIONS]
|
||||
# или после pip install:
|
||||
cubiomes-search [OPTIONS]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Типы условий
|
||||
|
||||
| Тип | Класс Python | CLI-флаг |
|
||||
|-----|-------------|---------|
|
||||
| Биом рядом с началом координат | `BiomeCondition` | `--biome NAME...` |
|
||||
| Хотя бы один из биомов (OR) | `AnyOfBiomes` | `--any-biome NAME...` |
|
||||
| Структура рядом с началом | `StructureCondition` | `--structure NAME...` |
|
||||
| Спавн в заданном радиусе/биоме | `SpawnCondition` | `--spawn-max-dist / --spawn-biome` |
|
||||
| Первые N стронгхолдов в радиусе | `StrongholdCondition` | `--stronghold-radius / --stronghold-count` |
|
||||
| Две структуры близко друг к другу | `ProximityCondition` | `--proximity A B D` |
|
||||
| Квад-база структуры | `QuadStructureCondition` | `--quad STRUCT` |
|
||||
| Плотность биома в области | `BiomeDensityCondition` | `--biome-density BIOME FRAC` |
|
||||
| Минимум слайм-чанков | `SlimeDensityCondition` | `--min-slime-chunks N` |
|
||||
| Произвольный код | `CustomCondition` | — (только Python API) |
|
||||
|
||||
Все условия работают с **AND-семантикой** — сид должен пройти каждое из них.
|
||||
|
||||
---
|
||||
|
||||
## Аргументы командной строки
|
||||
|
||||
### Источник сидов (взаимоисключающие)
|
||||
|
||||
| Аргумент | Описание |
|
||||
|---------|---------|
|
||||
| `--seed N` | Проверить один конкретный сид |
|
||||
| `--seeds START:STOP` | Перебрать диапазон (включительно) |
|
||||
| `--random-seeds` | Случайные 64-битные сиды (бесконечно) |
|
||||
|
||||
Если ничего не указано — используется `--random-seeds`.
|
||||
|
||||
### Версия Minecraft
|
||||
|
||||
```
|
||||
--mc VERSION Строка версии, например: '1.21', '1.18.2', 'b1.7'
|
||||
По умолчанию: 1.21
|
||||
--large-biomes Использовать тип мира Large Biomes
|
||||
```
|
||||
|
||||
### Условия по биомам
|
||||
|
||||
```
|
||||
--biome NAME [NAME ...]
|
||||
Один или несколько биомов, все должны присутствовать.
|
||||
Имена из BiomeID: mushroom_fields, badlands, cherry_grove, ...
|
||||
|
||||
--biome-radius R
|
||||
Радиус поиска в биомных координатах (≈ R×4 блоков).
|
||||
По умолчанию: 1024 (~4096 блоков)
|
||||
|
||||
--spawn-biome NAME
|
||||
Биом в точке спавна мира.
|
||||
```
|
||||
|
||||
### Условия по структурам
|
||||
|
||||
```
|
||||
--structure NAME [NAME ...]
|
||||
Структуры, все должны быть жизнеспособны (с проверкой биома).
|
||||
Имена из StructureType: Village, Monument, Mansion, Desert_Pyramid, ...
|
||||
|
||||
--struct-radius R
|
||||
Максимальное расстояние от начала координат в блоках.
|
||||
По умолчанию: 2048
|
||||
```
|
||||
|
||||
### Прочие условия
|
||||
|
||||
```
|
||||
--slime-chunk CX CZ
|
||||
Чанк (CX, CZ) должен быть слайм-чанком.
|
||||
|
||||
--spawn-biome NAME
|
||||
Биом в точке спавна мира.
|
||||
|
||||
--spawn-max-dist D
|
||||
Спавн мира не дальше D блоков от (0, 0).
|
||||
|
||||
--stronghold-radius R
|
||||
Первый N стронгхолдов должны быть в радиусе R блоков от начала.
|
||||
|
||||
--stronghold-count N
|
||||
Количество стронгхолдов для проверки (по умолчанию: 1).
|
||||
|
||||
--proximity STRUCT_A STRUCT_B DIST
|
||||
STRUCT_A и STRUCT_B должны быть в DIST блоках друг от друга.
|
||||
Флаг повторяемый: --proximity Village Monument 400 --proximity Village Mansion 2000
|
||||
|
||||
--quad STRUCT
|
||||
Квад-база: 4 жизнеспособных экземпляра STRUCT в сетке 2×2 регионов,
|
||||
все в пределах --quad-dist блоков от общего центроида.
|
||||
|
||||
--quad-dist R Максимальный радиус от центроида (по умолчанию: 128)
|
||||
--quad-max-regions N Поиск в ±N регионах от нуля (по умолчанию: 4)
|
||||
|
||||
--biome-density BIOME FRACTION
|
||||
Не менее FRACTION (0–1) заданной области должно быть биомом BIOME.
|
||||
Область задаётся через --biome-density-area.
|
||||
|
||||
--biome-density-area X Z SX SZ
|
||||
Биомные координаты области для --biome-density (по умолчанию: -256 -256 512 512)
|
||||
|
||||
--min-slime-chunks N
|
||||
Минимум N слайм-чанков в области из --slime-area.
|
||||
|
||||
--slime-area CX CZ CW CH
|
||||
Область чанков для --min-slime-chunks (по умолчанию: -4 -4 9 9)
|
||||
```
|
||||
|
||||
### Вывод
|
||||
|
||||
```
|
||||
--count N Остановиться после N найденных сидов (0 = без ограничений)
|
||||
--format text | json | csv (по умолчанию: text)
|
||||
--show-spawn Включить приблизительный спавн в вывод
|
||||
--show-strongholds N Первые N стронгхолдов в вывод
|
||||
|
||||
--info При --seed: подробная информация о сиде
|
||||
```
|
||||
|
||||
### Производительность
|
||||
|
||||
```
|
||||
--workers N Параллельных процессов (по умолчанию: 1)
|
||||
--batch-size N Сидов на батч (по умолчанию: 4096)
|
||||
--no-progress Не выводить счётчик прогресса
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Примеры использования
|
||||
|
||||
### Проверить один сид
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search --seed 123456789 --info
|
||||
```
|
||||
|
||||
```
|
||||
Seed: 123456789 (1.21.11)
|
||||
Shadow: 11066951453057188608
|
||||
Spawn: (64, -48) biome=forest
|
||||
|
||||
First 5 strongholds:
|
||||
[0] (-1116, -1596) (1947 blocks from origin)
|
||||
[1] (2468, -108) (2470 blocks from origin)
|
||||
...
|
||||
|
||||
Biomes at scale 4 (sample points):
|
||||
( 0, 0) river
|
||||
( 256, 0) ocean
|
||||
...
|
||||
|
||||
Common structures near origin:
|
||||
Village (-272, 160) (316 blocks)
|
||||
Monument (1200, 0) (1200 blocks)
|
||||
|
||||
Slime chunks (9×9 area): 3 found
|
||||
(-3, -2) (0, 1) (2, 0)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Найти 5 сидов с грибным островом и бедлендами
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--biome mushroom_fields badlands \
|
||||
--biome-radius 3000 \
|
||||
--count 5
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Деревня и монумент в 500 блоках от старта
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--structure Village Monument \
|
||||
--struct-radius 500 \
|
||||
--count 3 \
|
||||
--show-spawn
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Поиск в диапазоне с 4 процессами
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--seeds 0:100000000 \
|
||||
--mc 1.21 \
|
||||
--biome cherry_grove \
|
||||
--biome-radius 2000 \
|
||||
--workers 4 \
|
||||
--count 20 \
|
||||
--no-progress
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### Квад-база ведьминых хижин
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--quad Swamp_Hut --quad-dist 128 \
|
||||
--count 3 --seeds 0:100000000 --workers 4
|
||||
```
|
||||
|
||||
```
|
||||
seed=3256984 (1.21.11)
|
||||
struct Swamp_Hut_quad_0 block-coords (-1648, 2384)
|
||||
struct Swamp_Hut_quad_1 block-coords (-1392, 2336)
|
||||
struct Swamp_Hut_quad_2 block-coords (-1600, 2576)
|
||||
struct Swamp_Hut_quad_3 block-coords (-1344, 2528)
|
||||
quad Swamp_Hut center (-1496, 2456) positions [...]
|
||||
```
|
||||
|
||||
### Спавн близко к стартовой точке И деревня рядом
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--spawn-max-dist 200 \
|
||||
--spawn-biome plains \
|
||||
--structure Village --struct-radius 500 \
|
||||
--count 5 --no-progress
|
||||
```
|
||||
|
||||
### Две структуры близко друг к другу
|
||||
|
||||
```bash
|
||||
# Village и Ancient City в 500 блоках друг от друга
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--proximity Village Ancient_City 500 \
|
||||
--struct-radius 3000 \
|
||||
--count 3
|
||||
```
|
||||
|
||||
### OR-биомы + минимум слайм-чанков
|
||||
|
||||
```bash
|
||||
# Любой редкий биом рядом + минимум 6 слайм-чанков в 9×9
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--any-biome mushroom_fields cherry_grove pale_garden \
|
||||
--biome-radius 2000 \
|
||||
--min-slime-chunks 6 \
|
||||
--count 5
|
||||
```
|
||||
|
||||
### Плотность биома > 20%
|
||||
|
||||
```bash
|
||||
# Минимум 20% площади 512×512 вокруг нуля — бэдлэнды
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--biome-density badlands 0.20 \
|
||||
--biome-density-area -256 -256 512 512 \
|
||||
--count 3
|
||||
```
|
||||
|
||||
### Вывод в JSON
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--structure Village \
|
||||
--struct-radius 300 \
|
||||
--count 10 \
|
||||
--format json \
|
||||
--show-spawn \
|
||||
--show-strongholds 3 \
|
||||
> results.json
|
||||
```
|
||||
|
||||
Пример JSON-объекта:
|
||||
|
||||
```json
|
||||
{
|
||||
"seed": 8,
|
||||
"mc": 32,
|
||||
"mc_name": "1.21.11",
|
||||
"biome_positions": {},
|
||||
"structure_positions": {
|
||||
"Village": [16, -224]
|
||||
},
|
||||
"spawn": [64, -48],
|
||||
"spawn_biome": 4,
|
||||
"strongholds": [[-1116, -1596], [2468, -108], [-908, 1636]]
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### CSV для последующей обработки
|
||||
|
||||
```bash
|
||||
python -m cubiomes.search \
|
||||
--mc 1.21 \
|
||||
--structure Village Monument \
|
||||
--struct-radius 1000 \
|
||||
--seeds 0:5000000 \
|
||||
--format csv \
|
||||
--count 100 \
|
||||
> seeds.csv
|
||||
```
|
||||
|
||||
```
|
||||
seed,mc,biomes,structures,spawn_x,spawn_z,spawn_biome
|
||||
1,,,"Village@-240,-912|Monument@816,-272",,,
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Python API
|
||||
|
||||
### Простой однострочный поиск
|
||||
|
||||
```python
|
||||
from cubiomes.search import SearchCriteria, BiomeCondition, SeedSearch
|
||||
from cubiomes import MCVersion, BiomeID
|
||||
|
||||
criteria = SearchCriteria(
|
||||
mc=MCVersion.MC_1_21,
|
||||
biomes=[
|
||||
BiomeCondition(BiomeID.mushroom_fields, radius=2000),
|
||||
BiomeCondition(BiomeID.badlands, radius=3000),
|
||||
],
|
||||
)
|
||||
|
||||
search = SeedSearch(criteria)
|
||||
result = search.run(
|
||||
seed_range=(0, 50_000_000),
|
||||
count=1,
|
||||
).__next__()
|
||||
|
||||
print(result.seed)
|
||||
print(result.biome_positions)
|
||||
```
|
||||
|
||||
### Проверка одного сида
|
||||
|
||||
```python
|
||||
from cubiomes.search import SearchCriteria, StructureCondition, SeedSearch
|
||||
from cubiomes import MCVersion, StructureType
|
||||
|
||||
criteria = SearchCriteria(
|
||||
mc=MCVersion.MC_1_21,
|
||||
structures=[StructureCondition(StructureType.Village, radius=300)],
|
||||
)
|
||||
result = SeedSearch(criteria).check_seed(
|
||||
123456789,
|
||||
show_spawn=True,
|
||||
show_strongholds=3,
|
||||
)
|
||||
if result:
|
||||
print(result)
|
||||
```
|
||||
|
||||
### Параллельный поиск с колбэком прогресса
|
||||
|
||||
```python
|
||||
from cubiomes.search import SearchCriteria, StructureCondition, SeedSearch
|
||||
from cubiomes import MCVersion, StructureType
|
||||
|
||||
criteria = SearchCriteria(
|
||||
mc=MCVersion.MC_1_21,
|
||||
structures=[
|
||||
StructureCondition(StructureType.Village, radius=500),
|
||||
StructureCondition(StructureType.Monument, radius=500),
|
||||
],
|
||||
)
|
||||
|
||||
def on_progress(checked, found, rate):
|
||||
print(f"\r{checked:,} seeds checked | {found} found | {rate:,.0f}/s",
|
||||
end="", flush=True)
|
||||
|
||||
results = []
|
||||
for r in SeedSearch(criteria).run(
|
||||
seed_range=(0, 10_000_000),
|
||||
count=5,
|
||||
workers=4,
|
||||
progress_cb=on_progress,
|
||||
):
|
||||
results.append(r)
|
||||
print(f"\nFound seed: {r.seed}")
|
||||
|
||||
print(f"\nTotal results: {len(results)}")
|
||||
```
|
||||
|
||||
### Продвинутые условия через Python API
|
||||
|
||||
```python
|
||||
from cubiomes.search import (
|
||||
SearchCriteria, SeedSearch,
|
||||
SpawnCondition, StrongholdCondition, ProximityCondition,
|
||||
QuadStructureCondition, BiomeDensityCondition,
|
||||
SlimeDensityCondition, AnyOfBiomes, CustomCondition,
|
||||
)
|
||||
from cubiomes import MCVersion, BiomeID, StructureType, Dimension, Generator
|
||||
|
||||
# ── SpawnCondition ─────────────────────────────────────────────────────────
|
||||
SpawnCondition(max_distance=500) # спавн ≤ 500 блоков от (0,0)
|
||||
SpawnCondition(biome_id=BiomeID.plains) # спавн в равнинах
|
||||
SpawnCondition(max_distance=300, biome_id=BiomeID.forest) # оба условия
|
||||
|
||||
# ── StrongholdCondition ────────────────────────────────────────────────────
|
||||
StrongholdCondition(count=1, max_distance=2000) # первый стронгхолд < 2000 блоков
|
||||
StrongholdCondition(count=3, max_distance=5000) # первые 3 стронгхолда < 5000 блоков
|
||||
|
||||
# ── ProximityCondition ─────────────────────────────────────────────────────
|
||||
ProximityCondition(
|
||||
struct_a=StructureType.Village,
|
||||
struct_b=StructureType.Monument,
|
||||
max_dist=400, # максимальное расстояние между ними
|
||||
search_radius=3000, # радиус поиска от начала координат
|
||||
)
|
||||
|
||||
# ── QuadStructureCondition ─────────────────────────────────────────────────
|
||||
QuadStructureCondition(
|
||||
struct_type=StructureType.Swamp_Hut,
|
||||
max_dist=128, # все 4 хижины в 128 блоках от центроида
|
||||
max_regions=4, # искать в ±4 регионах от нуля
|
||||
)
|
||||
|
||||
# ── BiomeDensityCondition ──────────────────────────────────────────────────
|
||||
BiomeDensityCondition(
|
||||
biome_id=BiomeID.badlands,
|
||||
min_fraction=0.20, # минимум 20% площади
|
||||
x=-256, z=-256,
|
||||
sx=512, sz=512,
|
||||
scale=4,
|
||||
)
|
||||
|
||||
# ── SlimeDensityCondition ──────────────────────────────────────────────────
|
||||
SlimeDensityCondition(
|
||||
min_count=6, # минимум 6 слайм-чанков
|
||||
cx=-4, cz=-4,
|
||||
cw=9, ch=9, # область 9×9 чанков
|
||||
)
|
||||
|
||||
# ── AnyOfBiomes ────────────────────────────────────────────────────────────
|
||||
AnyOfBiomes(
|
||||
biome_ids=[BiomeID.mushroom_fields, BiomeID.cherry_grove],
|
||||
radius=2000,
|
||||
)
|
||||
|
||||
# ── CustomCondition ────────────────────────────────────────────────────────
|
||||
def my_filter(seed: int, mc: int):
|
||||
\"\"\"Returns dict on success, False on failure.\"\"\"
|
||||
g = Generator(mc)
|
||||
g.apply_seed(Dimension.DIM_OVERWORLD, seed)
|
||||
# ... any logic ...
|
||||
return {"my_data": 42} # True-y value with extra data
|
||||
|
||||
CustomCondition(my_filter)
|
||||
```
|
||||
|
||||
**Полный пример с несколькими условиями:**
|
||||
|
||||
```python
|
||||
criteria = SearchCriteria(
|
||||
mc=MCVersion.MC_1_21,
|
||||
# Базовые условия (AND)
|
||||
biomes=[BiomeCondition(BiomeID.mushroom_fields, radius=2000)],
|
||||
structures=[StructureCondition(StructureType.Village, radius=500)],
|
||||
# Продвинутые условия (AND)
|
||||
conditions=[
|
||||
SpawnCondition(max_distance=300),
|
||||
StrongholdCondition(count=1, max_distance=2000),
|
||||
SlimeDensityCondition(min_count=5),
|
||||
AnyOfBiomes([BiomeID.cherry_grove, BiomeID.pale_garden], radius=3000),
|
||||
],
|
||||
)
|
||||
|
||||
search = SeedSearch(criteria)
|
||||
for result in search.run(seed_range=(0, 100_000_000), count=5, workers=4):
|
||||
print(f"Seed {result.seed}:")
|
||||
print(f" Mushroom fields at: {result.biome_positions}")
|
||||
print(f" Village at: {result.structure_positions.get('Village')}")
|
||||
print(f" Spawn: {result.spawn}")
|
||||
print(f" Slime chunks: {result.extra.get('slime_chunk_count')}")
|
||||
print()
|
||||
```
|
||||
|
||||
### `SeedResult` атрибуты
|
||||
|
||||
| Атрибут | Тип | Описание |
|
||||
|---------|-----|---------|
|
||||
| `seed` | `int` | Мировой сид |
|
||||
| `mc` | `int` | Версия MC |
|
||||
| `biome_positions` | `dict[str, (x,z)]` | Биомы в биомных координатах |
|
||||
| `structure_positions` | `dict[str, (x,z)]` | Структуры в блочных координатах |
|
||||
| `spawn` | `(x,z) | None` | Приблизительный спавн |
|
||||
| `spawn_biome` | `int | None` | Биом спавна |
|
||||
| `strongholds` | `list[(x,z)]` | Список стронгхолдов |
|
||||
| `as_dict()` | `dict` | JSON-сериализуемый словарь |
|
||||
|
||||
---
|
||||
|
||||
## Скорость поиска
|
||||
|
||||
Ориентировочные значения на одном процессе:
|
||||
|
||||
| Тип проверки | сидов/сек |
|
||||
|-------------|----------|
|
||||
| `is_slime_chunk` | ~50 000 000 |
|
||||
| `get_biome_at` (scale=4) | ~500 000 |
|
||||
| `gen_biomes` 64×64 (scale=4) | ~50 000 |
|
||||
| `check_for_biomes` (multi-scale) | ~200 000 |
|
||||
| `is_viable_structure_pos` | ~200 000 |
|
||||
|
||||
С `--workers 4` скорость линейно масштабируется (примерно ×3.5–4).
|
||||
Loading…
Add table
Add a link
Reference in a new issue