Skip to content

sRandomRTP 3.1

Latest
Latest

Choose a tag to compare

View all tags
@snezhok69 snezhok69 released this 24 May 10:59
3.1
9ab96b6

SAVE ALL YOUR PLUGIN(SRANDOMRTP)
DATA BEFORE UPDATING!!!!!!!!!!!!!!!!

New Commands Added!

  1. The following admin/support commands have been added:

/rtp settings
/rtp doctor
/rtp dump
/rtp stats
/rtp portal check
/rtp tpsbar

/rtp rambar
/rtp msptbar
/rtp allbars

1.1. /rtp settings - opens a clickable in-game menu for enabling or disabling plugin subcommands.
Permission: sRandomRTP.Command.Settings
Default: disabled in Settings/commands.yml

1.2. /rtp doctor - shows the plugin health status: Java version, server version, Paper/Folia, language, optional plugins, config versions, active RTP searches, portal tasks, and admin bossbar status.
Permission: sRandomRTP.Command.Doctor
Default: disabled in Settings/commands.yml

1.3. /rtp dump - creates a support zip in plugins/sRandomRTP/Diagnostics with diagnostics, recent errors, and runtime information.
Permission: sRandomRTP.Command.Dump
Default: disabled in Settings/commands.yml

1.4. /rtp stats - shows live runtime statistics: active searches, total RTP count, cooldowns, portal tasks, completed/cancelled/refunded teleports, and average search timings.
Permission: sRandomRTP.Command.Stats
Default: disabled in Settings/commands.yml

1.5. /rtp portal check - checks portals for missing worlds, duplicate world + portal names, and active portal tasks.
Permission: sRandomRTP.Command.Portal.Check
Default: disabled in Settings/commands.yml

1.6. /rtp tpsbar, /rtp rambar, /rtp msptbar, /rtp allbars - optional admin bossbars for TPS, RAM, MSPT, or all bars at once.
Permissions: sRandomRTP.Command.TpsBar, sRandomRTP.Command.RamBar, sRandomRTP.Command.MsptBar, sRandomRTP.Command.AllBars
Default: disabled in Settings/commands.yml

New Stability Features!

  1. Chunk warming, portal particles/triggers, admin bossbars, and update-check callbacks now avoid unsafe async Bukkit API access.

  2. RTP counting is now saved in batches instead of writing Data/rtpCount.yml after every teleport.

  3. Cooldown-bypass teleports are counted correctly.

  4. Cooldown permissions such as sRandomRtp.Cooldown.N now work more consistently and also affect the bossbar countdown.

  5. Reload now sends a successful reload message after the plugin finishes reloading.

  6. /rtp cancel, movement cancellation, duplicate RTP requests, player quit during teleport, and refund handling were made safer.

  7. Fixed Minecraft version detection for the new Java Edition version scheme, including 26.1, 26.1.1, and newer 26.x builds.

Configuration & Localization Update!

config.yml: added diagnostic, Command-Aliases-Enabled, Command-Aliases, metrics.rtp.slow-request-threshold-ms, and updated permission comments.

Settings/commands.yml: added runtime switches for /rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, and admin bossbar commands. These debug/admin commands are disabled by default.

Settings/admin-bars.yml: added configurable TPS, RAM, and MSPT bossbars with titles, colors, styles, thresholds, and messages.

Settings/biome.yml: added a dedicated profile for /rtp biome search behavior.

Settings/teleport.yml: added safer search and chunk options, including parallel-search and prefer-generated-chunks settings.

plugin.yml: permissions were expanded for the new commands, and static aliases were removed from plugin.yml.

Command aliases were moved to config.yml:

Command-Aliases-Enabled: false
Command-Aliases:

  • randomtp
  • randomteleport

Aliases are disabled by default. Set Command-Aliases-Enabled to true if you want /randomtp and /randomteleport to work.

