koishi-plugin-restaurant

一个功能完整的 Koishi 餐厅经营插件，让用户体验从小餐馆到米其林餐厅的经营之路！

功能特色

🏪 餐厅管理系统

• 餐厅创建与升级：从小餐馆开始，逐步升级到知名餐厅
• 营业管理：开店、关店、改名等基础操作
• 财务管理：详细的收支统计和利润分析
• 等级系统：通过经验提升餐厅等级，解锁更多功能

🥬 食材管理系统

• 食材市场：丰富的食材种类，按分类展示
• 采购系统：支持单个和批量采购食材
• 仓库管理：食材存储、保鲜期管理
• 过期处理：自动清理过期食材，避免浪费

👨‍🍳 菜谱制作系统

• 菜谱大全：按分类展示所有可制作菜品
• 制作系统：根据食材制作各种美味菜品
• 难度系统：不同菜品有不同制作难度和经验奖励
• 推荐系统：根据现有食材智能推荐可制作菜品

👥 员工管理系统

• 招聘系统：多种职位可选，各有特色技能
• 培训系统：提升员工等级和工作效率
• 工资管理：自动计算和支付员工工资
• 员工详情：查看员工详细信息和成长记录

🍽️ 顾客服务系统

• 顾客接待：不同类型顾客，各有偏好和消费能力
• 订单处理：完整的点餐、制作、上菜流程
• 满意度系统：基于服务质量的顾客满意度评价
• 反馈统计：详细的顾客反馈和营业数据分析

🏆 成就系统

• 多类别成就：经营、财富、等级、声誉、服务、管理六大类
• 进度追踪：实时显示成就完成进度
• 奖励机制：完成成就获得金币奖励
• 自动检测：操作后自动检查并解锁新成就

⏰ 自动化系统

• 定时任务：自动处理租金、工资、食材过期等
• 随机事件：增加游戏趣味性的随机事件
• 数据维护：自动清理过期数据，保持数据库整洁

安装配置

依赖要求

• Koishi v4.15.0+
• 数据库插件（推荐 MySQL）

安装方式

npm install koishi-plugin-restaurant

基础配置

plugins:
  restaurant:
    initialMoney: 10000        # 初始资金
    dailyRent: 500            # 每日租金
    maxIngredientStorage: 100  # 食材仓库容量

配置说明

基础设置

• initialMoney: 新餐厅的初始资金（默认：10000金币）
• dailyRent: 每日需要支付的租金（默认：500金币）
• maxIngredientStorage: 食材仓库最大容量（默认：100单位）

食材配置

可以完全自定义食材种类、价格、保鲜期等：

ingredients:
  - id: rice
    name: 大米
    price: 5
    freshnessDays: 30
    category: 主食
    description: 优质东北大米

菜谱配置

可以自定义菜品、所需食材、制作难度等：

recipes:
  - id: fried_rice
    name: 蛋炒饭
    ingredients:
      - id: rice
        amount: 2
    cookTime: 10
    difficulty: 2
    price: 15
    category: 主食
    description: 经典蛋炒饭
    requiredLevel: 1

员工配置

可以自定义员工职位、工资、技能等：

staffTypes:
  - id: waiter
    name: 服务员
    salary: 3000
    efficiency: 1.0
    maxLevel: 10
    skills: [接待, 点餐, 上菜]
    description: 负责接待顾客和服务

顾客配置

可以自定义顾客类型、消费习惯等：

customerTypes:
  - id: student
    name: 学生
    patience: 15
    tipRate: 0.05
    preferredCategories: [主食, 面食]
    spendingPower: 0.8
    description: 预算有限的学生顾客

餐厅等级配置

可以自定义升级条件和解锁内容：

restaurantLevels:
  - level: 1
    name: 小餐馆
    requiredExp: 0
    maxTables: 5
    maxStaff: 3
    unlockFeatures: [基础经营]
    description: 刚起步的小餐馆

成就配置

可以自定义成就条件和奖励：

achievements:
  - id: first_day
    name: 初来乍到
    description: 成功开业第一天
    condition: open_first_day
    reward: 1000
    icon: 🎉

使用指南

快速开始

1. 创建餐厅：开餐厅 - 开始你的经营之路
2. 查看状态：餐厅状态 - 了解当前经营情况
3. 采购食材：食材市场 → 购买食材 大米 10
4. 招聘员工：招聘市场 → 招聘员工 服务员
5. 开始营业：开店 - 正式开始接待顾客
6. 接待顾客：接待顾客 - 迎接第一位顾客

核心指令

基础管理

