MLGRush - 高级速搭竞技场插件

如需帮助，请加入我的 Discord：https://discord.gg/ChM8SH6F9U

MLGRush 是一款高性能的 PvP 插件，它通过独特的模板系统，允许玩家在独立复制的竞技场中进行对战。你只需在模板世界建造一个地图模板，即可无限次地同时使用它，无需依赖动态服务器或其他插件。

💡核心原理

插件采用地图模板机制，类似于 WorldEdit 的 Schematic 文件。当玩家想要对战时，系统会将一个模板复制到一个独立的世界中，生成一个可游玩的竞技场（此过程经过高度性能优化）。理论上，这个复制过程可以无限次进行。因此，你只需在模板世界（通过 /tptemplate 进入）建造并设置好一个模板，它就可以被无限次地同时使用。

✨主要特性

• 多竞技场系统：支持多场对战同时进行。
• 无限地图：基于模板系统，可生成无限数量的对战地图。
• 地图模板：核心机制，模板被复制到独立世界以供游玩。
• 物品栏整理：内置物品栏排序功能。
• 挑战者系统：玩家可互相发起挑战。
• 队列系统：支持玩家排队等待对战。
• 数据统计：记录玩家的游戏数据。
• 观战模式：允许玩家观战。
• 高度可配置：约 90% 的设置可通过 config.yml 调整。
• 无额外依赖：无需安装其他插件即可运行。
• 无云服务器要求：无需依赖动态或云服务器。
• 易于理解：配置和使用简单。
• 数据库支持：支持 SQLite 和 MySQL。
• MySQL 连接池：使用连接池优化 MySQL 性能。
• 开源：插件代码完全开源。
• 简易 API：提供简单易用的 API 供开发者使用。
• 异步高性能：采用异步编程，性能表现优异。

🎮占位符

以下占位符可用于支持 PlaceholderAPI 的插件：

• 击杀数：%advancedmlgrush_kills%
• 死亡数：%advancedmlgrush_deaths%
• 击杀/死亡比：%advancedmlgrush_kd%
• 胜利数：%advancedmlgrush_wins%
• 失败数：%advancedmlgrush_looses%
• 已摧毁的床：%advancedmlgrush_beds%

🔧命令与权限

命令列表

• /mlgrush setlobby - 设置大厅位置
• /mlgrush setqueue - 设置排队位置
• /mlgrush setupmap <DE/EN> - 设置地图（DE为德语，EN为英语）
• /mlgrush deletemap <MAP> - 删除指定地图
• /leave - 离开当前游戏（无需权限）
• /tptemplate - 传送到模板世界
• /stats - 查看自己的统计信息
• /stats <Spieler> - 查看其他玩家的统计信息
• /sortinv - 整理物品栏
• /togglequeue - 在大厅中切换队列的开启/关闭状态

权限节点

• mlgrush.setlobby - 允许使用 /mlgrush setlobby
• mlgrush.setqueue - 允许使用 /mlgrush setqueue
• mlgrush.setupmap - 允许使用 /mlgrush setupmap
• mlgrush.deletemap - 允许使用 /mlgrush deletemap
• mlgrush.tptemplate - 允许使用 /tptemplate
• mlgrush.stats - 允许使用 /stats 查看自己数据
• mlgrush.stats.other - 允许使用 /stats <玩家> 查看他人数据
• mlgrush.notify - 当插件有新版本时接收通知
• mlgrush.* - 拥有所有权限

⭐配置文件 (config.yml) 摘要

# 开发者：FebanHD
# 源代码：https://github.com/FebbanHD123/MLGRush

# 基础设置
language: en # 语言 (de, en)
database: SQLite # 数据库类型 (MySQL, SQLite)
queue_entity_type: ENDER_CRYSTAL # 队列实体类型（完整列表见链接）
no_move_time: 1.5 # 对战开始后无法移动的时间（秒）
knockback-amplifier: 1 # 木棍上击退附魔的等级
no-damage: true # 为 true 时，玩家只会看到受伤动画，但生命值保持20点

# 地图生成
map_generation.spawningrate: 13 # 每 Tick 放置的方块数
map_generation.cached_maps.max: 6 # 无玩家时，应保持可用的最大地图缓存数
map_generation.cached_maps.min: 3 # 无玩家时，应保持可用的最小地图缓存数
paste.distance: 150 # 地图之间的粘贴距离（应大于最大地图的宽度）

# 游戏性
infinite.blocks: false # 为 true 时，玩家建造不会消耗方块
blockamount: 128 # 每个玩家获得的砂岩方块数量（超过64会自动分堆）
pickaxetype: IRON # 镐类型：WOOD, STONE, IRON, DIAMOND

# 大厅物品槽位 (1-9)
lobby.slots.challanger: 1 # 挑战者物品槽位
lobby.slots.inventory_sorting: 4 # 物品栏整理物品槽位
lobby.slots.spectate: 6 # 观战物品槽位

bstats: true # 是否启用 bStats 统计

❓开发者 API

// 获取 API 实例
AdvancedMLGRushAPI api = new AdvancedMLGRushAPI();

// 使用 API 进行各种操作
// 例如：获取所有地图模板
Collection<MapTemplate> templates = api.getMapTemplates();

🔧教程与支持

• 详细教程：请在插件文档中查看（点击此处访问）。
• Discord 支持：如需帮助，请加入我们的 Discord 服务器。

如果你喜欢这个插件，请别忘了给它评分！

💡快速开始

本指南将引导你完成 MLGRush 插件的基本设置流程。请按顺序执行以下步骤，确保服务器配置正确。

设置步骤

• 第一步：使用 /mlgrush setlobby 命令设置大厅的位置。
• 第二步：使用 /mlgrush setqueue 命令设置排队等待区的位置。
• 第三步：使用 /tptemplate 命令传送到模板世界。
• 第四步：在模板世界中建造你的地图。请确保双方玩家的出生点具有相同的 X 坐标。
• 第五步：使用 /mlgrush setupmap EN 命令创建地图。系统将引导你完成后续设置。

完成以上步骤后，你的 MLGRush 游戏即可正常运行。

❓关于 MySQL 数据库

如果你希望使用 MySQL 数据库，需要进行额外的配置。

配置步骤

• 第一步：在服务器的 config.yml 文件中，将数据库类型设置为 mysql。
• 第二步：重启你的服务器。
• 第三步：服务器重启后，插件会自动生成一个 database_config.yml 配置文件。你需要在此文件中填写你的数据库连接信息。

注意事项

• 在 database_config.yml 中，请只填写你知道用途的字段（如数据库名、主机、端口、用户名和密码）。
• 请勿修改你不了解其作用的配置项，例如 maxPoolSize: 10，否则可能导致连接问题。

配置文件示例

以下是一个 database_config.yml 的示例配置：

DATABASE: AdvancedMLGRush
HOST: localhost
PORT: 3306
USER: root
# 如果没有密码，请使用：''
PASSWORD: 'EinGutesPlugin123'
maxPoolSize: 10
cachePrepStmts: true
prepStmtCacheSize: 250
prepStmtCacheSqlLimit: 2048