83 lines
4.5 KiB
Markdown
83 lines
4.5 KiB
Markdown
# World Map Engine — 그려진 맵 위에서 장소 사이를 이동
|
||
|
||
World Map Engine은 게임 세계를 담은 전체 화면 그림에 장소를 표시해 보여 줍니다. 플레이어는 지도를 열고 장소를 고른 뒤 그곳으로 떠납니다: 게임은 그 장소의 장면으로 바뀝니다. 시나리오는 이야기가 진행됨에 따라 장소를 열고, 닫고, 숨기고, 다시 드러낼 수 있고, 게임은 그 변화를 저장합니다.
|
||
|
||
Cthangover가 쓰는 것입니다. RPG World의 타일 맵과는 다른 것입니다: 월드 맵은 클릭할 수 있는 영역을 가진 한 장의 그림이고, 이동이 장면을 바꿉니다. 타일 맵은 영웅이 한 칸씩 걷는 격자입니다.
|
||
|
||
## 게임 속의 지도
|
||
|
||
도구 모음의 지도 아이콘으로 엽니다.
|
||
|
||
|
||
|
||
- **장소**는 그림 위에 그려진 영역이고, 빗금으로 표시됩니다. 일부 장소에는 아이콘을 넣은 둥근 엠블럼도 있습니다.
|
||
- **범례**: 초록 — 현재 위치, 금색 — 갈 수 있음, 회색 — 닫힘.
|
||
- **장소를 클릭**하면 카드가 열립니다: 상태, 설명, **이동** 버튼. **Esc**나 **×**가 지도를 닫습니다.
|
||
|
||
|
||
|
||
**이동**은 게임을 그 장소의 장면으로 바꿉니다:
|
||
|
||
|
||
|
||
장소가 닫혀 있으면 — 카드에는 «아직 길이 열리지 않았습니다.»가 나오고 이동 버튼은 없습니다 — 시나리오가 닫았거나, 장면이 없거나, 플레이 중인 게임에 그 장면이 존재하지 않는 경우입니다.
|
||
|
||
## 게임에 월드 맵 추가하기
|
||
|
||
게임은 자기 mod 안에 두 가지를 필요로 합니다:
|
||
|
||
1. **그림** — `map`이라는 이름의 배경(예: `backgrounds/map.png`).
|
||
2. **장소** — `map/` 폴더의 JSON 파일. 모든 위치는 그림 너비와 높이에 대한 비율(0부터 1)이라서, 지도는 어떤 크기에서도 동작합니다.
|
||
|
||
다음은 Cthangover의 마을 입구입니다(요약판):
|
||
|
||
```json
|
||
{
|
||
"Items": [
|
||
{
|
||
"ID": "town_entry",
|
||
"points": [[0.7099, 0.2493], [0.7334, 0.2630], [0.7348, 0.2906], [0.7091, 0.3429], [0.6974, 0.3264]],
|
||
"title": "",
|
||
"scene": "town_entry",
|
||
"description": "mapzone/town_entry/info",
|
||
"locked": false,
|
||
"hidden": false
|
||
},
|
||
{
|
||
"ID": "town_entry_label",
|
||
"points": [],
|
||
"title": "mapzone/town_entry",
|
||
"label_pos": [0.7246, 0.2163]
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
- `points` — 클릭할 수 있는 영역의 윤곽.
|
||
- `scene` — 이동이 전환할 논리 장면.
|
||
- `title`, `description` — 번역 키. title은 장소의 이름으로 카드와 엠블럼에 나옵니다.
|
||
- `image`와 `image_pos` — 아이콘과 그 위치로, 장소에 둥근 엠블럼을 보여 줍니다.
|
||
- `label_pos` — 지도에 홀로 놓이는 이름. title과 라벨 위치만 가진 구역(`town_entry_label` 같은)은 이름이지 장소가 아니므로 클릭할 수 없습니다.
|
||
- `locked` — 시작 때 닫혀 있음. `hidden` — 시작 때 표시되지 않음.
|
||
|
||
Cthangover는 장소 이름을 별도의 라벨 구역에 두고 장소 자체의 `title`은 비워 둡니다. 그래서 위의 카드에는 상단에 이름이 없습니다.
|
||
|
||
월드 맵은 Editor Tools의 맵 편집기로 그리거나 고칠 수도 있습니다.
|
||
|
||
## 시나리오에서 장소 바꾸기
|
||
|
||
```scenario
|
||
action map.open_zone zone_id=town_entry
|
||
action map.close_zone zone_id=town_entry
|
||
action map.show_zone zone_id=town_entry
|
||
action map.hide_zone zone_id=town_entry
|
||
```
|
||
|
||
변경은 저장 파일에 기록되어 불러온 뒤에도 남습니다. 새 게임은 JSON의 값에서 시작합니다.
|
||
|
||
## 문제가 생겼을 때
|
||
|
||
1. **«지도를 쓸 수 없음».** 게임의 어느 mod에도 `map`이라는 이름의 배경이 없습니다.
|
||
2. **장소에 들어갈 수 없습니다.** 그 `scene`이 비었거나 철자가 틀렸거나, 시나리오가 닫았습니다.
|
||
3. **장소가 엉뚱한 곳에 있습니다.** 위치는 그림에 대한 비율(0–1)이지 픽셀이 아닙니다.
|