帕魯不打烊 · 朋友端 MOD 安裝工具 v1.1.1

v1.1.1 — 同步速度優化

主要改動

• 同步 MOD 資料庫加速：4 個 mod 時從 2-3 秒壓到 0.6-0.9 秒（3 次實測 min 645ms / median 662ms / max 878ms）。改用 ThreadPoolExecutor 平行抓取 manifest.json，避免每個 raw URL 都要單獨 TLS 握手的序列瓶頸。
• 修正 BreedingHelper 版本標籤 double-v 顯示問題（v1.1+v2 之前顯示成 vv1.1+v2）。

安裝

下載 PalworldFriendModInstaller-v1.1.1.zip 並解壓縮，雙擊 PalworldFriendModInstaller.exe 即可。（Windows SmartScreen 警訊依使用說明.txt 操作）

包含的 4 個 mod

• 帕魯繁殖助手 (BreedingHelper) — 計算配種結果、染色 / IV 鎖定
• 極致天氣 (UltraWeather) — 自訂日出日落、體積雲
• 小地圖雷達 (YetAnotherMinimap) — 全螢幕小地圖 + 隊友位置
• 青眼混沌龍 (BlueEyesChaosMaxDragon) — Xenolord 變身「青眼白龍」cosplay（純視覺）

完整更新日誌見 CHANGELOG.md。

PalworldFriendModInstaller v1.1.0

v1.1.0 (2026-08-02) — YetAnotherMinimap + Chinese UI

Friend installer now ships with 3 mods (BreedingHelper + UltraWeather + YetAnotherMinimap),
all displayed in Traditional Chinese with full "View Details" dialogs showing
features + usage instructions.

What's new

• YetAnotherMinimap (Paldar unofficial latest) added — real-time minimap radar
  showing Pals, chests, dungeons, fast-travel, player bases, death locations,
  skill-fruit trees, rare/shiny Pals, bosses. Client-only, server-side untouched.
• Mod cards fully Chinese — display name, description all in 繁中.
• "查看詳情" (View Details) button on every mod card — opens a dialog with
  full feature list + step-by-step usage instructions + source link.
• usage_zh field added to all manifests — friends get a Chinese
  how-to-use guide for every mod.
• Friend installer distributed as .zip — downloads as one archive containing
  the .exe + SHA256.txt + 使用說明.txt. Sidesteps most browser-level SmartScreen
  false positives that hit a bare .exe on GitHub Releases.

Download

• PalworldFriendModInstaller-v1.1.0.zip (88.2 MB) — friend-facing bundle
  • Extract → run PalworldFriendModInstaller.exe
  • Or send the .zip to friends directly

Build

• Raw PyInstaller, 88.5 MB single .exe
• Python 3.11.9 + Flet 0.86.4
• 3 mods auto-discovered via fetch_mods_from_github() (no catalog baked in)

Notes for friends

1. 解壓縮 zip → 雙擊 PalworldFriendModInstaller.exe
2. 第一次開可能跳 SmartScreen 警訊 → 點「其他資訊」→「仍要執行」
3. 進工具後點「🚀 一鍵安裝 UE4SS」（如果還沒裝）
4. 點「同步 MOD 資料庫」→ 看到 3 個中文 mod 卡：
   • 帕魯繁殖助手（BreedingHelper）
   • 極致天氣（UltraWeather）
   • 小地圖雷達（YetAnotherMinimap）
5. 想看詳細說明 → 點每張卡片的「查看詳情」

Mods included

中文名	英文	客戶端	伺服器端	熱鍵
帕魯繁殖助手	BreedingHelper	✅	✅	F8
極致天氣	UltraWeather	✅	❌	F8（重置）
小地圖雷達	YetAnotherMinimap	✅	❌	左 Ctrl + H

PalworldFriendModInstaller v1.0.8

使用說明
請先檢查有沒有安裝UE4SS
沒有的話按一鍵安裝
再按MOD同步

