r-merge

Paper plugin for Minecraft 1.21.11 — several players share one inventory, one health bar, one XP bar, one set of effects.

Author: rudak0v
Current version: 1.0.1
Download: Releases

---

🇷🇺 Русский

Суть

r.merge связывает игроков в одну «судьбу»:

• Один общий инвентарь — одинаковые предметы, одинаковые количества, одинаковые слоты у всех участников.
• Общие здоровье, опыт и эффекты зелий.
• При смерти тиммейта общий инвентарь очищается.
• Режим Хардкор — одна жизнь на команду; после смерти все остаются spectator в merge-мире 5 минут, затем мир удаляется и всех кидает в лобби.

Установка

1. Скачайте r-merge-1.0.1.jar из Releases.
2. Положите файл в папку plugins/ сервера Paper 1.21.11.
3. Перезапустите сервер.

Сборка из исходников:

./gradlew build
# JAR: build/libs/r-merge-1.0.1.jar

Нужен JDK 21+.

Как играть

1. Хост: /merge <ник> <название_команды> — создать лобби и пригласить игрока.
2. Приглашённый: /merge accept
3. Можно приглашать ещё игроков той же командой (только хост).
4. Хост: /merge setting — GUI настроек (маленький сундук).
5. Хост: /merge world — создать мир 2000×2000, телепортировать команду и включить общую синхронизацию.

Команды

Команда	Описание
/merge <ник> <команда>	Создать лобби / пригласить игрока
/merge accept	Принять приглашение
/merge setting	Открыть настройки (хост, до старта мира)
/merge world	Создать мир и начать сессию
/merge leave	Выйти из лобби
/merge list	Список лобби
/merge info	Информация о вашем лобби/сессии
/merge help	Справка

Общий инвентарь (логика)

• Источник правды — один shared-инвентарь сессии.
• Любое изменение (подбор, клик, выброс, установка блока, ведро, прочность) → захват инвентаря у инициатора → принудительная запись во все слоты всех игроков.
• Фоновая сверка каждые 5 тиков устраняет «полу-синхронизацию» (разные стаки / разные слоты).
• Если игрок A поднял землю, а у B земля уже была — после синка у обоих будет ровно то, что получилось у A (одинаковые слоты и amounts).

Смерть и хардкор

Обычный режим

• Смерть любого → общий инвентарь очищается у всех.
• Респавн в merge-мире, HP/голод сбрасываются.

Хардкор (вкл. в /merge setting)

• Смерть любого = поражение команды.
• Оба (все) игрока остаются в мире 2000×2000 в режиме spectator.
• Через 5 минут мир автоматически удаляется, игроков телепортирует в лобби (основной мир).
• Исправлено: раньше умерший мог улететь в лобби, а живой оставался в merge-мире.

Настройки (/merge setting)

Настройка	Описание
Хардкор	Одна жизнь; 5 мин spectator → удаление мира
Общий голод	Общая шкала голода
Без регенерации	UHC-стиль, без natural regen
Двойной урон	×2 урон по игрокам
Огонь по своим	PvP внутри команды
Проклятие ночи	Всегда ночь
Пульс хаоса	Случайный эффект всей команде каждые 3 мин
Эхо души	Glowing + warning при низком HP
Общий эндер-сундук	Синхронизация ender chest
Безумие мобов	Hard + усиленный спавн
Связь предметов	Режим связи дропа (инвентарь и так общий)
Связь опыта	Общий XP
Кровавое зеркало	25% урона отражается тиммейту
Мусорщик	10 минут нельзя скрафтить верстак

Права

Permission	По умолчанию	Описание
rmerge.use	true	Использование /merge
rmerge.admin	op	Админ-инструменты

Требования

• Paper 1.21.11
• Java 21+

---

🇬🇧 English

What it is

r-merge binds players into a single shared fate:

• One true shared inventory — same items, same stack sizes, same slots for every teammate.
• Shared health, experience, and potion effects.
• On teammate death the shared inventory is cleared.
• Hardcore mode — one life for the team; after death everyone stays as spectators in the merge world for 5 minutes, then the world is deleted and players are sent to the lobby.

Install

1. Download r-merge-1.0.1.jar from Releases.
2. Put it into the plugins/ folder of a Paper 1.21.11 server.
3. Restart the server.

Build from source:

./gradlew build
# JAR: build/libs/r-merge-1.0.1.jar

Requires JDK 21+.

Gameplay flow

1. Host: /merge <player> <team_name> — create a lobby and invite a player.
2. Invitee: /merge accept
3. Host can invite more players the same way.
4. Host: /merge setting — open the settings chest GUI.
5. Host: /merge world — create a 2000×2000 world, teleport the team, enable full sync.

Commands

Command	Description
/merge <player> <team>	Create lobby / invite player
/merge accept	Accept invite
/merge setting	Open settings (host, before world)
/merge world	Create world and start session
/merge leave	Leave lobby
/merge list	List lobbies
/merge info	Your lobby/session info
/merge help	Help

Shared inventory (logic)

• The session holds one authoritative inventory snapshot.
• Any change (pickup, click, drop, place, bucket, durability) → capture from the actor → force-write every slot to every teammate.
• A background reconcile task (every 5 ticks) prevents half-sync (different stacks/slots).
• If player A picks up dirt while B already had dirt, after sync both have exactly A’s resulting layout (same slots and amounts).

Death & hardcore

Normal

• Any death clears the shared inventory for everyone.
• Respawn stays in the merge world; HP/hunger reset.

Hardcore (enabled in /merge setting)

• Any death = team eliminated.
• All players stay in the 2000×2000 world as spectators.
• After 5 minutes the world is auto-deleted and everyone is teleported to the lobby (main world).
• Fixed: previously the dead player could be sent to the lobby while the living teammate remained in the merge world.

Settings (/merge setting)

Setting	Description
Hardcore	One life; 5 min spectator → world deleted
Shared hunger	Shared food bar
No natural regen	UHC-style
Double damage	2× player damage
Friendly fire	Teammates can hurt each other
Night curse	Always night
Chaos pulse	Random team effect every 3 minutes
Soul echo	Glowing + warning at low HP
Shared ender chest	Synced ender chest
Mob frenzy	Hard difficulty / denser hostiles
Item bond	Drop-link flavour (inventory is already shared)
XP link	Shared experience
Blood mirror	25% damage reflected to a teammate
Scavenger	No crafting table for 10 minutes

Permissions

Permission	Default	Description
rmerge.use	true	Use /merge
rmerge.admin	op	Admin tools

Requirements

• Paper 1.21.11
• Java 21+

---

Changelog

1.0.1

• True single shared inventory — force slot-for-slot sync (pickup, place, click, drop, etc.).
• Inventory reconcile loop every 5 ticks to prevent drift / half-sync.
• Hardcore fix: all players stay in the merge world as spectators; world auto-deletes after 5 minutes, then teleport to lobby.
• Respawn location forced to merge world (no accidental lobby kick on death).
• Plugin author set to rudak0v.
• Full RU + EN README.

1.0.0

• Initial release: lobbies, settings GUI, 2000×2000 worlds, shared vitals/inventory/effects.

License

MIT

Spoiler