78 lines
4.7 KiB
Markdown
78 lines
4.7 KiB
Markdown
# 背景
|
||
文件名: 2025-11-15_2_trap-system.md
|
||
创建于: 2025-11-15_16:41:02
|
||
创建者: ASUS
|
||
主分支: main
|
||
任务分支: (不需要创建)
|
||
Yolo模式: Off
|
||
|
||
# 任务描述
|
||
在菜园系统中加入陷阱功能，支持多种陷阱物品：
|
||
- 可以在某个地块放置陷阱（如防盗网等）
|
||
- 陷阱有不同等级，具有不同的触发概率、罚金金额、禁止偷盗时长和消息内容
|
||
- 偷盗者有概率触发陷阱，触发后立即缴纳罚金并被禁止偷盗一定时间
|
||
- 陷阱物品可以通过炼金合成获得，使用已有的矿物和木材作为材料
|
||
|
||
# 项目概览
|
||
菜园系统基于PWF插件体系，依赖现有WPSConfigSystem、WPSBackpackSystem、WPSStoreSystem、WPSFortuneSystem以及WPSAlchemyGame。
|
||
|
||
# 分析
|
||
- 数据库扩展：需要在 `garden_plots` 表中添加 `trap_item_id` 和 `trap_config` 字段来存储陷阱信息
|
||
- 新增 `garden_theft_ban` 表记录用户偷盗禁令（user_id, banned_until）
|
||
- 陷阱定义：需要设计多个等级的陷阱物品，包含触发概率、罚金、禁止时长、消息等属性
|
||
- 物品注册：在 `garden_plugin_base.py` 的 `wake_up` 中注册陷阱物品
|
||
- 炼金配方：注册陷阱的炼金合成配方，使用矿物和木材作为材料
|
||
- 服务层扩展：`GardenService` 需要添加 `place_trap`、`_check_trap`、`_is_theft_banned`、`_ban_theft` 等方法
|
||
- 修改偷盗逻辑：在 `steal` 方法中检查禁令和陷阱触发
|
||
- 插件层：创建 `garden_plugin_trap.py` 实现放置陷阱指令
|
||
|
||
# 提议的解决方案
|
||
- 设计3-4个等级的陷阱物品（普通、稀有、史诗、传说），每个等级有不同的效果
|
||
- 使用矿物（矿石、宝石、水晶、精华）和木材（银杏、樱花、红枫）合成不同等级的陷阱
|
||
- 陷阱触发后立即扣除罚金并设置禁止偷盗时间，同时发送陷阱消息给偷盗者
|
||
- 禁止偷盗期间用户无法偷取任何地块的作物
|
||
|
||
# 当前执行步骤："已完成实现"
|
||
|
||
# 任务进度
|
||
- 2025-11-15_16:43:34
|
||
- 已修改：
|
||
- Plugins/WPSGardenSystem/garden_models.py: 添加 GardenTrapDefinition 类和4种陷阱定义，扩展数据库模型
|
||
- Plugins/WPSGardenSystem/garden_service.py: 添加陷阱相关方法（place_trap, remove_trap, _check_trap, _is_theft_banned, _ban_theft），修改 steal 方法集成陷阱检查
|
||
- Plugins/WPSGardenSystem/garden_plugin_steal.py: 集成陷阱触发逻辑，扣除罚金并发送消息
|
||
- Plugins/WPSGardenSystem/garden_plugin_trap.py: 创建放置/移除陷阱的插件
|
||
- Plugins/WPSGardenSystem/garden_plugin_base.py: 在 wake_up 中注册陷阱物品和炼金配方
|
||
- 更改：
|
||
- 实现了完整的陷阱系统，包括4个等级的陷阱（防盗网、荆棘陷阱、魔法结界、传奇守护）
|
||
- 每个陷阱有不同的触发概率、罚金、禁止时长和消息内容
|
||
- 陷阱可以通过炼金合成获得，使用矿物和木材作为材料
|
||
- 偷盗时会检查禁令和陷阱，触发后立即扣除罚金并设置禁止偷盗时间
|
||
- 添加了 garden_theft_ban 表记录用户偷盗禁令
|
||
- 原因：实现用户需求的陷阱功能
|
||
- 阻碍因素：无
|
||
- 状态：未确认
|
||
|
||
- 2025-11-15_16:46:13
|
||
- 已修改：
|
||
- Plugins/WPSGardenSystem/garden_models.py: 为 GardenTrapDefinition 添加 durability 字段，设置各等级陷阱的耐久度（普通3次、稀有5次、史诗8次、传说15次）
|
||
- Plugins/WPSGardenSystem/garden_service.py: 在 _check_trap 中添加耐久度检查和减少逻辑，耐久度归零时自动移除陷阱；在 place_trap 中设置初始耐久度
|
||
- Plugins/WPSGardenSystem/garden_plugin_steal.py: 在消息中显示陷阱剩余耐久度，耐久度耗尽时提示
|
||
- Plugins/WPSGardenSystem/garden_plugin_trap.py: 在放置陷阱消息中显示耐久度
|
||
- Plugins/WPSGardenSystem/garden_plugin_base.py: 在菜园概览中显示陷阱信息及剩余耐久度
|
||
- 更改：实现了陷阱耐久度系统，每次触发后减少耐久度，耐久度归零时自动移除陷阱
|
||
- 原因：满足用户需求，让陷阱具有使用次数限制
|
||
- 阻碍因素：无
|
||
- 状态：未确认
|
||
|
||
- 2025-11-15_17:11:26
|
||
- 已修改：
|
||
- Plugins/WPSGardenSystem/garden_plugin_base.py: 修改 format_garden_overview 方法，添加 show_trap 参数控制是否显示陷阱信息
|
||
- Plugins/WPSGardenSystem/garden_plugin_view.py: 添加 _resolve_target_user 和 _handle_view 方法，修改 callback 支持 "查看"/"view" 子指令，更新 collect_command_entries 和 collect_guide_entries
|
||
- 更改：实现了查看其他玩家菜园的功能，支持通过用户名或用户ID查看，且不显示陷阱信息以保护隐私
|
||
- 原因：满足用户需求，允许查看任意玩家的菜园情况
|
||
- 阻碍因素：无
|
||
- 状态：未确认
|
||
|
||
# 最终审查
|
||
|