npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

koishi-plugin-otherworld-connection

v0.1.11

Published

异界连结:AI 叙事、角色成长、装备与副本冒险的聊天 RPG

Readme

koishi-plugin-otherworld-connection

《异界连结》Koishi插件。支持觉醒、32职业被动、四职业套装及能量、先手、攻速行动。当前版本采用规则 v15,新战斗和新装备使用 v15;历史战斗保持原快照。代码结算战果、探索成功率、掉落和资源,AI提供叙事、NPC技能选择及管理员内容草稿。

当前包版本为 0.1.11。秘药I/II/III使用一次立即将当前已有金币的20%扣除并转为等额经验,旧持续buff自动清除;四位数完整显示(9000、9000万);胸甲和裤子魔矿按颜色增加敏捷、体能、智力或力量,紫魔矿保留加体能;纠正异常防具基础护甲并保留词条、精炼与镶嵌。更新与迁移说明见 0.1.11 发布说明,规则见 规则v15。Linux 无可用共享浏览器时直接使用服务端 Canvas 绘图,插件附带中文字体;其他平台的浏览器启动失败也会自动切换服务端绘图。

0.1.8 重做武器魔矿与职业套装基础数值,调整70级古代币商店概率,新增记忆药水、秘药和永久限购房产。默认仅有一位正室,房产扩充纳妾名额;首次启动将旧妾降为恋人、保留正室,并更新已有职业套装。商店与掉落装备固定玩家主等级、最高70;全局数字使用中文单位,战报增加逐怪伤害结算。秘药行为以2026-10-18修正规则为准。

新增指令:古代币商店 记忆药水、魔盒 记忆药水、魔盒 秘药I/II/III、出售秘药 秘药I [数量]、房产商店、购买房产 房产名称。完整新规则见 规则 v15,更新与存档迁移见 0.1.8 发布说明。构建与86项相关测试通过;全量测试仍有既有失败,详见 验收记录。原有觉醒、被动、等级成长和佣兵模式保留。

完整玩法、公式、指令、结算与存档兼容说明见 当前游戏逻辑完整文档(含2026-10-13规则15补充),另有 HTML阅读版。

任务流程:任务 [NPC名称] → 执行任务 前往 “目的地” → 成功后 提交任务。执行免费、默认80%成功;失败结束本任务,可重新领取。默认奖励为1~10张冒险卷、400~20000金币和2000经验;奖励在领取时冻结,执行成功率使用执行时配置。

全参数热更新

管理员登录后打开 /otherworld-connection → 参数设置,可以编辑模型、图片、回复、提示词、知识查询及全部游戏规则数值。页面提供分类和搜索、中文说明(包含所有数组子项、上下限、阶位和曲线锚点)、单位、默认值、字段错误,以及未保存状态、放弃修改和恢复继承值。装备模板和技能定义继续在原入口编辑。

点击「保存并生效」后,下一次操作使用新配置,无需重启;进行中的操作使用开始时的不可变快照。覆盖保存到 Koishi 工作目录的 data/otherworld-connection/runtime-config.json,重启和更新插件后保留,优先级为页面覆盖、原插件配置、内置默认值。首次加载时,若新路径没有配置,会自动迁移仍存在的旧版插件目录 data/runtime-config.json,保留旧文件且不覆盖新路径已有配置;旧文件若已在升级时丢失,需要从备份恢复。恢复继承值先修改草稿,保存后才生效;并发修订冲突和保存失败不会部分切换。

除规则15一次性更新职业套装基础攻击/护甲与猎者护腿名称外,已有装备实例不重掷、已领取任务奖励不重抽;当天商品冻结模板、原价与生成规则,关系折扣另按当前规则计算;进行中的副本保留完整游戏配置快照。降低等级、队伍、仓库、技能、魔盒或魔矿容量不会删除现有记录,只限制继续扩张;装备曲线基准等级与等级上限独立。旧规则版本仍使用原结算算法。文档中的玩法数字表示内置默认值,实际规则由当前参数和服务端说明决定。

完整的 575 字段入口、默认值、调用点和兼容用途见 参数清单;操作与测试结果见 热更新验收。

启用与开始游戏

