ZZZ_LayoutFixer

# ZZZ Layout Fixer – Description & Configuration

## 📖 Description (Описание)
## Git Hub
https://github.com/aimdf/ZZZ_LayoutFixer[Git Hub](https://github.com/aimdf/ZZZ_LayoutFixer)

**ZZZ Layout Fixer** is a smart Minecraft server plugin that automatically fixes incorrect keyboard layouts in player messages. The plugin detects when players type Russian words in English layout (or vice versa) and automatically converts the text to the correct form.

**ZZZ Layout Fixer** — это умный плагин для серверов Minecraft, который автоматически исправляет неправильную раскладку клавиатуры в сообщениях игроков. Плагин определяет, когда игрок печатает русские слова на английской раскладке (или наоборот) и автоматически преобразует текст в правильную форму.

### 🔧 Key Features (Основные возможности):
– ✅ Automatic layout correction (RU↔EN) / Автоматическое исправление раскладки (RU↔EN)
– ✅ Dictionary-based language detection / Проверка по словарям для точного определения языка
– ✅ Porter stemming for Russian words / Использование стемминга Портера для русских слов
– ✅ Anti-spam protection system / Система защиты от спама сообщений
– ✅ Visual correction notifications / Визуальное уведомление об исправлениях
– ✅ Optimized memory usage / Оптимизированная работа с памятью

## 📥 Installation (Установка)
1. Download the `ZZZ.jar` file / Скачайте файл `ZZZ.jar`
2. Place the file in your server’s `plugins` folder / Поместите файл в папку `plugins` вашего сервера
3. Restart the server / Перезапустите сервер

## ⚙️ Configuration for Modrinth (Конфигурация для Modrinth)

The plugin works out-of-the-box without additional configuration. All anti-spam parameters are optimally configured:

Плагин работает из коробки без необходимости дополнительной настройки. Все параметры защиты от спама уже настроены оптимально:

