⚡ 什么是 LightBans?
LightBans 是一款用于 Paper 的服务端管理插件,用于管理处罚、调查关联账号以及保留清晰的管理操作记录。它将处罚和玩家历史记录存储在本地 SQLite 数据库中,数据库操作在主服务器线程之外处理。
?️ 功能
处罚
- Ban(封禁)和 tempban(临时封禁)玩家,支持可配置的持续时间格式
- IP ban(IP 封禁)账号以阻止来自共享 IP 的连接
- Mute(禁言)和 tempmute(临时禁言)玩家,并显示剩余时间消息
- IP mute(IP 禁言)共享同一 IP 的账号
- Kick(踢出)和 warn(警告)玩家
- 配置禁言玩家无法使用的命令,例如
/msg
规避警报与关联账号
- 使用
/alts查看通过 IP 关联的账号 - 从控制台使用
/dupeip检查重复 IP 的历史记录 - 当关联账号连接时接收封禁或禁言规避警报
- 警报中显示的关联账号名称会根据在线/离线状态及处罚状态着色
- 警报发送给拥有相应封禁或禁言权限的在线工作人员
历史与管理菜单
- Ban history(封禁历史)和 mute history(禁言历史)菜单显示当前有效的处罚,并允许工作人员确认撤销
- User history(用户历史)显示玩家的已记录处罚历史
/mod <player>打开包含传送、击杀、冻结、踢出和禁言等操作的管理菜单
Discord Webhook
- 将处罚、踢出和撤销通知发送到 Discord
- 使用简洁的嵌入消息,结构化展示玩家、管理员、原因、过期时间和案件字段
- 配置统一的嵌入颜色及可自定义的字段标签
自定义
- 在
messages.yml中自定义面向玩家的消息、广播、工作人员警报和处罚界面 - 在
config.yml中配置持续时间后缀和禁言拦截的命令 - 在
discord.yml中配置 Webhook URL、颜色和嵌入标题 - 配置自动警告禁言及其持续时间
⏱️ 持续时间格式
持续时间可以使用短后缀或长后缀,包括 s、min、hour、day、week、month 和 year,支持复数形式。
示例:30s、10minutes、2weeks、1month。可以组合多个单位,例如 1week2days。
? 命令
| 命令 | 描述 | 权限 |
|---|---|---|
/ban <player> [duration] <reason> |
封禁玩家,永久或设定持续时间 | lightbans.ban |
/tempban <player> <duration> <reason> |
临时封禁玩家 | lightbans.tempban |
/ipban <player> [duration] <reason> |
IP 封禁玩家 | lightbans.ipban |
/mute <player> [duration] <reason> |
禁言玩家,永久或设定持续时间 | lightbans.mute |
/tempmute <player> <duration> <reason> |
临时禁言玩家 | lightbans.tempmute |
/muteip <player> [duration] <reason> |
IP 禁言玩家 | lightbans.muteip |
/kick <player> <reason> |
踢出在线玩家 | lightbans.kick |
/warn <player> <reason> |
警告玩家 | lightbans.warn |
/unban <player> [reason] |
撤销玩家的封禁 | lightbans.unban |
/unbanip <player> [reason] |
撤销与玩家或其记录的 IP 关联的 IP 封禁 | lightbans.unbanip |
/unmute <player> [reason] |
撤销玩家的禁言 | lightbans.unmute |
/unmuteip <player> [reason] |
撤销与玩家或其记录的 IP 关联的 IP 禁言 | lightbans.unmuteip |
/unwarn <player> [reason] |
撤销玩家的警告 | lightbans.unwarn |
/alts <player> |
列出记录在同一 IP 上的账号 | lightbans.alts |
/dupeip <player> |
显示重复 IP 历史记录;仅限控制台 | lightbans.dupeip |
/history <player> [page] |
查看玩家的处罚历史 | lightbans.history |
/check <player> [page] |
检查玩家当前的有效处罚 | lightbans.check |
/banhistory [page] |
打开当前封禁历史 | lightbans.banhistory |
/mutehistory [page] |
打开当前禁言历史 | lightbans.mutehistory |
/userhistory <player> [page] |
打开玩家的历史菜单 | lightbans.userhistory |
/mod <player> |
打开管理菜单 | lightbans.mod |
/lightbans reload |
重新加载插件配置 | lightbans.admin |
? 权限节点
LightBans 为每个命令提供独立的权限节点,如上表所示。lightbans.mod 权限授予访问管理菜单的权限,lightbans.admin 权限授予 /lightbans reload 的权限。
? 兼容性
专为 Paper 1.21 及更高版本构建。服务器必须运行兼容的 Java 版本。
⚡ What is LightBans?
LightBans is a Paper moderation plugin for managing punishments, investigating linked accounts, and keeping a clear record of moderation actions. It stores punishment and player history in a local SQLite database, with database work handled off the main server thread.
?️ Features
Punishments
- Ban and tempban players, with configurable duration formats
- IP ban accounts to block connections from a shared IP
- Mute and tempmute players, with remaining-time messages
- IP mute accounts sharing an IP
- Kick and warn players
- Configure commands that muted players cannot use, such as
/msg
Evasion alerts and linked accounts
- See accounts linked by IP with
/alts - Check duplicate IP history with
/dupeipfrom the console - Receive ban or mute evasion alerts when a linked account connects
- Alerts show linked account names colored by online/offline and punishment status
- Alerts are sent to online staff with the relevant ban or mute permissions
History and moderation menus
- Ban history and mute history menus show active punishments and let staff confirm revocations
- User history shows a player's recorded punishment history
/mod <player>opens a moderation menu with teleport, kill, freeze, kick, and mute actions
Discord webhooks
- Send punishment, kick, and revocation notifications to Discord
- Use clean embeds with structured player, moderator, reason, expiry, and case fields
- Configure one shared embed color and customizable field labels
Customization
- Customize player-facing messages, broadcasts, staff alerts, and punishment screens in
messages.yml - Configure duration suffixes and mute-blocked commands in
config.yml - Configure webhook URL, color, and embed titles in
discord.yml - Configure automatic warning mutes and their durations
⏱️ Duration formats
Durations can use short or long suffixes, including s, min, hour, day, week, month, and year, with plural forms supported.
Examples: 30s, 10minutes, 2weeks, 1month. Multiple units can be combined, such as 1week2days.
? Commands
| Command | Description | Permission |
|---|---|---|
/ban <player> [duration] <reason> |
Ban a player, permanently or for a set duration | lightbans.ban |
/tempban <player> <duration> <reason> |
Temporarily ban a player | lightbans.tempban |
/ipban <player> [duration] <reason> |
IP ban a player | lightbans.ipban |
/mute <player> [duration] <reason> |
Mute a player, permanently or for a set duration | lightbans.mute |
/tempmute <player> <duration> <reason> |
Temporarily mute a player | lightbans.tempmute |
/muteip <player> [duration] <reason> |
IP mute a player | lightbans.muteip |
/kick <player> <reason> |
Kick an online player | lightbans.kick |
/warn <player> <reason> |
Warn a player | lightbans.warn |
/unban <player> [reason] |
Revoke bans for a player | lightbans.unban |
/unbanip <player> [reason] |
Revoke IP bans associated with a player or their recorded IP | lightbans.unbanip |
/unmute <player> [reason] |
Revoke mutes for a player | lightbans.unmute |
/unmuteip <player> [reason] |
Revoke IP mutes associated with a player or their recorded IP | lightbans.unmuteip |
/unwarn <player> [reason] |
Revoke a player's warnings | lightbans.unwarn |
/alts <player> |
List accounts recorded on the same IP | lightbans.alts |
/dupeip <player> |
Show duplicate-IP history; console only | lightbans.dupeip |
/history <player> [page] |
View a player's punishment history | lightbans.history |
/check <player> [page] |
Check a player's active punishments | lightbans.check |
/banhistory [page] |
Open active ban history | lightbans.banhistory |
/mutehistory [page] |
Open active mute history | lightbans.mutehistory |
/userhistory <player> [page] |
Open a player's history menu | lightbans.userhistory |
/mod <player> |
Open the moderation menu | lightbans.mod |
/lightbans reload |
Reload the plugin configuration | lightbans.admin |
? Permission nodes
LightBans provides separate permission nodes for each command, listed in the command table above. The lightbans.mod permission grants access to the moderation menu, and lightbans.admin grants access to /lightbans reload.
? Compatibility
Built for Paper 1.21 and newer. The server must run a compatible Java version.
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 LightBans
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
改进了格式在禁言期间添加了被禁止的命令(config.yml)
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