MCPcopy Index your code
hub / github.com/aevyrie/big_space

github.com/aevyrie/big_space @v0.12.0

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.12.0 ↗ · + Follow
380 symbols 1,073 edges 36 files 111 documented · 29%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Big Space

partitioning screenshot

Huge worlds, high performance, no dependencies, ecosystem compatibility. Read the docs

crates.io docs.rs test suite

Highlights

  • Enough precision to render proton-sized meshes across the observable universe.
  • Uses Transform, making it compatible with most of the Bevy ecosystem.
  • No added dependencies.
  • Absolute coordinates without drift, unlike camera-relative or periodic recentering solutions.
  • Chunks the world into nestable integer grids, from i8 up to i128.
  • Spatial hashing for fast grid cell lookups and neighbor search.
  • Spatial partitioning to group sets of connected cells.
  • Great performance scaling and parallelism with massive entity counts.
  • 👉 Extensive documentation you should read.

screenshot

Showcase

Proton to Observable Universe scale

https://github.com/user-attachments/assets/430624ee-e3a4-4ba3-b7cf-72f3d7f00b5f

Floating origin demonstration

https://github.com/user-attachments/assets/9ce5283f-7d48-47dc-beef-9a7626858ed4

Bevy Version Support

bevy big_space
0.18 0.12
0.17 0.11
0.16 0.10
0.15 0.8, 0.9
0.14 0.7
0.13 0.5, 0.6
0.12 0.4
0.11 0.3
0.10 0.2
0.9 0.1

License

This project is dual licensed:

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Extension points exported contracts — how you extend this code

ValidHierarchyNode (Interface)
Defines a valid node in the hierarchy: what components it must have, must not have, and what kinds of nodes its children [8 …
src/validation.rs
SpatialEntryToEntities (Interface)
Trait extension that adds `.entities()` to any iterator of [`CellLookupEntry`]s. [3 implementers]
src/hash/map.rs
BigSpaceCommands (Interface)
Adds `big_space` commands to bevy's `Commands`. [1 implementers]
src/commands.rs
CloneHierarchy (Interface)
(no doc) [1 implementers]
src/validation.rs
SpatialHashFilter (Interface)
Used as a [`QueryFilter`] to include or exclude certain types of entities from spatial hashing.The trait is automaticall [1 …
src/hash/mod.rs

Core symbols most depended-on inside this repo

spawn_spatial
called by 89
src/commands.rs
add
called by 57
src/grid/cell.rs
iter
called by 54
src/hash/mod.rs
update
called by 45
src/hash/map.rs
id
called by 39
src/partition/mod.rs
clone
called by 38
src/validation.rs
spawn
called by 37
src/commands.rs
get
called by 31
src/partition/map.rs

Shape

Method 185
Function 98
Class 89
Interface 5
Enum 3

Languages

Rust100%

Modules by API surface

src/grid/local_origin.rs25 symbols
src/timing.rs24 symbols
src/hash/map.rs23 symbols
benches/benchmarks.rs23 symbols
src/validation.rs21 symbols
src/commands.rs20 symbols
src/camera.rs19 symbols
src/hash/mod.rs17 symbols
src/partition/private.rs15 symbols
src/partition/tests.rs14 symbols
src/partition/map.rs14 symbols
src/hash/component.rs13 symbols

For agents

$ claude mcp add big_space \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact