MKT基础知识

MKT基础知识

一个为NeoForge提供许多基础工具的服务器端实用模组

MKT基础知识预览查看大图

MKT Essentials

一个全面的、一体化的 NeoForge 1.21.1 服务端实用模组。运行 Minecraft 服务器所需的一切——传送、富文本聊天、装饰、管理、认证、Discord 桥接、物品栏备份等等——都在这一个轻量级包中。玩家使用原版客户端即可加入，无需安装任何东西。

✨ 为什么选择 MKT Essentials？

  • 一体化 —— 用一个模组取代一堆独立的模组。
  • 仅服务端 —— 兼容原版客户端。
  • 自给自足 —— Tab 列表、名牌、MOTD 和占位符均为原生功能；无需配套模组。
  • 完全可配置 —— 简洁的 YAML，可单独开关每个命令，提供英文和波兰语语言文件。
  • 基于权限 —— 每个命令都有对应的权限节点；与 LuckPerms 完美配合。

💬 富文本聊天

  • Markdown 格式 —— *斜体*、**粗体**、<span style="text-decoration: underline;">下划线</span>、~~删除线~~、??矩阵?? —— 可在聊天、铁砧/书/告示牌文本中使用
  • 交互式聊天 —— 可点击的 URL、:emoji: 短代码，以及悬停显示的 ||剧透||
  • 内联物体 —— [item] 显示你手持的物品（带提示框），<head> 显示你的玩家头颅
  • 提及 —— @玩家名 会高亮并提醒对方；可通过 /mentions 关闭
  • 个人聊天颜色 —— /chatcolor
  • 聊天设置 GUI —— /chatsetting，以及忽略列表菜单
  • 本地/按世界聊天 —— 仅限附近玩家或按世界发送消息，并带全局前缀
  • 角色扮演、匿名与直播 —— /me、/do、/anon、/stream，以及 /symbol 符号

🎨 装饰与显示

  • 昵称 —— /nick 会显示在聊天、Tab 列表以及玩家头顶（保留皮肤）
  • 原生 Tab 列表 —— 自定义页眉/页脚、动画、可选的延迟列
  • 头顶名牌 —— 通过计分板队伍显示等级前缀/后缀
  • 名字下方数值、侧边栏计分板与 Boss 栏 —— 占位符 + 动画
  • 服务器标识 —— 自定义 F3 调试屏幕上的服务器名称
  • 欢迎问候语 —— 个性化的加入消息，可将玩家的皮肤头像渲染为像素画
  • MOTD 与服务器图标 —— 设置服务器列表的描述和图标，并支持独立维护 MOTD

🔗 Discord 集成

内置 JDA 机器人 —— 无需外部插件：

  • 账号关联 —— 在游戏中生成 6 位验证码，通过 Discord 斜杠命令验证；可选关联角色
  • 双向聊天转发 —— 游戏内聊天和加入/离开消息镜像到 Discord 频道（通过 Webhook 头像显示每位玩家的名字和皮肤）；频道消息会显示在游戏中
  • 实时状态 —— 机器人显示当前在线玩家数量
  • 默认安全 —— 阻止来自游戏的 @everyone 提及，双向净化颜色代码

Discord 功能需要 KotlinForForge 模组。

🔨 管理

  • 封禁 / 临时封禁 / 解封 —— 时长解析（1d12h、30m），以及带理由和时间的封禁界面
  • IP 封禁 —— /banip、/unbanip（可通过最后已知 IP 封禁离线玩家）
  • 禁言 / 临时禁言 / 解除禁言 —— 限时或永久，支持离线玩家
  • 警告 —— /warn，达到可配置次数后自动升级为临时封禁
  • 历史记录 —— /history 完整处罚记录
  • 影封 —— 4 种方式，包括幽灵完全隔离：被封玩家进入一个空世界，看不见任何人，也没人看得见他，无法聊天，并在语音聊天中被静默禁言

🔐 认证

  • 5 种模式 —— 完整、仅认证、仅关联、可选、禁用
  • 注册与登录 —— bcrypt 加密密码
  • 冻结系统 —— 未认证玩家无法移动、交互或聊天
  • 新手保护 —— 首次游玩玩家的无敌时间窗口
  • 会话管理 —— 同一 IP 在超时时间内自动登录
  • 可选的网页同步 —— 与外部网站/后端双向同步

🏠 传送

  • 通过 LuckPerms 设置家园的按等级数量限制（mktessentials.homes.<数量>）
  • 传送点（可点击 GUI）、TPA、RTP（异步、生物群系黑名单、安全落地）
  • /back（死亡后可用）、Spawn、Top、TpAll
  • 按类型冷却 —— TPA、RTP 和传送点使用独立的冷却计时器

📦 礼包与物品

  • 礼包 —— 可通过箱子 GUI 或从物品栏创建，每个礼包独立冷却，可点击的 /kits 浏览器
  • 虚拟工作台 —— /workbench、/anvil、/grindstone、/stonecutter、/smithing，以及 /trash

💾 物品栏备份

  • 死亡/加入/退出时自动备份，可选的定时备份，GUI 浏览器，支持 Curios

🧹 物品清理器

  • 自动消失并带全息倒计时、实体堆叠、白名单（模组物品及通配符）、手动清理

🛡️ 管理与实用工具

  • 飞行 / 无敌 / 隐身（持久化）、游戏模式快捷键、/invsee 与 /enderchest（离线玩家 + Curios）、 /speed、/repair、/enchant、/exp、/whois、/geolocate、/sudo、/tps 与 /lag
  • 自动广播、配置定义的文本命令、邮件、投票、按玩家的时间/天气设置

🔗 可选集成

自动检测 —— 安装即启用，缺失即忽略。

模组 提供功能
LuckPerms 权限、前缀/后缀、按组聊天
Text Placeholder API 聊天/Tab 中的 %mktessentials:*% 占位符
TAB MKT 的原生 Tab/名牌让位给 TAB 管理
MiniMOTD MKT 的 MOTD 让位
SkinsRestorer 欢迎头像使用玩家的 SkinsRestorer 皮肤
Plasmo Voice / Simple Voice Chat 游戏内禁言同时会禁言语音聊天
Curios API /invsee 和备份中的 Curios 槽位

该模组在没有以上任何模组时也能完美运行。

⚠️ 兼容性说明

📋 环境要求

  • Minecraft 1.21.1 · NeoForge 21.1.228+ · Java 21

🔒 权限

每个命令都有对应的权限节点（mktessentials.command.home、mktessentials.admin.fly、 mktessentials.moderation.ban 等）。游戏内可通过 /mkt permissions 查看完整列表。部分限制可通过 LuckPerms 按等级缩放（家园数量限制、按类型的传送冷却）。

📄 链接