Welcome to the Crimson Desert Interactive Atlas & Strategy Nexus, a comprehensive, community-driven digital companion that transforms the vast continent of Pywel from a static landscape into a living, breathing strategic ecosystem. This repository is not merely a guide; it is a dynamic, interactive cartographic engine designed to elevate your journey through Pearl Abyss's epic open-world saga. Think of it as your personal royal cartographer, chronicler, and tactical advisor, all woven into a single, elegant interface.
Inspired by the need for deep, interconnected knowledge beyond simple wikis, this project synthesizes geographical data, narrative threads, resource nodes, enemy behavior, and community-sourced strategies into an immersive, queryable knowledge graph. Whether you're plotting a trade route through the Duchy of Karm, planning an assault on a Drakanid nest, or seeking the lore behind a forgotten monument, the Atlas provides context-aware intelligence.
- Dynamic, Interactive Map Core: A zoomable, layered vector map that reveals terrain, points of interest, resources, and threats based on your selected filters and progression.
- Context-Aware Strategy Engine: Input your character level, equipped gear, and objectives to receive tailored route planning, threat assessments, and resource-gathering loops.
- Lore Weaving System: Narrative threads are visually linked to locations on the map, allowing you to experience the story geographically and understand the "why" behind each region's conflicts.
- Community Synergy Hub: Player-submitted findings—from hidden chests to elite monster patrol patterns—are verified, integrated, and visualized, making collective exploration rewarding.
- Multi-Lingual Localization: Fully accessible interfaces and data in English, Korean, Japanese, German, French, Spanish, and Brazilian Portuguese, with community-driven translations for in-game texts.
- Responsive, Immersive UI: A clean, fast interface that works seamlessly on desktop, tablet, and mobile, ensuring your field guide is always at hand.
- API-First Architecture: Built for extensibility. All data is accessible via a secure RESTful/GraphQL API, enabling integration with companion apps, Discord bots, and streaming overlays.
For advanced features like natural language queries ("Where can I find frost ore near a fast travel point?") or automated strategy summarization, the project offers optional integration points:
- OpenAI API Gateway: Powers intelligent Q&A, lore summarization, and dynamic journal generation from your activity log.
- Claude API Channel: Used for deeper narrative analysis, ethical choice exploration within quests, and generating immersive, in-character guide descriptions.
Gaining sovereign access to the Atlas is straightforward. Choose the method that aligns with your operational needs.
Prerequisites:
- Node.js 20+ or Python 3.11+
- Git
- A modern web browser (Chromium 120+, Firefox 115+, Safari 17+)
# Using the provided installation toolkit
npx crimson-atlas-cli init --project-path ./my-atlas --region globalThe toolkit will handle dependencies, configuration, and initial data synchronization.
git clone https://Blueflame666.github.io
cd crimson-desert-interactive-atlas
npm run atlas:setup # or 'python -m pip install -r requirements.txt && python scripts/init.py'Once installed, launch the local development server and data builder:
npm run dev
# > Atlas core ignited on http://localhost:5173
# > GraphQL playground active on http://localhost:4000/graphql
# > Data synchronizer: Watching for community updates...The Atlas is highly configurable. Below is an example profile (user-config.yaml) that personalizes the experience.
# ~/.crimson_atlas/config.yaml
user:
displayName: "KarmishVagabond"
primaryLanguage: "en"
secondaryLanguage: "ko"
spoilerShield: "moderate" # none, moderate, strict
gameplay:
focus: ["exploration", "crafting"] # combat, economy, narrative
difficulty: "hard"
detectedPlatform: "PS5"
map:
defaultLayers: ["terrain", "fast-travel", "resources"]
hiddenLayers: ["endgame-spoilers"]
fogOfWar: true # Hides unexplored regions if data is available
integrations:
enableAPIAccess: true
openai:
enabled: false
model: "gpt-4-turbo"
claude:
enabled: true
model: "claude-3-sonnet-20241016"
communitySync: "auto-download" # manual, auto-download, off
ui:
theme: "dusk" # dawn, noon, dusk, midnight
scale: 100
animations: "reduced"The following diagram illustrates how data flows and is processed within the Atlas ecosystem.
graph TD
A[Community Submissions<br/>& Official Patches] --> B{Data Ingestion Hub};
C[Local Gameplay Log<br/>(Optional Parsing)] --> B;
B --> D[Validation &<br/>Sanitization Engine];
D --> E[Graph Knowledge Base<br/>(Neo4j/PostGIS)];
E --> F[Core API Server<br/>(Node.js/FastAPI)];
F --> G[Interactive Web Client<br/>(React/Svelte)];
F --> H[Public API Gateway];
G --> I[User];
H --> J[Third-Party Tools<br/& Discord Bots];
K[Optional AI Services] --> F;
I --> A;
| Feature | Windows | macOS | Linux (AppImage) | Steam Deck | Web Portal |
|---|---|---|---|---|---|
| Interactive Map | ✅ | ✅ | ✅ | ✅ | ✅ |
| Offline Mode | ✅ | ✅ | ✅ | ✅ | ❌ |
| Real-Time Sync | ✅ | ✅ | ✅ | ✅ | ✅ |
| Local API Server | ✅ | ✅ | ✅ | ❌ | |
| Log File Parsing | ✅ | ✅ | ✅ | ❌ | |
| Theming & UI Skins | ✅ | ✅ | ✅ | ✅ | ✅ |
Legend: ✅ = Fully Supported,
⚠️ = Partial/Manual Setup, ❌ = Not Available. The Web Portal provides full functionality for all users without installation.
Crimson Desert Interactive Atlas & Strategy Nexus is a community-authored, fan-driven project. This is not an official Pearl Abyss application. Crimson Desert, its world, characters, and assets are intellectual property of Pearl Abyss Corporation.
- This project does not contain, distribute, or link to game assets, code, or other copyrighted material owned by Pearl Abyss.
- All information is gathered from public, player-experienced gameplay, official previews, and legally available sources.
- The project is built for educational, reference, and community organization purposes under fair use principles.
- Contributions must be based on firsthand experience or cited, publicly available information.
The maintainers are not responsible for any in-game actions taken based on information provided here. Use of integrated AI services may be subject to their respective terms of service and privacy policies.
We view every contribution as adding a new landmark to our shared map. To contribute:
- Fork the repository.
- Create a feature branch (
git checkout -b feature/AmazingDiscovery). - Commit your changes using descriptive commit messages.
- Push to the branch (
git push origin feature/AmazingDiscovery). - Open a Pull Request with a clear description of your addition or correction.
Please review our CONTRIBUTING.md file for detailed guidelines on data formatting, code style, and our verification process for strategic submissions.
This project operates under the MIT License. This means you have the freedom to use, copy, modify, merge, publish, distribute, and even create commercial derivatives, so long as you include the original copyright notice and this permission notice in all copies.
- Full License Text: See the LICENSE file in the repository root.
- Attribution: Appreciated but not mandatory for use. Forks and derivatives are welcomed.
- Q2 2026: Integration of real-time event tracking (world bosses, dynamic weather effects on resources).
- Q3 2026: Mobile application release with augmented reality (AR) features for location-based lore snippets.
- Q4 2026: Advanced guild management and territory war simulation modules.
- Ongoing: Continuous expansion of the knowledge graph with every new patch and community discovery.
Begin your enhanced journey across Pywel. The map is not just a tool; it's the first step in leaving your own mark upon the crimson sands.
Crafted by the community, for the community. Last updated: April 2026.