## Description<\/p>\n
ParallelCore is a lightweight Fabric-based API and foundational layer designed to enable safe multithreading for Minecraft mods. It does not add parallel behavior itself but provides the essential building blocks for other mods to implement concurrent logic without corrupting the game world or crashing.<\/p>\n
### Core Features<\/p>\n
**Thread-Safe World Access**
\nVanilla Minecraft prohibits world access from any thread other than the main server thread. ParallelCore overcomes this limitation through a safe-zone mechanism. Mods can mark regions of code as a “parallel safe zone,” which temporarily relaxes thread checks. While inside a safe zone, chunk and block lookups become thread-safe, allowing worker threads to read world state concurrently.<\/p>\n
**World Snapshot via Chunk Lookup**
\nRather than creating heavy full-world copies, ParallelCore provides a thread-safe chunk reader that bypasses the vanilla main-thread dispatcher. When worker threads request chunks, they receive direct read-only access to already-loaded chunks without blocking or deadlocking the main thread. This acts as a lightweight, on-demand snapshot system.<\/p>\n
**Isolated Thread Pools**
\nThe mod provides a thread-pool factory that creates independent, fixed-size executor services for different subsystems (such as physics, explosions, or hoppers). Each subsystem gets its own isolated pool, preventing task starvation and ensuring that one system’s nested submissions do not block another.<\/p>\n
**Entity Snapshot Helpers**
\nMutable entities like item entities are not thread-safe. ParallelCore includes utility methods to collect and deep-copy entities on the main thread before parallel execution begins. Worker threads receive immutable snapshot records, eliminating data races.<\/p>\n
**Command System Integration**
\nA `\/parallel` command (with a `\/pc` alias) is provided for administrators. Other mods can register their own subcommands under this root, allowing runtime configuration and status reporting for each parallelized subsystem.<\/p>\n
**Shared Configuration Base**
\nA configuration base class helps mods persist their settings in a single shared JSON file, with each subsystem owning a dedicated section. This keeps all parallel-related configuration in one place.<\/p>\n
### Recommended Usage Pattern: Parallel Read, Serial Write<\/p>\n
The core design follows a **read-parallel, write-serial** pattern to ensure thread safety without complex locking:<\/p>\n
1. **Collect on Main Thread** \u2013 Before parallel execution, collect all necessary positions, entity references, or mutable data on the main thread where world access is naturally safe.<\/p>\n
2. **Enter Safe Zone** \u2013 Call `SafeLevelAccess.enterSafeZone()` to mark the beginning of parallel read operations. This bypasses vanilla thread checks and enables thread-safe chunk lookups.<\/p>\n
3. **Execute Parallel Reads** \u2013 Submit tasks to isolated thread pools. Worker threads can safely read block states, item entity snapshots, and chunk data concurrently from immutable or deep-copied sources. No writing to the world occurs during this phase.<\/p>\n
4. **Join and Merge** \u2013 Wait for all parallel tasks to complete, collecting computed results (e.g., new block positions, item transfers, or state changes) from each worker.<\/p>\n
5. **Leave Safe Zone** \u2013 Call `SafeLevelAccess.leaveSafeZone()` to restore vanilla thread-safety checks.<\/p>\n
6. **Apply Changes Serially** \u2013 Back on the main thread, apply all accumulated modifications to the real world. This serial write-back prevents concurrent modification and keeps vanilla assumptions intact.<\/p>\n","protected":false},"excerpt":{"rendered":"
A mod provides thread pool and world snapshot capabilities<\/p>\n","protected":false},"featured_media":119392,"template":"","meta":{"_minecraft_slug":"parallel-core","_minecraft_project_id":"xTzfQxjv","_minecraft_author":"uright008","_minecraft_license":"MIT","_minecraft_downloads":12,"_minecraft_follows":1,"_minecraft_client_side":"unknown","_minecraft_server_side":"unknown","_minecraft_storage_type":"zip","_minecraft_archive_name":"parallel-core.zip","_minecraft_size_bytes":71587,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-16T14:16:40.919765Z","_minecraft_date_created":"2026-05-15T03:51:03.676661Z","_minecraft_date_modified":"2026-05-15T12:13:25.814979Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/parallel-core","_minecraft_icon_attachment_id":119392,"_minecraft_imported_at":"2026-06-07T00:31:22+00:00","_minecraft_import_hash":"4b83fe180c457eb3072abd6bb1dfafb6","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,90],"mod_loader":[99],"minecraft_version":[163],"class_list":["post-119391","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-optimization","mod_loader-fabric","minecraft_version-26-1-2"],"yoast_head":"\n