crimson-desert-localization-builder-public

KO | EN

gitlite — search

#python #react #ai #llm #machine-learning #deep-learning #linux #awesome #vue #awesome-list #security #ios #mcp #openai

crimson-desert-localization-builder-public

(★ 12)

Windows tool for unpacking, repacking, installing and restoring Crimson Desert localization and font packages.

crimson-desert-localization-builder-public Latest Version Download

Download Latest Version (.zip)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Crimson Desert Localization Builder

Công cụ xuất/nhập localization JSON, build font `0012`, cài đặt và gỡ cài đặt
an toàn. Ngôn ngữ nguồn được chọn trực tiếp trên góc phải giao diện.

## Ngôn ngữ hỗ trợ

Tool ánh xạ đúng package, PALOC và font của game:

| Ngôn ngữ | Package | PALOC | Font |
|---|---:|---|---|
| English | 0020 | localizationstring_eng.paloc | basefont_eng.ttf |
| Korean | 0019 | localizationstring_kor.paloc | basefont_kor.ttf |
| Japanese | 0021 | localizationstring_jpn.paloc | basefont_jpn.ttf |
| Russian | 0022 | localizationstring_rus.paloc | basefont_rus.ttf |
| Turkish | 0023 | localizationstring_tur.paloc | basefont_tur.ttf |
| Spanish | 0024 | localizationstring_spa-es.paloc | basefont_spa-es.ttf |
| Mexican Spanish | 0025 | localizationstring_spa-mx.paloc | basefont_spa-mx.ttf |
| French | 0026 | localizationstring_fre.paloc | basefont_fre.ttf |
| German | 0027 | localizationstring_ger.paloc | basefont_ger.ttf |
| Italian | 0028 | localizationstring_ita.paloc | basefont_ita.ttf |
| Polish | 0029 | localizationstring_pol.paloc | basefont_pol.ttf |
| Portuguese - Brazil | 0030 | localizationstring_por-br.paloc | basefont_por-br.ttf |
| Traditional Chinese | 0031 | localizationstring_zho-tw.paloc | basefont_zho-tw.ttf |
| Simplified Chinese | 0032 | localizationstring_zho-cn.paloc | basefont_zho-cn.ttf |

Khi đổi ngôn ngữ, tool tự đổi package nguồn, tên JSON, PALOC đích và font ngôn
ngữ. Hai font dùng chung là `basefont.ttf` và `creditfont.ttf`.

## Localization

1. Chọn ngôn ngữ nguồn.
2. Chọn package nguồn tương ứng có `0.pamt` và `0.paz`.
3. Nhấn **UNPACK `<package>` → JSON**.
4. Trong JSON, chỉ sửa trường `translation`; giữ nguyên `marker`, `key`,
   `original` và cấu trúc file.
5. Nhấn **REPACK JSON → `<package>`**.

Kết quả mặc định:

```text
output_unpack\localizationstring_<language>.paloc.json
output_repack\<package>\0.pamt
output_repack\<package>\0.paz
```

Source luôn được copy sang staging trước khi repack. Kết quả được giải nén lại và
so sánh PALOC, kích thước PAZ, CRC PAZ và checksum đầu PAMT trước khi bàn giao.

## Font 0012

**UNPACK FONT 0012** lấy đúng ba entry:

```text
ui/basefont.ttf
ui/basefont_<language>.ttf
ui/creditfont.ttf
```

Ba file được ghi vào thư mục **Font sau khi Unpack**. Nếu chọn một thư mục cha,
tool tự tạo thư mục con `fonts`; nếu chọn đúng thư mục tên `fonts`, tool dùng
nguyên thư mục đó. Có thể thay nội dung font nhưng phải giữ đúng tên file.
**REPACK FONT → 0012** dùng đường dẫn **Font dùng
để Repack**, nén ba font, append chúng vào PAZ cuối, cập nhật offset/size/PAZ
index trong PAMT rồi xác minh round-trip. Đường dẫn **Đầu ra package 0012** độc
lập và hiển thị chính xác nơi package `0012` được tạo.

Kết quả `output_repack\0012` là patch package, chỉ gồm:

```text
0012\0.pamt
0012\<PAZ cuối>.paz
```

Các PAZ không thay đổi không bị chép vào bản mod. PAZ cuối của `0012` có thể lớn;
cần bảo đảm ổ đĩa output còn đủ dung lượng.

