Thiết lập ROM và Cài đặt Cơ bản

2 Ship 2 Harkinian (2S2H) là dự án mã nguồn mở tối ưu hóa trải nghiệm chơi game N64 trên nền tảng hiện đại. Để bắt đầu, bạn cần xác thực ROM hợp lệ trước khi cài đặt.

Phương pháp Xác thực ROM

Mẫu giá trị SHA1 hợp lệ:

• 8dd7d5296a650672c07085a5797a8f9224c1e0e4
• 12b0110c7c6368511a5748efb1f3614a08f105e1

Hướng dẫn Cài đặt

Windows:

# Tải bản phát hành mới nhất
# Giải nén vào thư mục ứng dụng
# Chạy file 2ship2h.exe

Linux (Ubuntu/Debian):

sudo apt install libsdl2-dev libpng-dev
chmod +x 2ship2h.AppImage
./2ship2h.AppImage

macOS:

# Mount file .dmg vào Applications
# Giữ Control khi click chạy lần đầu
# Cho phép trong System Preferences > Security

Tối ưu Cấu hình Hệ thống

Bản đồ Điều khiển

Phím tắt đặc biệt: F1 (Ẩn hiện menu), F11 (Chế độ toàn màn hình), Ctrl+R (Khởi động lại)

Cài đặt Đồ họa

Chỉnh sửa tệp engine_config.json:

{
  "Renderer": {
    "Backend": "OpenGL",  // Tùy chọn: DirectX11, Metal, OpenGL
    "ResolutionScale": 1.5,
    "AntiAliasing": "MSAA_4X"
  }
}

Gợi ý tối ưu:

• GPU yếu: Dùng OpenGL, tắt AA, Scale 1.0x
• GPU trung cấp: Bật Anisotropic Filtering 4x, Scale 1.5x
• GPU mạnh: MSAA 4x + Ambient Occlusion, Scale 2.0x

Tạo Gói Âm nhạc Tùy chỉnh

Quy trình Thực hiện

1. Tổ chức tệp âm thanh theo chuẩn:

   custom_audio/
       ├── battle_theme.ogg
       └── overworld.mp3

2. Sử dụng công cụ AudioPacker:

   audio_packer --input custom_audio \
                 --format OTR \
                 --output zelda_music.otr

3. Đăng ký gói âm nhạc:

   cp zelda_music.otr mods/audio/

Trong game: Vào Enhancements > Audio Manager > Chọn bản nhạc cần thay thế

Xây dựng từ Mã nguồn

Môi trường Phát triển

Linux:

sudo apt install gcc g++ cmake ninja \
                sdl2 libpng libzip nlohmann-json

Windows:

# Cài Visual Studio 2022 với:
# - C++ Build Tools v143
# - Windows 10 SDK

Biên dịch Dự án

git clone https://github.com/HarbourMasters/2ship2harkinian
cd 2ship2harkinian
git submodule update --init
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=Release
cmake --build build
cd build && cpack -G ZIP

Giải quyết Sự cố Thường gặp

Tối ưu hiệu năng: Tắt VSync, giới hạn 60 FPS, tắt ứng dụng nền