31 lines
3.0 KiB
Markdown
31 lines
3.0 KiB
Markdown
# Shacraft Core
|
|
|
|
Самостоятельный открытый воксельный движок на Rust. Главный приоритет — низкое и предсказуемое потребление **серверной оперативной памяти**. Сервер Shacraft служит первым практическим применением; ядро не привязано к его мирам, аккаунтам и минииграм.
|
|
|
|
Проект начинается заново локально: исходники из зависшей облачной среды не восстановлены. Сведения о ранее выполненных сборках и тестах не являются результатами этого репозитория.
|
|
|
|
## Текущий результат: этап 1 — хранилище
|
|
|
|
Реализованы самостоятельная Rust-библиотека и локальный CLI: компактные секции, ограниченный кэш, сохранение, неизменяемые снимки, независимые экземпляры миров, атомарные правки, ревизии, идемпотентность, undo/reset и диагностика. Это основа движка; игровой сервер, графический клиент, MCP, каталог Minecraft и конвертер ещё предстоят.
|
|
|
|
```bash
|
|
cd /home/emil/Desktop/shacraft-core
|
|
bash scripts/verify.sh
|
|
cargo run -p shacraft-tools -- --data data/demo demo
|
|
```
|
|
|
|
Для повторной демонстрации укажите новый пустой каталог. [Команды, измерение и JSON-lines API](docs/DEVELOPMENT.md). JSON-lines API предназначен для локальной проверки хранилища и не является MCP.
|
|
|
|
Код доступен под MIT или Apache-2.0 на выбор. Оригинальные ресурсы Minecraft в проект не входят.
|
|
|
|
## Контекст и порядок чтения
|
|
|
|
1. [Требования](docs/REQUIREMENTS.md) — что запросил пользователь.
|
|
2. [План](docs/PLAN.md) — этапы и условия перехода.
|
|
3. [Решения](docs/DECISIONS.md) — принятые решения и их границы.
|
|
4. [Интерфейсы](docs/CONTRACT.md) — рабочие контракты компонентов.
|
|
5. [Текущее состояние](docs/STATUS.md) — проверенные результаты и ближайшая работа.
|
|
6. [Память и хранение](docs/MEMORY_AND_STORAGE.md), [совместимость](docs/COMPATIBILITY.md), [приёмка](docs/ACCEPTANCE.md).
|
|
|
|
Работа ведётся локально в `/home/emil/Desktop/shacraft-core`. Продакшен-серверы и существующие проекты лаунчера не изменяются автоматически.
|