# Stock

**Repository Path**: chenlirui233/Stock

## Basic Information

- **Project Name**: Stock
- **Description**: 一我的世界1.12.2股票魔力服务器插件
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-06-22
- **Last Updated**: 2025-06-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

 # Stock - Minecraft 股票插件

<img src="https://img.shields.io/badge/Minecraft-1.12.2-green" alt="Minecraft 1.12.2">
<img src="https://img.shields.io/badge/License-MIT-blue" alt="MIT License">

一个模拟真实股票市场的 Minecraft 服务器插件，让玩家可以交易股票、管理持仓并体验虚拟金融系统。

## 📦 功能特性
- **实时股票市场**：从 QQ 财经获取真实股票数据
- **股票交易系统**：
  - 买入/卖出股票操作
  - 持仓管理与市值计算
  - 价格波动模拟（±4% 随机波动）
- **用户界面**：
  - 图形化股票列表 (GUI)
  - 分页浏览与股票详情
  - 持仓盈亏统计
- **经济集成**：无缝对接 Vault 经济系统
- **多语言支持**：内置中文/英文语言文件
- **数据存储**：支持 SQLite 和 MySQL 数据库

## ⚙️ 安装要求
1. **必需依赖**：
   - [Vault](https://www.spigotmc.org/resources/vault.34315/)
   - 经济插件 (如 EssentialsX)
2. **Java 版本**：JDK 8
3. **Minecraft 版本**：1.12

## 📥 安装步骤
1. 将 `Stock.jar` 放入服务器 `plugins/` 目录
2. 重启服务器
3. 首次运行时自动生成配置文件:

```
# 支持 zh_CN, en_US 等
language: zh_CN

database:
  # sqlite 或 mysql
  type: sqlite

  # SQLite 配置
  sqlite:
    filename: stock_data.db

  # MySQL 配置
  mysql:
    host: localhost
    port: 3306
    database: minecraft
    username: root
    password: password
    parameters: "?useSSL=false&autoReconnect=true"

stocks:
  - "sh600519"
  - "sh605499"
  - "sh603325"
  - "sh688256"
  - "sz002371"
  - "sh688608"
  - "sz002594"
  - "sh688506"
  - "sh603444"
  - "sz300185"
  - "sz000839"
  - "sz002086"

# 更新频率(秒)
update-interval: 120

gui:
  # 打开GUI的物品
  open-item: PAPER
  # 每页显示股票数量
  items-per-page: 28
```

## 📜 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/stock view` | 查看所有股票 | `stock.command` |
| `/stock view <代码>` | 查看股票详情 | `stock.command` |
| `/stock buy <代码> <数量>` | 购买股票 | `stock.command` |
| `/stock sell <代码> <数量>` | 卖出股票 | `stock.command` |
| `/stock holdings` | 查看持仓 | `stock.command` |

## 🖱️ GUI 操作
1. **打开GUI**：手持纸(默认)右键
2. **功能区域**：
   - 股票列表：点击查看详情
   - 买入操作：点击股票选择数量
   - 翻页按钮：左右箭头导航

## 🌐 语言支持
- 编辑 `plugins/Stock/lang/zh_CN.yml` 自定义消息
- 支持变量替换：`%symbol%`, `%price%`, `%change%`

## 🖼️ 插件截图
![输入图片说明](dada.png)

## ⚠️ 注意事项
1. 首次使用需配置 Vault 和经济系统
2. 股票代码格式：`shXXXXXX` (上证) 或 `szXXXXXX` (深证)
3. 数据库自动备份（SQLite 每日备份）
4. 调试日志查看：`plugins/Stock/stock_data.log`

## 🛠️ 开发者信息
- **作者**：Yiran
- **版本**：1.0.0
- **依赖库**：SQLite JDBC, Vault API
- **开源协议**：GPLv3

> 提示：使用 `/stock` 查看游戏内帮助信息，所有玩家默认拥有 `stock.command` 权限