From f4a5633aab1a6c5dadef1b09d2f193bafde861d3 Mon Sep 17 00:00:00 2001 From: ZorahM Date: Thu, 1 May 2025 17:45:49 +0000 Subject: [PATCH] =?UTF-8?q?=D0=9E=D0=B1=D0=BD=D0=BE=D0=B2=D0=B8=D1=82?= =?UTF-8?q?=D1=8C=20readme.md?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- readme.md | 180 ++++++++++++++++++++++++++++++++++++++++-------------- 1 file changed, 133 insertions(+), 47 deletions(-) diff --git a/readme.md b/readme.md index d718dc3..7e992ad 100644 --- a/readme.md +++ b/readme.md @@ -1,63 +1,149 @@ -# SkyPvP Skript +# SkyPvP Skript 🚀 -![GitHub](https://img.shields.io/badge/Version-1.3.7-blue) -![GitHub](https://img.shields.io/badge/Minecraft-1.17+-brightgreen) -![GitHub](https://img.shields.io/badge/Skript-2.6+-orange) +**SkyPvP** — это динамичный и соревновательный скрипт для Minecraft PvP-серверов, работающий с **Skript**, **PlaceholderAPI** и **Vault**. +Подходит для режима «последний выживший», арен с хаотичными эффектами, системой Elo, престижами и ставками. +Идеально для захватывающих боёв на выживание! 🏟️ -Комплексный скрипт для PvP-режима с системой рейтинга, эффектами, ставками и достижениями. +> **Версия**: 1.3.7 +> **Автор**: Zorahm +> **Зависимости**: Skript, PlaceholderAPI, Vault -## 📌 Основные возможности +--- -- **Управление инвентарем** - автоматическая очистка при входе -- **Система рейтинга Elo** - динамический расчет уровня игрока -- **Хаотичные эффекты** - случайные эффекты для игроков -- **Механика победы** - последний выживший получает награды -- **Система ставок** - возможность ставить на себя или других игроков -- **Достижения** - уникальные цели с наградами -- **Престиж-система** - прогрессия для опытных игроков +## ✨ Особенности -## 🛠 Установка +### 🎮 Основной геймплей +- **Чистый старт**: очищение инвентаря, здоровье и сытость восстанавливаются, телепортация в лобби (`269.5, 118.0, 135.5`) +- **Механика победы**: автообъявление последнего выжившего, начисление Elo и монет, публичное сообщение +- **Контроль PvP**: отключено по умолчанию, включается только в бою +- **Дроп с убийств**: + - 🍏 50% — Золотое яблоко + - ⚡ 30% — Жемчуг Эндера + - ✨ 5% — Зачарованное золотое яблоко + - 🏹 3% — Улучшенный лук (Сила II, Бесконечность) -1. Убедитесь, что у вас установлены: - - Skript 2.6+ - - SkQuery (если требуется) - - PlaceholderAPI - - Vault (для экономики) +### 🎲 Хаотичные эффекты +- `/random_effects on` — включение случайных эффектов (права `skypvp.admin`) +- Более 30 эффектов: Левитация, Тошнота, Скорость и др. +- `/random_effects off` — отключение -2. Поместите файл скрипта в папку `plugins/Skript/scripts` +### 📊 Elo и ранги +- Ранги: от **Бездушный (<500)** до **Легенда (2500+)** +- `/ranks` — список рангов и текущий +- Управление Elo: `/elo give/take` +- Награды за убийства с учётом престижа -3. Перезагрузите сервер или выполните `/sk reload skypvp.sk` +### 💰 Магазин и экономика +- `/addshop` — купить и сохранить предмет +- `/shopitems_add` — добавить предмет в магазин игрока +- Интеграция с **Vault**: победы и убийства приносят монеты -## 🎮 Команды +### 🎰 Система ставок +- `/bet <сумма> [игрок]` — сделать ставку +- Выигрыш удваивается, проигрыш — потеря ставки +- 1 ставка за игру, игрок должен участвовать -### Для игроков -| Команда | Описание | -|---------|----------| -| `/stats [игрок]` | Показать статистику | -| `/bet <сумма> [игрок]` | Сделать ставку | -| `/ranks` | Просмотреть ранги | -| `/prestige` | Перейти на новый престиж | -| `/achievements` | Просмотреть достижения | +### 🏆 Достижения +- Примеры: "Первое убийство", "Смертельный выстрел", "Серия из 5 убийств" +- Награды: `+150 монет`, `+10 Elo` +- `/achievements [игрок]` — просмотр прогресса -### Для администраторов -| Команда | Описание | -|---------|----------| -| `/startgame` | Начать игру | -| `/random_effects on/off` | Включить/выключить хаотичные эффекты | -| `/elo give/take <игрок> <сумма>` | Управление рейтингом | -| `/border_set <размер>` | Установить размер границы | -| `/reset_all <игрок>` | Сбросить статистику игрока | +### 🌟 Престиж-система +- `/prestige` — переход на новый престиж (2500+ Elo) +- До 10 престижей +- Эффекты: сброс статистики, множитель наград (до x2), бонус монет -## ⚙️ Конфигурация +### 🌍 Управление границей +- `/border_set <размер>` — задать размер +- `/border_shrink <размер> <время>` — сжать границу +- `/border_stop` — остановить сужение +- `/border_reset` — сброс до 10 000 блоков +> **Центр карты**: `(9, -54, 12)` -Основные настройки можно изменить прямо в скрипте: +### 📜 Статистика и помощь +- `/stats [игрок]` — убийства, смерти, K/D, Elo, баланс, престиж +- `/help` — команды для игроков +- `/help-admin` — команды для админов -```skript -# Минимальная ставка -set {bet_min} to 10 +--- -# Стартовый Elo -set {elo::%player%} to 100 if not set +## 📦 Установка -# Список эффектов -set {effect_list::*} to "speed", "slowness", "haste", ... \ No newline at end of file +1. Убедитесь, что установлены: + - [Skript](https://github.com/SkriptLang/Skript) + - [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) + - [Vault](https://www.spigotmc.org/resources/vault.34315/) +2. Скопируйте файл `skypvp.sk` в папку: + `plugins/Skript/scripts/` +3. Перезагрузите скрипт: + ```bash + /sk reload skypvp.sk + ``` +4. При необходимости настройте координаты в коде (лобби, центр границы и арены) + +--- + +## 🔧 Команды + +### 👥 Для игроков + +| Команда | Описание | +|----------------------------------|------------------------------------------| +| `/stats [игрок]` | Просмотр статистики | +| `/bet <сумма> [игрок]` | Сделать ставку | +| `/ranks` | Список рангов и текущий | +| `/achievements [игрок]` | Прогресс достижений | +| `/prestige` | Переход на следующий престиж | +| `/prestige_info` | Информация о престиже | +| `/help` | Общая справка | + +### 🛠️ Для администраторов + +| Команда | Описание | +|-------------------------------------|-----------------------------------------| +| `/startgame` | Запуск игры | +| `/random_effects on/off` | Вкл/выкл хаотичные эффекты | +| `/elo give/take <игрок> <сумма>` | Управление Elo | +| `/shopitems_add <игрок> <предмет>` | Добавить предмет игроку | +| `/reset_all <игрок>` | Полный сброс статистики | +| `/border_set <размер>` | Установить границу | +| `/border_shrink <размер> <время>` | Сжать границу | +| `/border_reset` | Сброс границы | +| `/help-admin` | Справка по админ-командам | + +--- + +## 📋 Плейсхолдеры (PlaceholderAPI) + +Используйте префикс `skript_`: + +| Placeholder | Описание | +|--------------------------|-------------------------------| +| `%skript_kills%` | Кол-во убийств | +| `%skript_killstreak%` | Серия убийств | +| `%skript_winner%` | Победитель текущей игры | +| `%skript_alive%` | Живые игроки сейчас | +| `%skript_elo_rank%` | Ранг по Elo | +| `%skript_elo%` | Текущий Elo | + +--- + +## ⚠️ Примечания + +- Проверьте координаты телепортации (лобби, арена, граница) перед запуском +- **Vault обязателен** для работы экономики и ставок +- **Рекомендуется** тестировать хаотичные эффекты и границу на небольшой группе игроков + +--- + +## 🤝 Контрибьюторы + +- **Zorahm** — основной разработчик + +Хочешь внести вклад? Присылай [issue](https://git.zorahm.ru/FL/skypvp/issues) или pull request! 💡 + +--- + +## 📜 Лицензия + +Проект распространяется по лицензии **MIT** — свободно используйте и модифицируйте, но не забывайте указывать авторство. 😊 \ No newline at end of file