# Introduction

<div align="center">
  <img src="https://raw.githubusercontent.com/MaboroshiKobo/branding/refs/heads/main/projects/vessel/vessel.avif" width="180" alt="Vessel Logo" />
  <h1>Vessel</h1>
  <p>Easily capture and store any entity in portable items, allowing you to move and release them anywhere.</p>
</div>

### Features

Vessel provides flexible capture-and-release mechanics with a wide range of configuration options:

* Create as many vessel templates as you want with independent behavior, item appearance, and usage restrictions.
* Material overrides to dynamically change the item type or texture based on the exact entity that was captured.
* MythicMobs support to capture and release custom entities.
* Nexo integration to use your own custom item models for your vessel items.
* Custom effects and actions to trigger sounds, particles, or console commands on use (supports chance, permissions, and random selections).
* MiniMessage and PlaceholderAPI support for fully stylized and dynamic display text.

### Prerequisites

To use this plugin, your server must be running **Paper** on `26.1` or higher, and Java 25 or higher.

### Documentation & Support

For a complete guide on features, commands, and configuration, please visit our [wiki](https://docs.maboroshi.org). If you have questions or need to report a bug, join our [Discord server](https://discord.maboroshi.org).

### Statistics

This plugin utilizes [bStats](https://bstats.org/plugin/bukkit/Vessel/31642) to collect anonymous usage metrics.

![bStats Metrics](https://bstats.org/signatures/bukkit/Vessel.svg)

### Download

[GitHub Releases](https://github.com/MaboroshiKobo/Vessel)
    [Modrinth](https://modrinth.com/plugin/vessel)
    [Hangar](https://hangar.papermc.io/Maboroshi/Vessel)