在 Koishi 插件市场搜索并安装 otherworld-connection(npm 包名 koishi-plugin-otherworld-connection),然后启用插件。

  1. 启用 Koishi 的 database 和 http 服务。可沿用工作区现有 SQLite;插件通过 Koishi 模型自动建立 ow_ 前缀表,不单独创建数据库连接。
  2. 在插件配置的「模型连接」填写 OpenAI 兼容的 Base URL、API Key,获取并选择文本模型。接口须支持 GET /models 和 POST /chat/completions;无需鉴权的本地服务可不填 API Key。 若要生成图片,在「图片生成连接」另填图片服务的 Base URL、API Key,点击「获取模型」并选择支持图片生成的模型。可选填该服务支持的图片尺寸;接口须支持 POST /images/generations 并返回 data[0].url 或 data[0].b64_json。 管理员可在「图片风格与游戏配图」的风格下拉框选择「写实」「动漫二次元」「复古风」「科幻」,默认使用动漫二次元。选择「完全自定义」后填写自己的风格提示词;留空则不附加风格要求。保存插件配置后,画图/绘图、新装备及 NPC 配图、手动重绘共用所选风格。已有图片保留,可在管理页重新生成。 战斗插画已移除:战后及查看战报时不会生成战斗图片,旧战斗配图任务也不会继续请求图片接口。战报保留叙事、结算结果和掉落装备的模板配图。
  3. 「世界观与游戏规则提示词」可编辑默认的阿杜瓦纳设定,游戏生成与普通 AI 对话共用;「补充系统提示词」可另加要求。在「参数设置」中调整签到奖励、经验曲线、价格、掉率及探索任务奖励范围。副本入场与钥匙获取均无每日上限;旧配置中的 dailyEntries、dailyKeys 会被忽略。角色与装备相关 AI 功能使用同一文本模型。
  4. 聊天发送 创建 小舟 男,AI 补全年龄与介绍;也可完整填写:创建 小舟 男 -c 战士 -a 20 -i 来自库拉斯的旅行者。职业可省略,之后发送 职业 免费首次选择。姓名有空格时加引号。头像沿用聊天头像,缺失时显示插件默认图。
  5. 插件自动补齐商人、铁匠、附魔师、牧师及固定礼品商人五种服务 NPC,各一位。发送 签到,再发送 副本 普通。启动时入库711件白装(含锤、匕首和单手法杖)及4554件派生装备原型,另初始化315件手腕/戒指/护符、3件财富戒指、9件神圣模板及72件职业套装模板;掉落由程序从装备库抽取,不足时保留待补发。五档单次常规副本胜利后,默认分别有5%概率尝试新增一位自由NPC和一个公共装备模板;新模板供后续掉落使用,不增加本场奖励。

新用户与 Bot 私聊或在群聊中明确呼叫 Bot 时,会登记/更新平台账号记录,未建角时提醒创建。游戏指令也会按需登记账号。账号以平台名和平台用户 ID 唯一识别,不合并跨平台身份。普通 AI 对话的用户输入和完整回答会保存到数据库;游戏副本、NPC 对话与交易另写入游戏记录,用于任务判断和结算核查。

私聊 Bot 或在群聊中明确 @ Bot 时,未匹配到指令的文本默认由当前模型回复。已匹配的指令不会触发普通 AI 对话;群内未呼叫 Bot 的普通消息也不会触发。

普通 AI 自动回复与 ai 问题 共用对话记忆,无需先创建角色。记忆按平台、机器人账号、用户和会话隔离,私聊与各群聊互不混用,重启后仍保留。最多保存最近 20 轮完整问答;超过 50,000 字符时优先移除旧轮次,至少保留最新一轮。仅保存成功生成的回答,请求失败和空回复不会写入。发送 ai.清空 可清空自己在当前会话的记忆。普通 AI 记忆不作为游戏奖励的判定证据。修复前未保存的普通聊天无法自动补回。

AI 知识查询

「AI 知识查询」默认开启。玩家可直接问“噩梦副本掉落概率是多少”“学院入学需要什么”“我的任务怎么做”“我的装备怎样搭配”,也可发送 ai 问题。模型先结合历史理解问题,返回受限查询计划;程序只读检索相关资料,再让模型回答。闲聊通常只请求模型一次,需要检索时通常两次;使用现有文本模型的 /chat/completions,无需工具调用、向量数据库或额外 API Key。本功能没有联网搜索能力。

内置资料包括当前世界观、程序规则、玩家指令;奖励、价格、掉率取当前插件配置。公共 NPC 和装备模板在查询时读取,仅显示存活且启用的 NPC、启用的装备模板。启用的管理员资料供所有玩家查询,遇到冲突以程序规则和本轮游戏数据为准。管理员资料按约 800 字、重叠 100 字分段,用中文分词和 BM25 检索,标题及标签增加权重,最多取 6 段;全部本轮资料上下文不超过 12,000 字符,截断会提示。

商店查询只读取已保存的当日货单,并区分启用模板与今日在售商品;尚未刷新时会提示发送「商店 商人名称」查看,AI 查询本身不会抽取或刷新货单。

「允许查询本人游戏资料」默认开启,按当前聊天平台和用户 ID 读取本人角色、含强化及词条的装备、上海时区当天未领奖任务与 NPC 关系。装备搭配复用现有规则计算建议;不自动穿戴,也不领取、提交任务、发奖、交易或改变关系。不能指定其他玩家查询。关闭本人查询后,公共资料仍可使用;关闭知识查询后恢复原有普通 AI 对话。

控制台「异界连结 → 知识库」需要已登录且 authority ≥ 4,可分页查看、新建、编辑、启停、删除资料及预览检索结果。Markdown / TXT 导入要求 UTF-8,文件不超过 1 MiB、正文不超过 100,000 字;导入只修改草稿,保存后入库。标签最多 20 个,每个不超过 40 字,标题不超过 120 字。停用或删除后下一次查询立即生效,重启后索引从 ow_knowledge_document 重建。查询失败或无匹配资料会在回答中说明;来源编号由程序校验并附上资料标题。对话记忆只保存问题和最终回答,不保存检索计划或原始资料快照。

