Город 3D

Высокопроизводительный 3D-плагин защиты земли для серверов Hytale с управлением городом / страной, требованиями к участкам, контролем PvP и расширенными системами разрешений с корутинами Kotlin и пространственной индексацией.

Состояние: Альфа - Этот плагин является экспериментальным и находится в активной разработке. Он был портирован из API Spigot в API Hytale с широким использованием кода Claude, в основном полагаясь на декомпилированный исходный код сервера Hytale.

Зависимости

Требуется:

• Кассафорте Плагин реестра услуг для экономии, разрешений и интеграции чата

• Любой экономичный плагин, совместимый с кассафорте, например Простая экономика или Экономика

Towny3D требует установки и загрузки Cassaforte. Cassaforte предоставляет сервисный реестр, который Towny3D использует для интеграции экономики (в случае отсутствия такового)

Ключевые особенности

3D система претензий

Towny3D представляет настоящие 3D претензии на землю - вы можете иметь несколько участков в одном куске на разных вертикальных уровнях! Просто выберите нижнюю и верхнюю точки желаемой области участка с помощью клюшки претензии, затем запустите команду претензии.

• Вертикальная гранулярностьУкажите конкретные диапазоны Y-осей, а не целые куски
• пространственная индексация: Быстрый поиск областей с оптимизированным пространственным кэшем
• Претензионный Stick: Использовать /claim gcs (Get claim stick) — установить границы

Реализованные особенности

Управление городом

• /town create <townName> Создать новый город
• Городок удалить - Распустить свой город
• /town info [название города] Посмотреть городскую информацию
• Городской список Список всех городов
• /town join <townName> Присоединяйтесь к открытому городу
• Городской отпуск - Оставьте свой нынешний город

Национальный менеджмент

• /nation create <nationName> Создать новую нацию
• /нация удалить Распустить свою нацию
• /nation info [название страны] Просмотр национальной информации
• Список стран Список всех наций
• /nation join <nationName> Присоединяйтесь к открытой нации
• /национальный отпуск Оставьте свою нынешнюю нацию
• /nation invite <townName> Пригласите город в свою страну
• /nation kick <townName> - Выбирай город из своей страны

Управление проектами

