AntiSweats
一款轻量级的 Bukkit/Spigot 插件,适用于 Minecraft 1.21,允许你限制玩家可以挖掘和携带的物品。专为 Life Series(生存系列)和活动服务器设计,你可以根据游戏阶段来管控资源。
工作原理
你设置会话(sessions),即像 session1、session2、session3 这样的命名阶段。每个会话都有自己的规则。当你准备推进游戏时,只需运行一条命令,活动会话就会瞬间切换。就这么简单。
你可以在会话中设置三种类型的规则:
| 类型 |
示例 |
效果 |
| 方块规则 |
diamond-mining |
禁止任何人挖掘该资源 |
| 挖掘上限 |
diamond-mining-cap |
每位玩家在被切断访问前有一个个人限额 |
| 物品限制 |
limit TNT 20 |
任何人同时持有的某类物品数量不能超过 X |
安装
- 将 jar 文件放入你的
plugins/ 文件夹并启动服务器
- 会自动生成三个文件:
config.yml - 你的实时配置,可通过游戏内命令修改
default-config.yml - 你的出厂默认值,插件永远不会触碰此文件
playerdata.yml - 每位玩家的挖掘计数数据
- 所有命令都需要 OP 权限或
antisweats.admin 权限
命令
Tab 补全适用于所有内容:会话名称、规则名称、材质名称、玩家名称。
会话管理
/as session list
/as session switch <name>
/as session create <name>
/as session delete <name>
/as session reset <name>
/as session info <name>
/as session default
/as session default <name>
各会话命令的详情
/as session list
列出所有会话,并标记当前哪个处于活动状态。
/as session switch <name>
切换活动会话。规则会立即为服务器上的所有人更新。
/as session create <name>
创建一个新的空会话。使用 /as rule add 开始向其添加规则。
/as session delete <name>
永久删除一个会话。你不能删除活动中的会话,请先切换到其他会话。
/as session reset <name>
清除会话中的所有规则,但不删除该会话本身。
/as session info <name>
显示会话中的每个活动规则、上限数值,以及根据会话顺序每个规则的解锁时间。
/as session default
一次性将所有会话恢复到 default-config.yml 中的状态。
/as session default <name>
同上,但仅针对单个会话。
规则管理
/as rule list
/as rule add <session> <rule>
/as rule add <session> <cap-rule> <amount>
/as rule add <session> limit <MATERIAL> <amount>
/as rule remove <session> <rule>
/as rule remove <session> limit <MATERIAL>
各规则命令的详情
/as rule list
显示所有有效的方块和容量规则键,以及物品限制语法的提示。
/as rule add <session> <rule>
添加一个完整的封锁规则。在该会话中,任何人都无法挖掘该资源。
/as rule add session1 diamond-mining
/as rule add session1 gold-mining
/as rule add <session> <cap-rule> <amount>
添加一个按玩家的挖掘上限。他们可以挖掘到你设定的数量,之后就会被阻止。
/as rule add session2 diamond-mining-cap 8
/as rule add session2 gold-mining-cap 24
同一资源的方块规则和容量规则在同一个会话中是互斥的。你不能同时拥有 diamond-mining 和 diamond-mining-cap 这两个活跃规则。
/as rule add <session> limit <MATERIAL> <amount>
限制玩家同时持有的任何物品的数量。适用于任何有效的 Minecraft 材质名称 —— 只需在 limit 后开始输入,Tab 补全会建议剩余部分。
/as rule add session1 limit TNT 20
/as rule add session1 limit ENDER_PEARL 8
/as rule add session2 limit GOLDEN_APPLE 16
/as rule remove <session> <rule>
移除一个方块或容量规则。
/as rule remove <session> limit <MATERIAL>
移除一个物品限制。
玩家管理
/as player info <player>
/as player reset <player>
/as player reset <player> <cap-rule>
各玩家命令的详情
/as player info <player>
显示玩家在活动会话中的当前挖掘计数与其上限的对比。
Mining counts for Steve:
- diamond: 6 / 8
- gold: 19 / 24
/as player reset <player>
将玩家的挖掘计数重置为零。在游戏之间运行此命令。
/as player reset <player> <cap-rule>
仅重置玩家的一项资源。
/as player reset Steve diamond-mining-cap
支持的资源
这些是内置了方块和容量规则支持的资源:
| 资源 |
方块规则 |
容量规则 |
| Diamond |
diamond-mining |
diamond-mining-cap |
| Gold |
gold-mining |
gold-mining-cap |
| Cobweb |
cobweb-mining |
cobweb-mining-cap |
物品限制 (limit <MATERIAL> <amount>) 适用于任何 Minecraft 材质,无需额外设置。
深入解析物品限制
物品限制在三个地方强制执行,以确保没有漏洞:
- 地面拾取 - 支持部分拾取。如果玩家需要再拾取 3 个 TNT 才能达到上限,而走过一堆 64 个的 TNT,他们只会恰好拾取 3 个,剩下的 61 个留在地面上。
- 箱子和容器 - 从任何箱子、潜影盒、末影箱或漏斗中取出物品也会被检查。超出的部分会掉落在玩家脚边。
- 内部库存移动 - 快捷栏和主背包之间的 Shift+点击、拖拽、数字键交换都涵盖在内。
当玩家被阻止拾取某物时,他们会收到一条聊天消息。如果物品仍然在附近,消息会每秒重复一次,直到物品消失或玩家走开。不会刷屏,但他们也不会错过。
典型的游戏设置
以下是一个如何构建三阶段 Life Series 的快速示例:
# 第一阶段 — 完全禁止钻石/黄金,严格限制物品数量
/as rule add session1 diamond-mining
/as rule add session1 gold-mining
/as rule add session1 limit ENDER_PEARL 8
/as rule add session1 limit TNT 20
/as rule add session1 limit GOLDEN_APPLE 16
# 第二阶段 — 解锁挖矿但设有上限
/as rule add session2 diamond-mining-cap 8
/as rule add session2 gold-mining-cap 24
/as rule add session2 limit ENDER_PEARL 8
/as rule add session2 limit TNT 20
/as rule add session2 limit GOLDEN_APPLE 16
# 第三阶段 — 无挖矿限制,仅保留物品数量限制
/as rule add session3 limit ENDER_PEARL 8
/as rule add session3 limit TNT 20
然后在游戏过程中:
/as session switch session1 ← 游戏开始
/as session switch session2 ← 游戏中期
/as session switch session3 ← 游戏后期
一些值得了解的事项
- 挖矿计数会跨阶段累计。 如果玩家在
session1 中挖了 5 颗钻石,这 5 颗仍会计入他们在 session2 中的上限。在游戏之间运行 /as player reset <player>。
- 爆炸保护是自动的。 任何具有活跃方块或上限规则的资源都会受到 TNT 和苦力怕的保护,无法通过炸开地面来绕过限制。
default-config.yml 供你编辑。 它是 /as session default 命令的参考文件。插件永远不会写入该文件,因此你在其中放置的内容就是会被恢复的内容。编辑后无需重启,只需运行命令即可。
config.yml 中的 session-order 控制玩家被阻止时看到的解锁消息。请按照游戏实际进行的顺序排列,这样消息将始终保持准确。
AntiSweats
A lightweight Bukkit/Spigot plugin for Minecraft 1.21 that lets you restrict what players can mine and carry. Built for a Life Series and event servers where you want to gate resources by game phase.
How it works
You set up sessions, named phases like session1, session2, session3. Each session has its own rules. When you're ready to move the game forward, you run one command and the active session switches instantly. That's it.
There are three types of rules you can put in a session:
| Type |
Example |
Effect |
| Block rule |
diamond-mining |
Nobody mines that resource, period |
| Mining cap |
diamond-mining-cap |
Each player gets a personal limit before they're cut off |
| Item limit |
limit TNT 20 |
Nobody holds more than X of an item at once |
Installation
- Drop the jar into your
plugins/ folder and start the server
- Three files get generated automatically:
config.yml - your live config, modified by in-game commands
default-config.yml - your factory defaults, never touched by the plugin
playerdata.yml - per-player mining counts
- All commands require OP or the
antisweats.admin permission
Commands
Tab completion works on everything: session names, rule names, material names, player names.
Session management
/as session list
/as session switch <name>
/as session create <name>
/as session delete <name>
/as session reset <name>
/as session info <name>
/as session default
/as session default <name>
Details for each session command
/as session list
Lists every session and marks which one is currently active.
/as session switch <name>
Switches the active session. Rules update immediately for everyone on the server.
/as session create <name>
Creates a new empty session. Start adding rules to it with /as rule add.
/as session delete <name>
Permanently deletes a session. You can't delete the active one, switch away first.
/as session reset <name>
Wipes all rules from a session without deleting it.
/as session info <name>
Shows every active rule in a session, cap amounts, and when each rule unlocks based on your session order.
/as session default
Restores every session at once back to what's in default-config.yml.
/as session default <name>
Same thing but for a single session.
Rule management
/as rule list
/as rule add <session> <rule>
/as rule add <session> <cap-rule> <amount>
/as rule add <session> limit <MATERIAL> <amount>
/as rule remove <session> <rule>
/as rule remove <session> limit <MATERIAL>
Details for each rule command
/as rule list
Shows all valid block and cap rule keys, plus a reminder of the item limit syntax.
/as rule add <session> <rule>
Adds a full block rule. Nobody in that session can mine the resource.
/as rule add session1 diamond-mining
/as rule add session1 gold-mining
/as rule add <session> <cap-rule> <amount>
Adds a per-player mining cap. They can mine up to the number you set, then they're blocked.
/as rule add session2 diamond-mining-cap 8
/as rule add session2 gold-mining-cap 24
Block and cap rules for the same resource are mutually exclusive within a session. You can't have diamond-mining and diamond-mining-cap active at the same time.
/as rule add <session> limit <MATERIAL> <amount>
Caps how much of any item a player can hold at once. Works with any valid Minecraft material name — just start typing after limit and tab completion will suggest the rest.
/as rule add session1 limit TNT 20
/as rule add session1 limit ENDER_PEARL 8
/as rule add session2 limit GOLDEN_APPLE 16
/as rule remove <session> <rule>
Removes a block or cap rule.
/as rule remove <session> limit <MATERIAL>
Removes an item limit.
Player management
/as player info <player>
/as player reset <player>
/as player reset <player> <cap-rule>
Details for each player command
/as player info <player>
Shows a player's current mining counts vs. their cap for the active session.
Mining counts for Steve:
- diamond: 6 / 8
- gold: 19 / 24
/as player reset <player>
Resets all mining counts for a player to zero. Run this between games.
/as player reset <player> <cap-rule>
Resets just one resource for a player.
/as player reset Steve diamond-mining-cap
Supported resources
These are the resources with built-in block and cap rule support:
| Resource |
Block rule |
Cap rule |
| Diamond |
diamond-mining |
diamond-mining-cap |
| Gold |
gold-mining |
gold-mining-cap |
| Cobweb |
cobweb-mining |
cobweb-mining-cap |
Item limits (limit <MATERIAL> <amount>) work with any Minecraft material with no extra setup.
Item limits in depth
Item limits are enforced in three places so there are no loopholes:
- Ground pickup - partial pickup is supported. If a player needs 3 more TNT to hit the cap and walks over a stack of 64, they pick up exactly 3 and the other 61 stay on the ground.
- Chests and containers - taking items from any chest, shulker box, ender chest, or hopper is checked too. Excess gets dropped at the player's feet.
- Internal inventory moves - shift-clicking between hotbar and main inventory, dragging, number-key swaps, all covered.
When a player gets blocked from picking something up, they get a chat message. If the item is still nearby, the message repeats once per second until it's gone or they walk away. No spam, but they won't miss it either.
Typical game setup
Here's a quick example of how you'd structure a three-phase Life Series:
# Phase 1 — no diamond/gold at all, strict item limits
/as rule add session1 diamond-mining
/as rule add session1 gold-mining
/as rule add session1 limit ENDER_PEARL 8
/as rule add session1 limit TNT 20
/as rule add session1 limit GOLDEN_APPLE 16
# Phase 2 — mining unlocks but is capped
/as rule add session2 diamond-mining-cap 8
/as rule add session2 gold-mining-cap 24
/as rule add session2 limit ENDER_PEARL 8
/as rule add session2 limit TNT 20
/as rule add session2 limit GOLDEN_APPLE 16
# Phase 3 — no mining restrictions, only item limits
/as rule add session3 limit ENDER_PEARL 8
/as rule add session3 limit TNT 20
Then during the game:
/as session switch session1 ← game starts
/as session switch session2 ← mid game
/as session switch session3 ← late game
A few things worth knowing
- Mining counts carry across sessions. If a player mines 5 diamonds in session1, those 5 still count toward their cap in session2. Run
/as player reset <player> between games.
- Explosion protection is automatic. Any resource with an active block or cap rule is also protected from TNT and creepers, no bypassing restrictions by blowing up the ground.
default-config.yml is yours to edit. It's the reference file for /as session default. The plugin never writes to it, so whatever you put in there is what gets restored. No restart needed after editing it, just run the command.
session-order in config.yml controls the unlock message players see when they're blocked. Keep it in the order your game actually progresses and the messages will always be accurate.
评论 0
登录后参与评分
还没有评论,来抢沙发吧