# ItemSave

**Repository Path**: langle123/ItemSave

## Basic Information

- **Project Name**: ItemSave
- **Description**: Bukkit物品保存插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-21
- **Last Updated**: 2026-05-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# ItemSave

<div align="center">

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Java](https://img.shields.io/badge/java-21-orange.svg)](https://www.oracle.com/java/technologies/javase/jdk21-archive-downloads.html)
[![Minecraft](https://img.shields.io/badge/minecraft-1.21.1-green.svg)](https://www.minecraft.net/)

一个功能强大的 Minecraft 物品保存插件，适用于 Spigot/Bukkit 服务器。

</div>

## 📌 项目简介

**ItemSave** 是一个专为 Minecraft 服务器设计的插件，允许管理员通过命令保存、删除、分发自定义物品。它提供了便捷的命令行界面来管理服务器中的特殊物品。

主要功能包括：

- 使用 `/is save <name>` 命令保存手中持有的物品
- 使用 `/is delete <name>` 命令删除已保存的物品
- 使用 `/is give <player> <name> [amount]` 命令将保存的物品给予玩家
- 使用 `/is list` 查看所有已保存的物品
- 使用 `/is reload` 重载配置文件

---

## 🧰 开发环境

| 项目         | 版本                      |
|------------|-------------------------|
| Java 版本    | 21                      |
| Minecraft  | 1.21.1                  |
| Spigot API | 1.21.1-R0.1-SNAPSHOT    |
| Maven      | 3.x                     |
| IDE 推荐     | IntelliJ IDEA / Eclipse |

### 依赖库

- [Spigot API](https://www.spigotmc.org/wiki/spigot-maven/)
- [Lombok](https://projectlombok.org/)

---

## 📁 项目结构

```
ItemSave/
├── src/
│   ├── main/
│   │   ├── java/
│   │   │   └── me/
│   │   │       └── minecraft/
│   │   │           └── plugin/
│   │   │               └── itemsave/
│   │   │                   ├── ItemSave.java
│   │   │                   ├── command/
│   │   │                   ├── config/
│   │   │                   └── manager/
│   │   └── resources/
│   │       ├── plugin.yml
│   │       └── message.yml
├── target/
├── pom.xml
└── README.md
```

---

## ⚙️ 构建与部署

### 构建插件

在项目根目录下运行以下命令：

```bash
mvn clean package
```

构建成功后，会在 `target/` 目录下生成 `ItemSave-xxx-1.0.0.jar` 文件。

### 部署插件

1. 将生成的 JAR 文件复制到 Minecraft 服务器的 `plugins/` 目录中
2. 启动或重启服务器
3. 插件将自动加载并创建必要的配置文件

---

## 🎯 功能特性

### 核心功能

- **物品保存**: 使用 `/is save <name>` 命令保存玩家主手的物品
- **物品删除**: 使用 `/is delete <name>` 命令删除指定名称的物品
- **物品分发**: 使用 `/is give <player> <name> [amount]` 命令给玩家分发已保存的物品
    - 支持多种目标玩家模式：
        - `@a`: 给所有在线玩家
        - `@r`: 随机给一名在线玩家
        - `@s`: 给自己（执行命令的玩家）
        - `<player_name>`: 给指定玩家
- **物品列表**: 使用 `/is list` 命令查看所有已保存物品的名称
- **插件重载**: 使用 `/is reload` 命令重新加载配置文件

### 命令系统

所有命令都以 `/is` 或 `/ItemSave` 开头：

| 命令                                  | 描述        |
|-------------------------------------|-----------|
| `/is`                               | 显示插件基本信息  |
| `/is help`                          | 显示帮助信息    |
| `/is save <name>`                   | 保存主手物品    |
| `/is delete <name>`                 | 删除指定物品    |
| `/is give <player> <name> [amount]` | 给予玩家物品    |
| `/is list`                          | 列出所有已保存物品 |
| `/is reload`                        | 重载配置文件    |

---

## 🛠️ 配置文件

### message.yml

包含插件中使用的所有消息文本：

```yaml
command:
no_permission: "[§6ItemSave§f] §c你没有权限执行此命令"
reload: "[§6ItemSave§f] §a已重载配置文件"
```

---

## 🔐 权限设置

默认情况下，只有 OP
玩家可以使用这些命令。可以通过修改 [plugin.yml](file://D:\JavaDevelopment\ItemSave\target\classes\plugin.yml)
中的权限设置来自定义访问控制。

```yaml
permissions:
ItemSave.command:
default: op
```

---

## 📚 参考文档

- [Spigot 官方文档](https://www.spigotmc.org/wiki/)
- [Minecraft 开发 Wiki](https://minecraft.fandom.com/wiki/Minecraft_Wiki)
- [Maven 官方文档](https://maven.apache.org/guides/)

---

## 📄 许可证

本项目采用 MIT 许可证，详情请参见 [LICENSE](LICENSE) 文件。