koishi-plugin-otherworld-connection
v0.1.11
Published
异界连结:AI 叙事、角色成长、装备与副本冒险的聊天 RPG
Maintainers
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),然后启用插件。
- 启用 Koishi 的
database和http服务。可沿用工作区现有 SQLite;插件通过 Koishi 模型自动建立ow_前缀表,不单独创建数据库连接。 - 在插件配置的「模型连接」填写 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 配图、手动重绘共用所选风格。已有图片保留,可在管理页重新生成。 战斗插画已移除:战后及查看战报时不会生成战斗图片,旧战斗配图任务也不会继续请求图片接口。战报保留叙事、结算结果和掉落装备的模板配图。 - 「世界观与游戏规则提示词」可编辑默认的阿杜瓦纳设定,游戏生成与普通 AI 对话共用;「补充系统提示词」可另加要求。在「参数设置」中调整签到奖励、经验曲线、价格、掉率及探索任务奖励范围。副本入场与钥匙获取均无每日上限;旧配置中的
dailyEntries、dailyKeys会被忽略。角色与装备相关 AI 功能使用同一文本模型。 - 聊天发送
创建 小舟 男,AI 补全年龄与介绍;也可完整填写:创建 小舟 男 -c 战士 -a 20 -i 来自库拉斯的旅行者。职业可省略,之后发送职业免费首次选择。姓名有空格时加引号。头像沿用聊天头像,缺失时显示插件默认图。 - 插件自动补齐商人、铁匠、附魔师、牧师及固定礼品商人五种服务 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。
