OlEncounters
打造电影般的世界遭遇战:它们出现、战斗、给予奖励,然后消失,且不会破坏世界。
OlEncounters 是一个高度可配置的遭遇战和世界事件插件,适用于 Paper 和 Folia。你可以创建陨石撞击、传送门入侵、从地面升起的地标结构、飞行遭遇战、Boss 竞技场、资源点、宝藏事件等——所有这些都由同一个系统实现。
每个遭遇战都可以拥有自己的结构图(schematic)、到达动画、怪物、波次、战利品、排行榜、消息、特效、位置规则和清理行为。
不止是陨石插件
OlEncounters 被设计为一个通用的遭遇战引擎。预设可以代表几乎任何临时性的世界事件:
- 一颗陨石坠入森林
- 一个结构从地下浮现
- 一个地牢入口通过传送门显现
- 一个 Boss 竞技场从天而降
- 一个飞行结构从地平线飞来
- 带有个人战利品的定时资源点
- 带有排名奖励的多波入侵
每个预设都是独立配置的,因此同一类别的两个遭遇战可能表现出完全不同的行为。

完整的结构图到达动画
该插件可以对结构图本身进行动画处理,而不仅仅是移动一个装饰性的陨石核心。在到达过程中,结构图的方块由显示实体(display entities)表示,当动画结束时,真实结构会被安全地放置到位。
可用的遭遇战到达模式包括:
- 瞬间放置
- 正常天空坠落
- 缓慢的电影式下降
- 从地下升起
- 传送门到达
- 显化(Materialization)
- 水平飞入
每场遭遇战的动画持续时间、距离、粒子密度、声音、显示限制、批次大小和层级时间都可以进行调整。对于大型结构图,可以使用安全限制和自动回退行为以保护服务器性能。

游戏内设置与编辑
无需在配置文件中手动计算每个位置即可创建遭遇战。引导式设置系统允许管理员在游戏中直接构建新的预设或编辑现有的结构图。
设置工具可用于定义:
- 结构图根方块
- 选择边界
- 多个怪物生成点
- 多个战利品位置
- 自定义战利品方块,包括箱子或其他材料
- 全息图和文本位置
- 已保存的结构图名称
- 是否在事后移除临时设置结构
再次选择已有的点将移除它。设置背包会进行备份,离开时会清理临时工具,管理员可以选择是否保存后退出。

MythicMobs、波次与动态怪物到达
无论是小型生物遭遇战还是多阶段 Boss 战,都可以轻松构建。每个预设可以定义多个 MythicMobs 条目、选择权重、生成位置和波次行为。
怪物到达模式包括:
遭遇战中的怪物可以防止因自然距离导致的刷除,并由事件生命周期进行清理。当可用怪物列表超过一个物品栏时,MythicMobs 选择器支持多页浏览。

灵活的战利品与奖励
战利品不必来自单个箱子。每个遭遇战可以包含多个战利品点,并且几乎所有配置的方块都可以作为战利品来源。
奖励系统支持:
- 个人战利品或共享战利品
- 游戏内拖拽式战利品编辑
- 每个物品的概率、权重和数量
- 多个战利品方块
- 直到清空前可重新打开的容器
- 锁定的奖励保险箱
- 可选钥匙要求
- 自定义钥匙物品
- 伤害排名奖励
- 控制台命令奖励
- ItemsAdder 物品
- NBT、PDC 和现代数据组件(Data Component)保留
启用个人战利品后,每位玩家的奖励状态都会独立追踪。

高级位置规则的自动遭遇战
OlEncounters 可以在可配置的时间和距离范围内自动选择并启动遭遇战。多个预设可以共享一个类别,通过权重选择控制每个类别出现的频率。
自动放置支持:
- 按世界配置
- 自定义中心位置
- 最小和最大半径
- 圆形、方形、三角形、菱形和六边形搜索形状
- 陆地、空中、地下和任意表面放置
- 可配置的 Y 轴范围
- 粗糙地形和树顶放置
- 允许和禁止的表面材质
- 水和熔岩规则
- 世界边界验证
- WorldGuard 区域规避
- Towny 城镇规避
- TPS 保护
- 无人参与时的非活动清理
位置搜索以受控的批次进行处理,以避免服务器卡顿。搜索结果和拒绝原因会被报告,以便于管理和故障排除。

