# BagSystem

**Repository Path**: GProReat_admin/bag-system

## Basic Information

- **Project Name**: BagSystem
- **Description**: 使用love2d，制作的背包系统，不仅能存储，还能操作背包。
- **Primary Language**: Lua
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-08
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 背包与仓库系统 (Bag System)

基于 **Love2D 11.5** 的背包+仓库物品管理系统演示，支持堆叠、翻页、拖拽转移、金币管理。

## 快速开始

### 环境要求
- Love2D 11.5+
- Windows (字体依赖 H:/lovegame/font/ 或系统字体)

### 启动
```bash
# 方式1: 双击 run.bat
# 方式2: 命令行
love H:/lovegame/bagsystem
```

## 操作说明

### 基本操作

| 操作 | 说明 |
|------|------|
| **左键点击** | 选中物品，底部显示详情 |
| **双击** | 快速转移：背包↔仓库 |
| **↑ / ↓ 键** | ↑ 背包→仓库，↓ 仓库→背包 |
| **ESC** | 退出游戏 |
| **F1** | 控制台输出调试信息 |

### 拖拽操作

| 操作 | 说明 |
|------|------|
| **按住 + 拖动** | 拖动物品跟随鼠标 |
| **拖到目标格释放** | 自动执行转移/堆叠/交换 |
| **拖到空白处** | 取消拖拽 |

### 拖拽行为规则

| 拖拽方向 | 目标状态 | 结果 |
|---------|---------|------|
| 背包 → 仓库 | 空 / 有同类 | 转移 / 堆叠 |
| 仓库 → 背包 | 空 / 有同类 | 转移 / 堆叠 |
| 背包 → 背包 | 空 | 移动 |
| 背包 → 背包 | 有物/同类 | 堆叠 |
| 背包 → 背包 | 有物/不同 | **交换** |
| 仓库 → 仓库 | 同上 | 同上 |

### 按钮功能

| 按钮 | 说明 |
|------|------|
| **↑ 存入** | 选中的背包物品 → 仓库 |
| **↓ 取出** | 选中的仓库物品 → 背包 |
| **💰 金币** | 打开/关闭金币操作面板 |
| **📄 翻页** | 一键切换仓库页码 |

### 仓库翻页
- 仓库共 **40 格**，每页显示 20 格（5×4）
- 面板下方「上一页/下一页」按钮
- 快捷翻页按钮一键切换

### 金币面板
- 显示 随身 + 仓库 金币数量
- **+1000 存→**：随身 → 仓库
- **+1000 取←**：仓库 → 随身

## 数据说明

### 物品
- **30 种物品**：10 种材料(1-10)、10 种矿石(11-20)、10 种道具(21-30)
- **5 个等级**：S(金) / A(红) / B(紫) / C(蓝) / D(灰)
- 支持数量堆叠

### 存储
- 背包：20 格
- 仓库：40 格（翻页 20/页）

## 项目结构

```
H:/lovegame/bagsystem/
├── main.lua          # 主界面 + 交互逻辑
├── inventory.lua     # 背包/仓库逻辑 (转移/堆叠/金币)
├── items.lua         # 物品数据定义
├── constants.lua     # 常量 (布局/颜色/稀有度)
├── conf.lua          # Love2D 配置
├── README.md         # 本文件
└── run.bat           # 启动脚本
```

## 技术细节

- 纯 Love2D API，无第三方库
- 字体加载：`io.open` 读取 → `love.filesystem.write` → `love.graphics.newFont`
- 字体来源：`H:/lovegame/font/simhei.ttf`（后备系统字体）
- `pcall` 安全包裹所有字体渲染，防止异常崩溃
- UTF-8 编码，无 BOM