Just Essentials

Just Essentials

模块化服务器端管理套件，提供工作人员工具、审核、传送、审计、Discord集成及安全玩家管理功能。

Just Essentials

Just Essentials 是一个为 Minecraft 1.21.1 的 NeoForge 设计的模块化、服务端管理及实用模组。玩家无需安装它。服务器必须安装 Just Core 0.2.0 或更新版本。

将 Just Core 和 Just Essentials 的 JAR 文件都放入服务器的 mods 文件夹中。如果需要隐身（Vanish）集成，请另行安装 Just Vanish。

完整的安装、命令、权限、配置、集成和故障排除信息，请参阅 Just Essentials Wiki。

0.1.0 版本已实现功能

  • /staffchat <消息> 和 /sc <消息>
  • /stp <玩家> — 静默管理员传送
  • /history <玩家> — 持久的审计历史
  • /jkick <玩家> <原因>
  • /jban <玩家> <原因>
  • /heal [玩家]
  • /feed [玩家]
  • /fly [玩家]
  • /god [玩家]
  • /spawn
  • /back
  • /invsee <玩家> - 实时查看物品栏、盔甲和副手
  • /endersee <玩家> - 实时查看末影箱
  • /invseeoffline <玩家> - 只读查看离线玩家的已保存物品栏
  • /enderseeoffline <玩家> - 只读查看离线玩家的已保存末影箱
  • /curiossee <玩家> - 实时查看 Curios 插槽（也通过其 Curios 兼容层支持 Accessories）
  • /accessoriessee <玩家> - 绕过兼容层，直接通过 Accessories API 查看
  • /mute <玩家> 和 /unmute <玩家>
  • /freeze <玩家> 和 /unfreeze <玩家>
  • /staffmode - 切换飞行、神模式和员工频道模式，同时保留先前状态
  • /staffchattoggle - 将普通聊天消息路由到私密员工频道
  • /discordtest - 验证并发送一个 Discord Webhook 测试
  • /tempmute <玩家> <时长> <原因>
  • /tempfreeze <玩家> <时长> <原因>
  • /tempban <玩家> <时长> <原因>
  • /punishments <玩家> 和 /punishmentinfo <玩家>
  • /junban <玩家> - 带审计的解封
  • /sethome <名称>、/home <名称> 和 /delhome <名称>
  • /setwarp <名称>、/warp <名称> 和 /delwarp <名称>
  • /tpa <玩家>、/tpaccept 和 /tpdeny
  • 原生的 NeoForge 权限节点，并附有操作员级别的后备方案
  • 可独立配置的功能模块
  • 可选的异步 Discord 审计嵌入，用于记录管理行为和员工操作

Discord 审计日志

启动服务器一次，然后编辑 config/justessentials-server.toml：

[discord]
enabled = true
webhookUrl = "https://discord.com/api/webhooks/..."
username = "Just Essentials"
logStaffChat = false

[discord.channels]
activityWebhookUrl = "" # 共享的加入/离开频道
joinWebhookUrl = ""     # 可选的仅加入覆盖
leaveWebhookUrl = ""    # 可选的仅离开覆盖
moderationWebhookUrl = ""
inspectionWebhookUrl = ""
staffWebhookUrl = ""

[discord.events]
joins = true
leaves = true
moderation = true
inspections = true
staffActions = true

[discord.branding]
serverName = "My Server"
thumbnailUrl = "https://example.com/server-icon.png"
imageUrl = ""
footerText = "My Server Staff Logs"
usePlayerAvatars = true

每个特定类别的 URL 都是可选的，并会回退到 webhookUrl。加入和离开的 URL 首先回退到 activityWebhookUrl，允许您使用一个活动频道或两个独立的频道。重启服务器并运行 /discordtest。Webhook 仅保存在服务器配置中；切勿提交该文件或分享其 URL。出于隐私考虑，员工聊天记录默认是禁用的。