v1.0.8 (2026-08-02) — repo-driven mod discovery

Friend installer now reads mods directly from the GitHub repo. No more
hand-edited friend-catalog.json to ship with each new mod.

What's new

• Repo-driven mod discovery — installer lists mods/ via the GitHub
  API and reads each mod's manifest.json at runtime. Adding a new mod
  is now: drop a folder under mods/<name>/ with manifest.json + zip
  files. No catalog update, no installer rebuild, no SHA256 in catalog.
• Auto-loads both current mods on first sync: BreedingHelper
  (server+client) and Ultra Weather 1.0.1 (client-only).
• Custom catalogs still work — drop a friend-catalog.json next to
  the .exe (or in PyInstaller's _MEIPASS) and that local file takes
  precedence over the GitHub API. Useful for forks or local testing.

How to add a new mod from now on

1. Create mods/<YourMod>/ in the repo
2. Add mods/<YourMod>/manifest.json with this shape:

   {
     "name": "YourMod",
     "display_name_zh": "你的 mod",
     "version": "1.0.0",
     "description_zh": "...",
     "friend_allowed": true,
     "components": {
       "client": {
         "zip": "client.zip",
         "extract_to": "Pal/Binaries/Win64/ue4ss/Mods",
         "needs_ue4ss": true,
         "files": ["Scripts/main.lua"],
         "sha256": "<sha256 of client.zip>"
       }
     }
   }

3. Drop the actual zip file(s) at mods/<YourMod>/<component>.zip
4. Push to main — friends see it on the next "sync MOD database" click

Build

• Raw PyInstaller, 88.6 MB single self-contained .exe (Python 3.11 + Flet 0.86.4)
• No bundled friend-catalog.json — installer hits GitHub API at runtime

Known issues (unchanged from v1.0.7)

• During install/uninstall, 5-6 small console windows may briefly flash
  (Flet view's Chromium sub-processes). F8, verify, and other UI
  features all work correctly. This is a Flet/Chromium on Windows issue,
  not a fixable problem in our code.

帕魯不打烊 Mod 安裝工具 v1.0

v1.0.7 (2026-08-02)

這是專門給帕魯不打烊SERVER的MOD
請先確認有安裝UE4SS再安裝MOD

What's new

• Pal running check - refuses to install if Palworld.exe is running (prevents .pak/.dll lock)
• Auto-backup - snapshots existing mods to *.bak-<timestamp> before destructive operations
• UE4SS layout health check - verifies 5 critical files (UE4SS.dll, settings.ini, Mods/, UEHelpers, mods.txt)
• Mod verification - checks installed files match catalog expectations
• In-UI verify button - runs all checks, shows results in a dialog
• Auto-rollback on install failure - restores from backup if layout check fails

Fixed

• _install_component client branch bug (backup_msg UnboundLocalError)
• verify_mod_install SHA256 misuse (was hashing files against zip-level hash)
• Catalog UTF-8 BOM + Chinese mojibake
• Bundled catalog lookup (now checks sys._MEIPASS first for PyInstaller onefile)
• Flet 0.86.4 API compatibility (show_snack_bar -> show_dialog, page.open -> show_dialog)
• friend_common.py returns utf-8-sig decoded bytes (handles catalog with BOM)

Build

• Now built with raw PyInstaller (88 MB) instead of flet pack (60 MB) to avoid Chromium sub-process console flashes during install/uninstall operations.

Friend installer

• Single ~88 MB self-contained .exe (Python 3.11 embeddable + Flet 0.86.4)
• Catalog has only BreedingHelper v1.1+v2 (CrazyChips custom build, includes the v2 try_hook_widget_tick fix that prevents the F8 crash on dedicated server)
• First-run SmartScreen warning documented in USAGE.md

Known issues

• During install/uninstall, 5-6 small console windows may briefly flash (Flet view's Chromium sub-processes). F8, verify, and other UI features all work correctly. This is a Flet/Chromium on Windows issue, not a fixable problem in our code.