• Претензия /plot - Утверждай, что ты в этом замешан.
• /plot unclaim - Откажитесь от сюжета, в котором вы стоите
• /plot forsale <цена> (alias: /plot fs- Выставить участок на продажу
• /plot Notforsale (alias: /plot nfs) - Удалить участок с рынка
• /plot info Просмотр сюжетной информации
• /plot name <name> Назови свой участок.
• /plot showBorders (alias: /plot sb) - Показать границы сюжета визуально
• /plot hideBorders (alias: /plot hb) - Скрыть границы участка

Заявочные команды

• /claim gcs (Get claim stick) - Получить элемент, чтобы установить нижние и верхние точки сюжета
• /claim [чахать] Заявка на землю в выбранном 3D регионе
• автозавод Автоматически претендовать на прилегающую землю
• /claim unclaim Невостребованная земля города

Команды выбора (стиль WorldEdit)

• p1 Установите первую позицию (нижний угол) для выбора региона
• p2 - Установить вторую позицию (верхний угол) для выбора региона
• /pos1 Алиас для p1
• /pos2 Алиас для p2

Городские туфли

• /toggle pvp [включено/выключено] Toggle PvP в городе
• /toggle public [включено/выключено] - Переключать общественный статус
• /toggle explosions [включено/выключено] - Защита от взрыва
• /toggle open [включено/выключено] Открытый Toggle

Чат-система

• /tc <message> (alias: /townchat- Отправить сообщение в городской чат
• /nc <message> (alias: /nationchat- Отправить сообщение в национальный чат
• /g <сообщение> (alias: /globalchat- Отправить сообщение в глобальный чат
• / Chat Town | Нация | Глобальный - Режим чата по умолчанию

Экономика

• / Баланс (alias: бальПроверьте свой баланс (только с внутренней экономикой)
• Остаток резидента Проверить баланс резидента
• Городской баланс Проверьте баланс городского банка
• Баланс нации Проверьте баланс национального банка
• /eco give <player> <mount> Отдайте деньги игроку
• /eco take <player> <mount> - Берите деньги у игрока
• /eco set <player> <mount> Установить баланс игрока
• /eco balance <player> Проверьте баланс игрока

Примечание: Экономные команды доступны только при использовании внутренней экономики Towny3D. Если доступна внешняя экономика (например, встроенный или другой плагин Cassaforte), используйте команды этой экономики. Towny3D автоматически возвращается к внутренней экономике, если нет внешней экономики.

Поддержание и налогообложение

Towny3D имеет комплексную систему обслуживания и налогообложения для поддержания экономического баланса и поощрения активного участия.

Типы налогов:

• Городское содержание Периодические затраты городов на оплату сервера (конфигурируемые, по умолчанию отключены)
• Сохранение нации Периодическая стоимость, которую страны платят серверу (конфигурируемый, по умолчанию отключенный)
• Национальные налоги Страны могут облагать налогом города-члены (плоская сумма или процент городского баланса)
• Городские налоги Города могут облагать налогом жителей (плоская сумма или процент от остатка жителей)
• Налоги на участки Города могут устанавливать налоги на отдельные участки (плоская сумма или процент)

Налоговые команды:

• /городской налог <flat |%> <сумма> Установите налог на резидентов для вашего города
• Городской налоговый отчет Чистый налог резидента
• / Городская налоговая информация Посмотреть городские налоговые настройки
• /nation tax <flat |%> <сумма> Установить налог на города-члены
• /Национальный налог ясно Чистый национальный налог
• /nation tax information Посмотреть национальные налоговые настройки
• Государственный долг [город] Посмотреть Долги города перед страной
• /plot tax <flat |%> <сумма> - Установить налог на текущий участок
• /plot tax clear Чистый налог на участок
• /plot tax information - Посмотреть сюжет налоговая информация
• /налог Покажите свое личное налоговое бремя
• /налоговый город <name> - Посмотреть городскую налоговую информацию
• /tax nation <name> - Посмотреть национальную налоговую информацию

Административный налог Команды:

• /та сборных налогов Принудить к немедленному сбору налогов
• /ta nexttax Показать, когда будет следующий сбор
• /ta reclaim <town |nation> <имя> Восстановление разрушенной сущности
• /ta ruinate[править править код] <имя> Сущность силы в разрушенном состоянии
• /ta settaxtime <HH:mm> Изменение времени сбора налогов
• /taggle upkeep - Включить/отключить систему технического обслуживания

Последствия:

• Город / Страна не может платить содержание Падение в руины (можно вернуть за плату)
• Житель не может платить налог на земельный участок ? Потеря права собственности на участок
• Резидент не может платить налог резидента Пропущенные платежи (без долгов)
• Город не может платить национальный налог ? Влезает в долги, не может покинуть страну

Приглашения

• /принять - Принять ожидающее приглашение города/нации
• /упадок - Отклонить ожидающее приглашение

Административные команды ()/таунадмин)

• /ta скачать - Перезагрузка конфигурации плагина
• /ta Экономия - Force Save All Data
• /ta Статистика - Посмотреть статистику плагинов
• /ta unclaim - Невостребованная административная сила
• /ta сброс - Сбросить данные плагина

Командование резидентов

• /res (alias: /резидент) - Корень команды резидента
• /res info [игрок] Посмотреть информацию о резидентах
• /res список Перечислить всех жителей
• / Баланс Проверить баланс

Системы защиты

• Защита юридических лицКонтролировать нерест и взаимодействия
• Защита от взрывовПредотвращение повреждений от взрывов
• Игровые взаимодействия: Размещение блока управления, взлом и использование элементов
• PvP контрольПрекраснозернистый PvP Toggle per region
• Chunk Enter Уведомления: Показать город / регион информация о въезде

Планируемые функции (пока не реализованы)

Городские команды

• Городской мэр Подменю мэра
• Городок Добавить Ассистент <playerName> Добавить помощника
• /town removeПомощник <playerName> - Уберите помощника.
• Городской набор Домой - Установить точку нереста в городе
• /городской нерест Телепорт в город Испания
• Город онлайн Список онлайн-резидентов
• /Город здесь - Покажите информацию о городе, в котором вы находитесь
• /town kick <playerName> Житель города Kick
• /городской депозит <сумма> - Депозит в городской банк
• /town withdraw <сумма> - Вывод из городского банка
• /town set perm <permGroup> <permType> <value> - Установите городские разрешения

Игровые команды

• /plot toggle <flag> [включено/выключено] - Флаги заговора (pvp, взрыв, огонь, толпа)
• /plot set perm <permGroup> <permType> <value> - Установите разрешения на сюжет
• /plot set Посольство Марк заговор как посольство
• /plot reset - Перезагрузить график по умолчанию

Городская система разрешения и флага

Система флага частично реализована для перетасовки сюжета. Планируются разрешительные группы.

Флаги (через /plot toggle):

• pvp Игрок против бойца игрока
• взрыв - Повреждение от взрыва
• огонь - Пожар распространился и повредил

Планируемые флаги:

• Обсуждение Friendly_mobs_spawn - Дружественная толпа
• Исполнитель: Mobs_Spawn Враждебная толпа

Планируемые разрешения (для групп: res/ally/gen):

• pvp Игрок против бойца игрока
• инвентаризация - Доступ к инвентаризации
• взаимодействовать - Блок взаимодействия
• строить Размещать блоки
• разрушать Разбить блоки
• капать - Бросать предметы
• выбор - Подбирать вещи
• двигаться - Движение

Особенности Admin

• /townyadmin чат шпион Шпион по городу / нации чаты

Разрешения

Весь город3 D разрешения использовать Towny3d. префикс. Разрешения автоматически проверяются системой разрешений сервера Hytale.

Разрешения по умолчанию

Командные разрешения

Генеральское командование

Городские команды ()город, /т)

Национальные команды ()нация)

Командование сюжетом ()/plot)

Заявочные команды ()претензия)