消息、排行榜与玩家反馈
每次遭遇战都可以拥有独立的开始、抵达、战斗、奖励和完成消息。消息可以发送给所有玩家、附近玩家、远处玩家、参与者、管理员或控制台。
可选的战斗功能包括:
- 实时动作栏伤害反馈
- 按次遭遇战排名的伤害排行榜
- 特定排位的奖励
- 物品或指令奖励
- 可点击的管理员位置消息
- 土耳其语和英语本地化文件
- 语言感知的命令建议
每个遭遇战的排行榜和动作栏反馈均可单独启用或禁用。
安全清理与地形恢复
临时事件不应永久损坏世界。OlEncounters 会记录受影响的区域,并可在遭遇战结束后进行恢复。
清理操作可以移除:
- 遭遇战结构
- 事件中放置的方块
- 玩家所做的更改
- 遭遇战中的生物
- 宝箱方块和容器
- 显示实体
- 全息图
- 待处理的动画任务
插件可以显示清理倒计时,使用独立的不活跃超时机制,并在服务器意外关闭后恢复未完成的事件。可以使用 FAWE 高效地恢复较大区域。

专为 Paper 和 Folia 打造
OlEncounters 在 Paper 和 Folia 环境中使用基于区域和实体的调度机制。繁重的工作被拆分为受控批次,显示数量可以进行限制,当服务器性能低于配置阈值时,自动事件会自动暂停。
性能控制选项包括:
- 兼容 Folia 的调度
- 批处理原理图动画
- 可配置的显示实体上限
- 批处理位置搜索
- TPS 保护
- 安全的区块加载限制
- 任务和实体清理
- 启动失败后的受控取消
集成支持
必需
支持的集成
- FastAsyncWorldEdit
- WorldEdit
- WorldGuard
- Towny
- MythicMobs
- ItemsAdder
- PlaceholderAPI
- FancyHolograms
- NBT API
可选集成通过隔离的安全钩子加载。如果缺少某个可选插件,仅会禁用相关功能,而不会导致整个插件崩溃。
要求
- Paper 或 Folia
- Minecraft 1.21.1 或更高版本
- Java 21
- CommandAPI
在使用基于原理图的遭遇战时,推荐使用 WorldEdit 或 FastAsyncWorldEdit。
主命令
/olencounters
设置、事件管理、自动调度、预览、历史记录、配置和诊断工具都组织在主命令之下。命令建议遵循所选的土耳其语或英语本地化文件。
从 OlMeteor 升级
OlEncounters 可以检测到较旧的 OlMeteor 数据目录,并将现有数据迁移到新的插件文件夹中。为了兼容旧版命令、权限、PlaceholderAPI 标识符和持久化数据标签,保留了兼容性别名。
只应安装一个插件 JAR 文件。在启动带有 OlEncounters 的服务器之前,请移除旧的 JAR 文件。
支持信息
报告问题时,请包含以下内容:OlEncounters 版本、Paper 或 Folia 构建版本、Java 版本、已安装的集成、完整的控制台错误日志、相关的预设配置以及复现步骤。
OlEncounters 1.5.0
由 OlPlugins 开发
OlEncounters
Build cinematic world encounters that arrive, fight, reward, and disappear without leaving the world damaged.
OlEncounters is a highly configurable encounter and world-event plugin for Paper and Folia. Create meteor impacts, portal invasions, structures that rise from the ground, flying encounters, boss arenas, resource sites, treasure events, and more—all from one system.
Every encounter can have its own schematic, arrival animation, mobs, waves, loot, leaderboard, messages, effects, location rules, and cleanup behavior.
More than a meteor plugin
OlEncounters is designed as a general encounter engine. A preset can represent almost any temporary world event:
- A meteor crashing into a forest
- A structure emerging from underground
- A dungeon entrance materializing through a portal
- A boss arena descending from the sky
- A flying structure arriving from the horizon
- A timed resource site with personal loot
- A multi-wave invasion with ranking rewards
Each preset is configured independently, so two encounters in the same category can behave completely differently.

Full-schematic arrival animations
The plugin can animate the schematic itself instead of moving only a decorative meteor core. Schematic blocks are represented with display entities during arrival, then the real structure is safely placed when the animation finishes.
Available encounter arrival modes:
- Instant placement
- Normal sky fall
- Slow cinematic descent
- Underground rise
- Portal arrival
- Materialization
- Horizontal fly-in
Animation duration, distance, particle density, sounds, display limits, batch size, and layer timing can be adjusted per encounter. Large schematics can use safe limits and automatic fallback behavior to protect server performance.

In-game setup and editing
Create encounters without manually calculating every position in configuration files. The guided setup system lets administrators build a new preset or edit an existing schematic directly in game.
Setup tools can be used to define:
- The schematic root block
- Selection boundaries
- Multiple mob spawn points
- Multiple loot locations
- Custom loot blocks, including chests or other materials
- Hologram and text positions
- Saved schematic names
- Whether the temporary setup structure should be removed afterward
Selecting an existing point again removes it. Setup inventories are backed up, temporary tools are cleaned when leaving, and administrators can exit with or without saving.

