ArcartXSuite

主题

Essentials 基础工具 ​

功能定位 ​

Essentials 模块集合了服务器最常用的玩家工具、传送系统、安全管控和实用功能，开箱即用。

核心特性 ​

分类功能
玩家管理飞行 / 无敌 / 回血 / 回饱食 / 速度 / 隐身 / AFK / 修复 / 帽子
容器末影箱 / 工作台 / 铁砧 / 垃圾桶
传送系统Home / Warp / Spawn / TPA / Back / TP / Top / TpPos
世界管理时间 / 天气
安全管控封禁 / 禁言（委托 Chat 模块） / 踢出 / 警告 / Sudo / 背包查看
交互坐下 / 躺下
一键砍树连锁砍伐原木 + 树叶，可配置斧头/潜行/连锁数
背包操作自动补种作物 / 背包整理 / 自动工具切换
玩家信息昵称 / 上次在线查询

UI 面板 ​

Essentials 模块提供两个 ArcartX UI 面板，需要服务端安装 ArcartX 客户端 mod 才可使用。

玩家菜单 ​

命令：/axs essentials menu

单文件多视图架构，通过左侧导航栏切换 5 个子页面：

页面功能
首页玩家状态总览（飞行/无敌/AFK/速度/位置/家数量/传送点数）
家Home 列表 + 传送/删除/新建
传送点Warp 列表 + 一键传送
TPA在线玩家列表 + 点击发送传送请求 + 接受/拒绝
设置飞行/自动补种/自动工具开关 + 背包整理按钮

管理员面板 ​

命令：/axs essentials admin
权限：axs.essentials.admin

页面功能
玩家在线玩家列表 + 治疗/喂食/飞行/踢出/封禁
封禁封禁记录列表 + 解封
传送点Warp 管理 + 新建/删除
世界时间设置（白天/夜晚/正午）+ 天气（晴天/雨天/雷暴）+ 设置出生点

前置要求

UI 面板需要玩家安装 ArcartX 客户端 mod。未安装时命令会提示"UI 功能不可用"。

命令 ​

主入口：/axs essentials <子命令>，或使用缩写 /ess <子命令>

两种写法完全等价，例如 /ess fly = /axs essentials fly

UI ​

命令说明权限
/ess menu打开玩家功能菜单axs.essentials.menu
/ess admin打开管理员面板axs.essentials.admin

玩家管理 ​

命令说明权限
/ess fly [玩家]切换飞行模式axs.essentials.fly
/ess god [玩家]切换无敌模式axs.essentials.god
/ess heal [玩家]恢复生命值axs.essentials.heal
/ess feed [玩家]恢复饥饿值axs.essentials.feed
/ess gamemode <模式> [玩家]设置游戏模式axs.essentials.gamemode
/ess speed <数值> [玩家]设置移动速度axs.essentials.speed
/ess vanish切换隐身axs.essentials.vanish
/ess afk切换 AFK 状态axs.essentials.afk
/ess repair修复手持物品axs.essentials.repair
/ess hat将手持物品戴在头上axs.essentials.hat
/ess nick <昵称|off>设置/重置昵称axs.essentials.nick
/ess seen <玩家>查看玩家最后在线信息axs.essentials.seen

容器 ​

命令说明权限
/ess enderchest [玩家]打开末影箱axs.essentials.enderchest
/ess workbench打开工作台axs.essentials.workbench
/ess anvil打开铁砧axs.essentials.anvil
/ess trash打开垃圾桶axs.essentials.trash

传送系统 ​

命令说明权限
/ess home [名称]传送到家axs.essentials.home
/ess sethome [名称]设置家axs.essentials.sethome
/ess delhome [名称]删除家axs.essentials.delhome
/ess warp <名称>传送到传送点axs.essentials.warp
/ess setwarp <名称>设置传送点axs.essentials.setwarp
/ess delwarp <名称>删除传送点axs.essentials.delwarp
/ess spawn传送到出生点axs.essentials.spawn
/ess setspawn设置出生点axs.essentials.setspawn
/ess tpa <玩家>发送传送请求axs.essentials.tpa
/ess tpahere <玩家>请求对方传送到自己axs.essentials.tpahere
/ess tpaccept接受传送请求axs.essentials.tpa
/ess tpdeny拒绝传送请求axs.essentials.tpa
/ess back返回上次位置axs.essentials.back
/ess tp <玩家>管理员直接传送axs.essentials.tp
/ess top传送到头顶最高方块axs.essentials.top
/ess tppos <x> <y> <z> [世界]传送到坐标axs.essentials.tppos

