AstrBot 插件：文字修仙
版本: 2.1.0
一款为 AstrBot 设计的、功能丰富的放置类修仙游戏插件。让你在聊天群中体验从凡人到大能的修行之路，工作摸鱼、畅聊吹水的同时亦可得道飞升！
非常感谢 @Zhalslar 提供的模块化思路，十分清晰的重构了整个插件的结构。
v2.1.0 更新
- 新增装备系统: 玩家现在可以通过“使用”法器来穿戴装备，获得属性加成。新增“我的装备”和“卸下”指令来管理装备。
- 商店每日刷新: 坊市不再一成不变，现在会每日随机上架一部分商品，增加了寻宝的乐趣。
- 秘境难度调整: 降低了秘境最终Boss的强度，使其更符合当前境界的挑战难度，提升了游戏体验。
- Bug修复: 修复了玩家在“闭关”等状态下仍可执行大部分指令的Bug，现在状态限制更加合理。
插件特色
- 完整的成长体验: 从创建角色、闭关修炼，到突破境界，体验完整的修仙成长路线。
- 动态生成的无尽挑战: 基于强大的标签系统，怪物和秘境可以被动态生成，每一次的战斗和探索都独一-无二。
- 深度的经济与物品系统: 拥有超过40种物品。通过坊市购买丹药、材料，管理个人背包，让每一块灵石都有其价值。
- 丰富的社交互动: 创建或加入宗门，与其他道友共谋发展，不再是孤独的散修。
- 高度自由配置: 插件的核心指令、数值、游戏规则、物品、怪物、Boss乃至其特性标签，均可通过
.json文件进行修改，方便服主打造专属服务器生态。 - 规范化数据管理: 玩家数据使用 aiosqlite 独立存储，并包含专业的数据库迁移系统，保证了数据的安全、隔离与长期演进能力。
快速开始
(确保你的 AstrBot 实例已正确加载此插件)
开启你的修仙之路: 在任意聊天窗口（QQ群或私聊），发送：
我要修仙获取帮助:
发送修仙帮助查看所有可用的游戏指令。
游戏指令
| 功能 | 指令 (示例) | 说明 |
|---|---|---|
| 开启仙途 | 我要修仙 |
创建你的专属修仙角色，每个ID仅可创建一次。 |
| 查看信息 | 我的信息 |
查看你当前的境界、灵根、修为、灵石和宗门等详细信息。 |
| 每日签到 | 签到 |
每日可进行一次签到，以获取随机的灵石奖励。 |
| 闭关修炼 | 闭关 |
进入修炼状态，持续获得修为。 |
| 结束修炼 | 出关 |
结束闭关状态，并结算本次修炼获得的修为。 |
| 重入仙途 | 重入仙途 |
花费灵石重新获得灵根。 |
| 境界突破 | 突破 |
当修为足够时，尝试突破到下一境界，有失败风险。 |
| 查看坊市 | 商店 |
查看坊市当天随机上架的商品。 |
| 查看背包 | 我的背包 |
查看你拥有的所有物品和数量。 |
| 购买物品 | 购买 引气丹 10 |
从坊市购买指定名称和数量的物品。 |
| 使用/装备 | 使用 引气丹 / 使用 青锋剑 |
使用背包中的丹药等消耗品，或穿戴法器。 |
| 查看装备 | 我的装备 |
查看当前已穿戴的所有装备及其属性。 |
| 卸下装备 | 卸下 武器 |
卸下指定部位的装备（武器/防具/饰品）。 |
| 宗门 | 创建宗门/加入宗门/我的宗门/退出宗门 |
进行宗门相关的创建、加入、查询和退出操作。 |
| PVE | 查看世界boss/讨伐boss <ID> |
查看并挑战强大的世界Boss。 |
| PVP | 切磋 @某人 |
与服务器内的其他道友进行友好的切磋比试。 |
| 秘境 | 探索秘境/前进/离开秘境 |
探索根据自身修为动态生成的随机秘境副本。 |
| 获取帮助 | 修仙帮助 |
显示本指令列表。 |
配置文件说明
本插件所有配置均在插件目录下的 .json 文件中，无需改动代码。
_conf_schema.json: 插件主配置文件。包含访问控制、数值配置、文件路径等核心设置。ACCESS_CONTROL.WHITELIST_GROUPS: 群聊白名单配置，留空表示所有群聊都可用。VALUES.SHOP_DAILY_ITEM_COUNT: 每日坊市随机上架的商品种类数量。REALM_RULES.REALM_BOSS_SCALING_FACTOR: 秘境最终Boss的强度缩放系数（例如0.7代表70%强度）。
tags.json: 怪物标签系统。定义了所有怪物特性的基础模板，如属性、掉落物、名称前后缀等，是动态内容生成的核心。level_config.json: 境界配置文件。定义了所有境界的名称、升级所需修为和突破成功率。items.json: 物品配置文件。定义了所有物品的名称、描述、价格和使用效果。法器类物品需配置subtype和equip_effects字段。monsters.json/bosses.json: 怪物与Boss配置文件。仅需定义基础模板和需要附加的标签，具体数值由生成器动态创建。
白名单配置示例
如果您希望插件只在特定群聊中生效，可以在AstrBot的插件配置界面中配置白名单：
- 进入插件配置页面
- 找到"访问控制"配置项
- 在"白名单群号列表"中添加允许使用的QQ群号
- 留空则表示所有群聊都可用
后续更新
本插件未来计划加入更多有趣的系统，例如：
- 炼器系统: 引入装备合成与强化系统。
- 宗门扩展: 增加宗门任务、宗门仓库、宗门贡献度等玩法。
- 管理员工具: 提供更便捷的方式修改游戏数据。
- 钱庄系统：修仙界的银行。
- 娱乐玩法：内置简单的小游戏消费灵石。
贡献
欢迎通过提 Issue 或 Pull Request 的方式贡献代码、报告 Bug 或提出宝贵的建议。
许可证
本插件采用 AGPL-3.0 许可证。