BetterTalismans [1.8+] 自定义头颅！配方！权限！模型数据！自定义增益！

作者：AlonsoAliaga 发布时间：2020年8月20日原生版本：未知测试支持：1.8,1.9,1.10,1.11,1.12,1.13,1.14,1.15,1.16,1.17,1.18,1.19,1.20

为你的玩家制造带有助推器的护身符。

插件详细介绍

BetterTalismans 是一款 Minecraft 插件，允许服务器管理员创建具有自定义属性加成的物品，为玩家提供能力提升。这些物品使用 NBT 数据存储自定义属性，并支持自定义配方和权限控制。插件支持多种 Minecraft 版本，并提供了丰富的配置选项。

🎉 主要特性

多版本支持： 兼容 1.8.8 - 最新版本 Minecraft。
自定义权限： 为每个护身符设置独立的权限，以控制配方的解锁。
无限数量护身符： 可以创建不限数量的护身符。
护身符 GUI： 在图形界面中显示可用的护身符。
配方发现（1.13+）： 允许玩家自动发现他们有权限使用的配方。
多种属性加成：
- HEALTH_BOOST - 增加玩家生命值上限。
- KNOCKBACK_RESISTANCE - 增加击退抗性。
- MOVEMENT_SPEED - 增加移动速度。
- ATTACK_DAMAGE - 增加攻击伤害。
- ARMOR (1.9.2+) - 增加防御值。
- ARMOR_TOUGHNESS (1.9.2+) - 增加盔甲韧性。
- ATTACK_SPEED (1.9.2+) - 增加攻击速度。
- LUCK (1.9.2+) - 增加幸运值。
自定义效果槽位 (1.9+)： 限制某些属性加成仅在特定装备槽位生效。
- MAIN_HAND - 主手。
- OFF_HAND - 副手。
- HEAD - 头部。
- CHEST - 胸部。
- LEGS - 腿部。
- FEET - 脚部。
自定义物品： 可以创建具有属性加成的自定义可合成物品，例如铁甲飞行翼、钻石甲飞行翼、下界合金甲飞行翼，以及具有额外速度的头盔。
自定义显示名称和 Lore： 为每个护身符自定义显示名称和 Lore。
自定义配方： 为每个护身符选择自定义配方。
自定义材质： 为护身符选择材质，支持自定义头部材质。
命令别名： 可以为主要命令 '/bettertalismans' 添加别名，默认为 '/btalismans'。
耐久度： 设置物品的耐久度，允许在旧版本中使用彩色物品，在新版本中使用损坏的物品。
彩色物品： 设置特定物品的颜色，例如皮革盔甲、火焰弹和药水（仅限新版本）。
配方查看： 通过点击护身符 GUI 访问配方界面。
给予命令： 使用命令给予玩家护身符。
自定义模型数据： 支持 1.14+ 版本的自定义材质。
附魔选项： 为护身符添加附魔。
物品Flag选项： 选择要使用的物品Flag（默认为全部）。
配方界面自定义： 填充空白槽位的选项，以及“返回护身符”的物品。
物品交互白名单： 允许与特定材料进行交互，默认允许与武器、工具、盔甲和 PvP 相关物品进行交互。
实用子命令： "dropatlocation" 和 "dropatplayer" 子命令。
配置自动更新： 插件更新时自动更新配置。
更新检查器： 在有新版本时收到通知。

🗂️ 配置文件

config.yml
talismans.yml

⚙️ 安装步骤

从 SpigotMC.org 下载插件。
将 jar 文件复制到你的 plugins 文件夹中。
重启服务器。
在配置文件中编辑你想要的内容。
重启服务器。

🔑 命令与权限

/bettertalismans test - 给予所有护身符用于测试（OP ONLY）。
/bettertalismans talismans [player] - 打开护身符 GUI（权限：无，可配置）。
/bettertalismans give [player] [talisman] - 给予玩家护身符（权限：bettertalismans.admin）。
/bettertalismans reload - 重载配置（权限：bettertalismans.admin）。

❓ 常见问题解答

为什么是 Beta 版？
答：只是插件发布时的一个习惯用法。
为什么最多 54 个护身符？
答：因为 Minecraft 库存的最大尺寸是 54，并且这是一个简单的插件，没有考虑添加多个库存页面。
我可以限制某些护身符给特定玩家吗？
答：只能限制制作和配方查看，使用是免费的，所有玩家都可以使用所有护身符。
我可以在 mcbbs.net 上发布这个插件吗？
答：不可以。
你确定吗？
答：是的，我确定。你不允许发布它。
无法在我的服务器上运行！
答：在评论之前，请确保已安装所有依赖项。如果错误仍然存在，请将启动控制台日志粘贴到 https://sourceb.in/，并在讨论选项卡中发布或加入我的服务器。

🔗 依赖

NBTAPI - 此插件使用 NBT 标签。

👨‍💻 API

访问 API 包：com.alonsoaliaga.bettertalismans.api.BetterTalismansAPI
查看 Github 上的 DeveloperAPI

🐛 问题反馈

