xkx100

侠客行100 UTF-8 中文版 (基于MudRen/xkx100的fork)

• home [+<数字>|<数字>|-<数字>] - 记录/移动到/删除回城点（1-9），共可设 9 个
• localcmds (lc) - 查看当前房间所有可用指令
• deposit/cun all - 将身上所有现金一次性存入钱庄
• withdraw/qu <数量>[g|s|c] - 取款，不跟单位默认白银（例: 100=100银, 100g=100金, 100c=100文）
• verify <武功名称> - 查询此项技能的功能和数据
• hpmin - 精简状态，一行 JSON 风格输出精气、气血、精力和内力

• lm → map
• sk → skills
• map → map all
• sc → score
• lc → localcmds

• set no_more 1 - map 不分页
• set no_hunger 1 - 不饥渴
• set no_weather 1 - 不显示天气信息

• sppasswd <id> NO - 免密登陆
• roomid <房间名关键词> - 按房间名查找房间档名
• npcid <关键词> - 按 NPC 名字查找所在位置

项目下载

# clone xkx100
git clone https://github.com/zii/xkx100.git

请使用 fluffos 最新版驱动：

fluffos config.ini

优先本地运行（性能最好），如果编译环境受限再使用 Docker。

macOS 上可以直接编译 FluffOS 本地运行，彻底避免容器化的文件系统开销。 启动 < 1s，CPU ~0.3%，内存 ~10MB，零延迟。

brew install cmake pkg-config pcre openssl jemalloc icu4c sqlite3 googletest

git clone https://github.com/fluffos/fluffos.git
cd fluffos
mkdir build && cd build
ICU_ROOT="/usr/local/opt/icu4c" OPENSSL_ROOT_DIR="/usr/local/opt/openssl" \
  cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DPACKAGE_DB_SQLITE=2 -DPACKAGE_DB_MYSQL="" ..
make -j$(sysctl -n hw.logicalcpu) install

编译后 driver 在 build/bin/driver，可拷贝到系统路径：

cp build/bin/driver /usr/local/bin/fluffos

💡 消除 LPC 编译警告： 默认编译会启用大量 LPC 编译警告（unused variable 等），这些警告 无害但刷屏。如需清静，编辑 src/local_options, 去掉 PRAGMA_WARNINGS，然后重新编译即可。

cd /path/to/xkx100
fluffos config.ini

telnet localhost 5555   # GBK 编码
telnet localhost 6666   # UTF-8 编码

从 GitHub Releases 下载 fluffos 二进制文件，chmod +x 后即可直接使用，无需自行编译。

本地无法编译 FluffOS 时使用（如 Windows 或环境受限的 macOS）。

项目已包含 docker-compose.yml 配置，默认使用最新版 FluffOS master：

# 启动
docker compose up -d

# 查看日志
docker compose logs -f

# 停止
docker compose down

# 重启
docker compose restart

配置文件 docker-compose.yml 中可修改镜像版本：

image: ghcr.io/fluffos/fluffos:master    # 最新开发版
# 或
image: ghcr.io/fluffos/fluffos:v2019.20220507  # 稳定版

cd /path/to/xkx100

docker run -d --name xkx100 \
  -v $(pwd):/mudlib \
  -p 5555:5555 \
  -p 6666:6666 \
  -p 8888:8888 \
  --entrypoint sh \
  ghcr.io/fluffos/fluffos:v2019.20220507 \
  -c "cd /mudlib && /fluffos/bin/driver /mudlib/config.ini"

注意：cd /mudlib && 是必须的，因为 driver 在读取 mudlib directory 配置前会先打开日志文件，而容器默认工作目录不是 /mudlib。

管理命令：

验证：

telnet localhost 5555   # GBK编码
telnet localhost 6666   # UTF-8编码

游戏端口：5555(GBK编码)、6666(UTF8编码)；网页访问端口：8888

Docker Desktop 在 macOS 上占用资源较多（通常 4-5GB），导致系统卡顿。推荐使用 Colima 作为轻量替代：

# 安装
brew install colima

# 启动（按需分配资源，跑 MUD 最低 0.375G/1CPU 即可）
colima start --cpu 1 --memory 0.5 --disk 2

# docker compose 启动游戏
docker compose up -d

Colima 内存占用约 Docker Desktop 的 1/4，对 MUD 这种轻负载绰绰有余。

常用命令：

配置文件： ~/.colima/default/colima.yaml，可直接编辑 memory、cpu 等参数，改后重启生效。

FluffOS 在启动时会将 d/、kungfu/、clone/ 等目录的大量 LPC 文件读入内存。在 macOS 上通过 Docker bind mount（走 sshfs）访问这些文件有显著的 I/O 开销。

本项目通过 Docker tmpfs + 启动时复制的方式，将热路径文件放在容器的内存文件系统中运行：

tmpfs:
  - /mudlib/d:rw,noexec,nosuid,size=64M       # 房间文件 ~9000 个
  - /mudlib/kungfu:rw,noexec,nosuid,size=16M   # 武功文件
  - /mudlib/clone:rw,noexec,nosuid,size=16M    # 克隆对象

工作流程：

宿主机硬盘 (ext4/apfs)  →  sshfs bind mount  →  容器 tmpfs (内存)
     ↑ 改代码在这写                                   ↓
                                        FluffOS 加载 LPC 时读这里

开发时注意： tmpfs 中的文件是容器启动时的快照，宿主机上改 d/、kungfu/、clone/ 不会自动同步到容器内。需要开启同步脚本：

# 需先安装 fswatch
brew install fswatch

# 监控文件变更，实时同步到容器 tmpfs
./sync-container.sh

该脚本通过 base64 管道写入容器内部，绕过 docker cp 在 tmpfs 上建文件权限不可靠的问题。

entrypoint 负责在容器启动时把数据拷入 tmpfs，39M 数据耗时 < 1s：

cp -a /d-source/. /mudlib/d/
cp -a /kungfu-source/. /mudlib/kungfu/
cp -a /clone-source/. /mudlib/clone/

效果对比：

优势： 热数据（LPC 源码）在 tmpfs 中读写，冷数据（玩家存档、日志）走 sshfs bind mount，既保证了开发体验（改代码即改即生效），又让高频 I/O 路径达到纯内存速度，甚至优于 FluffOS 直接在原生 ext4 上运行的效果。

macOS 本地直接运行 FluffOS 与通过 Colima/Docker 容器的实测对比：

结论： FluffOS 是一个单进程事件循环的古典程序，3MB 二进制跑起来只要 10MB 内存。 容器化对 Web 应用有意义，对 MUD 这种直接跑在文件系统上的程序属于纯开销。 macOS 上开发推荐本地编译运行，部署再考虑容器化。