FlectoneAddons 🧩

⚠️ THIS IS NOT AN OFFICIAL FLECTONE PRODUCT

An unofficial community add-on for FlectonePulse. Please don't report its bugs to the FlectonePulse team.

FlectoneAddons adds what FlectonePulse doesn't ship: guest protection and alt-account detection.

It has no message renderer of its own. Everything it sends goes through FlectonePulse, so MiniMessage, gradients, legacy &-codes, PlaceholderAPI and tags like <online> or <replacement:tps> work in its messages the same way they work in your chat. Without FlectonePulse installed the plugin won't start.

---

🛡️ GuestMode

A new player joins and can look around, nothing else. Until they're verified:

Blocked	Details
🧱 The world	Any left-click and any right-click: breaking, placing, chests, ender chests, doors, trapdoors, buttons, levers, crafting tables, anvils, brewing stands, item frames, armor stands
🎒 Items	Dropping items and picking loot up off the ground
⚔️ PvP / PvE	Guests deal no damage, and hostile mobs ignore them
💬 Commands	Everything outside your allowed-commands list
🍗 Hunger	Food level doesn't drop, so an AFK guest won't starve

Three ways to let someone in:

• /fa verify add <player> — saved to verified-players.yml, survives restarts
• the flectoneaddons.module.guestmode.bypass permission — give it to a LuckPerms group and the whole rank is exempt at once
• OP is always exempt, automatically

A guest spamming a blocked action won't flood their own chat: one notification, then a cooldown you set in ticks (default 60, that's 3 seconds), with an optional sound.

The "you can't do that yet" text is written once and covers every blocked action, instead of five separate keys with the same sentence in them.

There's also an optional welcome message with {player} and a sound. Only guests see it, verified players don't get it again.

---

🔎 IpDetect

You ban a griefer, ten minutes later he's back under a new nickname. IpDetect tells your staff when it happens:

[IP] Griefer_Alt joined from an IP already used by: Griefer, OldAccount

• Alerts go only to holders of flectoneaddons.module.ipdetect.notify, regular players never see them
• No IP history of its own: the account list is read from FlectonePulse's database, the same one its /whois uses
• The query runs asynchronously through FlectonePulse's own scheduler, so it doesn't touch the main thread and works on Folia
• Alerts can also be printed to the console if you want them in your log

Blacklist

Moderators with the notify permission shouldn't be able to map out the owner's alt accounts. The blacklist hides players by nickname and by IP, and it works both ways: a protected player triggers no alerts and doesn't show up in anyone else's results either.

The list is filtered per recipient, not once for everyone. The owner (flectoneaddons.module.ipdetect.blacklist-bypass) sees everything, moderators see the filtered version, from the same event.

When someone looks up a protected player, the answer is identical to "no alts found", so the protection itself doesn't reveal who's on the staff list.

/ipcheck <player>

The manual lookup, behind flectoneaddons.command.ipcheck. Aliases: /alts, /altcheck.

Works for offline players too, since the target is looked up in FlectonePulse's database rather than among online players. The blacklist applies here as well, otherwise the command would just be a hole in it. Cooldown is optional.

---

🚀 Compatibility

Minecraft	1.20 → latest
Servers	Paper · Purpur · Spigot · Bukkit · Folia
Java	17+
Required	FlectonePulse 1.12.3+

Compiled for Java 17 so it still runs on older 1.20.x servers.

---

❓ FAQ

Nothing happens, or messages say Missing message: ... — your FlectonePulse is out of date. Check its version against the one above.

How do I exempt a whole rank? — grant flectoneaddons.module.guestmode.bypass to the LuckPerms group instead of verifying players one by one.

Can moderators see the owner's alts? — no, that's what ipdetect.blacklist is for. Keep blacklist-bypass for yourself.

🐛 Found a bug?

Report it on Discord: https://discord.flectone.net/. Mention your FlectonePulse version and server core, that answers most reports right away.

---

FlectoneAddons 🧩

⚠️ ЭТО НЕ ОФИЦИАЛЬНЫЙ ПРОДУКТ FLECTONE

Неофициальный аддон от сообщества для FlectonePulse. Не пишите о его багах разработчикам FlectonePulse.

FlectoneAddons добавляет то, чего нет в самом FlectonePulse: защиту от новичков-гриферов и обнаружение альт-аккаунтов.