“`yaml
# Показывать символ предупреждения при исправлении раскладки/Show warning symbol when fixing keyboard layout
show-warning-symbol: true

# Настройки защиты от спама/Spam protection settings
anti-spam:
# Максимальное количество сообщений в окне времени/Maximum number of messages in the time window
max-messages: 4

# Временное окно для подсчета сообщений (в миллисекундах)/Time window for counting messages (in milliseconds)
time-window-ms: 2000

# Длительность блокировки за спам (в миллисекундах)/Block duration for spam (in milliseconds)
block-duration-ms: 20000

Zyvera WelcomeMessage

# ZyveraWelcomeMessage

**Greet your players with stunning gradient messages, fireworks, and sounds—all fully controllable via a single config.**

![Welcome Message Screenshot](https://i.ibb.co/sp90jdKW/232311.png)
*↑ Gradient welcome message in chat*

## ✨ Features

– 🎨 **Color gradients** — Supports all MiniMessage gradients (``)
– 🌍 **Global message** for all players upon joining
– 👤 **Individual messages** per player (name or UUID)
– 🥇 **First-Join Message** — automatically detects new players
– 🎆 **Fireworks Effects** — type, colors, number, and delay configurable
– 🔊 **Sound Effects** — for the player themselves or everyone online
– ⚡ **Folia-compatible**
– 🔄 `/zwm reload` — no server restart required

## 🚀 Installation

1. Copy the JAR file to the `/plugins/` folder
2. Start the server
3. Customize `plugins/ZyveraWelcomeMessage/config.yml`
4. Run `/zwm reload` in-game

## ⚙️ Configuration (Example)

“`yaml
global:
join-message:
text: “✦ Welcome, {player}! ✦”
fireworks:
enabled: true
type: BALL_LARGE
colors: [“#a855f7”, “#6366f1”]
sound:
enabled: true
sound: “ENTITY_PLAYER_LEVELUP”
“`

Placeholders: `{player}` · `{displayname}` · `{world}` · `{uuid}`

All colors in hex format (`#rrggbb`). MiniMessage reference: [docs.advntr.dev](https://docs.advntr.dev/minimessage/format.html)

## 🔧 Commands & Permissions

| Command | Description |
|——–|————-|
| `/zwm reload` | Reload config |
| `/zwm preview [global|first-join|playername]` | Preview message |
| `/zwm version` | Plugin info |

| Permission | Default |
|———- -|———|
| `zyvera.welcomemessage.admin` | OP |
| `zyvera.welcomemessage.bypass` | false |

## 🖥️ Compatibility

| Platform | Status |
|———|——–|
| Paper 1.16+ | ✅ |
| Folia | ✅ |
| Purpur | ✅ |
| Spigot 1.16+ | ⚠️ Limited |

*Made by Thomas & Zyvera-Systems · [zyvera-systems.dev](https://zyvera-systems.dev)*

Translated with DeepL.com (free version)

Zyvera TicTacToe

# ⚔ Zyvera-TicTacToe

### Classic TicTacToe as a fully GUI-based Lobby Minigame.

![Minecraft](https://img.shields.io/badge/Minecraft-1.13–1.21+-brightgreen?style=flat-square)
![Platform](https://img.shields.io/badge/Platform-Bukkit%20%7C%20Spigot%20%7C%20Paper%20%7C%20Purpur%20%7C%20Folia-blue?style=flat-square)
![Version](https://img.shields.io/badge/Version-1.0-orange?style=flat-square)
![Java](https://img.shields.io/badge/Java-8+-red?style=flat-square)
![Dependencies](https://img.shields.io/badge/Dependencies-None-green?style=flat-square)

**by Thomas U. & Zyvera-Systems**

## Overview

Zyvera-TicTacToe adds a complete TicTacToe minigame to your Minecraft server — fully inventory-based, with automatic matchmaking, direct challenges, persistent ranked stats, and crafting table binding. No dependencies, no setup hassle. Just drop and play.

## Features

### 🎮 Game Modes

– **Queue (Ranked)** — Join the matchmaking queue and get paired automatically. Wins, losses, draws, streaks — everything is tracked.
– **Challenge (Unranked)** — Challenge any online player directly. No stats, just fun.
– **Workbench Binding** — Bind TicTacToe to crafting tables in your world. Right-click toggles the queue (1s cooldown).

### 🖥️ GUI System

– **Compact 3×3 Board** — Clean layout in a 36-slot inventory
– **Real Player Heads** — Actual Minecraft skins displayed via SkullMeta
– **Win Highlight** — Winning line turns green at the end
– **Main Menu** — Queue, stats, and leaderboard in one place
– **Stats GUI** — Wins, losses, draws, winrate, total moves, streaks
– **Top 10 Leaderboard** — Gold, silver, bronze for the best players

### ⏱️ Timeout System

– **No moves placed + 120s idle** → Game gets cancelled (no stats affected)
– **Ranked + moves placed + 120s idle** → Inactive player loses automatically
– **Challenge (Unranked)** → Timeout has no effect

### 🔮 Holograms

Bound crafting tables display a floating hologram above them:

> **TicTacToe**
> [Click Me]

## Commands

| Command | Description | Permission |
|———|————-|————|
| `/ttt` | Open main menu | `zyvera.ttt.use` |
| `/ttt play` | Join the queue | `zyvera.ttt.use` |
| `/ttt leave` | Leave the queue | `zyvera.ttt.use` |
| `/ttt challenge ` | Challenge a player | `zyvera.ttt.use` |
| `/ttt accept` | Accept a challenge | `zyvera.ttt.use` |
| `/ttt deny` | Deny a challenge | `zyvera.ttt.use` |
| `/ttt stats [name]` | View stats (GUI) | `zyvera.ttt.use` |
| `/ttt top` | Top players (GUI) | `zyvera.ttt.use` |
| `/ttt quit` | Leave active game | `zyvera.ttt.use` |
| `/ttt bind` | Bind a crafting table | `zyvera.ttt.bind` |
| `/ttt unbind` | Unbind a crafting table | `zyvera.ttt.bind` |
| `/ttt reload` | Reload config | `zyvera.ttt.admin` |

**Alias:** `/tictactoe`

## Permissions

| Permission | Description | Default |
|———–|————-|———|
| `zyvera.ttt.use` | Basic TicTacToe access | everyone |
| `zyvera.ttt.bind` | Bind/unbind workbenches | OP |
| `zyvera.ttt.stats.others` | View other players’ stats | everyone |
| `zyvera.ttt.admin` | Admin commands (reload) | OP |

## Compatibility

| Platform | Supported |
|———-|———–|
| Bukkit | ✅ 1.13+ |
| Spigot | ✅ 1.13+ |
| Paper | ✅ 1.13+ |
| Purpur | ✅ 1.13+ |
| Folia | ✅ Regionized Scheduler |

– **Java:** 8+
– **Dependencies:** None
– Material fallbacks ensure compatibility across all versions (e.g. `RED_CONCRETE` → `STAINED_CLAY` on legacy)
– Folia support is fully reflection-based — no compile-time dependency

## Configuration

Everything is customizable — messages, colors, materials, timeouts, and hologram text.

“`yaml
prefix: “&8[&6&lTTT&8] ”

game:
turn-timeout: 120
challenge-timeout: 60
workbench-cooldown: 1000

gui:
symbol-x-material: RED_CONCRETE
symbol-o-material: BLUE_CONCRETE

hologram:
line1: “&6&lTicTacToe”
line2: “&8[&aKlick Mich&8]”
offset-y: 1.5
“`

## Installation

1. Drop the JAR into your `plugins/` folder
2. Start or restart the server
3. Config generates automatically
4. Done — `/ttt` and play!

**Made with ❤️ by Thomas U. & Zyvera-Systems**

⭐ *Enjoying TicTacToe? Leave a review!*

zyraquests

# 📜 ZyraQuests

> **A fully custom quest plugin with beautiful GUI menus, 6 objective types, flexible rewards, and native ZyraJobs integration — built for Spigot 1.21.**

## ✨ Overview

**ZyraQuests** lets you create any quest you can imagine directly from a single YAML file — no commands, no in-game editor required. Players browse quests through polished inventory menus, track their progress in real time via action bar indicators, and earn XP, items, or custom commands as rewards.

Works perfectly standalone, and unlocks extra features when paired with **ZyraJobs**.

## 🖥️ GUI Menus

ZyraQuests is built around three fully interactive inventory menus:

**📋 Quest Browser** — Browse all quests sorted by category (Mining, Farming, Hunting, Brewing, General). Each quest shows its difficulty color, objectives count, your current status (not started / in progress / completed), and a live XP progress bar if active. Paginated for large quest collections.

**🔍 Quest Detail** — Opens on click. Shows the full quest description, each objective with its own progress bar, all rewards previewed as items, and the Accept / Abandon button. Border color changes based on difficulty (green = Easy, yellow = Medium, red = Hard, orange = Legendary).

**⚡ Active Quests** — See all your quests in progress at a glance, with per-objective progress bars. Quick-navigate back to any quest’s detail view.

## 📋 Creating Quests

Everything lives in `quests.yml`. One quest looks like this:

“`yaml
quests:
diamond_hunter:
display-name: “Diamond Hunter”
description:
– “The real treasure lies deep below.”
– “Find and mine diamonds.”
icon: DIAMOND
category: MINING
difficulty: HARD
repeatable: false
objectives:
– type: MINE_BLOCK
block: DIAMOND_ORE
amount: 10
display: “Mine Diamond Ore”
– type: REACH_JOB_LEVEL
job: miner
level: 20
display: “Be Miner Level 20”
rewards:
– type: XP
amount: 20
– type: JOB_XP
job: miner
amount: 1000
– type: ITEM
material: DIAMOND_PICKAXE
amount: 1
name: “&b&lDeep Earth Pickaxe”
lore:
– “&7Forged from the deepest veins.”
“`

That’s it — reload with `/qadmin reload` and the quest is live.

## 🎯 Objective Types

| Type | What it tracks |
|——|—————|
| `MINE_BLOCK` | Breaking specific blocks underground |
| `HARVEST_CROP` | Harvesting fully grown crops |
| `KILL_MOB` | Killing any entity by type |
| `BREW_POTION` | Brewing potions at a brewing stand |
| `COLLECT_ITEM` | Picking up or crafting specific items |
| `REACH_JOB_LEVEL` | Reaching a level in ZyraJobs *(ZyraJobs required)* |

## 🎁 Reward Types

| Type | Effect |
|——|——–|
| `XP` | Give vanilla experience levels |
| `JOB_XP` | Add ZyraJobs XP to a specific job *(ZyraJobs required)* |
| `ITEM` | Give an ItemStack with optional custom name & lore |
| `COMMAND` | Run any console command with `%player%` placeholder |

## 🔗 ZyraJobs Integration

ZyraQuests integrates with **ZyraJobs** as a soft-dependency — install both plugins and the integration activates automatically. No configuration needed.

When ZyraJobs is present:
– `JOB_XP` rewards give XP directly into the player’s job level
– `REACH_JOB_LEVEL` objectives track job progression in real time
– If ZyraJobs is absent, `JOB_XP` rewards fall back to vanilla XP automatically

## 📈 Player Experience

– 🔔 **Level-up style chat message** when a quest is completed, listing all rewards
– 📺 **Screen title** on completion
– 📊 **Action bar progress** updates every time an objective advances
– 🔊 **Sounds** on quest accept and completion
– 🔁 **Repeatable quests** — configure any quest to be completable multiple times
– 🌐 **Server broadcast** on completion (optional, disabled by default)
– 💬 **Join message** reminding players of their active quests

## 🏷️ Quest Difficulties

| Difficulty | Color | Border |
|———–|——-|——–|
| Easy | 🟢 Green | Lime glass |
| Medium | 🟡 Yellow | Yellow glass |
| Hard | 🔴 Red | Red glass |
| Legendary | 🟠 Orange | Orange glass |

## ⚙️ Configuration

**`config.yml`** — Global settings:
– `max-active-quests` — how many quests a player can track at once (default: 3)
– `actionbar-progress` — show action bar updates on objective progress
– `sounds` — toggle all sounds
– `broadcast-completion` — announce completions server-wide
– All chat messages fully customizable with color codes

**`quests.yml`** — All quests. Add, remove, or edit quests freely. No restart needed — just `/qadmin reload`.

## 🛠️ Commands

| Command | Description |
|———|————-|
| `/quests [category]` | Open the quest browser |
| `/qadmin reload` | Reload config and all quests |
| `/qadmin list` | List all quest IDs |
| `/qadmin give ` | Force-start a quest for a player |
| `/qadmin complete ` | Force-complete a quest |
| `/qadmin reset [id]` | Reset one quest or all quests |
| `/qadmin info ` | View a player’s quest progress |

Tab-completion is supported on all commands.

## 🔑 Permissions

| Permission | Default | Description |
|———–|———|————-|
| `zyraquests.use` | Everyone | Access to `/quests` |
| `zyraquests.admin` | OP | Access to `/qadmin` |

## 📦 Requirements

– **Minecraft**: 1.21.x
– **Server software**: Spigot or Paper 1.21+
– **Java**: 21+
– **No required dependencies**
– **Optional**: ZyraJobs (for `JOB_XP` rewards and `REACH_JOB_LEVEL` objectives)

## 🤝 Part of the Zyra Suite

ZyraQuests is designed to work alongside **ZyraJobs** as a unified gameplay ecosystem. Install both for the full experience — quests that reward job XP, objectives that track job levels, and a consistent GUI style across both plugins.

## 👤 Credits

Made with by **sti_moi** — *zyrajobs’s group*

zyramenu

## 🗂️ ZyraMenu — Custom GUI Menus for 1.8 → 1.21

**ZyraMenu** is a lightweight, fully YAML-driven GUI menu plugin with **native multi-version support** from Minecraft 1.8.8 all the way to 1.21.x — no NMS, no reflection hacks, just clean compatibility layers.

### ✨ Features

– **YAML-based menus** — each menu is its own `.yml` file in `plugins/ZyraMenu/menus/`, easy to edit and reload without restarting the server
– **In-game menu creator** — open a chest, place your items, close it: the menu is saved automatically (`/zm create `)
– **Image backgrounds** — drop a `.png` named after your menu into `IMAGES-MENU/`, and ZyraMenu will slice it into a 9-slot grid and apply it as the inventory background
– **Rich slot actions** — assign one action per slot:
– `CLOSE` — close the inventory
– `COMMAND:` — run a command as the player
– `CONSOLE:` — run a command from the console
– `MESSAGE:` — send a chat message
– `OPENMENU:` — open another ZyraMenu
– `SERVER:` — transfer to a BungeeCord server
– **Item utilities** — rename any held item or set individual lore lines directly in-game
– **Player head support** — set a skull owner per slot for custom player heads
– **Hot reload** — `/zm reload` picks up all config and menu changes instantly
– **Tab completion** — full tab-complete support on all subcommands

### 🔧 Commands

| Command | Description |
|—|—|
| `/zm view

` | Open a menu for yourself |
| `/zm create ` | Start the chest-based menu creator |
| `/zm cancel` | Cancel the current creation session |
| `/zm reload` | Reload all menus and configuration |
| `/zm rename ` | Rename the item in your main hand |
| `/zm lorename ` | Set a lore line on the item in your main hand |

### 🔒 Permissions

| Permission | Default | Description |
|—|—|—|
| `zyramenu.use` | OP | Open menus with `/zm view` |
| `zyramenu.admin` | OP | Create menus and use item utilities |
| `zyramenu.reload` | OP | Reload the plugin configuration |

### 📋 Menu Configuration Example

“`yaml
title: “&8&lMain Menu”
rows: 3

items:
4:
material: NETHER_STAR
amount: 1
name: “&6&lInfo”
lore:
– “&7Welcome to the server!”
– “”
– “&eClick to close”
action: “CLOSE”
enchanted: true
10:
material: COMPASS
amount: 1
name: “&eShop”
action: “COMMAND:/shop”
“`

### ⚙️ Compatibility

– **Minecraft:** 1.8.8 — 1.21.x
– **Platform:** Spigot / Paper
– **BungeeCord:** optional, required only for `SERVER:` action
– **Java:** 8+

### 📦 Installation

1. Drop `ZyraMenu.jar` into your `plugins/` folder
2. Start the server — a default `menus/zmenu1.yml` is generated
3. Edit or create your own menus in `plugins/ZyraMenu/menus/`
4. Run `/zm reload` to apply changes

*Made by **sti_moi***

zyrajobs

# ⚒ ZyraJobs

> **A fully custom Jobs plugin with beautiful GUI menus, progressive unlocks, and a deep leveling system — built for Spigot 1.21.**

## ✨ Overview

**ZyraJobs** lets your players choose a profession and level it up by doing what they love — mining, farming, hunting, or brewing. Every action earns XP, every level unlocks something new, and every milestone rewards the grind.

No bloat. No dependencies. Just a clean, immersive jobs experience with handcrafted GUI menus that look great out of the box.

## 🧭 The 4 Jobs

| Job | How to level up | Unlocks |
|—–|—————-|———|
| ⛏ **Miner** | Break ores underground | Coal → Iron → Gold → Diamond → Ancient Debris |
| 🌾 **Farmer** | Harvest fully grown crops | Wheat (Lv.1) → Carrots (Lv.5) → Chorus Plant (Lv.30) |
| 🏹 **Hunter** | Kill mobs & animals | Chickens → Creepers → Endermen → Warden (Lv.40) |
| ⚗ **Alchemist** | Brew potions at a stand | Basic potions (Lv.1) → Strength (Lv.8) → Turtle Master (Lv.25) |

Each job goes from **level 1 to 50**, with an XP formula that scales naturally: `100 × level^1.5`.

## 🖥️ Custom GUI Menus

ZyraJobs is built around **beautiful, interactive inventory menus**:

![Main Menu](https://cdn.modrinth.com/data/cached_images/6002b8e9acfe105caebfef51af6bcba10581a511.png)

![Main Menu — Farmer tooltip](https://cdn.modrinth.com/data/cached_images/46781a8aafae99fcbbf65aee41f6c613ba24403c.png)

![Job Detail Menu — Farmer](https://cdn.modrinth.com/data/cached_images/57db04912ccf9e61a0584c3de2cd7fb274689e00.png)

– **Main Menu** — displays all 4 jobs with your current level, XP bar, and active job highlighted with an enchantment glow
– **Job Detail Menu** — color-coded per job (gray / green / red / purple), shows every unlockable action, required level, XP reward, and all level bonuses
– Everything is **click-to-navigate**: open job details, join, leave, all without typing a command

## 📈 Progressive Unlocks

Crops, ores, mobs and potions are **gated by level** — you earn the right to work with better materials as you progress.

![Level requirement message](https://cdn.modrinth.com/data/cached_images/d9caa4320d123d42b34aa71afa9b2d39ec4dee0b.png)

**Example for Farmer:**
– Lv. 1 → Wheat `+8 XP`
– Lv. 5 → Carrots & Potatoes `+15 XP` *(unlocked!)*
– Lv. 8 → Beetroots `+12 XP`
– Lv. 10 → Pumpkins & Melons `+20 XP`
– Lv. 30 → Chorus Plant `+45 XP`

Every unlock sends the player a chat notification the moment they reach the required level.

## 🎖️ Level-Up System

When a player levels up, they get:

![Level-up title](https://cdn.modrinth.com/data/cached_images/d8954ae87a20e8fcf6a1a02421b7f31f412faaed.png)

![Level-up subtitle bar](https://cdn.modrinth.com/data/cached_images/f28951f74febff61d1d9ac8960881bee586fb90d.png)

– 🔔 A **rich chat message** with a formatted XP progress bar
– 📺 A full **screen title** announcing the new level
– 🔊 A **level-up sound** effect
– 📣 A notification if a **new action is unlocked** at that level

## ⚡ Job Bonuses (every 10 levels)

Each job grants passive bonuses at milestone levels:

**⛏ Miner**
– Lv. 10 — 15% chance to double coal drops
– Lv. 20 — 10% chance to double iron/gold drops
– Lv. 40 — 2% chance to find a diamond while mining deepslate
– Lv. 50 — **PRESTIGE**: Triple XP on all ores

**🌾 Farmer**
– Lv. 5 — 50% chance to auto-replant harvested crops
– Lv. 15 — 10% chance to double wheat/carrot yield
– Lv. 25 — Auto-replant guaranteed at 100%
– Lv. 50 — **PRESTIGE**: Instant harvest without breaking

**🏹 Hunter**
– Lv. 15 — 2% chance to drop monster heads on kill
– Lv. 25 — Double XP against bosses (Ravager, Elder Guardian, Evoker…)
– Lv. 35 — Regeneration effect after each kill
– Lv. 50 — **PRESTIGE**: Random potion drop on every kill

**⚗ Alchemist**
– Lv. 15 — 8% chance to brew a duplicate potion
– Lv. 25 — Brewed potions last 25% longer
– Lv. 35 — 5% chance to auto-upgrade potion to level II
– Lv. 50 — **PRESTIGE**: All your potions are automatically level II

## 🛠️ Commands

| Command | Description |
|———|————-|
| `/jobs` | Open the Jobs GUI |
| `/jadmin reload` | Reload the config |
| `/jadmin setlevel ` | Set a player’s job level |
| `/jadmin addxp ` | Add XP to a player |
| `/jadmin reset ` | Reset all job data for a player |
| `/jadmin info ` | View a player’s job stats |

## 🔑 Permissions

| Permission | Default | Description |
|———–|———|————-|
| `zyrajobs.use` | Everyone | Access to `/jobs` |
| `zyrajobs.admin` | OP | Access to `/jadmin` |

## ⚙️ Configuration

Everything is configurable in `config.yml`:
– Max level (default: 50)
– XP formula base and exponent
– Multi-job mode (allow multiple jobs at once)
– Per-action XP rewards and minimum level requirements
– Level-up titles & sounds on/off
– All chat messages with color code support

## 📦 Requirements

– **Minecraft**: 1.21.x
– **Server software**: Spigot or Paper 1.21+
– **Java**: 21+
– **No dependencies** required

## 👤 Credits

Made by **sti_moi** — *zyraplug’s group*

zyrahomes

# 🏠 ZyraHome

**GUI-based home management with teams & VIP support — by sti_moi**

![Paper 1.21.x](https://img.shields.io/badge/Paper-1.21.x-brightgreen)
![Java 21+](https://img.shields.io/badge/Java-21+-blue)
![No dependencies](https://img.shields.io/badge/Dependencies-none-lightgrey)

## ◈ Overview

ZyraHome is a lightweight yet feature-rich home plugin for Paper 1.21.x servers. Unlike traditional command-based home plugins, everything is handled through a clean 27-slot GUI — no memorizing commands, no typing coordinates. Just open the menu, click, and teleport.

The plugin supports personal homes, VIP premium homes with instant teleportation, and a full team system with a shared team home managed by the team leader.

## ◈ Features

– 🖱️ **GUI-only home management** — Set, teleport to, and delete homes entirely through an intuitive chest-style menu.
– ⏱️ **Teleport delay system** — Normal homes have a 3-second countdown. Moving during the delay cancels the teleport.
– ⭐ **VIP / premium homes** — 2 extra home slots with instant teleportation for players with the `zyrahome.vip` permission.
– 👥 **Team system** — Create teams, invite members, and share a common team home. The leader manages the team home via the GUI.
– 💾 **Persistent data** — All homes and team data are saved to `homes.yml` and `teams.yml` — no database required.
– ⚙️ **Configurable** — Teleport delays, home counts, cancel-on-move and all messages are fully editable in `config.yml`.

## ◈ GUI Explained

The menu is a 27-slot chest split into two rows: **beds on top** (visual status), **dye buttons on the bottom** (actions).

| Item | Meaning |
|——|———|
| Gray wool | Team home slot, not yet defined |
| White bed | Normal home, undefined |
| Red bed | VIP home — requires `zyrahome.vip` |
| Green bed | Home is defined and ready |
| Gray dye | Click to set / define this home |
| Green dye | Left-click to teleport · Right-click to delete |

> **Note:** VIP homes display as red beds until `zyrahome.vip` is granted. Once unlocked, they behave identically to normal homes but teleport instantly.

## ◈ Commands

| Command | Description |
|———|————-|
| `/home` | Open the home GUI menu |
| `/teamhome` | Teleport to your team’s home |
| `/team create ` | Create a new team |
| `/team invite ` | Invite a player to your team *(leader only)* |
| `/team accept` | Accept a pending team invitation |
| `/team leave` | Leave your current team |
| `/team kick ` | Kick a member from your team *(leader only)* |
| `/team disband` | Dissolve the team *(leader only)* |
| `/team info` | Display team info and member list |

## ◈ Permissions

| Node | Description | Default |
|——|————-|———|
| `zyrahome.home` | Access the home GUI and use homes | everyone |
| `zyrahome.vip` | Unlock VIP home slots + instant teleportation | op |
| `zyrahome.team` | Use team commands and team home | everyone |
| `zyrahome.admin` | Administrative commands | op |

## ◈ Installation

1. Drop the `.jar` into your server’s `plugins/` folder.
2. Restart the server — no dependencies required.
3. Configuration files (`config.yml`, `homes.yml`, `teams.yml`) are generated automatically inside `plugins/ZyraHome/`.

Works out of the box on any **Paper 1.21.x** server running **Java 21+**.

*Created by **sti_moi** · ZyraHome v1.0.0 · Paper 1.21.x*

ZyloLotto

# ZyloLotto – GUI-Based Lottery System for Minecraft 1.21
**Note:** This version supports **multiple languages**. Currently, **German (`de_DE`)** and **English (`en_US`)** are available.
Set your preferred language in `config.yml`. Additional languages will be added in future updates.

ZyloLotto brings a complete, easy-to-use lottery system to your server.
Players can buy tickets, watch live drawings, and enjoy massive winnings.

Everything is fully GUI-based – no complicated commands required.

## Features

### Ticket System
– Players buy tickets directly through a GUI – each ticket is a randomly generated 5-digit code.
– All tickets are saved automatically and increase the jackpot.

### Jackpot & Economy System
– Fully Vault-compatible, including automatic payout handling.
– The jackpot grows with every ticket purchased or via optional autofill.

### Animated Drawing
– Winning numbers are displayed through a multi-stage animation with sound effects.

### Intelligent Winner Detection
– Automatically detects 2 to 5 correct numbers in the correct positions.
– Winnings are distributed based on configurable percentage values.

### Drawing & Winner History
– Clean GUIs show past draws, winners, dates, and payout amounts.
– All data is stored permanently.

### Player Ticket Overview
– Players can browse their tickets in a paginated GUI.
– Admins can view or delete tickets directly.

### Admin Menu
– Complete lottery management through a dedicated admin menu.
– Change jackpot, ticket price, delete winners or draws, modify autofill, enable/disable rollback, and more.

### Automatic Drawing
– Optional auto-draw that starts a drawing at regular intervals.
– Interval can be set live via chat.

### Test Drawing
– Admins can run a test draw with any 5-digit number.
– Perfect for testing or events.

### SQLite Database
– No setup required – `lotto.db` is created automatically.
– The plugin handles saving tickets, drawings, winners, and jackpot values on its own.

## Commands

| Command | Description |
|——————|———————————————-|
| `/lotto` | Opens the main lottery GUI |
| `/lottodraw` | Starts a regular lottery drawing |
| `/lottotest <12345>` | Starts a test drawing with fixed numbers |

## LuckPerms Permissions

| Permission | Description | Default |
|———————|—————————————————————|———|
| `zylolotto.admin` | Access to the full admin menu and all admin functions | `op` |
| `zylolotto.draw` | Allows executing the official lottery draw (`/lottodraw`) | `op` |
| `zylolotto.test` | Allows executing test drawings (`/lottotest`) | `op` |
| *(no permission)* | Opens the lottery menu via `/lotto` | `everyone` |

## Required Plugins

– **Vault (1.7.3)** – For economy integration
*(SpigotMC: Vault Plugin)*
– **LuckPerms** – For permissions management
*(Modrinth: LuckPerms)*

ZxMenus

🧩 ZxMenus – Simple & Powerful GUI Menu Plugin

ZxMenus is a lightweight, all-in-one inventory GUI menu plugin inspired by DeluxeMenus, built to be powerful, fast, and easy to configure.

Create fully customizable GUI menus that open with commands and perform player-specific actions such as running commands, opening other menus, or executing console commands. ZxMenus focuses on simplicity without sacrificing flexibility.

✨ Features

Create unlimited GUI menus using simple YAML configuration

Open menus using custom commands

Execute player or console commands from menu items

Open menus for other players

Permission-based access for menus and items

Full PlaceholderAPI support

Lightweight and optimized for performance

Compatible with modern Spigot / Paper servers

Designed as an easier alternative to DeluxeMenus

📌 Commands

/zxmenu open

Opens a menu for yourself

/zxmenu open

Opens a menu for another player

/zxmenu list
Lists all menus you have access to

/zxmenu reload
Reloads all menus and configuration files

/zxmenu execute
Executes an action on a target player (Console/OP only)

🔑 Permissions

zxmenus.open
zxmenus.open.others
zxmenus.list
zxmenus.reload
zxmenus.execute

⚠ Requirements

Java 11 or higher

PlaceholderAPI (required for placeholders)

Spigot / Paper 1.13+

🎯 Why ZxMenus?

ZxMenus gives you the core power of DeluxeMenus with a cleaner and simpler configuration system, making menu creation faster and easier for server owners.

ZxArena

# ZXArena

**ZXArena** is a powerful and flexible **Spigot arena management plugin** that enables server owners to create, store, and instantly reset arenas across multiple Minecraft versions.

Perfect for **PvP**, **minigames**, and **event-based servers**.

## Key Highlights

### Arena Creation & Restoration

* Select any region and save it as a reusable arena
* Reset arenas back to their original state at any time

### Reset Performance Modes

* **Normal Mode** – Balanced reset speed (~3–5 seconds)
* **Extreme Mode** – High-speed reset in about 1 second

### Selection Tool

* Use a **golden axe** to define arena boundaries
* Left-click and right-click to set region corners

### Arena Statistics

* Track last reset time
* View how long each reset took

### Version Compatibility

* Works seamlessly on **Minecraft 1.20.1 – 1.21.4**

### Advanced Formatting

* Supports standard Minecraft colors and **hex color codes**

### Smart Command Completion

* Full tab-completion for all commands and arguments

### PlaceholderAPI Integration

* Access arena data anywhere using placeholders

## Commands & Permissions

| Command | Purpose | Permission |
| —————————— | ——————————– | —————— |
| `/zxarena pos1` | Set first selection point | `zxarenaset.admin` |
| `/zxarena pos2` | Set second selection point | `zxarenaset.admin` |
| `/zxarena save ` | Save selected region as an arena | `zxarenaset.admin` |
| `/zxarena reset [mode]` | Reset arena (normal / extreme) | `zxarenaset.use` |
| `/zxarena delete ` | Remove an arena | `zxarenaset.admin` |
| `/zxarena list` | Show all arenas and stats | `zxarenaset.use` |
| `/zxarena setspawn ` | Set arena spawn point | `zxarenaset.admin` |
| `/zxarena givewand` | Receive the selection wand | `zxarenaset.admin` |
| `/zxarena reload` | Reload configuration files | `zxarenaset.admin` |
| `/zxarena help` | View command help | All players |
| `/zxarena version` | Show plugin version | All players |

## Permission Nodes

* **`zxarenaset.admin`** – Complete administrative access
* **`zxarenaset.use`** – Basic usage (reset, list, view info)

## Installation Guide

1. Download **`xArenaReset.jar`**
2. Move the file to your server’s `/plugins` directory
3. Restart or reload the server
4. Configuration files will generate automatically

## Configuration Settings

All options can be customized via the configuration file, including:

* Reset delays
* Custom messages & color formats
* Automatic reset intervals
* Global broadcast messages

## PlaceholderAPI Placeholders

### General

| Placeholder | Output |
| —————– | ———————– |
| `%zxarena_count%` | Total number of arenas |
| `%zxarena_list%` | List of all arena names |

### Arena-Specific

| Placeholder | Description |
| ——————————————- | ——————— |
| `%zxarena_info__name%` | Arena name |
| `%zxarena_info__world%` | World name |
| `%zxarena_info__blocks%` | Block count |
| `%zxarena_info__mode%` | Last reset mode |
| `%zxarena_info__last_reset%` | Time since last reset |
| `%zxarena_info__reset_duration%` | Reset duration |
| `%zxarena_info__spawn%` | Spawn coordinates |
| `%zxarena_info__region%` | Region boundaries |
| `%zxarena_info__autoreset%` | Auto-reset status |
| `%zxarena_info__autoreset_interval%` | Interval (seconds) |

### Raw Data

| Placeholder | Description |
| ——————————————- | ——————– |
| `%zxarena_info__raw_reset_duration%` | Reset time (ms) |
| `%zxarena_info__raw_last_reset%` | Last reset timestamp |

## Color Formatting

* Supports standard Minecraft color codes (`&a`, `&c`, etc.)
* Full **HEX color** support for modern servers