Book and Sword 2002

✅ 可玩

书剑2002

jinyongwenzi

🔑 fluffos / Mud@2026 更新 a553fc7 2026-09-01 源码 下载 ZIP

▶ 开始游玩 · Play Now

源文件包名为"金庸文字版",取名自金庸小说《书剑恩仇录》。新角色开局就是一段"越狱"场景——在皇宫广场遭遇守卫拦截——随后立刻要从一阳指、九阳神功、易筋经、太极拳四门绝学里选一门修炼,直接决定日后的武学发展方向;此外仍可通过传统拜师制度加入少林、武当、明教、天山派等取自小说设定的门派。死亡是真实可用的复活循环而非软锁:死亡房间和新手出生点是同一地点,角色死后会直接回到开局的越狱场景重新经历一遍。经比对确认,这与本项目中的"bxsj"(书剑天下)、"bxsj1" 是同一套代码库的不同历史快照,属于同一支血脉的武侠 MUD。

English

In-game titled "书剑2002" (Book and Sword 2002), from a source package named "Jin Yong Text Edition" after Jin Yong's novel The Book and the Sword. A file-level comparison shows this isn't an independent rewrite but the same underlying codebase as this project's bxsj (Book and Sword: World of Jianghu) and bxsj1 — core system files (master/security/simul_efun) match byte-for-byte once CRLF line-ending differences are stripped out, and roughly two-thirds of the whole file tree overlaps — making all three different historical snapshots of one shujian/wuxia MUD lineage. New characters open on a prison-break scenario (a guard encounter at the Palace Square) and immediately pick one signature skill — Yiyang Finger, the Nine Yang Manual, the Yijin Jing, or Tai Chi Chuan — that shapes their whole martial-arts development path, on top of (not instead of) the traditional bai/apprentice sect-joining system into houses drawn from the novels (Shaolin, Wudang, the Ming Cult, the Tianshan sect, and others). Death is a real, working respawn loop rather than a soft-lock: the death room and starting room are literally the same location, so dying drops a character back into the opening prison-break encounter to replay it. Two shop NPCs at a roadside inn have working buy/list commands, while a parallel banking mechanic and most other vendor NPCs turned out to be well-coded but never actually placed in any room, unreachable in play. One quirk preserved rather than "corrected": the login code never checks passwords for existing accounts, an inherited behavior from the original snapshot; the built-in quest daemon also never seeds new dynamic quests, since its seed data lives in a /quest/ directory genuinely missing from this archive, though this doesn't affect ordinary combat/training/chat play.

README

内容亮点

在线试玩

https://mudlibs.fluffos.info/jinyongwenzi/

管理员账号 / Admin account

警告:正式对外开放前请务必修改此密码并恢复密码校验。

本地运行

cd libs/jinyongwenzi
~/src/fluffos/build-debug/src/driver config.fluffos

游戏端口:40083

NOTES · 移植与修复记录

金庸文字版.exe → jinyongwenzi (TRIAGE ONLY — not converted)

Extraction — two attempts, one silently-broken

