Please join the Streamline Hub Discord in order to get updates and for me to fully assist you with bugs, questions, or suggestions.
Discord: **click here**
Block players from entering or teleporting to specified worlds — All configurable with commands.
This offers a very simple configuration and setup all while remaining very light-weight.
1. Download and install BukkitOfUtils. Found here: BukkitOfUtils
2. Download the correct version of this plugin for you server version.
3. Place in your `plugins` folder.
4. Stop server.
5. Start server.
6. Use to your liking.
## How to block a world
1. Install plugin. (Shown above.)
2. `/manageworlds add ` – where `` is replaced with the world you want to block.
## Notes
Players with operator or the `*` permission can access all worlds by default.
To disable these players from bypassing the world block, set their permission for `worldlock.bypass.*` to false.
## Functions
* Block specified worlds from:
* Teleportation.
* Moving to.
* Portal-Warping to.
* List blocked worlds.
* Bypassable with permissions.
* Permission: `worldlock.bypass.`
## Commands
* `/manageworlds`
* `/manageworlds add `
* Adds a world to the blocked worlds.
* `/manageworlds remove `
* Removes a world from the blocked worlds.
* `/manageworlds list`
* Lists all worlds in the blocked worlds list.
WorldLobby999
## Core Features
1. World Management System
World Creation
– Players can create unlimited personal worlds
– Worlds persist between server restarts
– Automatic world loading/unloading based on player activity
– Support for different world types and environments
World Categories
– **Creative Build**: Traditional creative building worlds
– **Adventure/Story**: Narrative-driven worlds
– **Parkour**: Obstacle course and challenge worlds
– **PvP/Minigame**: Competitive gameplay worlds
– **Prototype/Development**: Testing and development worlds
World Visibility Settings
– **Public**: Anyone can join
– **Private**: Owner access only
– **Friends Only**: Invited players only
– **Whitelisted**: Specific player whitelist
2. Advanced Mode System
Build Mode
– Unlimited creative inventory
– Flight enabled
– No damage taken
– Fast block breaking
– Access to build tools (copy, paste, fill, brush)
Play Mode
– Game rules enforced
– Adventure/survival restrictions
– Scripts and events active
– Normal gameplay experience
Dev Mode
– Creative permissions with script access
– Developer tools available
– Debugging features enabled
– Testing environment
3. Player Context System
Player Roles
– **Owner**: Full control over world (scripts, settings, delete, invite, promote)
– **Developer**: Can modify scripts and world logic, but not delete world
– **Builder**: Can modify blocks and world structures
– **Player**: Can play the world, subject to script-triggered rules
– **Visitor**: Limited access, cannot modify world unless explicitly allowed
Context Management
– Persistent player settings across sessions
– World-specific preferences and configurations
– Mode-aware player behavior
– Player location tracking across worlds
4. World Permission System
Fine-grained Access Control
– Add/remove builders for your worlds
– Grant developer access for script editing
– Maintain whitelist for restricted worlds
– Manage player roles dynamically
World Browser
– GUI-based world browsing system
– Category filtering
– Search functionality
– World information display
– Pagination for large server lists
– Visual world representation
World Discovery
– `/worldlobby games` – Open world browser
– `/worldlobby list` – Text-based world list
– `/worldlobby join ` – Join specific world
– `/worldlobby locate ` – Find player’s location
6. World Configuration
Dynamic Settings
– Change world visibility (public/private/etc.)
– Set world categories
– Toggle weather systems
– Enable/disable mob spawning
– Update world descriptions
– Configure game rules
Advanced Lobby System
– Themed lobby areas (Space, Ocean, Forest)
– Interactive lobby elements
– Featured worlds display
– Quick travel options
– Lobby-specific features
World Statistics
– Track world usage and metrics
– Player count tracking
– Creation timestamps
– `/worldlobby stats [world-name]`
Data Management
– Persistent world metadata
– Player context preservation
– Configuration file management
– World state tracking
Performance Optimization
– Automatic world unloading
– Efficient player tracking
– Minimal resource usage
– Asynchronous operations where possible
Commands Reference
Basic Commands
– `/worldlobby` – Main command
– `/worldlobby help` – Show help
– `/worldlobby create ` – Create world
– `/worldlobby list` – List all worlds
– `/worldlobby join ` – Join world
– `/worldlobby delete ` – Delete world
– `/worldlobby lobby` – Return to lobby
Feature Parity
WorldLobby999 includes comprehensive feature parity with OpenCreative+:
✅ **World Management**: Full world creation, deletion, and management
✅ **Mode System**: Build, Play, and Dev modes with appropriate rule sets
✅ **Player Roles**: Owner, Developer, Builder, Player, and Visitor roles
✅ **Visibility Controls**: Public, Private, Friends Only, Whitelisted worlds
✅ **World Categories**: Creative, Adventure, Parkour, PvP, and Development categories
✅ **World Browser**: GUI-based world discovery system
✅ **Player Context**: Advanced context system with persistent settings
✅ **Permission System**: Comprehensive access control system
✅ **World Configuration**: Full settings and configuration management
WorldListTrashCan
## Allows players to customize their home world’s trash bin.
This cleaning plugin operates within a specific world (the player’s home) and, when cleaning items, gathers them into a trash bin that the player has personally set up in their home. It combines various features, supports Folia, boasts highly configurable settings, and is compatible with multiple languages.
(This plugin is more suitable for pairing a world with a team’s server, such as the Home server (using the PlayerWorldsPro plugin or other Home plugin servers). If you close the World Garbage can, its functions can also completely replace other cleaning plugins)
**Now, here’s a hellish joke for you:**
**Player** : Hey, my quantum solar panels got swept away by the cleaning plugin. Can you compensate me?
**OP** : No way, you can’t prove it, and my cleaning plugin doesn’t keep records.
**Player** : I just bought them!
**OP** : What if you hid them, and I compensate you, essentially doubling them?
**Player** : ***
**OP** : Even if there were public trash bins on the server, someone would snatch up those solar panels.
**OP** : What should I do?
And there you have it, this plugin was born.
When Foila supports multiple worlds, this cleaning plugin will benefit everyone
### Features:
—
– **Fully customizable tip**
Support multiple prompt messages
You can achieve fully customized prompts
For example, when there are three seconds left, let “bossbar”, “actionbar”, “chat”,and “title” prompt together,
Alternatively, you can have the bossbar change its style every second (solid, non solid, including its color, can be different every second)
After version 5.7.0, it supports switching between different prompt sounds per second, as well as setting different volumes and tones per second
– Thank you to QQ 1664907770 (“笑脸猫”) for providing the material package for the “itemsadder” plugin (applicable to public trash cans) Click here to download (IteamsAdder/WorldTrashCan config and resource)
– **Player-Created World Trash Bin:**
Players have the ability to create a trash bin in their world.
Similar to the mechanics of previous sign-locked chests, the font on the sign will undergo a
transformation after creation.
When the cleaning process is initiated, items will be automatically added to the home trash bin.
Configurable settings allow players to specify detection names and transformed names after cleaning.
“To meet the demands of a small number of people, here is a reminder”
How to create a world trash can:
Place the chest on the ground, hold the signboard and right-click on the chest. Enter [世界垃圾桶] in the configuration file (configured in Set. SighCheckName), and once the font is converted, it is created. Every time the garbage is cleaned, it will be placed in the marked chest
In the default configuration file, the names of the three worlds “world, dim-1, dim1” are disabled, creating a “world trash can” (excluding op)
– **Support for Multiple Home Trash Bins:**
Players can use commands to grant special players the ability to place additional home trash bins.
Default quantities for home trash bins are configurable.
– **Home Trash Bin Overflow to Public Trash Bin:**
Items from home trash bins overflow into the public trash bin.
Public trash bins can have a configurable maximum page count and a blacklist.
– **Item Exclusion and Public Trash Bin Handling:**
Players can add items to the home trash bin blacklist to prevent their recycling.
Excluded items go directly to the public trash bin.
Configuration includes support for excluding items with special lore (e.g., items from the QS shop with
showLocation).
Public trash bins can either clear new items during each sweep or accumulate all trash without clearing.
– **The public trash can can enable logging:**
Record what items the player took away
– **Entity Cleanup:**
Optional cleanup of all animals/monsters.
Command (/WorldListTrashCan Look) to view entity types and configure entity blacklists/whitelists.
Support for cleaning special entities from mod.
– **Dense Entity Cleanup:**
Configurable radius, target quantity, kill or remove options, and player notifications for dense entity
cleanup.
– **Spam/Command Limitations:**
Configurable chat/command intervals, whitelist commands, and informative messages.
Defense against item dropping.
Players can manually enable or disable the item-drop defense mode.
– **Performance Optimization:**
All optimizations have configurable options in the settings.
1. Quick removal of uncollectible arrows (e.g., arrows from skeletons or bows with infinite
enchantments).
2. Prohibit players from trampling on farmland
### How to Install
—
– **Throw it into the Plugins folder**
### Commands:
—
– **/wtc reload**
Reloads the plugin.
– **/wtc GlobalTrash**
Opens the public trash bin.
– **/wtc help**
Displays help information.
– **/wtc ban**
Opens the local world trash blacklist GUI.
– **/wtc Look**
Right-click to get entity type (useful for adding to the configuration blacklist/whitelist).
– **/wtc GlobalBan**
Opens the global world trash blacklist GUI.
– **/wtc add [WorldName] [Quantity]**
Sets the maximum quantity for the trash bin in the specified world (defaults to the world at your feet if not specified).
– **/wtc DropMode**
Opens or closes drop mode.
### Placeholders
—
– **%WTC_ClearTime%**:
Time until the next cleaning.
### Permission
—
– **WorldListTrashCan.BanGui**:
Permission to open the GUI for adding items to the player’s home trash bin blacklist.
– **WorldListTrashCan.GlobalTrashOpen**:
Permission to open the global trash bin.
– **WorldListTrashCan.help**:
Permission to access command help.
– **WorldListTrashCan.DropMode**:
Permission to open or close drop mode.
***(The above is available by default)***
– **WorldListTrashCan.GlobalBan**:
Permission to open the global trash bin blacklist GUI.
– **WorldListTrashCan.Look**:
Permission to right-click and query the entity type.
***(The above is not available by default)***
WorldGuardRegionProtect
**If you with try first newest, use the latest dev build
Start from version 1.8.0.21 will support Bukkit/Spigot/Folia and other forks of Paper.
Versions after 1.0.3.21 above require JAVA 21+!
If you need plugin support JAVA 17+, so you need just download 1.0.2.17 special version
This is not a WorldGuard. This plugin addon for a WorldGuard!
You don’t know where you can get WG for new released versions?
So you just can check on EngineHub from original authors for dev-builds.**
**Do you want protect from superpickaxe? Or feauters protection for players? Look at premium version.
The free version of the plugin will continue to be updated!
❤️Click here to check out the plus version! ❤️**
Do you speak multiple languages? If so, we always welcome contributions to our Crowdin project
If you have a idea for plugin, you can created issue on github
## Support
When reporting a bug:
Use the issue tracker! Don’t report bugs in the reviews and discussions. Please search for duplicates before reporting a new issue!
Provide as much information as possible. Provide your WorldGuardRegionProtect version and Spigot/Paper version.
Provide any stack traces or “errors” using pastebin.
## Join us in the discord!
## Opportunities of plugin
By entering the name of the region in the plugin config.yml, you will add protection by plugin. Nobody can interact with the region that is registered in config.yml. Even the operators are not able to do this!
This plugin is for extended protection of an existing region from WorldGuard. For example, possible damage region from the administration. Who has permission access from plugin WorldGuard, or from operators.
## With plugin, you can do advanced protect your region
1. Nobody cannot break or place blocks in region.
2. It is possible to enable/disable the limitation of interaction with the transport.
3. Protecting frame, painting from any damage from arrows, trident, snowball, eggs, enderpearl and player.
4. Protect from any change in the frame (On 1.18 MC glow frame too).
5. Nobody cannot damage armor stand and taking or place armor from it.
6. Cannot use none of the buckets in region.
7. Creeper, Wither, Ghast, Primed TNT, cannot blowing up stuff in the region. Skeleton, Stray and Shulker bullet cannot destroy frame/glow frame and painting.
8. TNT, minecart with TNT, Respawn Anchor and ender crystal can’t damage any blocks/frames in region.
9. Support for banned dangerous commands. Separate commands were added and tested used by FastAsyncWorldEditWorldEdit in the protected region.
10. Nobody cannot remove region or change flags in protected region. Just example using like:
– “/rg rem spawn”,
– “/rg rem -f spawn”,
– “/rg rem -f spawn -w world”,
– “/rg addowner spawn Steve” etc.
11. You can specify a special region inside the protected region in which you can “break and place” or “only break” (specified in config.yml)
## Permissions
1. If you need give access to region for Builder team or any member from your staff, just add permissions on LuckPerms or PermissionsEx: wgrp.regionprotect
2. Who has the permissions star, I mean ‘*’ in LuckPerms or PermissionsEx may will be given access to protected region by WGRP.
3. By default, all who is operators are not allowed access into the region.
## Permissions:
– wgrp.command.wgrpbase – access to /wgrp command.
– wgrp.command.reload – access to /wgrp reload and /wgrp reloadmsg command to reload the configurations file.
– wgrp.command.spy – notifies the administrator about interacting with the protected region (BREAK or PLACE only now).
– wgrp.regionprotect – access to protected regions.
– wgrp.notify.admin – notifies the administrator when an attempt is made to use WGWE(FAWE) commands in a protected region.
– wgrp.command.addregion – access to the command with the ability to add a region to the protected region by admin.
– wgrp.command.removeregion – access to the command with the ability to remove the region from the protection by admin.
## Commands:
– /wgrp help – help on all commands.
– /wgrp about – additional information, useful!
– /wgrp reload – reload config.yml and language files.
– /wgrp addregion [region] [world] – add a region to the configuration for protection.
– /wgrp removeregion [region] [world] – delete a region from the configuration to remove protection.
View the default config you can here!
Bstats
WorldGuard ItemBlocker
# Summary:
Restrict Players from entering specific regions with restricted items.
Good for pvp zones, mace vs sword area etc
# Features
– Hooks into WorldGuard to prevent users from entering regions with any items you list in the config
– Sends hotbar and or chat message about the block & whats blocking you from entering
– Easily configurable and reload new restrictions and regions with one command
WarpAreas by wolferynsito is a utility plugin for Bukkit/Paper servers that simplifies region management. Instead of typing long commands, you can manage your WorldGuard flags through a clean Graphical User Interface (GUI).
Features
Quick Access: Open the flags menu with /wap.
Automatic Detection: Automatically detects the WorldGuard region you are currently standing in.
User Friendly: No more memorizing flag names; just click to toggle settings.
Commands
/wap: Opens the flags GUI for the current region.
Requirements
WorldGuard
WorldEdit
WorldGuard ExtraFlags Plus
# WorldGuard ExtraFlags Plus
**Release 4.3.13**
An advanced WorldGuard extension that adds over 30+ extra region flags for full control of player behavior, teleportation, and region rules — featuring Folia support, item blocking (Mace, Firework, Wind Charge, Totem, vanilla Spears), throwable-only blocking (`disable-throw` for egg, snowball, pearl, XP bottle), optional PacketEvents/ProtocolLib packet hooks for full `disable-completely` coverage, and fully customizable messages.
> 🎚️ **XP-Based or PlaceholderAPI (integer output) based region entry limits**
—
## ⚠️ Warning DO NOT USE BOTH PLUGINS TOGETHER!
> If you’re upgrading from `WorldGuardExtraFlags` to `WorldGuardExtraFlagsPlus`, make sure to:
> – **Remove** the old `WorldGuardExtraFlags.jar` plugin file
> – **Only keep** `WorldGuardExtraFlagsPlus.jar` on your server
> – Both plugins cannot coexist – they will conflict with each other
—
## Key Features
– ✅ **Folia support** – fully compatible with async region handling
– 🛡️ **New flag:** `disable-completely` – blocks all usage of specified items *(MACE, FIREWORK_ROCKET, WIND_CHARGE, TOTEM_OF_UNDYING, TRIDENT, vanilla spear tiers 1.21.11+, plus **`SPEAR`** for all tiers at once)*
– *Note: `permit-completely` is replaced. Please use `disable-completely` instead.*
– *Spear **Lunge** (packet **STAB**, including **Lunge** enchant) requires **PacketEvents** or **ProtocolLib** on the server for reliable blocking; without either, Lunge may bypass region checks.*
– 🎯 **New flag:** `disable-throw` – blocks **launching** only these throwables: **`EGG`**, **`SNOWBALL`**, **`ENDER_PEARL`**, **`EXPERIENCE_BOTTLE`**. Tridents and wind charges stay on `disable-completely`.
– 🎚️ **New flags:** `entry-min-level` / `entry-max-level` – restrict entry by **XP level** or **PlaceholderAPI values**
– 💬 **Customizable messages** via `messages-wgefp.yml` (disable, recolor, or use placeholders)
– 🔁 **Message cooldown system** to prevent spam (default 3 seconds)
– 🏪 **New flag:** `villager-trade` – control villager trading in regions
– 🚫 **New flag:** `disable-collision` – disable player collision in regions
– *Uses Minecraft’s native scoreboard teams to control collision. TAB plugin is supported with API integration. May conflict with other plugins that use teams. See (public-documents/disable-collision flag documentation.md) for details.*
– 📝 **PlaceholderAPI Chat Integration** – chat prefix/suffix supports PlaceholderAPI placeholders
– 🧱 **New flags:** `allow-block-place` / `deny-block-place` / `allow-block-break` / `deny-block-break` – fine-grained block placement and breaking control
– 📦 **New flags:** `deny-item-drops` / `deny-item-pickup` – restrict specific items from being dropped or picked up (works when WorldGuard allows drops/pickups)
– 🔨 **New flag:** `permit-workbenches` – block workbench usage (anvil, crafting table, ender chest, etc.) and crafting table crafting in regions
– *Note: `permit-workbenches CRAFT` now only blocks crafting table (3×3) crafting, not inventory (2×2) crafting. Use `inventory-craft` flag to block inventory crafting.*
– 🎨 **New flag:** `inventory-craft` – block inventory crafting (2×2 grid) in regions
– 🛡️ **Godmode & Fly Flag Enhancement** – The `godmode` and `fly` flags now also disable EssentialsX godmode/fly when entering regions with these flags disabled (EssentialsX integration)
– 👥 **New flag:** `player-count-limit` – limit maximum number of players in a region
– 🎯 **New flag (experimental):** `chambered-enderpearl` – mitigates chambered ender pearl bypasses (pearls thrown outside denied regions are removed when the shooter enters a region where the flag denies); subject to change.
—
## About
WorldGuard protects land by defining regions.
**WorldGuard ExtraFlags Plus** extends it with even more customization — adding powerful flags that modify gameplay, teleportation, commands, and behavior within regions.
—
## Included Flags (30+)
> Here’s a quick overview — all managed with standard WorldGuard flag commands.
The jar declares **`api-version: 1.21`** in `plugin.yml` so Paper **1.21.x** servers (and forks such as Canvas) load it; the project still compiles against the pinned Paper API artifact in the root `pom.xml`.
—
## Message Customization
All plugin messages live in `plugins/WorldGuard/messages-wgefp.yml`.
– Edit freely to match your style
– Use `{required}`, `{current}`, `{item}`, `{workbench}` placeholders (e.g. **`disable-throw-blocked`** uses `{item}`)
– Color codes supported (`&c`, `&7`, etc.)
– Disable messages with `””`
– Reload instantly using `/wgefp reload` or `/wg reload`
—
## Authors
– **ExtraFlags Plus Developer:** tins
– **Original ExtraFlags Author:** isokissa3
⭐ If you like this project, give it a star on Github
WorldGrowth
# WorldGrowth
WorldGrowth sets and changes world borders as a gameplay mechanic.
![Github All Releases]()
## Lore
The idea for WorldGrowth was inspired by my watching of WadZee’s “Minecraft, But I Can’t Leave One Chunk” series, please check it out to see what you can do with this plugin!
## Point System
WorldGrowth’s point system is essentially a series of quotas for different types of actions, such as block placement or brewing, which translates into points to fulfill the World Border Growth point quota. The World Border Growth point quota increases by default as the sizes of the world borders increase.
Additionally, points can only be gained up to the World Border Growth point quota, and there are maximum limits on how much world borders can grow per hour. Point-gaining turns off for the remainder of the server hour once this maximum amount of blocks has been reached.
Server maintainers can use the boost command, perhaps as a donor reward, to hasten the rate at which points are gained towards World Border Growth point quotas.
## Unification Events
“What is a ‘Unification Event?'”, I hear you ask. A Unification Event is something players vote for to happen instead of a World Border Growth. The reason players might do this is because it temporarily expands all world borders to the largest world border, which means a comparatively huge amount of blocks become accessible compared to a permanent World Border Growth.
For example, because 1 block in The Nether is 8 in The Overworld, The Nether’s world border is 8 times smaller than The Overworld’s! This means it would take a lot of World Border Growths to make most Nether structures accessible. By default, this plugin makes The End’s world border 8 times larger than The Overworld’s, which means a Unification Event expands The Nether’s world border by 64 times! Just be careful not to overextend, or else you won’t have time to outrun the shrinking border 😉
Unification Events take one minute each to fully expand and shrink borders, while World Border Growths change border sizes at a rate of one block per second.
## Commands and Permissions
| Command | Permission | Description |
|———————–|———————|—————————————————————————————————-|
| `/worldgrowth` | worldgrowth.command | Base command. |
| `/wg boost [multiplier] [ticks]` | (console only) | Boosts point gaining by the specified multiplier for the specified tick duration. |
| `/wg help` | worldgrowth.help | Links to this README. |
| `/wg reload` | worldgrowth.reload | Reloads WorldGrowth. |
| `/wg stats` | worldgrowth.stats | Displays information about voting, Unification Events, border sizes, and the current boost. |
| `/wg vote [yes/no/y/n]` | worldgrowth.vote | A player uses this to vote for or against a Unification Event. |
WorldGit
# WorldGit
WorldGit is a Paper plugin for Minecraft 1.21.11 that introduces a Git-like
workflow for collaborative world building.
Players branch a selected region from the protected main world into an isolated
branch world, edit safely, submit their work for review, and merge approved
changes back into the main world. The main world stays read-only except through
explicit merges.
For the Chinese version, see [README.zh-CN.md](README.zh-CN.md).
## Target Stack
– Minecraft server: Paper `1.21.11`
– Java: `21`
– Build tool: Gradle Kotlin DSL + Shadow
– Main dependencies:
– Paper API `1.21.11-R0.1-SNAPSHOT`
– WorldEdit `7.4.1-SNAPSHOT`
– Multiverse-Core `5.5.3`
– SQLite JDBC `3.47.2.0`
– Optional integration:
– LuckPerms API
## Core Features
– Region-based branch creation from a WorldEdit selection
– Concurrent overlapping branches during the editing phase
– Isolated branch worlds for editing
– Book-driven player menu with branch-detail, conflict-center, review, and merge-history chest UIs
– Review flow: submit, approve, reject, confirm merge
– Region-scoped rebase onto the latest main-world revision with three-way conflict detection
– Conflict groups with `mine`, `theirs`, and manual resolution flows
– Approved branches are re-checked before merge; stale approvals are revoked and require re-review
– Approved branches become read-only until `/wg forceedit`
– Sign-based coordinate input for `Pos1` / `Pos2` and merge messages
– Crash-safe merge journal and rebase journal with startup recovery
– Invite system for shared branch access
– Revision and commit tracking for the protected main world
– Short-lived integration lock during merge only
– Main-world protection to enforce read-only behavior
– Periodic and manual backups
## Runtime Dependencies
Install these plugins on the Paper 1.21.11 test server:
– WorldEdit
– Multiverse-Core
– WorldGit
LuckPerms is optional and only needed if you want to manage permissions through
it.
## Build
“`bash
./gradlew build
“`
Output JAR:
“`text
build/libs/worldgit-1.1.0.jar
“`
## Installation
1. Copy the built JAR to the server `plugins/` directory.
2. Make sure `WorldEdit` and `Multiverse-Core` are also installed.
3. Start the server once to generate `plugins/WorldGit/config.yml`.
4. Edit the config if needed.
5. Restart the server.
– Players receive a menu book in hotbar slot `9`.
– Right-click the book to open the main player menu.
– Branch cards now open a dedicated branch-detail chest UI.
– `Pos1` / `Pos2` support:
– Left click to use the current player coordinates
– Right click to open a sign input
– Coordinate syntax supports absolute values, `~`, `~+n`, and `~-n`
– Branch detail exposes:
– Teleport
– Rebase
– Conflict Center
– Submit for review
– Confirm merge
– Force edit
– Abandon branch
– Conflict Center exposes:
– Conflict-group list
– Accept mine
– Accept theirs
– Teleport for manual resolution
– Mark resolved
– Approved branches are merged through the final confirmation UI plus a sign-based merge message input.
– The paper item in the lower-left area opens paged merge history with:
– Builders
– Approver
– Merger
– Merge message
– `Pos1` / `Pos2`
– Teleport entry back to the branch world
– WorldGit 1.1.0 uses **Rebase** as a product term, and that is acceptable because the plugin is intentionally Git-flavored.
– Technically, this is **not** full Git commit-history rewriting.
– It is a **region-scoped three-way replay** of the branch world onto the latest main-world revision:
– `base`: snapshot captured when the branch was created or last rebased
– `ours`: current branch-world blocks
– `theirs`: latest main-world blocks
– In user-facing docs and UI, the clearest wording is: **Rebase (sync to latest main world)**.
### Create a Branch
1. Stand in the main world.
2. Select a cuboid region with WorldEdit.
3. Run `/wg create`.
4. Edit inside the generated branch world.
### Rebase and Resolve Conflicts
1. Open the branch-detail UI from the player menu.
2. If the main world has overlapping updates since your base revision, the branch is marked stale.
3. Click **Rebase** to replay your region onto the latest main-world revision.
4. If auto-merge is possible, the branch becomes clean immediately.
5. If conflicts remain, open **Conflict Center**.
6. Resolve each conflict group with:
– `mine`
– `theirs`
– manual fix in-world, then mark resolved
7. Once all conflict groups are resolved, the branch becomes clean again.
### Submit, Review, and Merge
1. Run `/wg submit [id]` or submit through the branch-detail UI.
2. If the branch is stale, submission is rejected until it is rebased.
3. An admin reviews the branch.
4. Once approved, the branch becomes read-only.
5. If you want to keep editing after approval, run `/wg forceedit [id]` first.
6. After editing again, re-submit the branch for a fresh review.
7. If the main world changes after approval but before merge, the approval is revoked automatically.
8. Rebase the branch again, resolve conflicts if needed, and submit for re-review.
9. If the branch is still current, run `/wg confirm [id]`, enter a merge message, and merge it back into the main world.
## World Protection Coverage
The plugin blocks direct edits in the configured main world, including:
– Block place and multi-place
– Block break
– Bucket empty/fill
– Bone meal and fertilization updates
– Fluid and block-state changes such as spread, fade, form, and flow
– Pistons
– Explosions including TNT and fireball-style explosions
– Hanging entities such as paintings and item frames
– Armor stand manipulation and damage
– Spawn eggs, dispenser-fired spawn eggs, and egg hatching into chicks
– Natural creature and monster spawning, spawners, and trial spawners
– Patrol, raid, reinforcement, and similar hostile mob spawns
– Entering the Nether or the End from the main world
Admins with `worldgit.admin.bypass` can bypass player-driven protection checks.
## Paper 1.21.11 Test Checklist
### Environment Setup
1. Start a fresh Paper `1.21.11` server.
2. Install `WorldEdit`, `Multiverse-Core`, and `WorldGit`.
3. Confirm all three plugins load without errors.
4. Confirm the main world name matches `config.yml`.
### Branch Creation
1. Join as a player with `worldgit.branch.create`.
2. Select a small cuboid region in the main world.
3. Run `/wg create`.
4. Verify:
– A branch record exists in SQLite
– A branch world named like `wg_` exists
– The selected blocks were copied correctly
– A base snapshot exists for the branch
– The branch stores a base revision
### Protection
1. Try placing and breaking blocks in the main world.
2. Try buckets, bone meal, item frames, and armor stands in the main world.
3. Verify all changes are blocked unless the player has
`worldgit.admin.bypass`.
### Rebase, Review, and Merge
1. Let player A and player B create overlapping branches from the same region.
2. Let player A edit and merge first.
3. On player B, run `/wg submit`.
4. Verify submission is rejected and the branch is marked stale.
5. Use the branch-detail UI to run **Rebase**.
6. If conflicts appear, verify Conflict Center can:
– list groups
– accept mine
– accept theirs
– teleport for manual repair
– mark a group resolved
7. After the branch is clean, submit it again.
8. Approve with `/wg review approve `.
9. Before merging, let another overlapping branch update the main world again.
10. Run `/wg confirm `.
11. Verify the approval is revoked automatically and the branch must be rebased and re-reviewed.
12. Complete the second rebase and submit again.
13. Approve once more, then merge.
14. Verify:
– Players are moved out safely
– Blocks are merged into the main world
– A short-lived merge lock is created and released
– A world commit entry is recorded
– The branch world is unloaded after merge and can be reopened from merge history if needed
– The branch is marked `MERGED`
– Merge history shows builders, approver, merger, merge message, and region coordinates
### Recovery
1. Start a merge.
2. Stop the server during the merge or rebase process.
3. Restart the server.
4. Verify incomplete merge and rebase state is recovered cleanly.
### Backup
1. Run `/wg admin backup`.
2. Verify a backup appears under the configured backup directory.
3. If scheduled backups are enabled, verify old backups are pruned.
## Notes
– This repository currently passes `./gradlew build`.
– No automated unit tests are included yet.
– Runtime validation should still be done on a real Paper 1.21.11 server with
WorldEdit and Multiverse-Core installed.
World Events
# 🌍 World Events & World Events Pro
### The Ultimate Immersion Engine
*Atmospheric Weather, Psychological Horror, Realistic Physics, and Custom Rewards.*
  
