💡 VarLight

VarLight 是一款 Spigot 插件，允许玩家将普通方块变成自定义光源。插件的核心功能围绕着光照更新物品（Light Update Item，简称 LUI）展开，默认为荧石粉。

🎮 游戏玩法

• 使用光照更新物品右键点击大多数方块会使其亮度增加 1。
• 使用光照更新物品左键点击自定义光源会使其亮度降低 1。
• 破坏自定义光源：
  • 如果没有使用时运或精准采集，则掉落 1 个配置的光照更新物品。
  • 如果使用时运，则掉落最多 n 个配置的光照更新物品（n 为自定义光源的亮度）。更高级别的时运会增加掉落更多物品的几率。
  • 掉落一个发光变种的被破坏方块，如果使用合适的精准采集工具破坏，可以再次放置为自定义光源。

⚙️ 配置

所有插件的 config.yml 文件的配置项如下所示：

# Configuration file for VarLight

#use-base64-encoding: false
#language: "lang_en.yml"

mechanics:
  # Whether physics should apply to custom light sources
  gravity: false
  # Whether blocks should burn out after a while
  burnout:
    enabled: false
    #Chance of a block burning out per tick (1/chance)
    chance: 10000
    #List of materials that can burn out
    burnable:
      - "OAK_WOOD"
      - "SPRUCE_WOOD"
      - "BIRCH_WOOD"
      - "JUNGLE_WOOD"
      - "ACACIA_WOOD"
      - "DARK_OAK_WOOD"
  #Whether piston should be able to push or pull custom light sources
  allow-piston-move: false

# Settings related to the Light Update Item (LUI)
light-update-item:
  # The material of the LUI
  item: GLOWSTONE_DUST
  # The name of the LUI (will be colored)
  name: "&6Light Update Item"
  # Lore of the LUI (will be colored)
  lore:
    - "&7Right click to increase luminance"
    - "&7Left click to decrease luminance"
    - "&7Max luminance: 15"
  # Whether the LUI should be hidden from the inventory
  hide: false

# Settings related to persistence
persistence:
  # The mode of persistence
  #   * file - saves light sources to a file
  #   * chunk - saves light sources to chunk data (only works for block light)
  mode: file
  # Settings related to file persistence
  file:
    # The amount of light sources to save per tick
    save-rate: 200
  # Settings related to chunk persistence
  chunk:
    # The maximum amount of light sources per chunk to load
    load-limit: 400
    # The amount of light sources to load per tick per chunk
    load-rate: 50
    # Whether to only load light sources in loaded chunks
    load-only-loaded: true
    # Whether to remove light sources that are outside of the world border
    remove-outside-border: true

#Settings that related to the villager profession mechanic
villager:
  #Whether the villager mechanic is enabled or not
  enabled: false
  #The custom villager profession type
  profession: "LIGHTING_EXPERT"
  #The custom villager profession name
  name: "Lighting Expert"
  #The custom villager trade item
  item: GLOWSTONE_DUST
  #The display name of the custom villager trade item
  item-name: "&6Glowstone Dust"
  #The custom villager trade item lore
  item-lore:
    - "&7The villager can trade"
    - "&7this item for emeralds"

# Settings related to light checks
light-checks:
  # Whether light checks should be enabled
  enabled: true
  # The interval in ticks between light checks
  interval: 20
  # The maximum number of light sources to check per tick
  limit: 500

# Experimental Settings (might break)
experimental:
  # Whether to use the new light engine (faster, but might break)
  new-light-engine: false

⌨️ 命令

插件的所有命令如下：

• /varlight giveLightUpdateItem [player] -给予指定玩家光照更新物品
• /varlight clearAllCustomLights -清除所有自定义光源

权限节点：

• varlight.admin - 允许使用所有 VarLight 命令
• varlight.interact - 允许与自定义光源交互
• varlight.create - 允许创建自定义光源
• varlight.remove - 允许移除自定义光源
• varlight.give - 允许使用 /varlight giveLightUpdateItem 命令
• varlight.clear - 允许使用 /varlight clearAllCustomLights 命令

请在 Github Issues Page 上报告 Bug。