V-ItemSign

VItemSign Configuration

Vitemsign is a signing system for items, allowing you to sign and protect them.

Preview

Commands

Configuration Overview

Custom Messages

Customize messages for server startup, player join/quit, and Discord chat using the MiniMessage format. We currently support: `de` and `en`

Commands

`/itemsign <Message>` - Signs the item with the specified text

`/itemsign lock` - Locks the signed item so that it cannot be changed.

`/itemsign unlock` - Unlocks the signed item so that it can be changed again.

`/itemsign delete` - Removes the sign from the item.

4. Permissions

`vitemsign.use` | Fully configurable in the Config.yml. - Permission to use the `/itemsign` Command.

---

Setup Instructions

1. Download and install the plugin on your Minecraft server. 2. Configure the `config.yml` file with your preferred settings: - Set the database type and connection details. - Define custom messages using MiniMessage. 3. Restart the server to apply the changes.

---

Example config

```yaml language: en

These items should remain in the list to avoid duplication bugs

BlockedItems: - "SHULKER_BOX" - "WHITE_SHULKER_BOX" - "GRAY_SHULKER_BOX" - "BLACK_SHULKER_BOX" - "BROWN_SHULKER_BOX" - "RED_SHULKER_BOX" - "ORANGE_SHULKER_BOX" - "YELLOW_SHULKER_BOX" - "LIME_SHULKER_BOX" - "GREEN_SHULKER_BOX" - "CYAN_SHULKER_BOX" - "LIGHT_BLUE_SHULKER_BOX" - "BLUE_SHULKER_BOX" - "PURPLE_SHULKER_BOX" - "MAGENTA_SHULKER_BOX" - "PINK_SHULKER_BOX" - "CHEST" - "TRAPPED_CHEST" - "HOPPER" - "ENDER_CHEST" - "BARREL" - "FURNANCE" ```

---

Example Message Configuration

```yaml

General Messages

prefix: "<bold><dark_gray>[<gradient:#5FE2C5:#4498DB>VItem</gradient><gradient:#4498DB:#89B974>Si</gradient><gradient:#89B974:#89B974>gn</gradient><dark_gray>]<reset><gray> " date_format: "MM/dd/yyyy - hh:mm a" user_not_found: "<prefix><red>That user does not exist." no_permission: "<prefix><red>You don't have permission to do that." cannot_sign_blocked_item: "<prefix><red>You are not allowed to sign that!" cannot_lock_blocked_item: "<prefix><red>You are not allowed to lock this item!" item_not_signed: "<prefix><red>This item is not signed yet!" not_your_item: "<prefix><red>You are not the owner of that item!" item_sign_deleted_successfully: "<prefix>The sign has been <red>deleted <green>succesfully <gray>!" item_already_locked: "<prefix><red>This item has already been locked!" item_locked_successfully: "<prefix>This item has <green>succesfully <gray>been <red>locked<dark_gray>!" item_not_locked: "<prefix><red>This item is not locked!" item_unlocked_successfully: "<prefix>This item has <green>succesfully <gray>been unlocked<dark_gray>!" item_already_signed: "<prefix><red>This item has already been signed<dark_gray>!" item_signed_successfully: "<prefix>This item has <green>succesfully <gray>been signed<dark_gray>." item_in_hand_is_air: "<prefix><red>You have to hold the item in you main hand!" item_sign_broken_successfully: "<prefix>You have broken a signed item block!" lore_prefix_separator: " <dark_gray>| <gray>"

signed_lore: "<!i><dark_gray>» <gray>Signed by <luckperms_prefix><reset><separator><username> <gray>am <yellow><date>"

Command: Name: "itemsign" Permission: "vitemsign.use" Arguments: Delete: "delete" Lock: "lock" Unlock: "unlock" Usage: - "<prefix>VItemSign Help<dark_gray>:" - "<prefix><yellow>/itemsign <dark_gray><<green>Text<dark_gray>> - <gray>Signs an <yellow>Item<gray>." - "<prefix><yellow>/itemsign <red>delete <dark_gray>- <red>Delete <gray>the item sign." - "<prefix><yellow>/itemsign <red>lock <dark_gray>- <gray>The sign will get <red>locked." - "<prefix><yellow>/itemsign <green>unlock <dark_gray>- <gray>The sign will get <yellow>unlocked." ```

---

Example Database Configuration

```yaml type: Sqlite # Avaiable types: mongo, mysql, sqlite

MONGO

Mongo: connection-string: "mongodb://<username>:<password>@<host>:<port>/" database: "db"

SQL

SQL: connection-string: "jdbc:sqlite:plugins/VItemSign/database.db" username: "username" # Not required for sqlite password: "password" # Not required for sqlite ```

---

---

Soft Requirements

* WorldGuard ---

Notes

- The MiniMessage format is highly flexible for styling and formatting messages. Refer to the MiniMessage documentation for more details. - SQLite is the simplest database option as it doesn’t require additional setup.