1. 7z x "succeeded" but is a trap: it printed ERROR: Unsupported Method for 6,409 individual members (exactly the total file count) and Sub items Errors: 6409, yet exited having created every single file anyway — all 6,409 files landed on disk at 0 bytes, correct names/ timestamps, zero content. If you don't check file sizes after a 7z extraction of this SFX, you'd wrongly conclude the archive is full of empty stub files (or, worse, a fake/empty installer). 2. unrar x extracts it correctly — reports All OK, and 6,392 of the 6,409 files came out non-empty (17 zero-byte files appear to be genuinely empty in the source, e.g. some feature/*.c stubs — not an extraction artifact, sizes match plausible real content elsewhere). Lesson for future self-extracting .exe archives in this project: verify with find <dest> -type f -size +0c | wc -l vs total file count after EITHER tool, don't trust a clean exit code alone — 7z's "Unsupported Method" here is a real, silent-failure-mode method 7z's implementation of whatever RAR compression variant this SFX uses doesn't support, but it still writes placeholder files and doesn't propagate a nonzero process exit in a way that's obviously fatal.

Extracted to libs/jinyongwenzi/raw/ (via unrar x).

What's actually inside — THREE bundled things, not one

金庸文字版/
├── shujian/              <- genuine LPC MudOS mudlib (35MB, ~4,915 .c + 130 .h)
├── PZmud462/              <- bundled "PZMUD" (zmud-like) Windows telnet client (4.0MB)
├── hy/                    <- client-side menu/trigger text files for that client (60K)
├── MudOS.exe, mudos.dll   <- prebuilt Windows MudOS 0.9.20 driver binary
├── cmud.exe               <- a second bundled telnet client
├── 金庸文字版(zmud).bat   <- launcher: `start mudos.exe config.sj` + `start PZmud462\zmud.exe`
├── 金庸文字版(cmud).bat   <- launcher: `start mudos.exe config.sj` + `start cmud.exe`
├── config.sj, mudos.ini   <- driver config (config.sj is a genuine MudOS 0.9.20 runtime config)
├── *.mid, MudRoom.INI, MUDCHAR.DAT, ...  <- client-side sound/UI assets for the bundled clients
└── color.c                <- loose file at top level, unrelated to shujian/ (not investigated further)

This is the "bundles multiple things (client + server)" pattern AGENTS.md's pipeline step 2 already warns about, taken to its fullest extent seen so far in this project: a complete turnkey Windows package — driver binary + mudlib source + TWO alternative bundled telnet clients + auto-launch .bat scripts — clearly meant to be double-clicked and immediately play as a "local" experience, which is almost certainly why AGENTS.md's original triage note speculated it might be "a standalone single-player text game, not an LPC/FluffOS mudlib at all." That speculation is not correct — see below.

Determination: GENUINE LPC MUDLIB (do not convert without a dedicated pass — reporting only, per task instructions)

The shujian/ subtree is unambiguously a real, playable-over-the-network MudOS/LPC mudlib, not a single-player game:

**The PZmud462/, hy/, cmud.exe, MudOS.exe/mudos.dll, *.mid, .bat, .INI/.DAT client-and-driver-binary material is NOT mudlib source** and should be excluded/ignored the same way this project already ignores bundled prebuilt drivers/clients in other archives (per AGENTS.md pipeline step 2) — only shujian/ (and its config.sj) is relevant to any future conversion pass.

Per task instructions: STOPPING HERE

Per the triage task's explicit instruction, since shujian/ is genuine LPC mudlib source in a mudlib-shaped tree, no conversion, work/ copy, config.fluffos, port assignment, or driver boot attempt was made — this NOTES.md is a triage report only. If the main session decides to proceed, the next steps would follow the standard pipeline (AGENTS.md pipeline steps 2-7): confirm shujian/ as mudlib root (already done here), assign a port, copy to work/, run the encoding/.c.lpc/staticnosave passes, then compile/boot per usual. Not attempted in this pass.

Recommendation for TODO.md (left to the main session to apply, superseded below)

Suggest updating archive #90's row from "not started / may not be an LPC mudlib at all, triage first" to reflect the actual finding: it IS a genuine LPC MudOS mudlib (书剑2002, root shujian/) bundled inside a self- extracting exe alongside driver + 2 client binaries; ready for a normal conversion pass whenever scheduled. libs/jinyongwenzi/raw/ currently holds the unrar-extracted tree (7z's extraction of this file is NOT usable — see "Extraction" above, don't reuse a 7z-produced raw/ for this archive).


Conversion pass (this session) — Port 40083. Status: DONE — boots clean, full registration + post-login commands confirmed working over telnet

Lineage confirmation against libs/bxsj (archive #4) — SAME codebase, not just "related naming"

The triage pass above flagged this as "related lineage/naming convention, almost certainly NOT the same underlying codebase snapshot" based only on directory-shape/name similarity. A direct byte comparison proves that call wrong — this is the literal same codebase as bxsj (书剑天下), just saved with different line endings at some point in its history:

What was applied proactively, before ever booting (ported directly from bxsj/AGENTS.md, confirmed present via identical-file diff first)

1. adm/single/master.lpc log_error() (AGENTS.md §4 family): added the logging_error reentrancy guard + catch() around CHANNEL_D->do_channel(...). Confirmed the identical unguarded call was present (byte-identical source to bxsj's pre-fix version). 2. adm/single/master.lpc valid_override() (AGENTS.md §14): added the 3rd main_file parameter, plus the shout/write/tell_object/tell_room/say allow-list, exactly as in bxsj. 3. adm/daemons/securityd.lpc valid_read() (AGENTS.md §8c): was if (this_player()) user = this_player(); unconditionally — same bug/same file as bxsj, wrongly attributes a system-initiated load_object() (e.g. master lazily loading an unpreloaded daemon) to whatever player happens to be connected at the time, denying /adm reads a real root-euid caller was always allowed. Fixed to only fall back to this_player() when user has no resolvable euid/uid of its own. 4. adm/simul_efun/chinese.lpc is_chinese() (AGENTS.md §15h, applied here proactively for the first time instead of post-hoc): was checking GBK lead/trail-byte ranges (0xa1-0xfe etc), which silently never match now that str[i] returns a Unicode codepoint on this driver. Replaced with a CJK Unified Ideographs block check (str[0] >= 0x4e00 && str[0] <= 0x9fff). Note: this codebase's own check_legal_name() (which also has the GBK-byte-length-bound half of this bug, per bxsj's NOTES) turned out to have its ONE call site commented out in logind.lpc here — registration never actually invokes it in this snapshot, so that half of the fix was moot for registration specifically, but is_chinese() itself is still called live from several gameplay files (artname.lpc, uweapon.lpc, bboard.lpc, ling.lpc, zhao.lpc, tiejiang.lpc) so the fix was applied anyway.

Routine per-lib mechanical steps (via convert_lib.sh)

§15c: /adm/etc/preload bare .c refs (found and fixed)

Two of the 14 preload entries were bare paths with a literal .c suffix (/adm/daemons/questd.c, /adm/daemons/cron.c) — not caught by the quote-anchored .c" auto-fixer since this is an unquoted plain-text data file (exactly AGENTS.md §15c's documented shape). master.lpc's preload() does file_size(file + ".lpc") before loading, so "questd.c" + ".lpc" = questd.c.lpc, which never exists — the daemon would have silently never loaded, with zero error anywhere (preload() just returns early). Fixed both entries to bare questd/cron (matching every other entry in the file).

§15p: excluded network/dns_master from preload

Removed proactively per standing policy, before the first boot attempt.

§6: log directory — created libs/jinyongwenzi/log/ (sibling of config.fluffos, not inside work/)

The shipped config.sj used log directory : /adm/log; simplified to /log in config.fluffos (matching every other converted lib's convention) and created libs/jinyongwenzi/log/ at the driver's actual launch CWD. Also proactively created a log/nosave/ subdirectory (missing from the raw archive, present in bxsj's copy — AGENTS.md §15ah: master.lpc's crash()/log_error() both write there) to avoid a silent write_file()/log_file() failure if the driver ever crashes.

New findings this pass — TWO bugs bxsj/bxsj1 ALSO have, unfixed and undetected there

Both were only caught because this pass followed §15ae's standing policy literally (test a real post-login command, not just reaching the world) — bxsj's own NOTES.md explicitly stops at "reached ... the password prompt", never tests a command after entering the game, which is exactly the blind spot §15ae warns about. Confirmed by direct file comparison that bxsj's shipped work/ has the *identical* unfixed source for both of these:

1. feature/command.lpc's command_hook() was private nomask (AGENTS.md §15ae, textbook case) — inherited into the player body via F_COMMAND, registered with add_action("command_hook", "", 1), and on this driver a private function is unreachable by add_action's external dispatch. Registration completed fine (driven by input_to, not add_action), the character reached the game world, and then every single typed command — look, score, quit, everything — silently produced the default fail message (什么?), with zero debug.log entry, indistinguishable from a hung connection. Fixed by dropping private (kept nomask). Also found and fixed the identical pattern in one NPC file, d/city/npc/zhao.lpc's change_name() (registered via add_action("change_name", "zhuce")) — same fix. Confirmed bxsj's work/feature/command.lpc still has this exact private nomask on command_hook today — bxsj (and almost certainly bxsj1, same lineage) is very likely ALSO completely command-dead post-registration; flagging for the main session to decide whether to re-open those libs, out of scope for this task to fix directly. 2. adm/daemons/commandd.lpc's rehash() filters get_dir() output with sscanf(cmds[i]+"$", "%s.c$", cmds[i]) — a NEW bug pattern not yet in AGENTS.md's catalog, a variant of the classic .c.lpc rename fallout but invisible to every existing detection method (it's not a quoted string literal §2's auto-fixer or grep-for-.c" would catch, and it's not a bare-line data file §15c's preload fix pattern covers either — it's a live sscanf format string that silently matches nothing once every command file is named .lpc instead of .c). Effect: rehash() filtered its OWN get_dir() listing down to zero files every time (nothing ends in literal .c anymore), so search[dir] was NEVER populated, and find_command() returned 0 for every verb, forever — which combined with bug #1 above to produce the exact same "every command does nothing" symptom via TWO independent, compounding root causes. Fixed by matching "%s.lpc$" instead. Grepped the whole tree for the same sscanf(...,"%s.c$"/"%s.c",...)-shaped pattern — only this one instance exists. bxsj's shipped work/adm/daemons/commandd.lpc has the byte-identical unfixed "%s.c$" pattern too — same flagging-for-the-main-session note as bug #1; recommend adding this as a new AGENTS.md catalog entry (proposed §15ar) since it's a genuinely new class of .c.lpc fallout distinct from §2/§15c, and checking every already-"done" lib in this lineage family for it.

Both of the above were root-caused by first restarting the driver after the master/securityd fixes, completing a full interactive registration, observing look/score/quit all silently returning 什么?, then reading feature/command.lpc's dispatch chain end-to-end (find_command → commandd.lpc → rehash) rather than assuming it was one bug — the two compounded, and fixing only one of them (either one) would still have left the lib completely uncommandable after registration.

Cosmetic bug also fixed (not fatal, but noisy on every login/logout)

adm/daemons/logind.lpc's enter_world() and clone/user/user.lpc's net_dead() both called CHANNEL_D->do_channel() passing a non-player object as the "who" argument (this_object() = the logind daemon itself, and load_object(LOGIN_D) respectively, instead of the real player) — neither defines query("channel_id"), so channeld.lpc's fallback path (me->query("name") + "(" + capitalize(me->query("id")) + ")") crashed on capitalize(0) on literally every single login and every single disconnect (caught by the driver's own error handler, non-fatal, but spammed debug.log and the "err" channel on every connect/disconnect). Fixed both call sites to pass the actual player object, matching every other correctly-written do_channel() call site elsewhere in the same tree.

Confirmed NOT needed (checked, found absent/inapplicable)

Boot result

Clean boot, zero fatal errors. debug.log shows only expected compile *warnings* (unused locals, "Illegal to declare nosave function" on functions that are legitimately nosave-annotated per this codebase's own convention — cosmetic, harmless).

Update (2026-07-24, WASM long-sit boot-watch, AGENTS.md §7.9 class, FIXED): a previous pass of this note logged questd.lpc's read_table() explode()-on-0 preload error as a MySQL-environment gap and left it unfixed — that diagnosis was a guess, not verified against the source (questd.lpc has no MYSQL/__USE_MYSQL__ reference anywhere, and its create() has no catch() of its own; the error was only ever caught by master.lpc's generic preload() wrapper). The real root cause: read_table("/quest/dynamic_quest") and a second unguarded call two lines later (roomlines = explode(read_file("/quest/dynamic_location"), "\n")) both feed read_file()'s result straight into explode() with no stringp() guard — classic AGENTS.md §7.9 shape. /quest/ doesn't exist ANYWHERE in this archive (not a fresh-checkout gitignore gap, a genuine missing directory), so both calls always error, on every single boot, every time. Fixed both sites in adm/daemons/questd.lpc (read_table()'s line = ... assignment and create()'s roomlines = ... assignment) to guard with stringp() and fall back to ({}) — matches read_table()'s own natural "no data" return shape, and init_dynamic_quest()'s for (i = 0; i < sizeof(quests); i++) loop already no-ops cleanly on an empty quests array (never reaches the roomlines[random(...)] indexing that would otherwise need roomlines to be non-empty). Verified: fresh WASM long-sit boot-watch (200s) shows zero runtime errors of any kind (previously the one caught questd hit); native registration + look + score + quit (id qinfengw, Chinese name 秦风) still works end-to-end with no new regressions. Quest-spreading itself (spread_quest()) simply never fires without the missing /quest/dynamic_quest seed data — same as before, but now via a clean early return instead of a caught runtime error on every boot.

Full registration + post-login test transcript (ONE continuous connection)

cd libs/jinyongwenzi
~/src/fluffos/build-debug/src/driver config.fluffos
python3 ../../scripts/mudclient.py 127.0.0.1 40083 --timeout 30 --idle 0.5 \
  --send "qinfengc" --send "y" --send "秦风" --send "" --send "y" --send "1" \
  --send "look" --send "score" --send "quit"

lpcc_check.sh sweep

total=4915 pass=4866 fail=49 (99.0% pass). Failure categories, all matching known pre-existing-content-gap shapes already seen across this project (none in the master/login/security compile path, none newly introduced by this pass's fixes):

Full failure list: libs/jinyongwenzi/lpcc_fail.log (49 entries, 1317 lines with full compiler output).

Re-verification pass: driver rebuild + LPC formatter + WASM build

How to run

cd libs/jinyongwenzi
~/src/fluffos/build-debug/src/driver config.fluffos
python3 ../../scripts/mudclient.py 127.0.0.1 40083 --timeout 30 --idle 0.5 \
  --send "someid" --send "y" --send "真实中文名" --send "" --send "y" --send "1" \
  --send "look" --send "score" --send "quit"

WASM-enablement pass (loopback-allow / uptime / throttle / admin seed)

Standard pass per AGENTS.md §1.3(b)/(e), §1.5.

Gates patched:

Cold-relogin fix (real pre-existing bug exposed while seeding admin): adm/daemons/securityd.lpc valid_read() — added an own-save-file exception for func == "restore_object" mirroring valid_write()'s save_object exception. Without it, the cold-relogin path (logind.lpc get_passwd → make_body → user->restore(), body has uid but no euid until enter_world()'s exec/setup) got "restore_object: read permission denied: /data/user/...o", and the returning player landed in a body whose command path was never set (every command answered "什么?"). Hot/netdead reconnect was unaffected, which is why earlier passes (which only tested reconnect) never saw it.

Admin account: id fluffos, pw Mud@2026 (this snapshot does not verify passwords on login — original upstream edit), name 浮浮, granted (admin) via adm/etc/wizlist (rewrote file LF-only; the old CRLF endings made every parsed level end in \r and match nothing). Verified: relogin as fluffos, update /adm/daemons/band → 成功, admin-channel tag 【仙人】 shown. Save files (untracked but NOT gitignored — orchestrator must add): work/data/user/f/fluffos.o, work/data/login/f/fluffos.o.

Retest: fresh registration (id ceshiyi, name 秦风壬) end-to-end OK — look/score/quit all correct; test char saves removed afterwards. Only pre-existing caught questd preload error in debug.log; no new errors.

Proactive fix (2026-07-24): rank-decay loop crashed every quit (AGENTS.md §7.16/§10.7)

Found while pattern-matching a bug discovered on lineage sibling bxsj during that lib's first deep functional playthrough (AGENTS.md §10.7 methodology), before ever booting this lib for the check. cmds/usr/top.lpc's add_rank() decays a stale rank entry's score via while (ranks[i]["time"] + 3600 < t) { ... } with no iteration cap. The shipped work/log/rank.o carries a real timestamp from 2007 ("time":1181487290), so any boot against today's wall clock runs the loop ~170,000+ times and blows the eval-cost limit. cmds/usr/quit.lpc:139 calls TOP_CMD->add_rank(me) unconditionally on every quit — so every quit was silently crashing (driver's error handler swallows it; the player-visible "正在退出游戏……" message looks normal). Fixed the same way as bxsj: cap the loop at 240 iterations (~10 days of decay, enough to crush any stale score near zero) and unconditionally advance the stored timestamp to t afterward regardless of whether the cap was hit. Compile-checked clean via lpcc --batch; not re-verified live in this lib specifically (verified live on bxsj, the source of the pattern) — flagging per §10.7 point 6 rather than silently claiming a live retest.

深度功能测试 / Deep functional test (2026-08-06)

第一次完整游玩测试(原生驱动 build,ASAN/UBSAN debug 构建)。测试角色 id jyxtest,中文名 云飞扬,起手绝学选择「太极拳」(选项 4)。本轮 WASM 未重新验证:emsdk 工具链下载硬编码指向 storage.googleapis.com, 本次会话的出口代理策略性拒绝该域名(403,已用 curl $HTTPS_PROXY/__agentproxy/status 确认是策略拒绝而非临时故障),本地无 法构建 WASM 驱动。

发现并修复:natured.lpcevent_morning() 缺失 objectp() 守卫,导致日夜循环心跳永久停摆(新 AGENTS.md §7.63 追加实例)

发现并修复:回车一次即可进入提示与实际代码行为矛盾——按提示操作反而进不去

测试内容与结果

Round-four re-test (2026-08-20): economy/shops, sect apprenticeship, death/resurrection

Targeted the three areas the 2026-08-06 deep functional test explicitly left uncovered. Fresh build-debug driver boot, port 40083, tested via a raw Python telnet-negotiation-stripping socket script (two concurrent connections: a real registered player + the fluffos admin account, driven with goto/summon/clone/give/smash/update) rather than tmux_mud.sh, per this session's standing tooling preference.

Death/resurrection: WORKS CLEANLY, no bugs found

Registered a fresh character (jysidie, 秦风肆), used the admin's summon + smash (smash calls ob->die() directly — a real death, not a scripted low-HP retreat) to kill it. Full cycle confirmed:

Sect apprenticeship (bai/apprentice): CONFIRMED PRESENT, coexists with the signature-skill starter

Traditional sect-joining is NOT replaced/absent — cmds/skill/apprentice.lpc implements a full bai <master> / apprentice <master> flow (kneel-and-kowtow kowtow-to-join-family logic, expell/betrayal handling, generation tracking), and adm/daemons/aliasd.lpc maps "bai": "apprentice". Found real sect-master candidate NPCs (d/sld/npc/*.lpc etc. carrying set("family", ...) / family_name) — not live-tested end-to-end this round (would need a wizard escort to a specific sect NPC plus meeting its family/generation prerequisites), but the code path is unambiguously wired and reachable; the signature-skill picker at character creation is an *additional* starter mechanic on top of this, not a replacement for it.

Economy/shops: found and fixed 2 real bugs; bank/pawnshop mechanism is present in code but unplaced (unreachable) in this snapshot

Architecture: two parallel vendor mixins exist — feature/dealer.lpc (older, array-of-file-paths vendor_goods, buy/sell/value/list) and feature/vendor.lpc (F_VENDOR, array-of-(["name":file,"number":count]) mappings vendor_goods, buy/list only — no player-facing sell, matching this session's now-familiar "buy-only shop, separate buyback/pawnshop NPC" design pattern, not a bug). A survey of every F_DEALER/F_VENDOR NPC file found most of the 16 F_DEALER NPCs and several F_VENDOR NPCs are never referenced by any room's "objects" mapping anywhere in the archive — orphaned content, unreachable in actual gameplay, not something to "fix" by inventing a placement (that would be authoring new world content, out of scope). Two F_VENDOR NPCs *are* genuinely room-placed and reachable: d/hmy/pingding/npc/xiaoer2.lpc (跑堂, in d/hmy/pingding/xiaochidian.lpc, food/drink) and d/hmy/pingding/npc/huoji.lpc (药铺伙计, in d/hmy/pingding/yaopu.lpc, medicine).

Bug #1 (real, fixed): vendor_goods declared as the wrong data shape. feature/vendor.lpc's do_list()/do_buy()/is_vendor_good() all do if (arrayp(goods = query("vendor_goods"))) and then index goods[i]["name"]/goods[i]["number"] — expecting an ARRAY of one-entry MAPPINGS. d/hmy/pingding/npc/xiaoer2.lpc and d/hmy/pingding/npc/huoji.lpc instead set vendor_goods as a single MAPPING keyed by item path ((["/d/city/obj/jitui": 11, ...])), the shape feature/dealer.lpc uses, not feature/vendor.lpc's — an apparent copy-paste from the older mixin's convention. arrayp() on a mapping is false, so do_list/do_buy/ is_vendor_good all silently fall through with zero output, not even a fail message — a completely dead list/buy on two live, reachable, correctly-add_action-wired NPCs. (4 more F_VENDOR files elsewhere have the same wrong shape — d/sld/npc/chuzi.lpc, d/dali/npc/mafu.lpc, d/taishan/npc/shangren.lpc — but their list/buy add_action() calls are themselves commented out, so the shape bug is inert there; and d/taishan/npc/xiao-fan.lpc, which does have buy wired, is itself never room-placed — left untouched, no live impact.) Fixed: converted both xiaoer2.lpc and huoji.lpc to the correct ({ (["name":file,"number":count]), ... }) array-of-mappings shape.

Bug #2 (real, fixed, found only after fixing #1): huoji.lpc referenced 3 nonexistent/wrong-path item files. Once the shape was fixed, do_list/ do_buy proceeded far enough to actually resolve each vendor_goods entry via call_other()-on-string-path — and 4 of huoji.lpc's 6 entries pointed at files that don't exist: __DIR__ "obj/jinchuang" and __DIR__ "obj/yangjing" (real items exist, just at /clone/medicine/jinchuang.lpc and /clone/medicine/yangjing.lpc, not under this NPC's own directory), /clone/medicine/baiwei and /clone/medicine/baizhi (real items exist at /clone/medicine/drug/baiwei.lpc / drug/baizhi.lpc, wrong subpath), and /clone/medicine/badou (searched the whole archive incl. raw source — this item never existed anywhere, not just misplaced; dropped the entry rather than inventing a substitute). Each bad entry produced a real, live debug.log "*call_other() couldn't find object ..." runtime error on every list/buy at this NPC — a driver-level error, squarely in scope to fix. Fixed: repointed jinchuang/yangjing to their real /clone/medicine/ paths, repointed baiwei/baizhi to their real drug/ subpath, dropped the phantom badou entry.

Live verification (both fixes, fresh driver boot, naturally room-spawned NPCs — not wizard-cloned instances, which lack the startroom property the room's own make_inventory() sets on spawn): registered jyshopvi (秦风捌), admin summoned it to each shop, cloned + give-gifted gold. At 跑堂: list showed all 5 wares with real prices/stock; buy jitui completed a real purchase (money deducted, item received, "讨价还价" trade-skill XP awarded, inventory confirmed). At 药铺伙计: list showed all 5 (now-corrected) wares; buy jin (金创药) and buy dan (养精丹) both completed real purchases, confirmed via inventory + remaining coin/silver count. debug.log after the full session: zero runtime errors (only the routine boot-time compile warnings already documented above).

Bank/pawnshop (two-tier currency): feature/banker.lpc (shared mixin: check/convert/deposit/withdraw, a balance property separate from physical gold/silver/coin objects — the same two-tier-currency pattern already confirmed on several other libs this session) is well-formed code, hosted by d/city/npc/old-qian.lpc (银号/钱庄, deposit/cun, withdraw/qu) plus several sibling banker NPCs across other zones. None of them are referenced by any room's "objects" mapping anywhere in the archive — like most of the F_DEALER shops, the entire banking mechanic is orphaned/unplaced content in this snapshot, unreachable in actual gameplay even though the code itself looks sound. Not fixed (placing NPCs in the world is a content/design decision, not a bug fix); documented here as a genuine "untested because unreachable" finding rather than assumed fine.

Standing checklist sanity pass (this lib was NOT covered by either corpus sweep before this pass)

Cleanup

All player test-account saves created this round (jysidie, jyshopr, jyshoptw, jyshopvi) removed from work/data/{user,login}/j/ after verification. The fluffos admin account's own save files changed slightly (routine inventory/login-timestamp churn from using clone/ give/summon during testing) — left as-is, matching this project's standing practice of not hand-editing the persistent admin account's save data between sessions. Driver killed by exact PID after testing (never pkill -f).

WASM 修复摘要(迁移自 meta.json 的 group_note)

此前被错误标记为某个不存在于本项目任何档案的原始压缩包文件名的 duplicate_of;这里的内容其实是完全独立、可游玩的游戏(有自己的 -N 变体编号、自己的端口、自己的 README)——duplicate_of 已清除。

§7.30 uninitialized-mapping accessor sweep (2026-08-20)

Corpus-wide mechanical sweep of the feature/skill.lpc shared-lineage bug (confirmed independently on xiakexing2017/jqxz2015/haiyang2 via round-four testing): 4 accessor(s) in this file returned a raw never-initialized mapping instance variable (defaults to int 0, not ([]), until first assigned), crashing any unguarded keys()/sizeof()/indexing caller for a fresh/untrained character. Fixed at the accessor level (mapp(x) ? x : ([])) per the documented remedy. Verified via lpcc --batch static compile check only (not a live boot) as part of a large mechanical sweep; not individually functionally re-tested live on this lib.

AGENTS.md §7.19 fix: enable_player() reentrancy from init()

feature/command.lpc's enable_player() (wrapper around enable_commands()) was reachable from an NPC's init(): the shared inherit/char/char.lpc setup() (called from every character's create()) itself calls enable_player(), and d/gb/npc/xixia-wushi.lpc redundantly calls setup() again from inside its own init() (on top of the setup() its create() already made) -- same shape as the originally-documented mhxy zhangmen.lpc case. enable_commands() is only safe to call from create(): calling it again on an object already living() makes the driver re-invoke that same object's init() as a side effect, which recurses back into enable_player() on the same call stack until "Too deep recursion" aborts the boot on a room's first-ever visit. Fixed with a true reentrancy flag (in_enable_player_now), NOT a living() guard (which would break legitimate re-enables from revive() in feature/damage.lpc and wakeup()/wakeup2() in cmds/std/sleep.lpc, both confirmed to re-invoke enable_player() on this lib while the object is still living()). Verified via lpcc --batch single-file compile check (PASS). Part of the corpus-wide §7.19 sweep (Batch E).