ArenaRegenerator
ArenaRegenerator 插件
ArenaRegenerator 是一个 Minecraft 服务器插件,使用 WorldEdit 或 FAWE 来处理竞技场保存、重置以及完整的迷你游戏逻辑。
该插件管理和再生由 WorldEdit 或 FAWE 定义的竞技场。包含完整的迷你游戏支持(例如大厅、倒计时、游戏状态、胜利判定)和用于便捷使用的交互式告示牌。
目录
- 功能
- 依赖项
- 安装
- 使用方法
- 示例配置
- 数据存储
- 从源代码构建
- 支持与贡献
功能
-
竞技场管理:
-
将 WorldEdit 选区保存为竞技场。
-
即时清除或再生竞技场。
-
列出、删除和查看已保存竞技场的详细信息。
-
迷你游戏系统:
-
大厅系统:玩家可以加入竞技场的等待大厅,并等待达到最少玩家数量。
-
倒计时:当满足最少玩家数量时,开始可配置的倒计时。
-
游戏开始:玩家将从小厅移动至游戏出生点,清空物品栏(可配置),并设置游戏模式。
-
游戏结束:在设定时间结束后或满足胜利条件(例如最后一名存活者)时结束游戏。玩家被传送离开,恢复其状态(可配置),并重置竞技场。
-
观战模式:在游戏中离开竞技场边界的玩家会被移至观战模式。
-
可配置规则:设置最少/最多玩家数、游戏时长、大厅倒计时、加入时的物品和游戏模式、允许破坏或放置的方块,以及每个竞技场的伤害防护。
-
交互式告示牌:
- 点击带有
[RegenArena] 的告示牌来再生竞技场
- 通过带有
[JoinArena] 的告示牌加入迷你游戏竞技场
- 通过带有
[LeaveArena] 的告示牌离开迷你游戏竞技场
/arena save 和 /arena info
/arena clear 和 /arena regen
竞技场再生告示牌
加入竞技场告示牌
迷你游戏逻辑
依赖项
此插件需要服务器上已安装 WorldEdit 或 FastAsyncWorldEdit (FAWE)。
重要提示: 仅在服务器上安装其中一个插件(WorldEdit 或 FAWE)。同时安装两者可能会导致冲突。
安装
- 从 releases 页面下载最新的
ArenaRegenerator-X.X.X.jar(或者自行编译)。
- 下载与你服务器版本兼容的 WorldEdit 或 FastAsyncWorldEdit (FAWE)。
- 将
ArenaRegenerator-X.X.X.jar 和你选择的 WorldEdit/FAWE JAR 文件放入服务器的 plugins/ 文件夹中。
- 重启服务器。
使用方法
交互式告示牌
创建告示牌以自动再生竞技场、加入或离开迷你游戏。
- 放置告示牌。
- 第一行:输入
[RegenArena] 或 [JoinArena] 或 [LeaveArena]。
- 第二行:输入你设定的确切竞技场名称。
- 拥有相应权限的玩家点击即可使用。
- 默认冷却时间为 10 秒;
arenaregenerator.sign.bypass 权限可绕过此限制。
命令与权限
命令使用前缀 /arena。同时也提供别名 /ar。将 <arenaName> 替换为你希望设置的竞技场名称。
<arenaType> 可以是 lobby(大厅)、exit(出口)、spectator(观战)或 game(游戏)中的任意一种。
| 权限节点 |
描述 |
命令 |
arenaregenerator.regen |
允许使用重生功能 |
/arena regen <arenaName> |
arenaregenerator.save |
允许保存竞技场 |
/arena save <arenaName> |
arenaregenerator.list |
允许列出已保存的竞技场 |
/arena list |
arenaregenerator.delete |
允许删除竞技场 |
/arena delete <arenaName> |
arenaregenerator.clear |
允许清空竞技场而不删除结构图 |
/arena clear <arenaName> |
arenaregenerator.info |
允许查看当前竞技场的信息 |
/arena info <arenaName> |
arenaregenerator.select |
允许为竞技场选择区域 |
/arena select <arenaName> |
arenaregenerator.setspawn |
允许为小游戏设置大厅、出口、观战和游戏出生点 |
/arena setspawn <arenaType> <arenaName> [spawnName] |
arenaregenerator.delspawn |
允许删除小游戏的出生点 |
/arena delspawn <arenaType> <arenaName> [spawnName] |
arenaregenerator.join |
允许加入小游戏竞技场 |
/arena join <arenaName> |
arenaregenerator.leave |
允许离开小游戏竞技场 |
/arena leave |
arenaregenerator.reload |
允许重载插件配置 |
/arena reload |
arenaregenerator.sign.create.regen |
允许玩家创建 [RegenArena] 告示牌 |
创建带有标签的告示牌 |
arenaregenerator.sign.create.join |
允许玩家创建 [JoinArena] 告示牌 |
创建带有标签的告示牌 |
arenaregenerator.sign.create.use |
允许玩家创建 [LeaveArena] 告示牌 |
创建带有标签的告示牌 |
arenaregenerator.sign.use.regen |
允许玩家使用 [RegenArena] 告示牌 |
点击 [RegenArena] 告示牌 |
arenaregenerator.sign.use.join |
允许玩家使用 [JoinArena] 告示牌 |
点击 [JoinArena] 告示牌 |
arenaregenerator.sign.use.leave |
允许玩家使用 [LeaveArena] 告示牌 |
点击 [LeaveArena] 告示牌 |
arenaregenerator.sign.bypass |
允许玩家绕过告示牌冷却时间 |
反复点击告示牌 |
arenaregenerator.sign.break |
允许玩家破坏交互式告示牌 |
破坏告示牌方块 |
示例配置
# ArenaRegenerator 插件配置
# 使用 ArenaRegenerator 告示牌(例如 [JoinArena], [RegenArena])的冷却时间,单位为秒。
# 设置为 -1 以完全禁用冷却时间。
sign-use-cooldown-seconds: -1
# 小游戏竞技场配置
# 定义将作为小游戏运行的每个竞技场的设置。
minigames:
# 示例竞技场配置
arena_1:
enabled: false # 此竞技场是否可以用作小游戏
min-players: 2 # 开始游戏所需的最少玩家数
max-players: 8 # 竞技场允许的最大玩家数
game-duration-seconds: 180 # 游戏持续时间(例如 3 分钟)
lobby-countdown-seconds: 10 # 达到最少玩家数后游戏开始前的倒计时
# 玩家状态恢复
# 如果为 true,玩家在加入前将保存其物品栏、生命值、饥饿度、游戏模式和确切位置,
# 并在离开/游戏结束时恢复这些状态。
# 如果定义了出口出生点,这将覆盖玩家的最后位置。
restore-player-state-on-exit: true
# 玩家加入游戏时是否清空其物品栏
clear-inventory-on-join: true
# 指定加入时给予的物品列表,格式为 "MATERIAL_NAME" 或 "MATERIAL_NAME:AMOUNT"
give-item-on-join:
- DIAMOND_SHOVEL
- STONE_AXE:1 # 示例:数量为 1 的石斧
- LEATHER_HELMET
- LEATHER_CHESTPLATE
- LEATHER_LEGGINGS
- LEATHER_BOOTS
- COOKED_BEEF:16 # 示例:16 个熟牛肉
game-mode-on-join: SURVIVAL # SURVIVAL, ADVENTURE, CREATIVE, SPECTATOR
# 玩家允许在此竞技场破坏的材料列表
breakable-blocks:
- SNOW_BLOCK
- ICE
- GLASS
# 玩家允许在此竞技场放置的材料列表
placeable-blocks:
- COBBLESTONE
- DIRT
- SAND
prevent-damage: true # 防止对玩家造成任何伤害
item-drops: true # 允许从方块掉落物品
prevent-item-durability-loss: true # 防止物品失去耐久度
winner-rewards: # 给予获胜玩家奖励。使用 %player% 指定获胜玩家。
commands:
- "give %player% diamond 3"
- "eco give %player% 100"
数据存储
该插件存储:
-
竞技场元数据与出生点:位于 plugins/ArenaRegenerator/arenas.json。该文件包含每个竞技场的起源、世界以及所有配置好的大厅、出口、观战和命名游戏出生点。
-
结构文件:位于 plugins/ArenaRegenerator/schematics/。这些是每个保存的竞技场的 WorldEdit 结构文件(.schem)。
-
小游戏配置:位于 plugins/ArenaRegenerator/config.yml。该文件定义了哪些保存的竞技场作为小游戏的规则和设置(例如,最小/最大玩家数、游戏时长、特定游戏规则)。
从源码构建
要从源码构建:
- 克隆仓库。
- 确保已安装 Java 25 并设置了 JAVA_HOME。
- 使用 Maven 进行构建(
mvn clean package)。
编译后的 JAR 文件将位于 target/ 目录中。
支持与贡献
如果您遇到问题、有建议或希望做出贡献,请访问 GitHub 仓库。
ArenaRegenerator
ArenaRegenerator Plugin
ArenaRegenerator is a plugin for Minecraft servers that handles arena saving, resetting, and full minigame logic using WorldEdit or FAWE.
This plugin manages and regenerates WorldEdit or FAWE-defined arenas. Includes full minigame support (e.g., lobby, countdown, game state, win detection) and interactive signs for easy use.
Table of Contents
- Features
- Dependencies
- Installation
- Usage
- Example Configuration
- Data Storage
- Building from Source
- Support & Contribution
Features
-
Arena Management:
-
Save WorldEdit selections as arenas.
-
Instantly clear or regenerate arenas.
-
List, delete, and view detailed information for saved arenas.
-
Minigame System:
-
Lobby System: Players can join an arena's lobby and wait for enough players.
-
Countdown: A configurable countdown begins when the minimum player count is met.
-
Game Start: Players are moved from the lobby to game spawn points, inventories are cleared (configurable), and game mode is set.
-
Game End: Game ends after a set duration or when a win condition (e.g., last player standing) is met. Players are teleported out, their state is restored (configurable), and the arena is reset.
-
Spectator Mode: Players leaving the arena boundaries during a game can be moved to spectator mode.
-
Configurable Rules: Set minimum/maximum players, game duration, lobby countdown, items and game mode on join, what blocks can be broken or placed, and damage prevention per arena.
-
Interactive Signs:
- Regenerate arenas on click with
[RegenArena] signs
- Join minigame arenas with
[JoinArena] signs
- Leave minigame arenas with
[LeaveArena] signs
/arena save and /arena info
/arena clear and /arena regen
Arena Regen Signs
Join Arena Signs
Minigame Logic
Dependencies
This plugin requires either WorldEdit or FastAsyncWorldEdit (FAWE) to be installed on your server.
Important: Only install ONE of these plugins (WorldEdit or FAWE) on your server. Having both can cause conflicts.
Installation
- Download the latest
ArenaRegenerator-X.X.X.jar from the releases page (or compile it yourself).
- Download either WorldEdit or FastAsyncWorldEdit (FAWE) that is compatible with your server version.
- Place both
ArenaRegenerator-X.X.X.jar and your chosen WorldEdit/FAWE JAR into your server's plugins/ folder.
- Restart server.
Usage
Interactive Signs
Create signs to automatically regenerate arenas, join minigames, or leave minigames.
- Place sign.
- Line 1:
[RegenArena] or [JoinArena] or [LeaveArena].
- Line 2: Your exact arena name.
- Players with appropriate permissions can click to use.
- Default 10-second cooldown;
arenaregenerator.sign.bypass overrides.
Commands and Permissions
Commands use the /arena prefix. An alias /ar is also available. Replace <arenaName> with your desired name for the arena.
<arenaType> can be either lobby, exit, spectator, or game.
| Permission Node |
Description |
Command |
arenaregenerator.regen |
Allows use of the regen function |
/arena regen <arenaName> |
arenaregenerator.save |
Allows saving an arena |
/arena save <arenaName> |
arenaregenerator.list |
Allows listing saved arenas |
/arena list |
arenaregenerator.delete |
Allows deleting an arena |
/arena delete <arenaName> |
arenaregenerator.clear |
Allows clearing an arena without deleting the schematic |
/arena clear <arenaName> |
arenaregenerator.info |
Allows viewing info about the current arena |
/arena info <arenaName> |
arenaregenerator.select |
Allows selecting a region for an arena |
/arena select <arenaName> |
arenaregenerator.setspawn |
Allows setting lobby, exit, spectator, and game spawns for minigames |
/arena setspawn <arenaType> <arenaName> [spawnName] |
arenaregenerator.delspawn |
Allows deleting spawn points for minigames |
/arena delspawn <arenaType> <arenaName> [spawnName] |
arenaregenerator.join |
Allows joining minigame arenas |
/arena join <arenaName> |
arenaregenerator.leave |
Allows leaving minigame arenas |
/arena leave |
arenaregenerator.reload |
Allows reloading the plugin configuration |
/arena reload |
arenaregenerator.sign.create.regen |
Allows players to create [RegenArena] signs |
Create sign with tags |
arenaregenerator.sign.create.join |
Allows players to create [JoinArena] signs |
Create sign with tags |
arenaregenerator.sign.create.use |
Allows players to create [LeaveArena] signs |
Create sign with tags |
arenaregenerator.sign.use.regen |
Allows players to use [RegenArena] signs |
Click [RegenArena] sign |
arenaregenerator.sign.use.join |
Allows players to use [JoinArena] signs |
Click [JoinArena] sign |
arenaregenerator.sign.use.leave |
Allows players to use [LeaveArena] signs |
Click [LeaveArena] sign |
arenaregenerator.sign.bypass |
Allows players to bypass sign cooldowns |
Click signs repeatedly |
arenaregenerator.sign.break |
Allows players to break interactive signs |
Break sign block |
Example Configuration
# ArenaRegenerator Plugin Configuration
# Cooldown in seconds for using ArenaRegenerator signs (e.g., [JoinArena], [RegenArena]).
# Set to -1 to disable the cooldown entirely.
sign-use-cooldown-seconds: -1
# Minigame Arena Configurations
# Define settings for each arena that will function as a minigame.
minigames:
# Example Arena Configuration
arena_1:
enabled: false # Whether this arena can be used as a minigame
min-players: 2 # Minimum players required to start the game
max-players: 8 # Maximum players allowed in the arena
game-duration-seconds: 180 # How long the game lasts (e.g., 3 minutes)
lobby-countdown-seconds: 10 # Countdown before game starts when min players met
# Player State Restoration
# If true, players' inventory, health, food, game mode, and exact location
# will be saved before joining and restored upon leaving/game end.
# If an exit spawn is defined, this will override the player's last location.
restore-player-state-on-exit: true
# Whether players' inventories are cleared when joining the game
clear-inventory-on-join: true
# Specify items to give on join as a list of "MATERIAL_NAME" or "MATERIAL_NAME:AMOUNT"
give-item-on-join:
- DIAMOND_SHOVEL
- STONE_AXE:1 # Example: a stone axe with quantity 1
- LEATHER_HELMET
- LEATHER_CHESTPLATE
- LEATHER_LEGGINGS
- LEATHER_BOOTS
- COOKED_BEEF:16 # Example: 16 cooked beef
game-mode-on-join: SURVIVAL # SURVIVAL, ADVENTURE, CREATIVE, SPECTATOR
# List of materials that players are allowed to break in this arena
breakable-blocks:
- SNOW_BLOCK
- ICE
- GLASS
# List of materials that players are allowed to place in this arena
placeable-blocks:
- COBBLESTONE
- DIRT
- SAND
prevent-damage: true # Prevent any damage to the players
item-drops: true # Allow item drops from blocks
prevent-item-durability-loss: true # Prevent items from losing durability
winner-rewards: # Gives players rewards for winning the game. Use %player% to specify the winning player.
commands:
- "give %player% diamond 3"
- "eco give %player% 100"
Data Storage
The plugin stores:
-
Arena Metadata and Spawn Points: Located in plugins/ArenaRegenerator/arenas.json. This file contains the origin, world, and all configured lobby, exit, spectator, and named game spawn points for each arena.
-
Schematic Files: Located in plugins/ArenaRegenerator/schematics/. These are the WorldEdit schematic files (.schem) for each saved arena.
-
Minigame Configurations: Located in plugins/ArenaRegenerator/config.yml. This file defines the rules and settings for which saved arenas function as minigames (e.g., min/max players, game duration, specific game rules).
Building from Source
To build from source:
- Clone repository.
- Ensure Java 25 and JAVA_HOME are set.
- Build with Maven (
mvn clean package).
The compiled JAR will be in the target/ directory.
Support & Contribution
If you encounter issues, have suggestions, or wish to contribute, visit the GitHub repository.
评论 0
登录后参与评分
还没有评论,来抢沙发吧