"A factory without community is just a machine — the Nexus turns it into an ecosystem."
Welcome to the Shapez-2 Factory Game Multiplayer — Community Blueprint Nexus. This is not merely a mod; it is a living logistics brain that connects players across servers, time zones, and production philosophies. Inspired by the geometric elegance of shapez-2, this repository provides a peer-assisted blueprint distribution network, cooperative factory simulation tools, and a decoupled modding API that treats your factory layout as a collaborative artwork.
- The Vision — Why This Exists
- Features That Redefine Collaboration
- System Architecture (Mermaid Diagram)
- Compatibility Matrix
- Quickstart — From Zero to Nexus
- Example Profile Configuration
- Example Console Invocation
- AI Integration: OpenAI & Claude API
- Multilingual & Responsive UI
- 24/7 Support & Community Maintenance
- Performance Optimization Benchmarks
- Modding API Reference
- Disclaimer
- License
Every factory game harbors a silent tension: the desire to build alone versus the power of shared intelligence. The Community Blueprint Nexus resolves this paradox by transforming blueprint-sharing from a static file exchange into a dynamic, multiplayer-aware protocol.
Imagine a space logistics network where your resource-management decisions automatically ripple across connected servers. Your logic gates become shared components. Your 3d-factory layouts are not isolated monoliths but modules that others can adopt, optimize, and return improved. This repository is the operating system for that vision — an open-source, MIT-licensed framework that treats cooperative engineering as its highest value.
The Nexus is not a modification that changes shapez-2's core code; it is a sidecar service that enriches the multiplayer experience through community-tools, a modding-api, and a performance-optimization layer that keeps even the largest factories running smoothly.
| Feature | Description |
|---|---|
| Blueprint Synchronization Protocol | Real-time, conflict-resolved blueprint sharing across multiplayer sessions. Think of it as Git for factory layouts. |
| Decoupled Modding API | Build your own tools on top of the Nexus. The API exposes factory state, player inventory, and logistics flow without modifying game binaries. |
| Cooperative Space Logistics | Design inter-shipment routes where multiple players contribute resources to a single stellar production chain. |
| Logic Gate Sharing | Export and import complex logic circuits as reusable components — the open-source chip library for shapez-2. |
| Performance Sandbox | Isolate performance-heavy factories in a lightweight simulation mode before deploying them to the main game. |
| Community Blueprint Marketplace (P2P) | A fully peer-to-peer blueprint exchange — no central server, no censorship, pure community-driven distribution. |
| Multilingual UI | Interface translations contributed by the community (currently 12 languages). |
| 24/7 Automated Support Bot | First-line issue resolution using a hybrid of rule-based and AI-driven responses (OpenAI/Claude integration). |
graph TB
subgraph "Community Blueprint Nexus"
A[Client Launcher] --> B{Blueprint Synchronization}
B --> C[Peer Discovery]
B --> D[Conflict Resolution Engine]
B --> E[Version History Store]
C --> F[Shared Space Logistics Graph]
D --> G[Logic Gate Library]
H[Modding API] --> I[Factory State Access]
H --> J[Player Inventory Queries]
H --> K[Production Flow Hooks]
L[Performance Sandbox] --> M[Lightweight Simulation]
L --> N[Benchmark Reports]
O[AI Assistant Layer] --> P[OpenAI API Connector]
O --> Q[Claude API Connector]
O --> R[Community Support Bot]
end
subgraph "External Services"
S[GitHub Releases] --> A
T[WebSocket Servers] --> B
U[Discord Bridge] --> R
end
subgraph "User Experience"
V[Responsive Web UI] --> A
W[Multilingual Strings] --> V
X[Terminal Interface] --> A
end
The architecture is modular by design: each component can be deployed independently. You want blueprint sharing without the AI assistant? Disable the ai_bot flag. You need only the modding API for custom tool development? Run the nexus-api standalone service.
| Operating System | Status | Notes |
|---|---|---|
| 🪟 Windows 10/11 | ✅ Full Support | Native binary installer included |
| 🐧 Ubuntu 20.04+ | ✅ Full Support | Requires Python 3.11+ and tkinter |
| 🍎 macOS 12+ | ✅ Full Support | Homebrew dependencies managed automatically |
| 🔵 FreeBSD | See CONTRIBUTING.md for build instructions |
|
| 🐳 Docker (any OS) | ✅ Supported via container | Use nexus-docker.sh |
Emoji Legend: ✅ = Tested and maintained by core team •
- Python 3.11 or higher
- A copy of shapez-2 (Steam or standalone)
- Network access for peer discovery (port 8765 UDP)
-
Download the latest release
-
Extract the archive to your shapez-2 installation directory (or any location — the Nexus auto-discovers the game path).
-
Launch the configuration wizard
python nexus_launcher.py --quickstart
-
Join or host a multiplayer session
- Host:
python nexus_launcher.py --host - Connect:
python nexus_launcher.py --connect <peer_ip>
- Host:
The Nexus stores user preferences in a JSON profile located at ~/.nexus/profile.json. Below is a fully annotated example:
{
"nexus_version": "2.6.0",
"user": {
"handle": "BlueprintArchitect",
"language": "en",
"region": "eu-west"
},
"blueprint_sync": {
"auto_share": true,
"conflict_strategy": "latest_wins",
"enable_version_history": true
},
"ai_assistant": {
"integration": "openai",
"model": "gpt-4-turbo",
"api_key_env_var": "NEXUS_OPENAI_KEY"
},
"performance": {
"sandbox_tolerance": 0.85,
"log_interval_seconds": 10
},
"multilingual": {
"fallback": "en",
"download_on_first_use": true
},
"support": {
"auto_report_crashes": false,
"enable_24_7_bot": true
}
}Each key is documented in the schema/ folder of this repository.
For headless servers or advanced users, the Nexus provides a full terminal interface:
# Launch with multiplayer host and specific performance profile
nexus -m multiplayer host \
--port 9876 \
--profile optimized.json \
--blueprint-limit 500 \
--ai-integration openai
# Connect to a peer with custom blueprint log
nexus -m multiplayer connect \
--target 192.168.1.42:9876 \
--log-level debug \
--sync-interval 5
# List all known blueprint repositories
nexus blueprint list --repositories
# Export a specific blueprint to shared library
nexus blueprint export --id "circuit_alpha" --tags "logic,gates,compact"The console output uses color-coded sections (ANSI escape sequences) for readability: green for successful peer connections, yellow for pending syncs, red for conflicts requiring resolution.
The Nexus features a plugin architecture for AI assistants, with first-class support for both OpenAI and Claude APIs.
- Blueprint Description Generation: When you export a blueprint, the AI can auto-generate human-readable documentation (e.g., "This circuit uses 8 logic gates to sort shapes by color in 3 cycles").
- Conflict Resolution Suggestions: In multiplayer sessions, when two players modify the same factory region, the AI suggests a merge strategy based on optimization heuristics.
- Community Support Bot: A 24/7 automated assistant that answers installation questions, interprets error logs, and guides new users through their first cooperative session.
Set your API keys as environment variables:
export NEXUS_OPENAI_KEY="your_key_here"
export NEXUS_CLAUDE_KEY="your_key_here"Or use the profile configuration (see above). The system respects rate limits and tiered usage — no unexpected costs.
The Nexus features a responsive web-based UI that adapts to any device — desktop, tablet, or phone. Built with React and TypeScript, it communicates with the backend via WebSockets.
- English (en)
- Deutsch (de)
- Français (fr)
- Español (es)
- 日本語 (ja)
- 简体中文 (zh-CN)
- Русский (ru)
- 한국어 (ko)
- Português (pt-BR)
- Italiano (it)
- Nederlands (nl)
- Polski (pl)
Translation contributions are managed via Crowdin — see the CONTRIBUTING.md file for details.
The UI degrades gracefully: on low-bandwidth connections, it switches to a text-only mode with minimal CSS, ensuring factory management never stalls.
This project is maintained by a global team of volunteers and a semi-automated support system.
- First Line: The AI bot (OpenAI/Claude) handles 80% of queries — installations, common errors, and feature explanations.
- Second Line: Human maintainers triage issues within 2 hours during business hours (CET, EST, and JST overlap).
- Third Line: Core developers address architecture-level concerns through weekly sync meetings.
To request help, open an issue with the support tag, or join the community Discord (link in CONTRIBUTING.md).
The Nexus includes a built-in benchmarking suite that tests factory throughput under different multiplayer loads.
| Scenario | Without Nexus | With Nexus (Sandbox) | Improvement |
|---|---|---|---|
| 4-player blueprint sync (100 blueprints) | 3.2s latency | 0.4s latency | 87% reduction |
| Single-player factory with 10k entities | 45 FPS | 58 FPS | 29% uplift |
| 8-player logistics network | 12 ms tick | 4 ms tick | 66% improvement |
The performance sandbox isolates heavy computations, allowing players to test factory designs in a zero-latency simulation before committing them to the main multiplayer world.
The Nexus exposes a RESTful and WebSocket-based API for custom tools. Below is a minimal example:
import requests
# Get current factory state
response = requests.get("http://localhost:8765/api/v1/factory/state")
factory_data = response.json()
# Subscribe to blueprint changes
ws = websocket.create_connection("ws://localhost:8765/ws/blueprints")
ws.send(json.dumps({"action": "subscribe", "channel": "blueprint_updates"}))The full API reference is at docs/api_reference.md in this repository.
This project is an independent, community-driven initiative and is not affiliated with, endorsed by, or sponsored by the developers of shapez-2 or its parent company. shapez-2 is a registered trademark of its respective owner.
The Community Blueprint Nexus is provided "as is," without warranty of any kind. Use at your own risk. The maintainers are not responsible for any loss of game data, session interruptions, or conflicts arising from multiplayer synchronization. Always backup your save files before using the Nexus in cooperative mode.
AI integrations use third-party APIs (OpenAI, Claude) subject to their respective terms of service and pricing. The Nexus does not store API keys or transmit game data outside of your network without explicit user consent. See PRIVACY.md for full details.
This project is licensed under the MIT License — see the LICENSE file for the full text. In short: you are free to use, modify, distribute, and sublicense this software for any purpose, provided you include the original copyright notice.
Shapez-2 Factory Game Multiplayer — Community Blueprint Nexus
Turning solitary automation into collective intelligence, one blueprint at a time.
© 2026 — MIT License