TSTMenuMinecraft 服务器主菜单插件，2.1.0

标题里显示的服务器名。{brand} 会替换成 name。支持 & 颜色代码和 &l 加粗。

brand:
  name: "潮汐"
  menu-title: "{brand} 服务器菜单"
  shop-title: "{brand} 商店"

免费版的配置里没有这一段，也不需要。商业版启动时把 server-id 和 code 发到 cloud-url 校验：通过才继续加载；不通过（码不存在、已过期、绑定了别的服务器、连不上接口）就打印原因，5 秒后关闭服务器。code 首次校验后绑定 server-id，之后改标识码即失效。

license:
  enforce: true
  cloud-url: "https://tstservers.pages.dev/api/license/verify"
  server-id: "myserver"
  code: "XXXX-XXXX-XXXX-XXXX"

七个入口的开关。关掉只是不显示入口，已有数据（挂单、签到、邮件）不会丢。免费版的配置里只有前三个键，rank、profile、social、mail 的实现不在这个 jar 里。

menu:
  modules:
    teleport: true
    shop: true
    daily: true
    rank: false
    profile: false
    social: false
    mail: false

传送大厅里的地标列表。名字必须是 EssentialsX 里已存在的 warp，大小写一致。列表为空时传送页只剩玩家互传。

  warps:
    - resource
    - end
    - event
    - trade

签到与在线奖励。checkin-coins 是签到给的钱；reward-minutes 是连续在线多少分钟后能领；reward-coins 是领多少。礼包格式 材质:数量，不写数量就是 1。

  daily:
    checkin-coins: 50.0
    reward-minutes: 30
    reward-coins: 120.0
    kit-items:
      - "IRON_HELMET"
      - "IRON_CHESTPLATE"
      - "IRON_LEGGINGS"
      - "IRON_BOOTS"
      - "BREAD:16"

在主菜单里加自己的按钮，只在商业版渲染。slot 用 0-53，避开已占用的 10、12、14、16、28、31、34、45、49、53。action 有五种写法。

  custom:
    spawn:
      enabled: true
      slot: 11
      material: COMPASS
      name: "&b回主城"
      lore:
        - "&7一秒回到出生点"
      permission: ""
      action: "command spawn"
    site:
      enabled: true
      slot: 13
      material: PAPER
      name: "&e服务器网站"
      action: "url https://example.com"
    qq:
      enabled: true
      slot: 15
      material: OAK_SIGN
      name: "&a玩家群"
      action: "message &a群号 123456789"

restock-rate 控制价格多久回到基准：0.10 表示每小时把当前偏离量收回一成。price-decimals 是价格显示几位小数，只影响显示，结算用完整精度。

shop:
  restock-rate: 0.10
  price-decimals: 2

玩家市场。fee-percent 是成交抽成，0 表示不收；max-listings 是每人同时挂单上限；expire-days 到期后物品退回发件箱；page-size 取值 9-45。

market:
  enabled: true
  max-listings: 10
  expire-days: 7
  fee-percent: 0.0
  page-size: 36

对接排行榜网站的接口，没有配套网站就保持关闭。开了之后排行榜数据走远程接口，sync-seconds 与 pull-seconds 是推送和拉取的间隔秒数。

website:
  enabled: false
  base-url: ""
  server-token: ""
  server-id: ""
  sync-seconds: 60
  pull-seconds: 60

把在线人数、人数上限、版本、TPS、已开模块、服务器名和 MOTD 推到服务器列表站，间隔 interval-seconds 秒，最少 240。列表站注册服务器后会给出 api-key。免费版没有这段配置，也不会向外发任何请求。

report:
  enabled: false
  url: "https://tstservers.pages.dev/api/server/push"
  api-key: ""
  interval-seconds: 300

categories:
  blocks:
    title: 方块
    icon: STONE
    items:
      diamond_01:
        name: 钻石
        material: DIAMOND
        base-buy: 80.0
        base-sell: 30.0
        target-stock: 64
        stock: 64
        alpha: 0.15
        min-buy: 60.0
        max-buy: 110.0
        slot: 10

brand:
  name: "我的服"

改完 /menu reload，主菜单和商店标题一起变。

menu:
  modules:
    shop: false

关掉后主菜单里没有商店入口，/shop 命令也打不开，但已有商品和挂单数据保留，改回 true 就恢复。

categories:
  blocks:
    title: 方块
    icon: STONE
    items:
      emerald_01:
        name: 绿宝石
        material: EMERALD
        base-buy: 12.0
        base-sell: 5.0
        target-stock: 32
        alpha: 0.2

改完 /tstshop reload。注意 categories 下已有分类不要重复写，items 缩进比 items 多两格。

  warps:
    - spawn
    - resource
    - nether_hub

每个名字必须先在 EssentialsX 里 /setwarp spawn 建好，否则点了会提示找不到地标。

market:
  fee-percent: 0.0

这个值按配置生效，不会被插件强制改回 5%。想抽 5% 就写 5.0。

  custom:
    spawn:
      enabled: true
      slot: 11
      material: COMPASS
      name: "&b回主城"
      action: "command spawn"

玩家点一下就以自己的身份执行 /spawn。想跳过权限检查就写 console spawn {player}。

商业版每次启动向 /api/license/verify 发一次 POST，连接超时 3 秒、读取超时 5 秒。校验失败不降级成演示模式，直接关服。免费版不联网：不做校验，也不上报。

免费版要不要授权码？

不要。免费版 jar 里没有校验代码，也没有 license 配置段，装上直接能用。

免费版能改配置打开那五项吗？

不能。排行榜、个人中心、社交、邮件、自定义菜单项的代码不在免费版 jar 里，配置里也没有对应键。要用就换商业版 jar。

商业版没授权会怎样？

启动时云端校验不通过就打印失败原因，5 秒后自动关服。不会进演示模式，也不会带着半套功能跑。

商业版多少钱？

48 元买断，单服永久，含 2.x 全部更新。一个码绑定一个 server-id，换服免费改一次，之后再换另议。多服或服群直接加 QQ 3057722030 谈。

授权码怎么来？

联系 QQ 3057722030，把服务器标识（server-id）发过去，换一个 16 位码填进 license.code。第一次校验后码绑定这个标识，换服务器或改标识都要重新发码。下载商业版之前请先拿码，没有码装上会直接关服。

免费版会上报服务器信息吗？

不会。免费版没有任何对外请求；上报只出现在商业版，而且 report.enabled 默认是 false，要自己开了才发。

数据存在哪，换版本会丢吗？

plugins/TSTMenu/shop.db（SQLite）。库存、挂单、签到、邮件都在里面。升级时保留这个文件和 shops.yml 即可。

服务端要求？

Java 21 运行环境，Paper 或 Purpur 1.20 及以上。Vault 必需，EssentialsX 和 PlaceholderAPI 是软依赖。

打开商店是空的？

默认不预装商品。shops.yml 里三个分类的 items 都是空的，加商品后 /tstshop reload。

能修改后重新发布吗？

免费版可以，MIT 协议，保留版权声明即可。商业版不含源码，不适用。