安全管控 ​

命令说明权限
/ess ban <玩家> [原因]永久封禁axs.essentials.ban
/ess tempban <玩家> <时长> [原因]临时封禁axs.essentials.ban
/ess unban <玩家>解封axs.essentials.unban
/ess mute <玩家> [原因]永久禁言（委托 Chat 模块）axs.essentials.mute
/ess tempmute <玩家> <时长> [原因]临时禁言（委托 Chat 模块）axs.essentials.mute
/ess unmute <玩家>解除禁言（委托 Chat 模块）axs.essentials.unmute
/ess kick <玩家> [原因]踢出服务器axs.essentials.kick
/ess warn <玩家> <原因>警告玩家axs.essentials.warn
/ess sudo <玩家> <命令>强制玩家执行命令axs.essentials.sudo
/ess inv <玩家>查看玩家背包axs.essentials.inv

交互 & 工具 ​

命令说明权限
/ess sit坐下axs.essentials.sit
/ess lay躺下axs.essentials.lay
/ess sort整理背包axs.essentials.sort
/ess replant开关自动补种axs.essentials.replant
/ess autotool开关自动工具切换axs.essentials.autotool

配置文件 ​

配置文件位于 plugins/ArcartXSuite/data/essentials/ArcartXEssentials.yml

一键砍树 (TreeCapitator) ​

yaml
tree-capitator:
  enabled: true
  # 需要的权限节点 (留空 = 无需权限)
  permission: "axs.essentials.treecap"
  # 最大连锁方块数
  max-blocks: 128
  # 需要手持斧头
  require-axe: true
  # 需要潜行触发
  require-sneak: false
  # 是否消耗工具耐久
  consume-durability: true
  # 支持的原木类型 (留空 = 所有原木)
  log-types: []
  # 是否同时破坏树叶
  break-leaves: true
  # 树叶搜索范围
  leaf-radius: 4

工作原理：玩家用斧头破坏原木时，自动向上搜索所有连接的原木方块并一次性破坏，模拟"砍倒整棵树"的效果。

背包操作 (InvActions) ​

yaml
inv-actions:
  # 自动补种作物
  auto-replant:
    enabled: true
    permission: "axs.essentials.replant"
    crops:
      - WHEAT
      - CARROTS
      - POTATOES
      - BEETROOTS
      - NETHER_WART
  # 背包整理
  inventory-sort:
    enabled: true
    permission: "axs.essentials.sort"
    sort-mode: type  # type / name / amount
  # 自动工具切换
  auto-tool:
    enabled: true
    permission: "axs.essentials.autotool"
    switch-on-break: true

自动补种：收获成熟作物时自动从背包消耗种子补种。仅成熟作物触发。

背包整理：整理 9-35 槽位（非快捷栏），合并同类物品后按配置的模式排序。

自动工具切换：左键点击方块时自动切换快捷栏中的最佳工具（镐/斧/锹/锄）。

存储 ​

支持 SQLite（默认）和 MySQL，存储传送点、Home、封禁/警告记录等数据。禁言数据由 Chat 模块统一管理。

yaml
storage:
  dialect: sqlite
  sqlite-file: essentials.db
  mysql:
    host: localhost
    port: 3306
    database: arcartxsuite
    username: root
    password: ''
    table-prefix: axs_ess_

跨模块联动 ​

联动模块说明
TabAFK/Vanish 状态变化时刷新 Tab 列表
Chat禁言命令委托 Chat 模块执行（通过 ChatMutable capability）；昵称联动
EventPacket通过 EssentialsQueryable capability 供其他模块查询玩家状态

权限汇总 ​

权限说明默认
axs.essentials.admin管理员面板 UIOP
axs.essentials.treecap一键砍树false
axs.essentials.replant自动补种false
axs.essentials.sort背包整理false
axs.essentials.autotool自动工具切换false
axs.essentials.fly.bypass绕过世界禁飞OP
axs.essentials.interact.bypass绕过交互限制OP

基于 GPL-3.0 许可发布

© 2024-2026 墨墨啊