- 15
- 56
SanMap Studio
Визуальный 3D-редактор карт и ретекстуринга для GTA San Andreas и SA-MP.
Скачать · Руководство · English
Скачать · Руководство · English
SanMap Studio — автономный Windows-редактор для создания карт SA-MP без запуска GTA, SA-MP, MTA или Texture Studio. Приложение читает ресурсы из выбранной пользователем установки GTA San Andreas; игровые файлы не входят ни в репозиторий, ни в дистрибутив.
Возможности
- Индексация и предпросмотр DFF-моделей и TXD-текстур из GTA IMG-архивов.
- Размещение, выбор, группировка, дублирование и трансформация объектов в Three.js viewport.
- Редактирование слотов материалов, цвета, текстур и параметров SetDynamicObjectMaterialText.
- Импорт и экспорт Pawn-кода для native SA-MP и streamer.
- Опциональный просмотр мира GTA через IPL и экспорт RemoveBuildingForPlayer.
- Версионированные .sanmap-проекты, undo/redo, автосохранение и восстановление после сбоя.
Скриншоты
Скачать
Установщик и portable-сборка доступны в последнем GitHub Release:- SanMap Studio Setup 0.1.0.exe — установщик Windows.
- SanMap Studio 0.1.0.exe — portable-приложение.
- SHA256SUMS.txt — контрольные суммы обоих файлов.
Системные требования
- Windows 10 или 11, 64-bit.
- Видеокарта с поддержкой WebGL 2.0 / Direct3D 11.
- Легально приобретённая GTA San Andreas для загрузки моделей, текстур и мира.
Быстрый старт
- Запустите SanMap Studio и выберите каталог GTA San Andreas с models/gta3.img и data/gta.dat.
- Создайте новый проект или импортируйте существующий Pawn-код.
- Перетащите модели из Object Catalog в viewport.
- Настройте трансформации и материалы в Inspector.
- Сохраните .sanmap-проект или экспортируйте Pawn-код.
Основные клавиши
| Клавиши | Действие |
|---|---|
| WASD / стрелки | Перемещение камеры |
| Q / E | Камера вниз / вверх |
| Shift / Alt | Быстрое / точное перемещение |
| F | Фокус на выбранном объекте |
| Home | Сброс камеры |
| 1 / 2 / 3 | Перемещение / вращение / дублирование по размеру |
| L | Локальная/мировая система gizmo |
| Ctrl+D | Дублировать выбор |
| Delete | Удалить выбор |
| Ctrl+Z / Ctrl+Y | Отменить / повторить |
| Numpad 1 / 3 / 7 / 0 | Спереди / справа / сверху / изометрия |
Разработка
Нужны Node.js 22.13+ и pnpm 11.8.0.git clone https://github.com/mgmoldova/sanmap-studio.git
cd sanmap-studio
corepack enable
pnpm install --frozen-lockfile
pnpm dev
Проверки и Windows-сборка:
pnpm run agent:check
pnpm test
pnpm run lint
pnpm run typecheck
pnpm run build
pnpm run build:win
Архитектура
- src/main/ — Electron main process, файловые операции, настройки и typed IPC.
- src/preload/ — изолированный мост window.sanMapApi.
- src/renderer/ — React-интерфейс и Three.js viewport.
- packages/shared/ — типы, миграции, схемы и общие утилиты.
- packages/gta-assets/ — парсеры IMG/DFF/TXD/IDE/IPL и каталоги ресурсов.
- packages/samp-map/ — lexer, importer и exporter Pawn.
Участие и безопасность
Перед pull request прочитайте CONTRIBUTING.md. Уязвимости сообщайте приватно по инструкции из SECURITY.md.Правовая информация
SanMap Studio — независимый проект сообщества, не связанный с Rockstar Games, Take-Two Interactive или командой SA-MP. Репозиторий и релизы не содержат моделей, текстур, архивов или других проприетарных материалов GTA San Andreas.Сторонние лицензии перечислены в THIRD_PARTY_NOTICES.md. Исходный код распространяется по MIT License.