• 开餐厅 - 创建餐厅
• 餐厅状态 - 查看餐厅信息
• 餐厅帮助 - 查看完整指令列表
• 开店 / 关店 - 营业管理
• 改名 [新名字] - 修改餐厅名称
• 升级餐厅 - 提升餐厅等级

食材管理

• 食材市场 - 查看可购买食材
• 购买食材 [食材名] [数量] - 采购食材
• 批量购买 [食材:数量,...] - 批量采购
• 食材仓库 - 查看库存
• 清理过期 - 清理过期食材
• 食材详情 [食材名] - 查看食材信息

菜谱制作

• 菜谱大全 - 查看所有菜谱
• 制作菜品 [菜品名] [数量] - 制作菜品
• 菜品库存 - 查看制作的菜品
• 菜谱详情 [菜谱名] - 查看菜谱信息
• 推荐菜品 - 智能推荐可制作菜品

员工管理

• 招聘市场 - 查看可招聘员工
• 招聘员工 [职位] - 招聘新员工
• 员工列表 - 查看所有员工
• 培训员工 [员工名] - 提升员工技能
• 解雇员工 [员工名] - 解雇员工
• 员工详情 [员工名] - 查看员工信息
• 工资结算 - 支付员工工资

顾客服务

• 接待顾客 - 接待新顾客
• 订单列表 - 查看当前订单
• 完成订单 [订单号] - 完成订单
• 顾客反馈 - 查看满意度统计
• 营业分析 - 详细营业数据

财务管理

• 财务报表 - 查看收支详情

成就系统

• 成就列表 - 查看所有成就
• 领取成就 [成就名] - 领取奖励
• 成就详情 [成就名] - 查看成就信息
• 成就统计 - 查看成就统计

游戏机制

经济系统

• 收入来源：完成订单、顾客小费、成就奖励
• 支出项目：食材采购、员工工资、每日租金、培训费用
• 利润计算：总收入 - 总支出 = 净利润

经验系统

• 获得方式：制作菜品、完成订单、培训员工、升级餐厅
• 作用：用于餐厅升级，解锁新功能和更高等级菜谱

声誉系统

• 影响因素：顾客满意度、服务质量、订单完成情况
• 作用：影响顾客类型和消费能力，高声誉吸引更多优质顾客

满意度系统

• 影响因素：等待时间、员工效率、菜品质量
• 计算方式：基础满意度 + 服务加分 - 等待扣分
• 影响结果：决定小费数量和顾客评价

时间系统

• 保鲜机制：食材有保鲜期，过期自动清理
• 工作时间：员工工作时间影响经验获得
• 等待时间：订单等待时间影响顾客满意度

高级玩法

经营策略

1. 成本控制：合理采购食材，避免过期浪费
2. 员工配置：平衡各职位员工数量，提升整体效率
3. 菜品选择：制作高利润菜品，提升盈利能力
4. 升级时机：积累足够经验和资金后及时升级

效率优化

1. 批量操作：使用批量购买减少操作次数
2. 智能推荐：利用推荐菜品功能优化食材利用
3. 员工培训：定期培训员工提升工作效率
4. 数据分析：通过营业分析优化经营策略

成就攻略

1. 经营类：保持长期稳定经营
2. 财富类：注重利润积累和成本控制
3. 服务类：提升服务质量和顾客满意度
4. 管理类：合理配置员工和资源

常见问题

Q: 资金不足怎么办？

A: 可以通过以下方式增加收入：

• 制作高利润菜品
• 提升员工效率减少制作时间
• 完成成就获得奖励
• 优化食材采购减少浪费

Q: 顾客满意度低怎么提升？

A: 影响满意度的因素：

• 减少订单等待时间
• 培训员工提升效率
• 确保食材新鲜度
• 合理安排餐桌和员工数量

Q: 如何快速升级餐厅？

A: 获得经验的方式：

• 制作复杂菜品获得更多经验
• 完成更多订单
• 培训员工
• 完成成就任务

Q: 员工管理有什么技巧？

A: 员工管理建议：

• 平衡各职位员工数量
• 定期培训提升效率
• 根据餐厅规模调整员工数量
• 关注员工工资成本

更新日志

v1.0.0

• 初始版本发布
• 完整的餐厅经营系统
• 六大核心功能模块
• 丰富的配置选项
• 详细的帮助系统

技术支持

如果在使用过程中遇到问题，请：

1. 查看本文档的常见问题部分
2. 检查配置文件是否正确
3. 确认数据库连接正常
4. 查看 Koishi 控制台的错误日志

许可证

MIT License

贡献

欢迎提交 Issue 和 Pull Request 来改进这个插件！

享受你的餐厅经营之旅！ 🍽️✨