# 吊想 · 客户端接入包（本地版）
## 日常启动（已接入过，直接玩）
双击本目录下的「启动单机.bat」即可：它会自动启动本地服务端（最小化窗口），
等服务就绪后启动 吊想.exe。已在运行的服务端/游戏会自动跳过，重复双击无副作用。
玩完后关闭游戏，再关闭任务栏里最小化的「吊想-本地服务端」窗口即可。
（启动器会自动寻找当前 Windows 用户的 WorkBuddy Python 环境，无需固定用户名）
给已有"完整的原版吊想"的朋友。把客户端从连官方服务器，改成连本机的
离线服（127.0.0.1:19000）。**版本任意**：最新版和旧版都能用。
data 文件夹和 GameAssembly.dll 都不用动。
用法二选一（推荐用第二种，什么版本都行）：
## 方式一：覆盖预置文件（只适配当前最新官方版）
1. 解压本包。
2. 把包内这些文件整体复制到 吊想.exe 所在目录，选"替换/覆盖"：
- server.json
- launcher.json
- 吊想_Data\StreamingAssets\server.json
- 吊想_Data\il2cpp_data\Metadata\global-metadata.dat
3. 先开服务端（启动服务端.bat），再启动 吊想.exe 登录。
> 注意：官方以后更新游戏、global-metadata.dat 大小变化后，这份会失效，改走方式二。
## 方式二：一键接入工具（任意版本通用，推荐）
1. 把 一键接入.py 和 一键接入.bat 两个文件复制到 吊想.exe 所在目录。
2. 双击 一键接入.bat（或命令行执行 python 一键接入.py）。
3. 看到"完成！文件已接入本地服"即可。
4. 先开服务端（启动服务端.bat），再启动 吊想.exe 登录。
说明：工具会读取你这个客户端自己的 global-metadata.dat，把官方服务器
地址和握手公钥等长替换成本机地址，并自动备份为 global-metadata.dat.online.bak。
已接入过会提示"已经是本地版"，不会重复改。没找到官方常量（版本过老）才会报错。
## 通用注意事项
- 服务端和客户端要装/跑在同一台电脑上（本包连的是 127.0.0.1）。
- 登录输任意想用的账号密码即可，首次登录会进入建角色界面。
- 想恢复官方：把 global-metadata.dat.online.bak 改回 global-metadata.dat
（并把三个 json 的地址改回官方值，或直接还原接入前的备份文件）。
- 进阶：想和朋友联网一起玩，需要把地址从 127.0.0.1 改成对方的服务器地址/端口，
且 global-metadata.dat 也要按对方服务器的握手公钥重新打补丁——不在本说明范围内。
----
# 吊想 · 本地离线服（给朋友的单机服务端）
这是一个**纯单机**的吊想服务端：在你自己的电脑上开一个私服，配合
修改过的客户端就能登录玩。打包内容**不含任何制作者的账号、存档、密码
或隐私数据**，首次启动会生成一套独立的新存档。
## 一、需要准备
1. Windows 电脑，安装 **Python 3.12 或更新版本**（64 位）。
- 官网下载：https://www.python.org/downloads/windows/
- 安装时务必勾选 **Add Python to PATH**。
2. 一份**吊想原版客户端**（已经装好/玩过的那份），目录里有 `吊想.exe`。
3. 随附的“客户端接入包”`吊想客户端接入_本地版.zip`（连本机 127.0.0.1 的那套）。
任意官方版本都能用：把包内 `一键接入.py` / `一键接入.bat` 复制到
`吊想.exe` 所在目录，双击 `一键接入.bat` 即可。
## 二、安装依赖（只需一次）
双击或命令行运行：
```
cd 吊想离线服\server
pip install -r requirements.txt
```
## 三、启动服务端
双击 `server\启动服务端.bat`。
看到类似下面的日志就表示启动成功：
> 若提示端口被占用/启动失败，先关闭本机其它吊想旧服务或旧的离线服窗口，再重试。
```
dispatch server listening on http://127.0.0.1:19004/dispatch.json
```
出现 `Ctrl+C to stop`（或类似监听提示）后**不要关这个黑色窗口**，
它就是服务器，最小化即可。想停止就按 `Ctrl+C`。
## 四、登录游戏
1. 先启动游戏服务端（上面的窗口）。
2. 用**改好的客户端**启动 `吊想.exe`。
3. 登录时服务器地址会指向本机 `127.0.0.1`，输入任意想用的账号密码即可。
4. 首次登录自动创建角色（出生在桃源西村）。
> 注意：游戏客户端要连本机服务端，需要先做“接入”（见客户端接入包使用说明）。
> 接入包 `吊想客户端接入_本地版.zip`：最新官方版可直接覆盖包内预置 4 个文件；
> 任意版本（包括旧版）用包内 `一键接入.bat` 一键打补丁。
> 原版官方客户端不接入的话会去连官方服务器，无法进本地服。
## 五、存档与管理
- 存档位置：`data/save.db`（SQLite）。要备份/换给别人，复制这个文件即可。
- GM 后台 API：默认在本机 `http://127.0.0.1:19003/api/help`（浏览器打开可查看全部指令，仅本机可访问）。
- 服务端密钥已随包内置（`data/keys/`），与应用覆盖文件的握手公钥一致，无需手动生成。
- 常见 GM 聊天命令（游戏内发）：
- `/give 物品ID 数量`——发物品
- `/map 地图ID`——传送
- `/money 金额`——给钱
## 六、和朋友一起玩（局域网/自组网，可选用）
默认配置只在本机（127.0.0.1）运行。想让别人通过网络连你：
1. 编辑 `server\config.toml`：
- `host = "0.0.0.0"`
- `advertise_host = "你的局域网IP"`（例如 `192.168.1.100`）
- `allow_external = true`
2. 重启服务端。
3. 对方的客户端改为连你的 `advertise_host` 地址。
4. 需要在防火墙放行 19000 / 19004 端口。
> 局域网/异地联机需要组网或端口映射，不在本说明范围内。
## 七、更新
以后拿到新版服务端：把 `server` 目录和 `data` 目录之外的部分整体替换
（或者直接解压新包覆盖）。`data/save.db` 是自己的存档，别删。
----
相关游戏下载：
吊想，QQ幻想一键端单机游戏下载爆爽刺激版
https://www.wangdanyouxi.com/thread-3063-1-1.html
QQ幻想单机版一键端，吊想
https://www.0du.net/thread-9625-1-1.html