Чат команд ()/chat, /tc, nnc, г)

Пригласить команду ()приглашать, /принять, /упадок)

Команды Toggle/ggle)

Административные команды ()/та)

Командования администратора экономики ()Эко)

Пример настройки разрешения

Разрешение Буккит / Дефолт

# Игроки получат доступ к базовому городу
Towny3d.town - оригинальное название
towny3d.town.info: истинный
towny3d.town.list: правда
towny3d.town.join: оригинальное название
towny3d.town.leave: оригинальное название
Towny3d.resident: настоящее
towny3d.resident.info: правда
Towny3d.balance: правда

# Дать мэрам дополнительные разрешения
towny3d.town.create - оригинальное название
towny3d.town.claim: правда
towny3d.town.kick: правда
towny3d.town.invite: правда
towny3d.plot: правда
towny3d.plot.claim: правда
Towny3d.toggle: правда

# Дайте администраторам полный доступ
towny3d.admin: истинный

Лакпермс

# Группа игроков по умолчанию
Разрешение на групповой дефолт устанавливает city3d.town true
Разрешение по умолчанию для группы lp устанавливает cityy3d.town. Информация правдивая
lp group default permission set towny3d.town.list true
lp group default permission set town3d.town.join true
Разрешение по умолчанию для группы lp установлено Towny3d. Реальный резидент
Разрешение по умолчанию для группы lp установлено Towny3d. баланс истинный

# Ранг мэра
Разрешение мэра ИП-группы установлено towny3d.town. Создать истинное
Разрешение мэра ИП-группы установлено towny3d.town. утверждение истинного
Разрешение мэра ИП-группы установлено towny3d.plot true
Разрешение мэра ИП-группы: city3d.toggle true

# Административный ранг
lp group admin permission set towny3d. истинный

Ультраразрешения

группы:
по умолчанию:
разрешения:
Город 3d.town
Towny3d.town.info
- towny3d.town.list
Towny3d.town.join
Towny3d.резидент
- Towny3d. баланс
Мэр:
разрешения:
- Towny3d.town. *
- Towny3d.plot. *
- towny3d.toggle. *
администратор:
разрешения:
- Towny3d.*

Архитектура

Оптимизация производительности

• Котлин КорутинсАсинхронные операции для ввода/вывода базы данных и сетевых вызовов
• Каширование кофеинаВысокопроизводительное кэширование для городов, наций, жителей и регионов
• пространственная индексацияЭффективный 3D-поиск областей с пространственным кэшем
• АккумуляторПериодическая партия пишет для сокращения операций ввода/вывода

хранение

• JSON Backend для хранения данных
• Автоматическая экономия с настраиваемыми интервалами
• Бэтч-писатель для эффективных записей

Статус развития

Это и есть альфа освободить. Многие основные функции работают, но ожидают ошибок и отсутствующей функциональности. Плагин разрабатывается без официальной документации Hytale, опираясь на декомпилированный серверный код.

Известные ограничения

• API может значительно измениться по мере обновления сервера Hytale
• Некоторые особенности оригинала Город еще не портирован
• Тестирование ограничено доступными серверными версиями

Вклад

Это личный проект, разработанный для того, чтобы привнести в Hytale функциональность, подобную Towny. Вклад приветствуется, когда плагин стабилизируется.

Кредиты

• Вдохновленный Город 3D Minecraft/Spigot, автором которого я являюсь
• Портирован в Hytale API через реверс-инжиниринг