原创 世界管理 [Mohist可用] 实体管理插件 | Paper及其衍生服务端均可用,并针对Mohist适配 8.0

[MD] --- ## 功能概述 | Overview 一个轻量级 Paper 插件，用于限制每个区块内的实体自然生成数量，精细化控制服务器负载。 A lightweight Paper plugin that limits natural entity spawns per chunk for fine-grained server performance control. --- ## 核心特性 | Key Features ### 1. 按区块精准控制 | Per-Chunk Control - 针对每个区块单独设置实体上限 - Set individual entity limits for each chunk ### 2. 跨世界支持 | Multi-World Support - 自动区分不同世界的区块设置 - Automatically separates chunk settings by world ### 3. 仅限制自然生成 | Natural Spawns Only - 只拦截自然生成的实体 (`NATURAL` SpawnReason) - Only intercepts naturally spawned entities - 不影响刷怪笼、命令召唤、玩家繁殖等 - Does not affect spawners, commands, breeding, etc. ### 4. 持久化存储 | Persistent Storage - 区块配置保存至 `chunks.yml` - Chunk configurations saved to `chunks.yml` - 服务器重启后自动加载 - Automatically loaded on server restart --- ## 设计原理 | Design Principles ### 事件驱动 | Event-Driven 插件监听 `CreatureSpawnEvent`，在实体生成前判断当前区块实体数量是否超过上限： The plugin listens to `CreatureSpawnEvent` and checks if the current chunk entity count exceeds the limit before spawning: ``` 实体自然生成 → 获取所在区块 → 读取区块上限 → 超限则取消生成 Entity Spawns → Get Chunk → Read Limit → Cancel if Exceeded ``` ### 默认上限 | Default Limit - 未配置的区块默认上限为 **20** 实体 - Unconfigured chunks default to **20** entities ### 性能友好 | Performance-Friendly - 使用内存 Map 缓存配置，避免频繁文件读取 - Uses in-memory Map cache to avoid frequent file reads - 仅在配置变更时写入文件 - Only writes to file when configuration changes --- ## 命令 | Commands **主命令 / Main Command:** `/LimitEntitiesInChunk` (简写 / Alias: `/leic`) | 子命令 Subcommand | 说明 Description | |---|---| | `set <数量>` | 设置当前所在区块的实体上限<br>Set entity limit for current chunk | | `cancel` | 取消当前区块的自定义上限（恢复默认 20）<br>Remove custom limit for current chunk (reset to default 20) | | `list` | 列出所有已配置区块的上限<br>List all configured chunk limits | ### 使用示例 | Usage Examples ```bash # 将当前区块实体上限设为50 # Set current chunk entity limit to 50 /leic set 50 # 取消当前区块的限制，恢复默认 # Remove current chunk limit, reset to default /leic cancel # 查看所有配置 # View all configurations /leic list ``` --- ## 配置文件 | Configuration 插件会在 `plugins/MaxEntitiesInChunk/` 目录下生成 `chunks.yml`： The plugin generates `chunks.yml` in `plugins/MaxEntitiesInChunk/`: ```yaml world: "0,0": 50 "1,-2": 30 world_nether: "5,10": 15 ``` 格式：`世界名.区块X坐标,区块Z坐标: 上限` Format: `worldName.chunkX,chunkZ: limit` --- ## 安装 | Installation 1. 下载插件 jar 文件 / Download the plugin jar 2. 放入 `plugins/` 文件夹 / Place in `plugins/` folder 3. 重启服务器 / Restart server [/MD]