Big Space

https://docs.rs/crate/big_space/latest
Admin
Big Space is a floating origin plugin for Bevy that enables huge worlds with high performance and...
Tokens:7,736
Snippets:103
Trust Score:9.1
Update:4 months ago
Show doc for...
Tokens:
Raw
### Example Configuration: Minimal

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'minimal' example with its path and required features. Use for testing the most basic project setup.

```toml
[[example]]
name = "minimal"
path = "examples/minimal.rs"
required-features = ["camera", "debug"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Split Screen

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'split_screen' example with its path and required features. Use for testing split-screen rendering or multi-view setups.

```toml
[[example]]
name = "split_screen"
path = "examples/split_screen.rs"
required-features = ["camera", "debug"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Debug

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'debug' example with its path and a required feature. Use to enable specific example runs during development or testing.

```toml
[[example]]
name = "debug"
path = "examples/debug.rs"
required-features = ["debug"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Planets

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'planets' example with its path and a required feature. Use for testing planet-related functionalities.

```toml
[[example]]
name = "planets"
path = "examples/planets.rs"
required-features = ["camera"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Demo

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'demo' example with its path and multiple required features. Use for running a comprehensive demonstration of project capabilities.

```toml
[[example]]
name = "demo"
path = "examples/demo.rs"
required-features = ["i128", "camera", "debug"]
doc-scrape-examples = false
```

--------------------------------

### Build Log - Docker Start Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223

The command to start the Docker container and execute the build process.

```bash
[INFO] running `Command { std: "docker" "start" "-a" "3ae05d6f10d4646ef41431930d1aa8b724d2f37ab1e382ebe3df4cf3b067ec3c", kill_on_drop: false }`
```

--------------------------------

### Example Configuration: Error

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines an 'error' example with its path. Use to test error handling mechanisms.

```toml
[[example]]
name = "error"
path = "examples/error.rs"
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Small Scale

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'small_scale' example with its path and multiple required features. Use for testing small-scale simulations or rendering.

```toml
[[example]]
name = "small_scale"
path = "examples/small_scale.rs"
required-features = ["camera", "debug", "i128"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Infinite

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines an 'infinite' example with its path and required features. Use for testing scenarios involving infinite loops or recursion.

```toml
[[example]]
name = "infinite"
path = "examples/infinite.rs"
required-features = ["i8", "camera", "debug"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Spatial Hash

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a 'spatial_hash' example with its path and a required feature. Use for testing spatial hashing algorithms.

```toml
[[example]]
name = "spatial_hash"
path = "examples/spatial_hash.rs"
required-features = ["camera"]
doc-scrape-examples = false
```

--------------------------------

### Example Configuration: Error Child

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines an 'error_child' example with its path and required features. Use for testing child error scenarios.

```toml
[[example]]
name = "error_child"
path = "examples/error_child.rs"
required-features = ["camera", "debug"]
doc-scrape-examples = false
```

--------------------------------

### Benchmark Configuration in Cargo.toml

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines a benchmark target named 'benchmarks' that does not use the default harness. Use for custom benchmarking setups.

```toml
[[bench]]
name = "benchmarks"
harness = false
```

--------------------------------

### Build Error: GCC Not Found

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-unknown-linux-gnu_json.txt

This error indicates that the C compiler 'aarch64-linux-gnu-gcc' could not be located. This is a common issue when cross-compiling for an ARM architecture on a system that does not have the necessary toolchain installed.

```text
error occurred in cc-rs: failed to find tool "aarch64-linux-gnu-gcc": No such file or directory (os error 2)
```

--------------------------------

### Build Log - Docker Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223

The Docker command executed to build the documentation. This includes environment variables, volume mounts, and the cargo rustdoc command.

```bash
# build log
[INFO] running `Command { std: "docker" "create" "-v" "/home/cratesfyi/workspace/builds/big_space-0.12.0/target:/opt/rustwide/target:rw,Z" "-v" "/home/cratesfyi/workspace/builds/big_space-0.12.0/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace/builds/big_space-0.12.0/source:/opt/rustwide/workdir:ro,Z" "-v" "/home/cratesfyi/workspace/cargo-home:/opt/rustwide/cargo-home:ro,Z" "-v" "/home/cratesfyi/workspace/rustup-home:/opt/rustwide/rustup-home:ro,Z" "-e" "SOURCE_DIR=/opt/rustwide/workdir" "-e" "CARGO_TARGET_DIR=/opt/rustwide/target" "-e" "DOCS_RS=1" "-e" "CARGO_HOME=/opt/rustwide/cargo-home" "-e" "RUSTUP_HOME=/opt/rustwide/rustup-home" "-w" "/opt/rustwide/workdir" "-m" "6442450944" "--cpus" "6" "--user" "1001:1001" "--network" "none" "ghcr.io/rust-lang/crates-build-env/linux@sha256:61361fe0aef631f17e9d025a70c5a647956f8c671dd02950a60ad3f5cc5526d7" "/opt/rustwide/cargo-home/bin/cargo" "+nightly" "rustdoc" "--lib" "-Zrustdoc-map" "--all-features" "--config" "build.rustdocflags=[\"--cfg\", \"docsrs\", \"-Z\", \"unstable-options\", \"--emit=invocation-specific\", \"--resource-suffix\", \"-20260208-1.95.0-nightly-6efa357bf\", \"--static-root-path\", \"/-/rustdoc.static/\", \"--cap-lints\", \"warn\", \"--extern-html-root-takes-precedence\"]" "--offline" "-Zunstable-options" "--config=doc.extern-map.registries.crates-io=\"https://docs.rs/{pkg_name}/{version}/x86_64-unknown-linux-gnu\"" "-Zrustdoc-scrape-examples" "-j6" "--target" "x86_64-unknown-linux-gnu", kill_on_drop: false }`
```

--------------------------------

### Build Log - Docker Container Warning

Source: https://docs.rs/crate/big_space/latest/builds/2883223

Standard error output from the Docker container, indicating a warning about kernel swap limit capabilities.

```text
[INFO] [stderr] WARNING: Your kernel does not support swap limit capabilities or the cgroup is not mounted. Memory limited without swap.
```

--------------------------------

### Configure Unwrap or Default Behavior

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level for using unwrap or unwrap_or_default methods. Use 'warn' to be notified about potential panics or unexpected defaults.

```toml
unwrap_or_default = "warn"
```

--------------------------------

### Cargo.toml Dependencies

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Lists the project's dependencies, including core Bevy crates and optional crates like 'bevy_color', 'bevy_gizmos', etc. It also includes 'smallvec' and 'libm' with specific feature configurations.

```toml
[dependencies]
smallvec = { version = "1.15.0", default-features = false } # Already used by bevy in commands
bevy_app = { version = "0.18.0", default-features = false, features = [
  "bevy_reflect",
] }
bevy_ecs = { version = "0.18.0", default-features = false }
bevy_log = { version = "0.18.0", default-features = false }
bevy_math = { version = "0.18.0", default-features = false }
bevy_reflect = { version = "0.18.0", default-features = false, features = [
  "glam",
] }
bevy_tasks = { version = "0.18.0", default-features = false }
bevy_transform = { version = "0.18.0", default-features = false, features = [
  "bevy-support",
  "bevy_reflect",
] }
bevy_utils = { version = "0.18.0", default-features = false }
bevy_platform = { version = "0.18.0", default-features = false, features = [
  "alloc",
] }
# Optional
bevy_color = { version = "0.18.0", default-features = false, optional = true }
bevy_gizmos = { version = "0.18.0", default-features = false, optional = true }
bevy_camera = { version = "0.18.0", default-features = false, optional = true }
bevy_input = { version = "0.18.0", default-features = false, optional = true, features = [
  "keyboard",
  "mouse",
] }
bevy_time = { version = "0.18.0", default-features = false, optional = true }
libm = { version = "0.2", default-features = false, optional = true }

```

--------------------------------

### Constructing a Plugin with a Custom Filter

Source: https://docs.rs/crate/big_space/latest/source/CHANGELOG.md

Use the `new()` method to construct a plugin with a custom filter, specifying the filter type with turbofish notation.

```rust
GridHashPlugin::<With<Player>>::new()
```

--------------------------------

### Build Log - Docker Inspect Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223

The command to inspect the Docker container's status.

```bash
[INFO] running `Command { std: "docker" "inspect" "3ae05d6f10d4646ef41431930d1aa8b724d2f37ab1e382ebe3df4cf3b067ec3c", kill_on_drop: false }`
```

--------------------------------

### Docs.rs Version

Source: https://docs.rs/crate/big_space/latest/builds/2883223

Displays the version of the docs.rs service used for the build.

```rust
# docs.rs version
docsrs 0.0.0 (e6b9bb9a 2026-02-06 )
```

--------------------------------

### Ignore Build Artifacts and Lock Files

Source: https://docs.rs/crate/big_space/latest/source/.gitignore

This snippet lists common directories and files to ignore in version control. It includes build output directories, lock files, and IDE configuration folders.

```gitignore
/target
/Cargo.lock
/.cargo
/.vscode
/.idea
```

--------------------------------

### Configure Missing Docs Lint

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level for missing documentation on items. Use 'warn' to ensure all public items are documented.

```toml
missing_docs = "warn"
```

--------------------------------

### Docker Command Output

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin.txt

This snippet shows the standard output from a Docker command, typically indicating the successful removal or identification of a container.

```text
ce861f8f853491dfcfc1deac8c752ca4c8bf2c2d2526534828c5a4db532ddcbe
```

--------------------------------

### Configure Undocumented Unsafe Blocks

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level for undocumented unsafe blocks. Use 'warn' to be notified about unsafe blocks without documentation.

```toml
undocumented_unsafe_blocks = "warn"
```

--------------------------------

### Configure Unused Qualifications Lint

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level for unused import qualifications. Use 'warn' to clean up unnecessary import paths.

```toml
unused_qualifications = "warn"
```

--------------------------------

### Cargo.toml Documentation Metadata

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Configuration for documentation generation on docs.rs, enabling all features by default.

```toml
[package.metadata.docs.rs]
all-features = true

```

--------------------------------

### Cargo.toml Development Dependencies

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Specifies development dependencies, including a comprehensive 'bevy' crate with numerous features enabled for testing and development purposes, along with 'noise', 'turborand', and 'criterion'.

```toml
[dev-dependencies]

bevy = { version = "0.18.0", default-features = false, features = [
  "bevy_animation",
  "bevy_asset",
  "bevy_color",
  "bevy_gizmos",
  "bevy_gltf",
  "bevy_log",
  "bevy_pbr",
  "bevy_post_process",
  "bevy_render",
  "bevy_scene",
  "bevy_remote",
  "bevy_ui",
  "bevy_ui_render",
  "bevy_window",
  "bevy_winit",
  "default_font",
  "multi_threaded",
  "png",
  "reflect_auto_register",
  "tonemapping_luts",
  "x11",
  "zstd_rust"
] }
noise = "0.9"
turborand = "0.10"
criterion = "0.8"

```

--------------------------------

### Linting Configuration in Cargo.toml

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Configures Rust linting rules, including documentation, unexpected configurations, unsafe code usage, and qualification requirements. Use to enforce code quality and safety standards.

```toml
[lints.rust]
missing_docs = "warn"
unexpected_cfgs = { level = "warn", check-cfg = ['cfg(docsrs_dep)'] }
unsafe_code = "deny"
unsafe_op_in_unsafe_fn = "warn"
unused_qualifications = "warn"
```

--------------------------------

### Docker Commands Executed During Build

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-unknown-linux-gnu_json.txt

The build process involved executing Docker commands to inspect and remove a container. This suggests that the build environment might be containerized or uses Docker for managing build artifacts or dependencies.

```text
running `Command { std: "docker" "inspect" "c96ec983770e9a679f2d676211bfc54dd62589623354c008c28bc0d7a3543648", kill_on_drop: false }`
```

```text
running `Command { std: "docker" "rm" "-f" "c96ec983770e9a679f2d676211bfc54dd62589623354c008c28bc0d7a3543648", kill_on_drop: false }`
```

```text
c96ec983770e9a679f2d676211bfc54dd62589623354c008c28bc0d7a3543648
```

--------------------------------

### Build Log - Cargo Rustdoc Output

Source: https://docs.rs/crate/big_space/latest/builds/2883223

Standard error output from the cargo rustdoc command, including documentation generation status and target information.

```text
[INFO] [stderr] warning: target filter specified, but no targets matched; this is a no-op
[INFO] [stderr]  Documenting big_space v0.12.0 (/opt/rustwide/workdir)
[INFO] [stderr]     Finished `dev` profile [unoptimized + debuginfo] target(s) in 2.69s
[INFO] [stderr]    Generated /opt/rustwide/target/x86_64-unknown-linux-gnu/doc/big_space/index.html
```

--------------------------------

### Cargo.toml Lints Configuration

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Configures lints for the project using Clippy, specifying warnings for common issues like 'doc_markdown', 'manual_let_else', and 'redundant_else', while allowing 'type_complexity'. It also sets specific lint levels for pointer-related operations.

```toml
[lints.clippy]
doc_markdown = "warn"
manual_let_else = "warn"
match_same_arms = "warn"
redundant_closure_for_method_calls = "warn"
redundant_else = "warn"
semicolon_if_nothing_returned = "warn"
type_complexity = "allow"
undocumented_unsafe_blocks = "warn"
unwrap_or_default = "warn"

ptr_as_ptr = "warn"
ptr_cast_constness = "warn"
ref_as_ptr = "warn"

```

--------------------------------

### Configure Unsafe Code Lint

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Denies the use of unsafe code outside of unsafe functions. Use 'deny' to strictly enforce the use of unsafe code within documented unsafe functions.

```toml
unsafe_code = "deny"
```

--------------------------------

### Compiler Error: Unrecognized Command-Line Option

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin_json.txt

This snippet shows a common error where the compiler (cc) encounters unrecognized command-line options, specifically '-arch' and '-mmacosx-version-min'. This often indicates an issue with the build environment or compiler configuration.

```stderr
cc: error: unrecognized command-line option '-arch'
cc: error: unrecognized command-line option '-mmacosx-version-min=11.0'
```

--------------------------------

### Docker Inspect Command Execution

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin.txt

This snippet shows the execution of a Docker inspect command, used to retrieve detailed information about a Docker container identified by its ID.

```text
docker inspect ce861f8f853491dfcfc1deac8c752ca4c8bf2c2d2526534828c5a4db532ddcbe
```

--------------------------------

### VCS Information Snippet

Source: https://docs.rs/crate/big_space/latest/source/.cargo_vcs_info.json

This JSON snippet contains version control system (VCS) information, specifically the Git commit SHA and the path within the VCS.

```json
{
  "git": {
    "sha1": "63ea28f3a93b23e627a21eebcada5b1012dc71b8"
  },
  "path_in_vcs": ""
}
```

--------------------------------

### Build Log - Docker Remove Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223

The command to remove the Docker container after the build.

```bash
[INFO] running `Command { std: "docker" "rm" "-f" "3ae05d6f10d4646ef41431930d1aa8b724d2f37ab1e382ebe3df4cf3b067ec3c", kill_on_drop: false }`
```

--------------------------------

### Build Log - Docker Container ID

Source: https://docs.rs/crate/big_space/latest/builds/2883223

The unique identifier for the Docker container used in the build process.

```text
[INFO] [stdout] 3ae05d6f10d4646ef41431930d1aa8b724d2f37ab1e382ebe3df4cf3b067ec3c
```

--------------------------------

### Cargo.toml Package Metadata

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines the core metadata for the big_space crate, including its name, version, edition, description, license, keywords, repository, and documentation links. It also specifies files to exclude from the package.

```toml
[package]
name = "big_space"
version = "0.12.0"
edition = "2021"
description = "A floating origin plugin for bevy"
license = "MIT OR Apache-2.0"
keywords = ["bevy", "floating-origin", "large-scale", "space"]
repository = "https://github.com/aevyrie/big_space"
documentation = "https://docs.rs/crate/big_space/latest"
exclude = ["assets"]

```

--------------------------------

### cc-rs Build Failure with Specific Flags

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin_json.txt

This snippet details a build failure originating from the 'cc-rs' crate. It highlights the exact command executed by 'cc-rs' and the specific flags that led to the error, including '-arch arm64' and '-mmacosx-version-min=11.0'.

```stderr
error occurred in cc-rs: command did not execute successfully (status code exit status: 1): LC_ALL="C" "cc" "-O0" "-ffunction-sections" "-fdata-sections" "-fPIC" "-gdwarf-2" "-fno-omit-frame-pointer" "-arch" "arm64" "-mmacosx-version-min=11.0" "-Wall" "-Wextra" "-std=c11" "-o" "/opt/rustwide/target/aarch64-apple-darwin/debug/build/blake3-28ddab62b47bb95d/out/a1edd97dd51cd48d-blake3_neon.o" "-c" "c/blake3_neon.c"
```

--------------------------------

### Docker Inspect Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin_json.txt

This snippet shows a Docker inspect command being executed, likely to retrieve information about a specific container ID during the build process.

```shell
docker inspect 830e7e62145de4a565aa3a2a5093563f4b4ebec82f02b96a0b2e17efcaf2d702
```

--------------------------------

### Rustc Version

Source: https://docs.rs/crate/big_space/latest/builds/2883223

Displays the version of the Rust compiler used for the build.

```rust
# rustc version
rustc 1.95.0-nightly (6efa357bf 2026-02-08)
```

--------------------------------

### Configure Unexpected CFGs Lint

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level and priority for unexpected conditional compilation (cfg) attributes. It checks for 'cfg(docsrs_dep)'.

```toml
[lints.rust.unexpected_cfgs]
level = "warn"
priority = 0
check-cfg = ["cfg(docsrs_dep)"]
```

--------------------------------

### Configure Unsafe Operation in Unsafe Function Lint

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml

Sets the warning level for unsafe operations within unsafe functions. Use 'warn' to be notified about potential issues in unsafe contexts.

```toml
unsafe_op_in_unsafe_fn = "warn"
```

--------------------------------

### Docker Remove Command Execution

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin.txt

This snippet shows the execution of a Docker remove command with the force flag (-f), used to stop and remove a Docker container identified by its ID.

```text
docker rm -f ce861f8f853491dfcfc1deac8c752ca4c8bf2c2d2526534828c5a4db532ddcbe
```

--------------------------------

### Docker Remove Container Command

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin_json.txt

This snippet shows a Docker remove command being executed to forcefully remove a container identified by its ID. This is a cleanup step after a build attempt.

```shell
docker rm -f 830e7e62145de4a565aa3a2a5093563f4b4ebec82f02b96a0b2e17efcaf2d702
```

--------------------------------

### Docker Container ID

Source: https://docs.rs/crate/big_space/latest/builds/2883223/aarch64-apple-darwin_json.txt

This snippet displays the ID of a Docker container that was inspected and subsequently removed.

```text
830e7e62145de4a565aa3a2a5093563f4b4ebec82f02b96a0b2e17efcaf2d702
```

--------------------------------

### Disable Bevy's Transform Plugin

Source: https://docs.rs/crate/big_space/latest/source/CHANGELOG.md

When updating to Bevy 0.16, you may need to disable Bevy's built-in transform system to avoid conflicts with the big_space plugin.

```rust
DefaultPlugins.build().disable::<TransformPlugin>(),
```

--------------------------------

### Cargo.toml Feature Flags

Source: https://docs.rs/crate/big_space/latest/source/Cargo.toml.orig

Defines feature flags for conditional compilation. The 'default' feature includes 'std', while 'debug' enables additional debugging-related features. Other features like 'camera', 'i8', 'i16', etc., enable specific functionalities.

```toml
[features]
default = ["std"]
debug = ["std", "bevy_gizmos", "bevy_color"]
camera = ["std", "bevy_camera", "bevy_time", "bevy_input"]
i8 = []
i16 = []
i32 = []
i64 = []
i128 = []

std = [
  "bevy_app/std",
  "bevy_ecs/std",
  "bevy_math/std",
  "bevy_reflect/std",
  "bevy_transform/std",
  "bevy_utils/std",
  "bevy_platform/std",
  "bevy_color?/std",
  "bevy_input?/std",
  "bevy_time?/std",
]
libm = ["bevy_math/libm", "dep:libm"]

```

--------------------------------

### Enable BigSpace Validation Plugin

Source: https://docs.rs/crate/big_space/latest/source/CHANGELOG.md

The BigSpaceValidationPlugin is enabled by default when debug assertions are active. You can manually enable or disable it to override this behavior.

```rust
BigSpaceDefaultPlugins
    .build()
    .enable::<BigSpaceValidationPlugin>()
```
Tokens:
Raw