🛡️ ForgeModBlocker 是一款可配置的插件，允许您控制 Spigot 服务器上 Forge Mods 的使用，您可以选择允许或禁止玩家使用特定的 Forge 模组。它是同类产品中第一个完全可定制且完全免费的插件。

🛡️ ForgeModBlocker

⚙️ 依赖

ForgeModBlocker 运行时不再需要任何插件依赖！

但 ForgeModBlocker 至少需要 Java 8 才能运行。如果您的服务器还在使用 Java 7，请尽快更新。

⚙️ 配置

以下是插件的当前配置文件：

# The action to be performed on players using a disallowed mod
# Valid actions:
#   KICK - Kicks the player
#   BAN - Bans the player
#   NONE - Does nothing
action: KICK

# The kick message to be displayed to players using a disallowed mod
kick_message: '&cYou are using a disallowed mod!'

# The ban message to be displayed to players using a disallowed mod
ban_message: 'You have been banned for using a disallowed mod!'

# Whether or not the action should only be performed if the player doesn't have the "fmb.bypass" permission
# Set this to true if you want to allow certain players to use disallowed mods
bypass_permission: false

# Whether or not players should be able to use Forge at all.
# If set to true, any player using Forge will be affected by the selected action.
# If set to false, only the mods in the "mods" list will be checked.
block_forge: false

# Whether or not to perform the action async.
# If set to true, the action will be performed async.
# If set to false, the action will be performed sync.
# Only set this to true if you know what you are doing.
action_async: false

# The list of mods to be checked for.
# To find a mod's ID, open Forge with the mod installed, click "Mods" on the title screen, find the mod and look at the "Mod ID" field.
# Mod IDs are case sensitive.
mods:
  - examplemodid

# The list of mods to be whitelisted.
# This list overrides the blacklist.
# If a mod is in both the whitelist and the blacklist, it will be whitelisted.
whitelist: []

# Should the plugin attempt to download updates automatically?
auto_update: true

如果更新对配置进行了添加，您需要在安装更新时删除您的配置文件。它将被重新生成，并包含新的选项。

🚫 屏蔽模组

要将模组添加到配置文件的模组列表中，您必须找到其模组 ID。您可以通过以下方式找到模组 ID：打开 Forge，点击主屏幕上的“Mods”，找到该模组，并查看“Mod ID”字段：

模组 ID 区分大小写。

还有一些通过充当 Forge 模组来工作的作弊客户端。如果您将这些模组添加到配置中，您可以可靠地封禁他们。

✨ 功能特性

• 可配置：选择任意数量的模组进行白名单或黑名单设置，并决定当玩家使用不允许的模组时会发生什么。
• 轻量级：ForgeModBlocker 不会对您的服务器性能产生任何影响。
• 跨版本兼容：ForgeModBlocker 将在所有 Spigot 1.8.8 及更高版本上运行，并且很可能会自动支持任何未来版本。
• 免费：与目前市面上的其他 Forge 模组检测器不同，这是唯一完全可配置和定制的 Forge 模组屏蔽器，所有功能均可免费使用！

⌨️ 命令和权限

• /fmb：主命令，显示模组版本并列出子命令。
权限：fmb.main_command
• /fmb reload：重新加载插件。
权限：fmb.reload_command
• /mods <player>：列出玩家加载的模组。
权限：fmb.mods_command

🔑 其他权限

• fmb.*：授予所有插件权限。默认情况下，此权限不授予给 OP 玩家。
• fmb.update_notification：拥有此权限的玩家将收到可用插件更新的通知。
• fmb.bypass：拥有此权限的用户将免受模组白名单/黑名单的限制。默认情况下，此权限不授予给 OP 玩家。

📝 补充说明

• ForgeModBlocker 使用自动更新系统，使您无需执行任何操作即可保持插件为最新版本！当有新更新可用时，拥有“fmb.update_notification”权限的玩家将收到警报，并且插件将尝试下载它。
• 如果插件更新无法下载，插件将重新尝试下载两次，然后放弃。拥有权限的玩家将收到警报，告知他们有新版本可用。
• 该插件还使用 bStats 来记录有关运行该插件的服务器的指标。不会记录诸如您的服务器 IP 之类的信息。如果您确实不想贡献服务器中的指标，则可以通过打开 /plugins/bStats/config.yml 文件并将“enabled”设置为 false 来禁用它们。
• 玩家加入后，在检测到他们的模组并在他们身上执行命令（如果需要）之前，会有一个小延迟。不幸的是，不可能完全消除此延迟并仍然检测到玩家的模组。
• 最后，虽然 ForgeModBlocker 将以 100% 的准确率检测到用户的模组，但在多种无法阻止的方式中，有可能绕过该系统。

🔌 PlaceholderAPI

除了以上所有功能外，如果您的服务器上安装了 PlaceholderAPI，ForgeModBlocker 还可以连接到 PlaceholderAPI。

占位符在“forgemodblocker”ID 下注册。

可用的占位符：

• forge：玩家是否正在使用 forge - 返回“true”或“false”
• mods：玩家正在使用的所有模组 - 例如：FML, mcp, Forge

🔮 未来特性

• 开发者 API

如果您对 ForgeModBlocker 的任何新功能有任何想法，请在“讨论”选项卡或评论中提出建议。

👨‍💻 源代码和许可证

该项目的源代码可以在我的 GitHub 上找到：

https://github.com/Mas281/ForgeModBlocker

任何代码问题/建议都应通过 Issues 或 Pull Requests 提出。

ForgeModBlocker 项目在 Mozilla Public License 2.0 下获得许可。

简单条款：

• 如果您希望使用我的插件中的代码，可以，前提是您留下署名和指向原始项目的链接。
• 如果您使用我的代码并进行任何更改，那没关系，只要您再次留下署名，并开源您所做的更改。

⭐ 评论

评论不是抱怨错误的地方，它们是建设性的反馈。鼓励所有建设性和有用的评论。

如果您通过 PM 将错误发送给我或在“讨论”选项卡中发送它们，则可以更快地修复错误。