## Đường dẫn portable

Các mặc định `output_unpack`, JSON, `output_repack`, thư mục font và thư mục mod
được hiểu tương đối theo vị trí EXE. Có thể di chuyển EXE sang máy/thư mục khác mà
không mang theo đường dẫn cá nhân của người build. Nếu người dùng duyệt tới một vị
trí bên ngoài, tool giữ đúng đường dẫn tuyệt đối họ đã chọn.

## Giao diện responsive

Ở cửa sổ rộng, workflow và Trạng thái nằm cạnh nhau. Khi thu hẹp cửa sổ, bảng
Trạng thái tự chuyển xuống dưới workflow và header dành thêm chỗ cho bộ chọn
ngôn ngữ. Thanh cuộn dọc cho phép truy cập đầy đủ Font, Install/Uninstall và
Trạng thái ở độ phân giải hoặc chiều cao cửa sổ nhỏ.

## Install và metadata động

`Thư mục mod để cài` mặc định là `output_repack`. Package của ngôn ngữ đã chọn là
bắt buộc; `0012` là tùy chọn và chỉ được cài nếu đã build.

Mỗi lần Install, tool:

1. Xác minh PALOC/font, header PAMT, kích thước và CRC của từng PAZ sẽ chép.
2. Đọc `meta\0.papgt` hiện tại của game.
3. Tạo backup có manifest và SHA-256 cho đúng các file sắp thay.
4. Chép package localization và patch `0012` nếu có.
5. Chỉ cập nhật CRC metadata của các package vừa cài, rồi tính lại checksum
   `0.papgt`.
6. Đọc lại toàn bộ file đã cài và metadata để xác minh.

Metadata của các package/mod khác được giữ nguyên. Nếu có lỗi, tool rollback toàn
bộ package đã chọn và metadata từ backup.

```text
meta\crimson0020_backups\install-<thời gian>\
├── manifest.json
├── <package>\0.pamt
├── <package>\0.paz
├── 0012\0.pamt             (nếu có font)
├── 0012\<PAZ cuối>.paz     (nếu có font)
└── meta\0.papgt
```

## Uninstall / Restore

Uninstall dùng backup Install chưa phục hồi gần nhất và tạo thêm safety backup.
Tool phục hồi đúng các file đã bị lần Install đó thay, đồng thời:

- giữ metadata hiện tại của mọi package không thuộc lần Install;
- tính lại CRC metadata của package localization/`0012` từ chính `0.pamt` backup
  vừa phục hồi, tránh trường hợp file/PAMT và entry trong `0.papgt` bị lệch;
- hỗ trợ cả backup `0020` kiểu cũ từ các bản EXE trước;
- dừng trước khi ghi game nếu manifest hoặc SHA-256 backup bị hỏng.

Nên đóng Crimson Desert khi Install hoặc Uninstall.

## Lỗi và trạng thái

Không có popup kết quả. Các lỗi đường dẫn, thiếu PALOC/font, JSON sai cú pháp, TTF
không hợp lệ, PAMT/PAZ hỏng, metadata thiếu entry, hết dung lượng, lỗi quyền truy
cập và kết quả rollback đều hiển thị trong bảng **Trạng thái** bên phải.

## Build EXE

Yêu cầu Python 3.11-3.13 trên Windows (Python 3.13 được dùng cho bản release):

```powershell
.\BUILD_EXE.cmd
```

EXE one-file được tạo tại:

```text
release\CrimsonDesert0020Tool.exe
```

Build script dùng Nuitka để biên dịch EXE one-file không nén, đồng thời biên dịch
lõi checksum native 64-bit dùng cho PAZ font lớn và nhúng DLL vào EXE. Người sử
dụng EXE không cần cài Python, Zig hay package Python.

## Kiểm thử source

```powershell
python -m unittest discover -s tests -v
```

Kiểm tra repository không chứa dữ liệu game, binary build sẵn, đường dẫn cá
nhân hoặc chuỗi có dạng credential:

```powershell
python scripts/verify_public_source.py .
```

crimson-desert-localization-builder-public

crimson-desert-localization-builder-public Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

crimson-desert-localization-builder-public

crimson-desert-localization-builder-public Latest Version Download

Today's picks

Was this content helpful?

Recent Feedback

Download README