STARTERPACK PLUGIN

Overview StarterPack is a lightweight Paper/Spigot plugin that provides new players with a customizable starter kit. With a simple /gift command, players can claim their starter items once per player forever.

Features

• One-time claim per player (data saved across server restarts)
• Fully configurable via config.yml - no recompilation needed
• Supports all vanilla Minecraft items with custom stack sizes
• Smart inventory handling - items drop at feet if inventory is full
• Lightweight - zero dependencies
• Optional permission support

Commands /gift - Claim your starter pack

Configuration Edit plugins/StarterPack/config.yml: gifts:

• "IRON_HELMET:1"
• "IRON_CHESTPLATE:1"
• "IRON_LEGGINGS:1"
• "IRON_BOOTS:1"
• "IRON_SWORD:1"
• "IRON_PICKAXE:1"
• "IRON_AXE:1"
• "IRON_SHOVEL:1"
• "SHIELD:1"

Permissions starterpack.gift - Allows use of /gift (default: true)

Requirements

• Paper 1.21.x to 26.2.x (also compatible with Spigot)
• Java 21 or higher

Installation

1. Place StarterPack.jar in plugins/ folder
2. Restart the server
3. Edit config.yml to customize the kit
4. Players use /gift to claim

新手礼包插件 StarterPack

概述 StarterPack 是一款轻量级新手礼包插件。玩家输入 /gift 即可领取礼包，每个玩家仅限领取一次。

功能特性

• 每人仅限领取一次（数据自动保存）
• 通过 config.yml 自定义物品，无需重新编译
• 支持所有原版物品，可自定义数量
• 背包满时物品自动掉落在脚下
• 轻量无依赖
• 支持权限控制

指令 /gift - 领取新手礼包

配置文件 编辑 plugins/StarterPack/config.yml： gifts:

• "IRON_HELMET:1" 铁头盔
• "IRON_CHESTPLATE:1" 铁胸甲
• "IRON_LEGGINGS:1" 铁护腿
• "IRON_BOOTS:1" 铁靴子
• "IRON_SWORD:1" 铁剑
• "IRON_PICKAXE:1" 铁镐
• "IRON_AXE:1" 铁斧
• "IRON_SHOVEL:1" 铁锹
• "SHIELD:1" 盾牌

权限 starterpack.gift - 允许使用 /gift（默认开启）

环境要求

• Paper 1.21.x 至 26.2.x（也支持 Spigot）
• Java 21 或更高

安装方法

1. 将 StarterPack.jar 放入 plugins 文件夹
2. 重启服务器
3. 编辑 config.yml 自定义礼包
4. 玩家使用 /gift 领取