# astrbot_plugin_srwolrd

**Repository Path**: ts-yf/astrbot_plugin_srwolrd

## Basic Information

- **Project Name**: astrbot_plugin_srwolrd
- **Description**: 星铁World小游戏插件
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-30
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 星铁World - AstrBot插件

星铁World是一款基于AstrBot框架开发的模拟经营类游戏插件，让用户可以在聊天环境中创建和管理自己的展会，招募助理，收集收益，体验轻松有趣的模拟经营玩法。

## 功能特点

- **展会创建与管理**：创建个性化展会，管理多种类型的展台
- **助理系统**：通过邀约获取不同稀有度的助理，提升展会收益
- **经济系统**：完整的金币、钻石经济体系，支持多种货币单位
- **升级系统**：展台升级、助理升级、星级提升等多重成长路径
- **收藏系统**：收集回忆卡片和碎片，激活特殊效果
- **社交功能**：好友系统，排行榜等社交互动功能
- **事件系统**：随机事件，为游戏增添变数和乐趣

## 安装要求

- AstrBot框架环境
- Python 3.7+
- MySQL/MariaDB数据库
- 必要的Python依赖包：pymysql等

## 数据库配置

在使用前需要配置数据库连接信息：

1. 创建名为`wolrd`的数据库
2. 创建对应的数据库用户并授权
3. 修改`Database.py`中的数据库连接参数：

```python
# 数据库配置
DB_HOST = '127.0.0.1'
DB_PORT = 3306
DB_NAME = 'wolrd'
DB_USER = 'wolrd'
DB_PASS = '<YOUR_PASSWORD>'
```

## 安装步骤

1. 将插件文件夹放入AstrBot的插件目录中
2. 确保数据库配置正确
3. 重启AstrBot，插件将自动加载并初始化数据库表

## 游戏指令

### 基础指令
- `创建展会 [展会名]` - 创建一个新的展会
- `展会指令` - 查看所有可用指令
- `展会信息` - 查看自己的展会信息

### 展台管理
- `解锁 [展台名]` - 解锁新的展台
- `查看展台 [展台名]` - 查看指定展台的信息
- `一键收取` - 收取所有展台的收益

### 助理系统
- `普通邀约` - 使用普通邀约券招募助理
- `黄金邀约` - 使用黄金邀约券招募助理
- `炫彩邀约` - 使用炫彩邀约券招募助理
- `我的助理` - 查看拥有的所有助理
- `分配助理 [助理名] [展台名]` - 将助理分配到指定展台
- `升级助理 [助理名]` - 提升助理等级
- `一键升级助理` - 升级所有助理

### 其他功能
- `展会签到` - 领取每日奖励
- `世界排行` - 查看全服玩家排名
- `我的回忆卡` - 查看拥有的回忆卡
- `抽取回忆` - 抽取回忆卡片

## 文件结构

- `main.py` - 插件主要逻辑和功能实现
- `Database.py` - 数据库连接池和数据操作类
- `[星铁Wolrd]助理名单.json` - 助理数据配置文件
- `[星铁Wolrd]回忆卡.json` - 回忆卡数据配置文件
- `[星铁Wolrd]星海轶闻.json` - 游戏事件数据配置文件
- `banned_words.json` - 敏感词过滤配置文件
- `api_config.json` - API配置文件

## 数据存储

插件使用MySQL数据库存储玩家数据，主要表结构包括：
- `players` - 玩家基本信息
- `player_booths` - 玩家展台信息
- `player_assistants` - 玩家助理信息
- `player_fragments` - 助理碎片信息
- `player_memory_parts` - 回忆卡碎片信息
- `player_memory_cards` - 完整回忆卡信息
- `world_ranking` - 世界排行榜信息
- `player_friends` - 玩家好友关系

## 开发者信息

- 插件名称：星铁World
- 版本：1.0.0
- 作者：ZY霆生
- 基于AstrBot框架开发

## 支持与帮助

如需帮助，请访问[AstrBot官方文档](https://astrbot.app)  
加入插件交流群[687976465](https://qm.qq.com/q/PCWuy2zV6u)。

## 许可证

本插件遵循MIT许可证开源。