计划中功能

  • 离线物品栏查看
  • 原生 Accessories API 适配器（不依赖其兼容层）
  • 完整的消息本地化/自定义化及多人游戏回归测试

员工工具

员工模式会将员工的完整物品栏安全地存储在持久的玩家数据中，并提供一个临时工具快捷栏：

  • 指南针：传送到一名随机的在线玩家
  • 箱子：右键点击一名玩家以查看其物品栏
  • 烈焰棒：右键点击一名玩家以冻结或解冻
  • 屏障：退出员工模式并恢复原始物品栏

如果在员工模式激活时服务器重启，则保存的物品栏仍然可用，并在员工模式关闭时恢复。

当安装了 Just Vanish 1.2.0+ 时，员工模式会自动使用其公共 API：它会记住员工之前的隐身状态，在进入时启用隐身，并在退出时恢复之前的状态。此集成完全在 Just Essentials 中实现，并可通过 integrations.justVanish.staffModeVanish 进行配置。

消息和菜单自定义

服务器配置包含 [messages]、[menus] 和 [staffTools] 部分。文本支持经典的 & 颜色/样式代码和诸如 {player}、{reason}、{type} 和 {expires} 之类的占位符。您可以自定义全局前缀、管理通知、TPA 消息、员工模式消息、菜单标题、工具名称，或完全禁用员工快捷栏。NeoForge 会监视配置文件；/jereload 可确认当前值已生效。

可选的服务器端自定义 TAB 列表在 [tabList] 下配置。其页眉和页脚支持多行、& 颜色/样式代码以及 {player}、{online}、{max}、{visible} 和 {vanished}。当安装了 Just Vanish 时，每个查看者的可见计数都会单独计算，绝不会暴露隐藏的员工。

TAB 文本还支持 RGB 颜色（例如 &#AA54F4）、通过 {animation:info} 和 {animation:bar} 实现的动画，以及 {world}、{ping}、{time}、{date} 和 {uptime}。玩家列表名称和可选的配套 Boss 血条都可配置，无需客户端模组。请参阅 TAB 配置。

玩家可以通过 /tab on|off|toggle|status 和 /tab bossbar on|off|toggle 来控制显示效果。模板还支持 {health}、{food}、{x}、{y}、{z}、{tps} 和 {mspt}，管理员可以在选定的维度中禁用此显示。

加入和离开消息

启用 modules.customJoinLeaveMessages 以替换原版的加入和离开公告。activityMessages.joinMessage 和 activityMessages.leaveMessage 支持 &/HEX 颜色以及 {player}、{online}、{max} 和 {world}。每个公告都可以独立禁用，空白模板将完全隐藏它。当安装了 Just Vanish 时，未授权的查看者永远不会收到关于隐身员工的公告。

当 activityMessages.staffAlwaysSeesMessages = true 时，持有 justessentials.staff.activity 权限的玩家仍能收到隐藏的公告，包括隐身玩家的活动。默认情况下，该权限回退到操作员级别 2。

离线查看使用一个受保护的快照菜单：对已保存槽位的点击以及所有 Shift 点击转移都会在服务器端被拒绝。它绝不会写入玩家数据。

管理与安全传送

传送命令支持安全目的地检查、可配置的冷却时间和移动取消的引导时间。管理发现功能包括 /je help、/homes、/warps、/seen、/whois、/warn、/warnings 和 /activitytest。

TAB 配置文件可以使用不同的下界和末地页眉/页脚、可配置的权限级别组前缀，以及用于即时查看的 /tab preview。

环境要求

  • Minecraft 1.21.1
  • NeoForge 21.1.x
  • Java 21

官方发布渠道

官方编译版本通过 CurseForge 和 Modrinth 发布。GitHub 用于文档、问题报告、安全审查和兼容性评估。

许可证

版权所有 © 2026 Yo_Fred。保留所有权利。官方编译版本可在服务器上使用。未经事先书面许可，禁止重新使用源码、修改、再分发、制作衍生作品和商业利用。请参阅 LICENSE。