原创 开源 工具 经济 【礼包插件】一个小白也能用的懂的礼包类插件 1.0.0

# ============================================================
#  RanGiftPack 方可梦礼包系统 - 主配置
#  改完执行 /gift reload 生效（无需重启服务器）
# ============================================================

# 右键使用礼包的开关。
# true  = 玩家手持礼包右键即可开启
# false = 只有 /gift give 管理员可发放，玩家无法自行开启（适合需要审批的礼包）
enable_right_click: true

# 玩家右键使用礼包时是否被"潜行"状态影响。
# true  = 潜行右键不开启（避免误触，适合礼包可与方块交互的场景）
# false = 潜行右键也开启
require_not_sneaking: false

# 同一玩家两次开启礼包的最小间隔（毫秒）。
# 防止连点/高频右键导致同一礼包被连续消耗。
# 0 = 不做限制（不推荐）
open_cooldown_ms: 400

# 开启礼包时是否向玩家发送产出汇总消息（如 "&7你获得了: &f铁锭 x10"）
# false = 只发 messages.yml 里配置的开包标题消息，不逐条列产出
announce_result: true

# 产出汇总里最多列出多少条（超出只显示 "&7...等 N 项"），避免刷屏
result_max_lines: 6

# 礼包本体物品的名称前缀。
# 会拼在 gifts/<id>.yml 的 display 之前，用于统一标识（如 "&7[礼包] &f"）。
# 留空 "" 表示不加前缀，直接使用 display。
pack_name_prefix: ""

# 礼包本体物品是否加附魔光效（配置文件里 display 为空时也更容易辨认）
# 注意：启用后所有礼包本体都会有附魔光效，视觉上会被覆盖
pack_glow: false

# 开启礼包时是否播放音效
# 可选项为原版音效名，例如 ENTITY_PLAYER_LEVELUP / BLOCK_CHEST_OPEN / UI_BUTTON_CLICK
# 留空 "" 表示不播放
open_sound: "ENTITY_PLAYER_LEVELUP"

# 音效音量与音调
open_sound_volume: 0.8
open_sound_pitch: 1.2

# 礼包产物绑定玩家后，是否拦截"被销毁"类路径（火焰/爆炸/仙人掌/展示框等）。
# true  = 绑定产物的唯一去处就是绑定者自己的背包（最严格，符合"不允许以任何方式离开自身背包"）
# false = 允许绑定产物被销毁（但依然不能转移给别人）
protect_bound_from_destroy: true

# 是否在服务器启动/重载时，检查玩家背包里"贴了绑定标记但不属于该玩家"的物品并告警。
# true  = 额外安全网（有轻微性能开销：只在重载时检查一次在线玩家背包）
# false = 关闭检查
verify_bind_on_reload: true

# 调试日志：开启后会在控制台打印礼包加载细节、产出抽取结果、绑定拦截原因
# 排查配置问题时可临时开启，平时建议 false（避免刷屏与性能损耗）
debug: false

# 产出模式（必填）：independent / shared / all
#`independent` —— 独立概率判定
#`shared` —— 权重共享（只出 1 条）
#`all` —— 全部获得
mode: independent

# ---------- 礼包本体外观 ----------
display: "&6&l传说礼包"          # 显示名（& 颜色代码；同时是识别礼包的依据之一）
material: minecraft:chest        # 本体材质：原版英文 id，或模组 命名空间:名称
amount: 1                        # 每次 /gift give 给几个礼包
lore:                            # 物品说明
  - "&7右键开启，可以获得稀有宝可梦或道具"
  - "&8使用后消失"
glow: true                       # 附魔光效
custom_model_data: 0             # 原版 CustomModelData

# ---------- AX NBT 贴图（★ 只有礼包本体能配） ----------
nbt:
  icon: gift/legendary           # 背包/物品栏图标
  # model: gift/legendary_model  # 手持模型
  # fp_model: gift/legendary_fp  # 第一人称模型

# ---------- 绑定开关 ----------
bind_pack: false                 # 礼包本体是否绑定使用者
bind_products: false             # 开出的产物是否绑定使用者

# ---------- 产出条目 ----------
entries: #支持模组物品,使用指令
  铁锭:
    type: item
    material: minecraft:iron_ingot
    amount: 10
    chance: 100                  # 100 = 必得
  盖欧卡:
    type: console
    command: "pokegiveother {p} kyogre"
    chance: 3                    # 3%
  大师球:
    type: item
    material: cobblemon:master_ball   # 模组物品
    amount: 1
    chance: 5
  金锭:
    type: item
    material: minecraft:gold_ingot
    amount: 6-10                 # 数量区间：每次随机 6~10
    chance: 30
  点券奖励:
    type: console
    command: "points give %player% 500"
    chance: 15