# 群友市场

**Repository Path**: Tloml-Starry/Slave-Market

## Basic Information

- **Project Name**: 群友市场
- **Description**: 群友市场，购买群友来给你打工小游戏
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 15
- **Forks**: 11
- **Created**: 2024-08-22
- **Last Updated**: 2026-01-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 文游

## README

# 奴隶市场
<div align="center">
  <img src="./resources/psc.png" alt="奴隶市场" width="200" height="200">
</div>

![动态访问量](https://count.kjchmc.cn/get/@Slave-Market?theme=rule34)

一个为 [Yunzai-Bot V3](https://gitee.com/Le-niao/Yunzai-Bot) 开发的群聊文字游戏插件。在这个奇妙的市场中，玩家可以体验当主人和奴隶的乐趣，通过各种方式赚取金币，提升身价！

## 🌟 游戏特色

### 💰 经济系统
- 完善的金币系统
- 银行存取功能
- 信用等级提升
- 动态的市场经济

### 👥 社交玩法
- 购买其他玩家作为奴隶
- 训练提升奴隶价值
- 放生奴隶获得好感
- 丰富的互动体验

### ⚔️ 竞技系统
- 奴隶决斗对战
- 排位赛晋级
- 段位等级提升
- 丰厚的竞技奖励

### 📊 排行系统
- 奴隶身价排行
- 玩家资金排行
- 实时数据更新
- 竞争氛围浓厚

### 🔄 每周重置系统
- 自动每周重置存档
- 排行榜历史记录
- 数据自动备份
- 公平竞争环境

## 🔧 安装方法

1. 在Yunzai根目录执行，克隆本仓库到 Yunzai-Bot 的 plugins 目录
```bash
git clone https://gitee.com/Tloml-Starry/Slave-Market.git ./plugins/Slave-Market/
```

2. 重启 Yunzai-Bot

## 🔄 更新方法

两种方式：
1. 使用 Yunzai-Bot 自带命令：`#全部更新`
2. 使用指令: `#奴隶更新`
3. 运行插件目录下的 `UPDATE.bat`

## 📝 使用说明

发送 `#奴隶帮助` 或 `#nl帮助` 查看详细指令。

### 🎮 游戏玩法

**基础经济循环**：
1. 通过 `#打工` 赚取初始金币
2. 使用 `#购买奴隶` 购买其他玩家
3. 通过 `#训练` 提升奴隶价值
4. 参与 `#决斗` 和 `#排位赛` 获得奖励
5. 使用 `#银行` 管理资金和利息

**每周重置机制**：
- 每周一 00:00 自动重置所有玩家数据
- 重置前自动保存排行榜历史记录
- 重置后显示上周排行榜回顾
- 保持游戏新鲜感和公平竞争

**排行榜系统**：
- 实时更新金币、身价、奴隶数量、银行等级排行
- 支持查看上周历史排行榜
- 重置时自动展示上周成绩
- 激励玩家持续参与游戏

基础指令：
- `#奴隶市场` - 查看市场信息
- `#购买奴隶` - 购买其他玩家
- `#打工` - 赚取金币
- `#我的奴隶` - 查看奴隶信息

进阶玩法：
- `#训练` - 提升奴隶价值
- `#决斗` - 奴隶对战
- `#排位赛` - 参与竞技
- `#银行` - 资金管理

每周重置功能：
- `#奴隶重置状态` - 查看重置系统状态
- `#上周排行榜` - 查看上周各项排行榜
- `#手动奴隶重置` - 手动执行重置（管理员）
- `#奴隶重置帮助` - 查看重置功能帮助

## ⚙️ 配置说明

### 每周重置配置
在 `config/SlaveMarket_config.yaml` 中可以配置重置功能：

```yaml
weeklyReset:
  enabled: true              # 启用/禁用每周重置
  resetTime:
    day: 1                   # 重置日期（1=周一）
    hour: 0                  # 重置小时（24小时制）
    minute: 0               # 重置分钟
  preserveData:
    nickname: true          # 是否保留昵称
    basicValue: 100         # 重置后的基础身价
```

### 重置内容
- ✅ 金币归零
- ✅ 清空奴隶列表和主人关系
- ✅ 身价重置为初始值
- ✅ 清除所有冷却时间
- ✅ 重置银行等级和余额
- ✅ 重置竞技排位等级
- ✅ 保留昵称（可配置）

## 🤝 参与贡献

1. Fork 本仓库
2. 提交代码
3. 发起 [Pull Request](https://gitee.com/Tloml-Starry/Slave-Market/pulls)

## 📞 联系方式

- [作者主页](https://gitee.com/Tloml-Starry)
- [QQ直达](https://qm.qq.com/q/h9UHpRmomc)
- [班级群](http://qm.qq.com/cgi-bin/qm/qr?_wv=1027&k=irT-arKOLusNtih-HccwMbHrtBuma4IZ&authKey=YZeABWIX%2BkSIMYM3T1Fuc0Bm%2BZJAMyD9rUivnLO42dbZrXGqdZBlATbVx0r7zO9o&noverify=0&group_code=1030599760)

## 🎮 其他游戏

- [曲奇点点乐(Cookie-plugin)](https://gitee.com/Tloml-Starry/Cookie-plugin)
- [面包商店(Bread-Shop)](https://gitee.com/Tloml-Starry/Bread-Shop)
- [种田模拟器(Farming-Simulator)](https://gitee.com/Tloml-Starry/Farming-Simulator)
- [按钮(Button)](https://gitee.com/Tloml-Starry/Button)

## ⭐ 支持项目

如果你觉得这个项目不错，请点个 Star 支持一下吧！

## 🔄 更新日志

### v2.0.0 - 每周重置系统
- ✨ 新增每周自动重置功能
- 🏆 新增排行榜历史记录系统
- 📊 支持查看上周各项排行榜
- 🔧 新增重置系统配置选项
- 🛡️ 自动数据备份机制
- 🎮 优化游戏平衡性和公平性

### 历史版本
- v1.x.x - 基础奴隶市场功能

## 📢 问题反馈

遇到问题？
- 联系[作者](https://gitee.com/Tloml-Starry)
- 提交 [Issues](https://gitee.com/Tloml-Starry/Slave-Market/issues)