Localizations in lang/*.yml were extended for:

/rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, admin bossbars, invalid-command, reload success messages, and updated help lines.

Small Changes!

  1. LuckPerms is no longer required as a hard dependency; optional integrations now fail more gracefully.

  2. The unknown-command message is now configurable through localization instead of always using the server default.

  3. Config updates now create backups and write Diagnostics/config-changes.txt.

  4. Startup, reload, config-change, backup, and slow RTP diagnostics now run only when diagnostic: true is enabled.

  5. Portal storage, portal cleanup, portal particles, and portal cooldown handling were improved.

  6. PlaceholderAPI values and public RTP/portal events were added for integrations.

  7. Auto-reload now applies config.yml language/diagnostic/alias changes and Settings/commands.yml command switches after saving the file.

Important for Server Owners!

  1. Player RTP commands stay enabled by default. The new support/debug commands and admin bossbars are disabled by default, even for OP, until you enable them in Settings/commands.yml or through /rtp settings after enabling that menu.

  2. /rtp settings is also disabled by default. To manage command switches in-game, first set commands.admin.settings.enabled: true in Settings/commands.yml.

  3. /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, /rtp tpsbar, /rtp rambar, /rtp msptbar, and /rtp allbars are intended for server owners, administrators, and support/debug use. Regular players do not need them for normal RTP gameplay.

  4. diagnostic: false is the default. With this setting, the plugin will not create Diagnostics files automatically. Enable diagnostic: true only when you want full startup/reload/config-change/slow-RTP reports.

  5. Command aliases are also disabled by default. Enable Command-Aliases-Enabled: true in config.yml if you want /randomtp and /randomteleport.

  6. Existing configs are migrated without overwriting your custom values. As usual, make a backup before updating a production server.

Notes

Update 3.1 is mainly a stability, diagnostics, and compatibility update after the large 3.0 release. Most new admin/support commands are disabled by default, so normal players will keep using the plugin like before unless you enable those tools in Settings/commands.yml.

Please report bugs on the Discord server or create a GitHub issue.

СОХРАНИТЕ ВСЕ ДАННЫЕ ПЛАГИНА (SRANDOMRTP)
ПЕРЕД ОБНОВЛЕНИЕМ!!!!!!!!!!!!!!!!

Новые команды!

  1. Добавлены следующие админские/служебные команды:

/rtp settings
/rtp doctor
/rtp dump
/rtp stats
/rtp portal check
/rtp tpsbar

/rtp rambar
/rtp msptbar
/rtp allbars

1.1. /rtp settings - открывает кликабельное меню прямо в игре для включения или выключения подкоманд плагина.
Пермишион: sRandomRTP.Command.Settings
По умолчанию: выключена в Settings/commands.yml

1.2. /rtp doctor - показывает состояние плагина: версию Java, версию сервера, Paper/Folia, язык, optional-плагины, версии конфигов, активные RTP-поиски, задачи порталов и статус admin bossbar.
Пермишион: sRandomRTP.Command.Doctor
По умолчанию: выключена в Settings/commands.yml

1.3. /rtp dump - создаёт support zip в plugins/sRandomRTP/Diagnostics с диагностикой, последними ошибками и runtime-информацией.
Пермишион: sRandomRTP.Command.Dump
По умолчанию: выключена в Settings/commands.yml

1.4. /rtp stats - показывает живую статистику: активные поиски, общий RTP count, cooldowns, задачи порталов, completed/cancelled/refunded телепорты и среднее время поиска.
Пермишион: sRandomRTP.Command.Stats
По умолчанию: выключена в Settings/commands.yml

1.5. /rtp portal check - проверяет порталы на отсутствующие миры, дубли world + portalName и активные portal tasks.
Пермишион: sRandomRTP.Command.Portal.Check
По умолчанию: выключена в Settings/commands.yml

1.6. /rtp tpsbar, /rtp rambar, /rtp msptbar, /rtp allbars - дополнительные admin bossbar для TPS, RAM, MSPT или всех bar сразу.
Пермишионы: sRandomRTP.Command.TpsBar, sRandomRTP.Command.RamBar, sRandomRTP.Command.MsptBar, sRandomRTP.Command.AllBars
По умолчанию: выключены в Settings/commands.yml

Новая стабильность!

  1. Chunk warming, частицы/триггеры порталов, admin bossbar и callbacks проверки обновлений теперь не трогают Bukkit API из небезопасных async-потоков.

  2. Счётчик RTP теперь сохраняется пачками, а не пишет Data/rtpCount.yml после каждого телепорта.

  3. RTP через cooldown bypass теперь тоже корректно считается.

  4. Cooldown-пермишионы вроде sRandomRtp.Cooldown.N теперь работают стабильнее и также влияют на bossbar-отсчёт.

  5. Reload теперь пишет сообщение об успешной перезагрузке после завершения reload.

  6. /rtp cancel, отмена при движении, повторные RTP-запросы, выход игрока во время телепорта и возврат денег после отмены стали безопаснее.

  7. Исправлено определение версии Minecraft для новой схемы Java Edition, включая 26.1, 26.1.1 и более новые 26.x сборки.

Обновление конфигов и локализации!

config.yml: добавлены diagnostic, Command-Aliases-Enabled, Command-Aliases, metrics.rtp.slow-request-threshold-ms и обновлённые комментарии по permissions.

Settings/commands.yml: добавлены переключатели для /rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check и admin bossbar-команд. Эти debug/admin команды выключены по умолчанию.

Settings/admin-bars.yml: добавлены настраиваемые bossbar для TPS, RAM и MSPT с заголовками, цветами, стилями, порогами и сообщениями.

Settings/biome.yml: добавлен отдельный профиль для поведения поиска через /rtp biome.

Settings/teleport.yml: добавлены более безопасные настройки поиска и чанков, включая parallel-search и prefer-generated-chunks.

plugin.yml: расширены permissions для новых команд, а статичные aliases удалены из plugin.yml.

Алиасы команд перенесены в config.yml:

Command-Aliases-Enabled: false
Command-Aliases:

  • randomtp
  • randomteleport

Алиасы выключены по умолчанию. Поставьте Command-Aliases-Enabled: true, если хотите включить /randomtp и /randomteleport.

Локализации в lang/*.yml расширены для:

/rtp settings, /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, admin bossbar, invalid-command, сообщения успешного reload и обновлённых help-строк.

Мелкие изменения!

  1. LuckPerms больше не является жёсткой зависимостью; optional-интеграции теперь обрабатываются мягче.

  2. Сообщение о неизвестной команде теперь настраивается через локализацию, а не всегда берётся стандартный текст сервера.

  3. При обновлении конфигов теперь создаются backup-файлы и пишется Diagnostics/config-changes.txt.

  4. Диагностика startup, reload, config-changes, backup и slow RTP теперь работает только при diagnostic: true.

  5. Улучшены хранение порталов, очистка порталов, частицы порталов и cooldown порталов.

  6. Добавлены PlaceholderAPI значения и публичные RTP/portal events для интеграций.

  7. Auto-reload теперь применяет изменения языка/diagnostic/алиасов из config.yml и переключатели команд из Settings/commands.yml после сохранения файла.

Важно для владельцев серверов!

  1. Игровые RTP-команды для игроков остаются включены по умолчанию. Новые support/debug команды и admin bossbar выключены по умолчанию даже для OP, пока вы сами не включите их в Settings/commands.yml или через /rtp settings после включения этого меню.

  2. /rtp settings тоже выключена по умолчанию. Чтобы управлять переключателями команд прямо из игры, сначала поставьте commands.admin.settings.enabled: true в Settings/commands.yml.

  3. /rtp doctor, /rtp dump, /rtp stats, /rtp portal check, /rtp tpsbar, /rtp rambar, /rtp msptbar и /rtp allbars нужны владельцам сервера, администраторам и поддержке для проверки/отладки. Обычным игрокам они не нужны для стандартного RTP.

  4. diagnostic: false стоит по умолчанию. При этом плагин не создаёт Diagnostics-файлы автоматически. Включайте diagnostic: true только если нужны полные отчёты запуска, reload, изменений конфигов и медленных RTP.

  5. Алиасы команд тоже выключены по умолчанию. Включите Command-Aliases-Enabled: true в config.yml, если хотите использовать /randomtp и /randomteleport.

  6. Старые конфиги мигрируются без перезаписи пользовательских значений. Как обычно, перед обновлением рабочего сервера лучше сделать backup.

Примечания

Обновление 3.1 в основном про стабильность, диагностику и совместимость после большого релиза 3.0. Большинство новых admin/support команд выключены по умолчанию, поэтому обычные игроки продолжат пользоваться плагином как раньше, пока вы сами не включите эти инструменты в Settings/commands.yml.

Если найдёте баги, пишите на Discord-сервер или создавайте GitHub issue.

Assets 3
Loading