—
# 🚀 World Events Pro: JUST RELEASED!
**Bring your server to the next level with the Pro version.**
Upgrade now to unlock enterprise-grade features designed for big networks and content creators:
* **⚡ Folia & Multi-Threading Support:** Built for modern hardware with true multi-threading support.
* **💾 Database Persistence:** Sync active events and player data across your network using **MySQL** or **Redis**.
* **🎥 Twitch & Discord Integration:** Let your stream viewers trigger events via bits/subs, and announce events to your Discord automatically.
* **💻 JavaScript Scripting Engine:** Create your own completely custom events using the powerful JS scripting API.
* **🏆 Achievements & Betting:** Let players bet money on event outcomes and hunt for custom achievements.
* **⚔️ Boss Rush Mode:** Chain events together for the ultimate PVE challenge.
—
## ⚡ Why Choose World Events?
Static worlds lead to bored players. **World Events** transforms your server into a living, breathing ecosystem where every hour brings a new challenge or reward. Whether it’s a terrifying **Blood Moon** or a lucrative **Diamond Fever**, your players will always have a reason to stay logged in.
* **🚀 80+ Pre-Configured Events:** Ready to use out of the box. From simple buffs to complex environmental changes.
* **👻 Immersive Horror:** Features unique “Hidden Events” (**Paranoia**, **Silent Mobs**) that play tricks on players’ minds without obvious warnings.
* **🌲 Realistic Physics:** Trees that topple with gravity, meteors that leave craters, and acid rain that requires actual shelter.
* **🎨 In-Game Editor:** Create, edit, and tweak events live with a beautiful GUI. No YAML knowledge required.
* **✨ Smart Boss Bars:** A single, elegant bar that handles multiple active events with smooth carousel animations and MiniMessage gradient support.
* **⚡ Zero Lag Promise:** Highly optimized implementation maintaining **0.02% CPU usage** even on high-population servers.
—
## 📂 Explore The Categories
### 🌪️ Atmosphere & Weather
* **Acid Rain:** Seek shelter or take toxic damage during storms.
* **Solar Flare:** Direct sunlight burns! Stay in the shadows or underwater to survive.
* **Meteor Shower:** Watch the skies for falling stars that drop rare loot (and cause explosions).
* **Gravity Trees:** Chop one log, and the entire tree falls with realistic animations.
### 👁️ Psychological Horror
* **Paranoia:** Players hear footsteps, creeper hisses, and whispers that aren’t actually there.
* **The Mist:** A thick, blinding fog rolls in, reducing visibility to just a few blocks.
* **Silent Mobs:** Hostile mobs spawn invisible and completely silent—you won’t see them until they strike.
### ⚔️ Combat & Survival
* **Blood Moon:** Mobs spawn with custom **Boss Attributes** (150+ HP), iron/diamond gear, and aggressive AI.
* **Vampirism:** Players heal a percentage of all damage dealt to entities.
* **Exploding Mobs:** Every mob becomes a potential TNT trap upon death.
* **Mob Surge:** 2x-5x spawn rates for a true apocalypse experience.
### 💎 Mining & Economy
* **Diamond Fever:** Greatly increased chance to find diamonds in ores or even regular stone.
* **Auto-Smelt:** All mined ores drop as refined ingots instantly.
* **Treasure Hunt:** A loot-filled chest spawns in the wilderness with coordinates broadcasted to all players.
* **Bumper Harvest:** Massive multipliers for all crop yields.
—
## 🛠️ Administration Made Easy
* **/wevent editor:** The ultimate GUI tool. Create, delete, and modify events live.
* **/wevent list:** View exactly what’s running, how much time is left, and which events are hidden.
* **/wevent extend :** Keep the hype going by adding time to an active event on the fly.
* **/wevent debug:** One-click diagnostic check for PAPI, Vault, WorldGuard, and version status.
* **/wevent reload:** Instantly reload all configurations without restarting the server.
—
## 🔌 Smart Integrations
We respect your server’s rules. World Events integrates natively with:
* **🛡️ Protection:** **WorldGuard, GriefPrevention, Towny,** and **Lands**. Meteors and explosions won’t grief protected claims.
* **📱 Bedrock:** **Floodgate** support ensures boss bars and MiniMessage symbols look perfect on mobile/console.
* **💰 Economy:** **Vault** integration for survival rewards and console command rewards.
* **⚔️ Custom Items:** Full support for **ItemsAdder** and **Nexo** in loot pools and mob equipment.
* **📊 Display:** **PlaceholderAPI** support for `%worldevents_active%` and per-event timers.
—
## 📊 Live Performance Metrics
## ❓ Need Support?