如果您发现任何错误或想要提出功能请求，请加入我的 Discord 服务器或使用我们的 issue tracker。请勿在评论区报告错误。

📜 条款与条件

下载此插件即表示您同意以下所有条款和条件：

您不得以任何形式重新分发该插件，包括作为任何软件包的一部分。
您不得以任何形式反编译或修改该插件。
您不得声称此资源是您自己的创作。

💰 捐赠链接

http://paypal.me/AlonsoAliaga

💻 配置文件示例


# Talismans configuration

# How long will the discovered recipes last? (In days)
recipes-expiration: 30

# General settings
settings:
  # Enable/Disable talismans gui.
  enable-talismans-gui: true

  # Talismans command permission. (Leave empty to allow everyone)
  # Requires Server restart.
  talismans-command-permission: "bettertalismans.talismans"

  # Allow players to discover recipes when joining.
  discover-recipes-on-join: true

  # Allow recipe view.
  enable-recipe-view: true

  # Recipes title. (Talismans recipe)
  recipes-title: "&6Talismans recipe"

  # Enable return to talismans gui button in recipes view.
  enable-return-button: true

  # What will happen when item is clicked in recipes view?
  # open_crafting_table - Opens crafting table.
  # take_item - Takes item.
  recipes-click-action: "open_crafting_table"

  # Enable whitelist item interaction. (Prevents items from being dropped)
  enable-whitelist-item-interaction: true

  # Auto-update configuration file.
  auto-update-config: true

  # Use update checker.
  update-checker: true

  # Debug mode.
  debug: false

  # Command aliases.
  command-aliases:
    - "btalismans"

  # Custom model data start value.
  # Increase it if you want to add more custom model data.
  # If you dont know what this is, leave it as it is.
  custom-model-data-start: 10000

  # Useful subcommands.
  useful-subcommands:
    drop-at-location: true # /bettertalismans dropatlocation  
    drop-at-player: true   # /bettertalismans dropatplayer   

  # Empty slots item. (Recipes gui)
  recipes-empty-slots:
    enabled: false
    material: "GRAY_STAINED_GLASS_PANE"
    displayname: "&f"
    lore: []

# How many custom talisman slots you want?
# Requires Server restart.
talismans-size: 18

# Name for talismans gui.
talismans-name: "&6Talismans"

# Item for when talisman is locked.
locked-talisman:
  enabled: true # Enable locked talisman.
  material: "SKULL_ITEM:3"
  displayname: "&cLocked"
  lore:
    - "&7You don't have permission to craft this talisman."
    - "&7Obtain the permission and come back."
  texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvODkyZDg0ZGE4MGNkYWMzMGY0NzU0ZjQ4NzlmMmU1ZGI5MzQ1NzhkMDQ2Zjc2MjQ3ZmE2OGE4NjQyNzQzIn19fQ=="

# Item for return button in recipes view.
return-button:
  material: "BARRIER"
  displayname: "&cReturn"
  lore:
    - "&7Click to return to talismans."

# Whitelist item interaction.
whitelist-item-interaction:
  # Prevent drop items?
  prevent-drop: true

  # Prevent moving items in inventory?
  prevent-move: true

  # Prevent crafting items with talismans?
  prevent-craft: true

  # Prevent using items with talismans?
  prevent-use: true

  # Materials allowed to interact with. (WEAPON, TOOL, ARMOR, POTION, etc.)
  allowed-materials:
    - "DIAMOND_SWORD"
    - "DIAMOND_AXE"
    - "DIAMOND_PICKAXE"
    - "DIAMOND_SHOVEL"
    - "DIAMOND_HOE"
    - "DIAMOND_HELMET"
    - "DIAMOND_CHESTPLATE"
    - "DIAMOND_LEGGINGS"
    - "DIAMOND_BOOTS"
    - "IRON_SWORD"
    - "IRON_AXE"
    - "IRON_PICKAXE"
    - "IRON_SHOVEL"
    - "IRON_HOE"
    - "IRON_HELMET"
    - "IRON_CHESTPLATE"
    - "IRON_LEGGINGS"
    - "IRON_BOOTS"
    - "GOLDEN_SWORD"
    - "GOLDEN_AXE"
    - "GOLDEN_PICKAXE"
    - "GOLDEN_SHOVEL"
    - "GOLDEN_HOE"
    - "GOLDEN_HELMET"
    - "GOLDEN_CHESTPLATE"
    - "GOLDEN_LEGGINGS"
    - "GOLDEN_BOOTS"
    - "STONE_SWORD"
    - "STONE_AXE"
    - "STONE_PICKAXE"
    - "STONE_SHOVEL"
    - "STONE_HOE"
    - "LEATHER_HELMET"
    - "LEATHER_CHESTPLATE"
    - "LEATHER_LEGGINGS"
    - "LEATHER_BOOTS"
    - "WOOD_SWORD"
    - "WOOD_AXE"
    - "WOOD_PICKAXE"
    - "WOOD_SHOVEL"
    - "WOOD_HOE"
    - "SHIELD"
    - "BOW"
    - "CROSSBOW"
    - "TRIDENT"
    - "FISHING_ROD"
    - "FLINT_AND_STEEL"
    - "SHEARS"
    - "POTION"
    - "SPLASH_POTION"
    - "LINGERING_POTION"
    - "SNOWBALL"
    - "EGG"
    - "ENDER_PEARL"
    - "FIRE_CHARGE"
    - "WRITTEN_BOOK"
    - "FIREWORK_ROCKET"
    - "NETHERITE_SWORD"
    - "NETHERITE_AXE"
    - "NETHERITE_PICKAXE"
    - "NETHERITE_SHOVEL"
    - "NETHERITE_HOE"
    - "NETHERITE_HELMET"
    - "NETHERITE_CHESTPLATE"
    - "NETHERITE_LEGGINGS"
    - "NETHERITE_BOOTS"


