Kyouyuu (共有)

Paper plugin for linking physical chests across your server to shared inventory channels. Opening any chest linked to a channel shows the same inventory.

Supports Paper 1.21+ / 26.1+ (Java 21+).

Features

• Shared Channels: Link chests, trapped chests, and barrels to named channels.
• Double Chests: Automatically links both halves of double chests.
• Database Support: Embedded SQLite (default), MySQL, and PostgreSQL via HikariCP.
• Permission Control: Fine-grained permissions per channel (access, deposit, withdraw), with native LuckPerms integration.
• Hopper Automation: Supports hopper insertion and extraction on linked containers synced with shared channels.
• Chunk Keep-Alive: Automatically maintains chunk tickets for linked chest locations so hoppers can transfer items across long distances.
• Safety Checks: Channels with items cannot be deleted or downsized without --force.

Installation

1. Download the latest jar and put it into your server's plugins/ folder.
2. (Optional) Install LuckPerms.
3. Restart the server.

Quick Start

/kyo channel create vault 54

/kyo link vault

/kyo link vault

Items placed into one chest appear in all other chests linked to vault.

Commands

Alias: /kyouyuu

Permissions

Configuration

plugins/Kyouyuu/config.yml:

storage:
  type: SQLITE
  autosave-interval-seconds: 30

  mysql:
    host: "localhost"
    port: 3306
    database: "kyouyuu"
    username: "root"
    password: ""
    ssl: false

  postgresql:
    host: "localhost"
    port: 5432
    database: "kyouyuu"
    username: "postgres"
    password: ""
    ssl: false

chunk-loading:
  enabled: true
linking:
  session-timeout-seconds: 30

hopper:
  enabled: true

License

MIT