Своего рендера сообщений у него нет. Всё, что он отправляет, идёт через FlectonePulse, поэтому MiniMessage, градиенты, legacy &-коды, PlaceholderAPI и теги вроде <online> или <replacement:tps> работают в его сообщениях так же, как в вашем чате. Без установленного FlectonePulse плагин не запустится.

---

🛡️ GuestMode

Зашёл новый игрок — может осмотреться, и всё. Пока он не верифицирован:

Заблокировано	Подробности
🧱 Мир	Любое действие ЛКМ и ПКМ: ломать, ставить, сундуки, эндер-сундуки, двери, люки, кнопки, рычаги, верстаки, наковальни, зельеварки, рамки, стойки для брони
🎒 Предметы	Выбросить предмет и подобрать лут с земли
⚔️ PvP / PvE	Гость не наносит урона, враждебные мобы его игнорируют
💬 Команды	Все, кроме указанных в allowed-commands
🍗 Голод	Шкала не убывает, АФК-гость не умрёт с голоду

Три способа пустить игрока:

• /fa verify add <ник> — сохраняется в verified-players.yml, переживает рестарт
• право flectoneaddons.module.guestmode.bypass — выдайте группе в LuckPerms, и весь ранг освобождается разом
• у ОПа ограничений нет никогда, автоматически

Гость, который долбит одно и то же запрещённое действие, не зафлудит себе чат: одно уведомление, дальше кулдаун, который вы задаёте в тиках (по умолчанию 60, это 3 секунды), и опциональный звук.

Текст «пока нельзя» пишется один раз и покрывает все запрещённые действия, вместо пяти отдельных ключей с одной и той же фразой.

Ещё есть опциональное приветствие с {player} и звуком. Его видят только гости, верифицированному игроку оно больше не показывается.

---

🔎 IpDetect

Забанили грифера, через десять минут он снова на сервере под новым ником. IpDetect сообщит администрации, когда это произойдёт:

[IP] Griefer_Alt зашёл с айпи, с которого уже играли: Griefer, OldAccount

• Оповещения приходят только обладателям flectoneaddons.module.ipdetect.notify, обычные игроки их не видят
• Своей истории IP плагин не ведёт: список аккаунтов читается из базы FlectonePulse, той же, по которой работает его /whois
• Запрос выполняется асинхронно через планировщик самого FlectonePulse, поэтому не трогает основной поток и работает на Folia
• Оповещения при желании дублируются в консоль, чтобы остались в логе

Blacklist

Модератор с правом на оповещения не должен собирать список альтов владельца. Blacklist скрывает игроков по нику и по IP и работает в обе стороны: защищённый игрок и сам не вызывает оповещений, и в чужих результатах не появляется.

Список фильтруется под каждого получателя, а не один раз на всех. Владелец (flectoneaddons.module.ipdetect.blacklist-bypass) видит всё, модератор — отфильтрованное, из одного и того же события.

На проверку защищённого игрока приходит тот же ответ, что и при «альтов не найдено», так что сама защита не выдаёт состав администрации.

/ipcheck <ник>

Ручная проверка под правом flectoneaddons.command.ipcheck. Алиасы: /alts, /altcheck.

Работает и по оффлайн-игрокам, потому что цель ищется в базе FlectonePulse, а не среди онлайна. Blacklist действует и здесь, иначе команда была бы дырой в нём. Кулдаун опционален.

---

🚀 Совместимость

Minecraft	1.20 → последняя
Ядра	Paper · Purpur · Spigot · Bukkit · Folia
Java	17+
Требуется	FlectonePulse 1.12.3+

Собран под Java 17, чтобы работать и на старых 1.20.x серверах.

---

❓ FAQ

Ничего не происходит или в чат идёт Missing message: ... — у вас устаревший FlectonePulse, сверьте версию с указанной выше.

Как освободить целый ранг? — выдайте группе в LuckPerms право flectoneaddons.module.guestmode.bypass, вместо того чтобы верифицировать по одному.

Могут ли модераторы посмотреть альты владельца? — нет, для этого и нужен ipdetect.blacklist. Право blacklist-bypass оставьте себе.

🐛 Нашли баг?

Пишите в Discord: https://discord.flectone.net/. Укажите версию FlectonePulse и ядро сервера, это сразу закрывает большинство вопросов.