MythicMobs, waves, and animated mob arrivals
Build anything from a small creature encounter to a multi-stage boss fight. Each preset can define multiple MythicMobs entries, selection weights, spawn locations, and wave behavior.
Mob arrival modes include:
- Instant spawn
- Sky descent
- Underground emergence
- Portal arrival
- Materialization
Encounter mobs can be protected from natural distance-based despawning and are cleaned up by the event lifecycle. The MythicMobs selector supports multiple pages when the available mob list exceeds one inventory.

Flexible loot and rewards
Loot does not have to come from a single chest. Each encounter can contain multiple loot points, and nearly any configured block can act as a loot source.
The reward system supports:
- Personal or shared loot
- Drag-and-drop in-game loot editing
- Per-item chance, weight, and amount
- Multiple loot blocks
- Reopenable containers until they are emptied
- Locked reward vaults
- Optional key requirements
- Custom key items
- Damage-ranking rewards
- Console-command rewards
- ItemsAdder items
- NBT, PDC, and modern Data Component preservation
With personal loot enabled, every player's reward state is tracked independently.

Automatic encounters with advanced location rules
OlEncounters can automatically select and start encounters within configurable time and distance ranges. Multiple presets can share a category, with weighted selection controlling how often each one appears.
Automatic placement supports:
- Per-world configuration
- Custom center positions
- Minimum and maximum radius
- Circle, square, triangle, diamond, and hexagon search shapes
- Land, air, underground, and any-surface placement
- Configurable Y ranges
- Rough terrain and tree-top placement
- Allowed and blocked surface materials
- Water and lava rules
- World-border validation
- WorldGuard region avoidance
- Towny town avoidance
- TPS protection
- Inactivity cleanup when nobody participates
Location searches are processed in controlled batches to avoid freezing the server. Search results and rejection reasons are reported for easier administration and troubleshooting.

Messages, leaderboards, and player feedback
Every encounter can have independent start, arrival, combat, reward, and completion messages. Messages can target all players, nearby players, distant players, participants, administrators, or the console.
Optional combat features include:
- Live action-bar damage feedback
- Per-encounter damage leaderboards
- Rank-specific rewards
- Item or command rewards
- Clickable administrator location messages
- Turkish and English locale files
- Language-aware command suggestions
Leaderboards and action-bar feedback can be enabled or disabled separately for every encounter.
Safe cleanup and terrain restoration
Temporary events should not permanently damage the world. OlEncounters records the affected area and can restore it after the encounter ends.
Cleanup can remove:
- The encounter structure
- Blocks placed during the event
- Changes made by players
- Encounter mobs
- Loot blocks and containers
- Display entities
- Holograms
- Pending animation tasks
The plugin can display a cleanup countdown, use a separate inactivity timeout, and recover unfinished events after an unexpected server shutdown. FAWE can be used for efficient restoration of larger areas.

Built for Paper and Folia
OlEncounters uses region-aware and entity-aware scheduling for Paper and Folia environments. Expensive work is split into controlled batches, display counts can be limited, and automatic events can pause when server performance falls below configured thresholds.
Performance controls include:
- Folia-compatible scheduling
- Batched schematic animation
- Configurable display-entity limits
- Batched location searching
- TPS protection
- Safe chunk-loading limits
- Task and entity cleanup
- Controlled cancellation after startup failures
Integrations
Required
Supported integrations
- FastAsyncWorldEdit
- WorldEdit
- WorldGuard
- Towny
- MythicMobs
- ItemsAdder
- PlaceholderAPI
- FancyHolograms
- NBT API
Optional integrations are loaded through isolated safe hooks. If an optional plugin is missing, only the related features are disabled instead of crashing the entire plugin.
Requirements
- Paper or Folia
- Minecraft 1.21.1 or newer
- Java 21
- CommandAPI
WorldEdit or FastAsyncWorldEdit is recommended when using schematic-based encounters.
Main command
/olencounters
Setup, event management, automatic scheduling, previews, history, configuration, and diagnostic tools are organized under the main command. Command suggestions follow the selected Turkish or English locale.
Updating from OlMeteor
OlEncounters can detect an older OlMeteor data directory and migrate existing data to the new plugin folder. Compatibility aliases are retained for legacy commands, permissions, PlaceholderAPI identifiers, and persistent data tags.
Only one plugin JAR should be installed. Remove the old JAR before starting the server with OlEncounters.
Support information
When reporting a problem, include the OlEncounters version, Paper or Folia build, Java version, installed integrations, complete console error, relevant preset configuration, and reproduction steps.
OlEncounters 1.5.0
Developed by OlPlugins
评论 0
登录后参与评分
还没有评论,来抢沙发吧