5.5 KiB
Changelog
All notable changes to active-cubiomes are documented here.
Format follows Keep a Changelog. Versioning follows Semantic Versioning.
0.2.0 — 2026-10-12
Added
Advanced search conditions — SearchCriteria.conditions now accepts any
mix of the following new types in addition to the existing BiomeCondition
and StructureCondition:
| Class | CLI flag | Description |
|---|---|---|
SpawnCondition |
--spawn-biome / --spawn-max-dist |
Constrain spawn biome and/or distance from origin |
StrongholdCondition |
--stronghold-radius / --stronghold-count |
First N strongholds within a block radius |
ProximityCondition |
--proximity A B DIST |
Two structure types within DIST blocks of each other |
QuadStructureCondition |
--quad STRUCT / --quad-dist |
Classic quad-farm base: 4 viable instances in a 2×2 region grid |
BiomeDensityCondition |
--biome-density BIOME FRAC |
Minimum biome coverage fraction in an area |
SlimeDensityCondition |
--min-slime-chunks N |
Minimum slime-chunk count in a configurable chunk area |
AnyOfBiomes |
--any-biome NAME... |
OR semantics — at least one of a list of biomes must be present |
CustomCondition |
— (Python API only) | Arbitrary (seed, mc) → bool | dict function as a post-filter |
SeedResult extended:
quad— quad-structure result dict (center,positions,max_r,name)extra— free-form dict populated byBiomeDensityCondition,SlimeDensityCondition, andCustomCondition
Documentation added under docs/:
docs/guide.md— user guide with code examplesdocs/api.md— full API referencedocs/search.md— CLI and Python search API reference
cubiomes/__main__.py — enables python -m cubiomes as an alias for
python -m cubiomes.search.
cubiomes-search entry point registered via pyproject.toml so the CLI
is available after pip install active-cubiomes.
Fixed
-
OverflowError: can't convert negative value to uint64_twhen passing negative world seeds (e.g. from--random-seeds). All public Cython wrapper functions that accept a seed now uselong long(int64) as the parameter type and cast touint64_tinternally, matching Minecraft'slongseed semantics. Affected functions:apply_seed,check_for_biomes,StrongholdIterator.__cinit__,get_structure_pos,get_variant,iter_strongholds,init_first_stronghold,get_mineshafts,is_slime_chunk,get_shadow,move_structure,chunk_generate_rnd,get_population_seed. -
_find_biomeinsearch.pyreplaced stochasticlocate_biome(random walk, ~37 % miss-rate on common biomes at small radii) with deterministicget_biome_centersscan, eliminating false-negative search results. -
Nether/End structures (
Fortress,Bastion,End_City, …) no longer trigger spuriousisViableStructurePos: bad structure type N or dimension 0warnings when an Overworld generator is active — they are skipped based on thedimfield of theirStructureConfig.
Changed
setup.pyC source glob now produces relative paths (viaos.path.relpath) to satisfy setuptools' requirement when building a wheel from an sdist.pyproject.tomlbuild-backend corrected tosetuptools.build_meta(wassetuptools.backends.legacy:buildwhich does not exist in setuptools 84).- License classifier removed from
classifierslist (superseded by thelicense = "MIT"SPDX expression per PEP 639).
0.1.1 — 2026-10-12
Fixed
OverflowErroron negative seeds passed toapply_seedand related functions (initial partial fix; superseded by the comprehensive fix in 0.2.0).
0.1.0 — 2026-10-12
Added
- Cython bindings for cubiomes C
library, compiled into a single shared object (
cubiomes._wrapper). Generatorclass —apply_seed,get_biome_at,gen_biomes,get_spawn,estimate_spawn,locate_biome,get_biome_centers,check_for_biomes.BiomeFilter/setup_biome_filter— multi-scale biome requirement filter compatible withcheck_for_biomes.StrongholdIterator— yields accurate stronghold positions with biome verification viaiter_strongholds.StructureVariant— structure rotation, bounding box, and flags viaget_variant.- Structure functions —
get_structure_config,get_structure_pos,is_viable_structure_pos,is_viable_feature_biome,get_mineshafts. - Biome helpers —
biome_exists,is_overworld_biome,get_dimension,get_mutated,get_category,are_similar,is_mesa,is_shallow_ocean,is_deep_ocean,is_oceanic,is_snowy. - Seed utilities —
is_slime_chunk,get_shadow,move_structure,chunk_generate_rnd,get_population_seed. cubiomes.searchmodule withSearchCriteria,BiomeCondition,StructureCondition,SeedSearch,SeedResultand thecubiomes-searchCLI.MCVersion,Dimension,BiomeID,StructureTypeIntEnumclasses covering all versions up to MC 26.3.- 107 pytest tests covering bindings and search module.
pyproject.toml,MANIFEST.in,README.md,LICENSE.