NoBats

A lightweight Minecraft server optimization plugin that prevents bats from spawning, freeing up natural mob cap slots.

中文介绍见下方 / Chinese docs below.

Why?

Bats are among the least valuable passive mobs in Minecraft: they drop nothing, attack nothing, and only add noise. Every bat occupies a slot in the natural mob cap (ambient category) and is a full entity participating in per-tick AI and entity tracking. Removing them releases those slots to more valuable mobs and trims per-tick entity overhead.

How it works

The plugin ships with exactly one listener. It cancels CreatureSpawnEvent whenever the spawned entity is a Bat.

Why it costs (almost) nothing

• Listens only to CreatureSpawnEvent (mob spawns), naturally filtering out items, XP orbs, and projectiles
• The check is a single instanceof Bat — nanosecond scale
• Stateless: no scheduled tasks, no caches, no extra threads
• Registers at EventPriority.LOWEST to cancel as early as possible

Compatibility

Folia	26.2+ (folia-supported: true)
Paper	fully backward compatible — thread-safe by design
Java	21+ (built with Java 25)

Installation

1. Drop NoBats-1.0.0.jar into your server's plugins/ folder
2. Restart the server (or run /reload confirm)

Notes

The plugin prevents new spawns. A handful of bats already loaded in chunks are not removed instantly; they despawn through vanilla mechanics instead. This is the deliberate trade-off of staying stateless and zero-scheduling.

Source & License

• Source: github.com/tiancuocuo/nobats
• License: MIT

---

中文介绍

轻量的 Minecraft 服务端优化插件：阻止蝙蝠生成，释放自然刷怪池名额。

工作原理

插件只有一个监听器：监听 CreatureSpawnEvent，当生成实体是 Bat 时取消。只监听生物生成事件，天然过滤掉落物、经验球等非生物实体；判断只有一次 instanceof Bat，纳秒级；无状态、无定时任务、无额外线程；注册在 EventPriority.LOWEST 尽早取消。

兼容性

• Folia 26.2+（folia-supported: true）
• Paper 完全向下兼容，天然线程安全
• Java 21+（使用 Java 25 构建）

安装

1. 把 NoBats-1.0.0.jar 放进服务端 plugins/ 目录
2. 重启服务端（或执行 /reload confirm）

说明

插件负责阻止新生成。已加载在区块里的少量蝙蝠不会立即移除，而是按 MC 原生机制自然消失。这是保持插件无状态、零调度的刻意取舍。

源码与许可证

• 源码：github.com/tiancuocuo/nobats
• 许可证：MIT