# Talismans

# Armor Elytra
iron-armored-elytra:
  enabled: true
  displayname: "&fIron Armored Elytra"
  lore:
    - "&7This elytra gives you the same amount of armor points as a iron chestplate."
  material: "ELYTRA"
  durability: 0
  custom-model-data: 0
  slot: "CHEST"
  health-boost: 0
  knockback-resistance: 0.0
  movement-speed: 0.0
  attack-damage: 0.0
  armor: 5.0
  armor-toughness: 0.0
  attack-speed: 0.0
  luck: 0.0
  item-flags:
    - "HIDE_ENCHANTS"
    - "HIDE_ATTRIBUTES"
  enchantments: {}
  recipe:
    enabled: true
    permission: "bettertalismans.recipe.iron-armored-elytra"
    shape:
      - "ABA"
      - "BCB"
      - "ABA"
    ingredients:
      A:
        material: "IRON_INGOT"
        data: 0
      B:
        material: "ELYTRA"
        data: 0
      C:
        material: "IRON_CHESTPLATE"
        data: 0

diamond-armored-elytra:
  enabled: true
  displayname: "&fDiamond Armored Elytra"
  lore:
    - "&7This elytra gives you the same amount of armor points as a diamond chestplate."
  material: "ELYTRA"
  durability: 0
  custom-model-data: 0
  slot: "CHEST"
  health-boost: 0
  knockback-resistance: 0.0
  movement-speed: 0.0
  attack-damage: 0.0
  armor: 8.0
  armor-toughness: 0.0
  attack-speed: 0.0
  luck: 0.0
  item-flags:
    - "HIDE_ENCHANTS"
    - "HIDE_ATTRIBUTES"
  enchantments: {}
  recipe:
    enabled: true
    permission: "bettertalismans.recipe.diamond-armored-elytra"
    shape:
      - "ABA"
      - "BCB"
      - "ABA"
    ingredients:
      A:
        material: "DIAMOND"
        data: 0
      B:
        material: "ELYTRA"
        data: 0
      C:
        material: "DIAMOND_CHESTPLATE"
        data: 0

netherite-armored-elytra:
  enabled: true
  displayname: "&fNetherite Armored Elytra"
  lore:
    - "&7This elytra gives you the same amount of armor points as a netherite chestplate."
  material: "ELYTRA"
  durability: 0
  custom-model-data: 0
  slot: "CHEST"
  health-boost: 0
  knockback-resistance: 0.0
  movement-speed: 0.0
  attack-damage: 0.0
  armor: 8.0
  armor-toughness: 3.0
  attack-speed: 0.0
  luck: 0.0
  item-flags:
    - "HIDE_ENCHANTS"
    - "HIDE_ATTRIBUTES"
  enchantments: {}
  recipe:
    enabled: true
    permission: "bettertalismans.recipe.netherite-armored-elytra"
    shape:
      - "ABA"
      - "BCB"
      - "ABA"
    ingredients:
      A:
        material: "NETHERITE_INGOT"
        data: 0
      B:
        material: "ELYTRA"
        data: 0
      C:
        material: "NETHERITE_CHESTPLATE"
        data: 0

# Custom head with speed.
speed-head:
  enabled: true
  displayname: "&fSpeed Head"
  lore:
    - "&7This head gives you extra speed."
  material: "SKULL_ITEM:3"
  durability: 0
  custom-model-data: 0
  slot: "HEAD"
  health-boost: 0
  knockback-resistance: 0.0
  movement-speed: 0.2
  attack-damage: 0.0
  armor: 0.0
  armor-toughness: 0.0
  attack-speed: 0.0
  luck: 0.0
  item-flags:
    - "HIDE_ENCHANTS"
    - "HIDE_ATTRIBUTES"
  enchantments: {}
  texture: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzk0NzQyMzQ0ZDY3YmQzOGI4ODhkZDMwNmRjYzkyYjNjY2Y4MzU3ZDZhNzQ2Y2Q0NzQ3MmQ0M2M5NzUifX19"
  recipe:
    enabled: true
    permission: "bettertalismans.recipe.speed-head"
    shape:
      - "AAA"
      - "A A"
      - "   "
    ingredients:
      A:
        material: "SUGAR"
        data: 0