当前指令

  • 成长:创建、角色、职业、转职、加点;技能、学习技能、技能升级、遗忘技能、主技能、副技能。
  • 冒险:签到、副本 普通、快速副本 普通 10、折磨 XVI、大秘境 1 连续5次;当前怪物与经验不随巅峰/战力增长,默认折磨I无经验魔矿9.6万~14.4万,大秘境经验基数为 30000×1.05^(层数−1),100层以上每层额外增加2%;新副本生命倍率为 2×1.05^(层数−1)。重伤请用 治疗,NPC用 治疗 NPC名称(兼容 NPC治疗)。复活与冒险卷出售已取消。
  • 佣兵:加入佣兵团、退出佣兵团、佣兵团 [页码]、雇用 玩家名字 普通/折磨16、结算;雇主消耗3古代币和2张冒险卷,胜利佣兵5币、失败1币,24小时内领取。同平台、70级开放,同一双方每天最多完成5场,仅普通副本和折磨可用。
  • 装备:仓库、装备 01、主手 穿戴 01、副手 穿戴 02、穿戴 01 [槽位]、附魔 主手 主要 1、精炼 铁匠 01、强化 头盔 钻石魔矿晶体、智能穿戴、一键修理、一键分解 全部、一键NPC配装。
  • 社交:npc、人物、关系、对话、邀请、队伍;告白 NPC、求婚 NPC、分手 NPC、离婚 NPC、纳妾 NPC。好感上限200,普通关系必须明确确认,翡翠之心和旧海洋之心直接结婚/免罚纳妾,NPC独占伴侣。
  • 礼物:礼品商店、购买礼物、礼物、送礼。玫瑰300、蛋糕500、门票1600、翡翠之心5000古代币,每人每种每天1件,上海零点刷新。翡翠之心直接结婚/免罚纳妾,旧连衣裙和海洋之心库存仍可赠送。
  • 古代币商店 [部位] [次数]:任意等级,单次1~50件,按角色等级生成最高70级;空间、余额或模板不足整批拒绝,写入异常全回滚。
  • 魔盒:魔盒 威能 首饰、魔盒 萃取 01、魔盒 装配 武器 01、魔盒 卸下 武器、魔盒 威能消除 武器 01、魔盒 恢复 武器 01、魔盒 财富秘境 01;70级开放,共用总计10个收藏威能(包含激活),武器、防具、首饰各一个激活槽。

自动新增概率可在游戏配置 game.autoNpcChance、game.autoEquipmentChance 中分别设置为0~1,默认均为0.05,0表示关闭。两类独立抽样,无保底,每场每类最多尝试一次;请求失败、内容无效、重名或请求中断都不重试,重启和恢复不重新抽样。快速、批量、折磨、大秘境、财富秘境和职业考试不参与,历史副本不会补抽新增机会。NPC重伤保留装备、队伍、成长和伴侣;固定服务职位不因重伤补位。玩家/NPC默认每点体能增加2生命,生命迁移按比例且幂等。旧副本使用独立历史计算器,已确定奖励不重抽。神圣三星套装已实现自然掉落、两件/三件效果与双戒联动;职业套装70级起跨职业掉落,只限对应职业穿戴。

管理与开发

控制台“异界连结”需要authority≥4。可维护装备模板、NPC、玩家、技能JSON及知识库,发放古代币/礼物,查看伴侣,标记重伤或恢复NPC。NPC聊天管理命令:管理.NPC重伤 NPC、管理.NPC恢复 NPC;模板编辑不重掷已有装备。

规则配置集中于src/game/next-rules.ts、config.ts、endgame.ts。资源与伴侣变化使用数据库事务、权限检查及审计日志。新增技能底层效果需扩展运算注册表,不执行任意脚本。

开发验证:node scripts/test.cjs、node scripts/build.cjs --typecheck、node scripts/build.cjs。隔离管理页使用 node --import tsx test/manual-console.ts,数据库为内存SQLite,不连接生产存档。测试产物仅写插件data目录。

文字与Canvas回复共用结构化文档;Canvas绘制或图片发送失败会退回文字,不重复执行交易或战斗。本次兼容与验收见版本8验收文档,历史验收见版本6验收文档。

规则10已加入双方直接减防(护甲减伤最多50%)、大秘境每层5%生命成长、巅峰每级1%独立最终增伤(最高100%)、七种常规护符威能及星核专属20%~60%荆棘转化。旧副本按版本恢复,旧普通护符保留,旧星核幂等补发专属威能。详见 规则10验收。

财富金币综合×10、100币保底及五色魔矿,太古70层通关解锁后单件0.025%,神圣两件主手×10/技能×3、三件暴击+2/破甲30%,双戒30%。详见 规则12。