r-merge

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, телепортировать команду и включить общую синхронизацию.

Команды

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

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

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

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

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

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

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

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

Права

Требования

• 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

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)

Permissions

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