well404.Essentials 1.0.1

well404.Essentials

Essentials —— 面向玩家的实用指令合集：回家、传送、传送点、礼包、睡觉投票、回到死亡点。

well404.Essentials 是 well404 OpenMod 插件家族 的一员。它面向玩家而非管理员， 把生存常用的便利指令集中到一个插件里，并为所有传送提供统一的「预热静止 + 可选经济收费 + 冷却」体验。

功能

• /home：回到你设置的家；/home set 把当前位置设为家（单个家）。
• /tp <玩家>：传送到某玩家。同队直接传送；不同队则发出请求，对方用 /tpa 接受或 /tpd 拒绝（请求会超时）。
• /party：组队。/party invite <玩家> 发邀请，对方 /party accept 入队（绕过难用的 游戏内组队菜单）；还有 /party deny、/party leave、/party kick、/party（看成员）。 组队后队友之间 /tp 即可免确认直传。
• /warp：传送点。/warp <名称> 传送，/warp set <名称> [冷却] 新建， /warp delete <名称> 删除，/warps 列出你有权限使用的传送点（指令格式参考 NewEssentials）。
• /gift：免费礼包。/gift 列出你可领取的，/gift <id> 领取。每个礼包可设 crontab 刷新规则与可选权限（做 VIP 专属礼包）。
• /sleep：睡觉投票。在线玩家中达到设定比例（默认半数）即在白天/黑夜之间切换。
• /back：回到上次死亡的地点，并获得可配置秒数的无敌时间。

传送通用规则（home/tp/warp/back 共用）：传送前需静止预热若干秒（默认 5s，移动则取消）、 可设每条命令的冷却、以及可选的经济费用——仅当装了任一 IEconomyProvider（如 well404.Economy）时才扣费，默认全为 0（免费）。

装了 well404.WebPanel 时，上述所有设置项（传送规则、费用、tpa/sleep/back、传送点、礼包） 都可在 Web 界面里编辑。同时还会给玩家提供一个面向玩家的「实用工具」菜单(中英双语)：玩家 游戏内输入 /menu（或 /menu essentials）即可在浏览器里设置家/回家/返回死亡点/传送到有权限的传送点、 向玩家发起传送请求并接受/拒绝来请、组队邀请/接受/退出/队长踢人、领取礼包、投票睡觉(沿用同样的冷却/收费/读条)。

安装

openmod install well404.Essentials

重启服务器或执行 openmod reload 后生效。Essentials 不强制依赖经济或面板插件—— 没有它们也能正常工作（传送免费、无 Web 界面）。

命令

权限

OpenMod 会按命令路径自动派生命令权限（如 well404.Essentials:home、 well404.Essentials:warp.set）。此外本插件使用这些自定义权限节点：

配置 (config.yaml)

teleport:
  warmupSeconds: 5        # 传送前静止秒数，0=瞬移
  cancelOnMove: true      # 预热期间移动则取消
  moveThreshold: 0.5      # 移动判定阈值（米）
  cooldownSeconds: 0      # 成功传送后的冷却，0=无
  costs:                  # 经济费用（需经济插件，默认 0=免费）
    home: 0
    tp: 0
    warp: 0
    back: 0
tpa:
  expirationSeconds: 30   # /tp 请求超时
party:
  inviteExpirationSeconds: 60  # /party 邀请超时
  maxMembers: 0           # 队伍人数上限，0=不额外限制
back:
  invincibilitySeconds: 5 # /back 落地后的无敌秒数
sleep:
  enabled: true
  requiredRatio: 0.5      # 通过所需的在线玩家比例
warps: []                 # /warp set 或 WebUI 维护
gifts: []                 # 礼包：id/name/permission/cron/items

gifts 示例：

gifts:
  - id: "daily"
    name: "Daily Supply"
    permission: ""          # 留空=所有人
    cron: "0 0 * * *"       # 每天 0 点刷新（服务器本地时间）
    items:
      - itemId: 15
        amount: 2
  - id: "vip"
    name: "VIP Weekly Crate"
    permission: "well404.essentials.gift.vip"
    cron: "0 0 * * 1"       # 每周一刷新
    items:
      - itemId: 81
        amount: 1

well404 OpenMod 插件家族

完整文档见 GitHub 仓库 的 docs/。

许可

CC BY-NC-SA 4.0 © well404