FacilisCommon






[](https://www.codefactor.io/repository/github/dev7ex/faciliscommon)



___

Report a Bug

Wiki

Discord Community
___
» FacilisCommon is a useful library for Minecraft plugins.
» The goal of this project is to make plugin writing even easier and more elegant.
» The code in this project is not only written by me but also consists partly of code from other developers, which was either modified or taken over directly.
___
» At present, the FacilisCommon Bukkit version does not include any commands on its own.
___
» GitHub Repository
___
» MultiWorld version 1.3.0 or higher
» MultiPerms version 1.0.0 or higher
» MultiWarp version 1.0.0 or higher
___
## Setup Instructions
1. **Download the version you need:**
[Download from Modrinth](https://modrinth.com/plugin/faciliscommon)
2. **Put FacilisCommon in your plugins folder**
3. **Restart the server**
___
✓ Bukkit
✓ BungeeCord [Download]
X Craftbukkit
X Sponge
✓ Velocity
F3Name-Fixed
# F3Name – Edit server brand in debug screen
This is my fork of [original](https://www.spigotmc.org/resources/f3name-edit-your-server-brand-in-debug-screen.58997/) plugin that fixes joining issue on 1.20.3+.
Also thanks to [Marcelektro](https://github.com/Marcelektro), original fix author
—
### Info
With release of Minecraft 1.13, server owners got an additional place to show information to players. And this place is… debug screen!
With this plugin you can easily edit server brand from default (“Spigot”, or very long Bungee version) to whatever you want.
### Features
* Edit server brand in debug screen (F3)
* Colors and animation
* Easy configuration
* Both BungeeCord and Spigot
* Supports PlaceholderAPI
* Vault (basic) or LuckPerms (advanced) group support
* Built-in placeholders for BungeeCord
### BungeeCord placeholders
– `%player_name%` – player name
– `%player_displayname%` – player displayname
– `%player_uuid%` – player UUID
– `%player_ping%` – player ping
– `%server_name%` – server name
– `%server_motd%` – server motd
### Commands
– `/f3name` `/debugname` `/f3n` `/f3namebukkit` – aliases for Bukkit
– `/f3nameb` `/f3namebungee` – aliases for BungeeCord
– `/f3name reload` – reload configuration
### Permissions
– `f3name.reload` – permission for reload
EzHub

### Description
A simple plugin for sending player to the lobby.
### Commands
/lobby – Join Lobby
/hub – Join Lobby
### Config
“`
hub-server: “hub” #Hub Server Name
hub-teleport: “§aYou have been sent to the hub!” # Teleport Message
hub-not-available: “§cHub server is not available.” # Not Available Message
only-players: “§cOnly players can use this command.” # Console Execute Message
“`
EzDiscordLink
—
# EzDiscordLink
**The simplest way to share your Discord community with your players.**
EzDiscordLink provides an elegant, no-fuss solution for servers wanting to connect their Minecraft community with Discord. With just a simple command, players can instantly access your server’s Discord invite.
## ✨ Features
– **Simple Commands** – Players can use `/discord` or `/dc` to get your server’s Discord link
– **Rich Formatting** – Beautiful, customizable messages with color codes and hover effects
– **Multi-Display Options** – Show invites via chat messages, action bar, or both
– **Sound Notifications** – Optional audio feedback when players use the command
– **Fully Customizable** – Every message, color, and format is configurable
– **Lightweight** – Minimal performance impact on your server
– **Placeholder Support** – Dynamic content with `{link}` placeholder
## ⚙️ Config Preview
“`yaml
discord:
link: “https://discord.gg/yourserver”
messages:
chat-enabled: true
actionbar-enabled: true
hover: “&aClick to open Discord invite!”
sound:
enabled: true
type: “ENTITY_PLAYER_LEVELUP”
“`
## 🎨 Customization
The plugin comes with a comprehensive config file that lets you control:
– Chat message format with multi-line support
– Hover tooltips for interactive links
– Action bar notifications
– Sound effects (type, volume, and pitch)
– Error messages
– Enable/disable individual features
All messages support Minecraft color codes (`&a-&f`) and formatting codes for complete visual control.
## 🚀 Quick Setup
1. Drop the plugin into your `plugins` folder
2. Restart your server
3. Edit `config.yml` and add your Discord invite link
4. Reload and you’re done!
## 📋 Commands
– `/discord` – Display the Discord invite
– `/dc` – Shorthand alias for `/discord`
—
**Made with ❤️ by A3rial Studios**
exaroton
exaroton Proxy Plugin
A proxy plugin designed to use exaroton servers in your proxy network.
This plugin automatically updates exaroton servers in your proxy and allows you to manage them.
Installing this plugin on proxies that do not run on exaroton but use exaroton servers is also supported.
## About exaroton
exaroton provides high-end on demand game servers. This is very
useful for proxy networks as you can turn off servers which aren’t used right now to save money and start them
automatically when you need them.
## Commands
The Plugin provides the `/exaroton` command with the following subcommands:
| Command | Arguments | Description | Permission Node |
|———-|————————|———————————————————————————————————————————————————-|——————-|
| start | | Start a server and automatically add it to the network when it goes online | exaroton.start |
| stop | | Remove a server from the proxy and stop it | exaroton.stop |
| restart | | Restart a server | exaroton.restart |
| add | | Add a server that’s already online to your proxy | exaroton.add |
| remove | | Remove a server from your proxy | exaroton.remove |
| switch | [] | Start a server (if needed) and transfer the selected players to it. If no players are specified the player who executed the command will be transferred. | exaroton.switch |
### Permissions
Commands are not available to players by default. You can give players access to the commands by giving them the
required permission nodes. The `exaroton` permission node is required for all commands.
## Configuration
Since this plugin uses the exaroton API to manage servers, you need to provide an API token, which can be obtained
on https://exaroton.com/account/. You can also configure this plugin to start servers alongside your proxy (e.g. for
your main lobby) and stop servers when the proxy stops.
It’s also possible to disable the watch servers feature which automatically removes servers from the proxy when they
go offline.
### Default configuration
“`toml
# exaroton API token. You can generate this on https://exaroton.com/account/
apiToken = ‘example-token’
# Watch servers in the proxy config and automatically remove them when they go offline
# Note that this only works if you use .exaroton.me addresses in your velocity config.
watchServers = true
# Automatically start servers when the proxy starts
[autoStartServers]
enabled = false
servers = [“example.exaroton.me”]
# Automatically stop servers when the proxy stops
[autoStopServers]
enabled = false
servers = [“example.exaroton.me”]
“`
## Bukkit plugin
The bukkit plugin forwards commands from your backend servers to the proxy using plugin messages. This makes it possible to use these commands in command blocks or other plugins (e.g. for NPCs).
Since plugin messages are sent using a player connection, at least one player has to be connected to the backend server. If the plugin is missing from one of your proxies, the player could read the command that would have been executed.
Selectors like `@a`, `@p` and `@r` will automatically be replaced on the backend server. `@a` therefore refers to all players on the backend server, not all players on the proxy. These selectors are not supported on the proxy directly.
## Using multiple Proxies
Since this plugin does not synchronize the proxy servers with each other, there are some limitations when you try to
use it with multiple proxies. Starting a server using `/exaroton start ` only adds the server to the proxy you
are connected to right now. Stopping/Restarting works across proxies, assuming that all proxies have the plugin
installed as they will automatically remove the server when it is no longer online and will automatically add it back
once it comes back online.
If all servers you intend to use with the proxy are already in your proxy configuration, starting a server should also
work across proxies because the other proxies are already watching the status of this server.
EpicGuardPlus
# EpicGuardPlus
🛡️➕ Enhanced bot protection plugin for Minecraft servers with extended security features.
A maintained fork of [EpicGuard](https://github.com/4drian3d/EpicGuard) with integrated features from [AntiVPN](https://github.com/funkemunky/AntiVPN).
## Features
– **8+ configurable antibot checks** — Geographical, VPN/Proxy, Nickname, Reconnect, Server List, Settings, Lockdown, Name Similarity, Account Limit
– **Staff alerts** — notify online staff when a player is blocked
– **Custom commands on detection** — execute commands with placeholders
– **Bedrock prefix whitelisting** — exempt players by name prefix
– **SQLite/MySQL** database support
– **Live actionbar** attack statistics
– **Automatic whitelisting** and **console filter**
## Platforms
| Platform | Version |
|———-|———|
| Paper (+ forks) | 1.17+ |
| Velocity | 3.0+ |
| Waterfall | 1.17+ |
**Requires Java 17+** | Permission: `epicguard.admin`
**Supported Platforms:** Paper 1.17+, Velocity 3.0+, Waterfall 1.17+
**Requires:** Java 17+
**Permission:**
epicguard.admin Access to all /guard commands and staff alerts
epicguard.bypass Bypass all antibot checks (auto-whitelists the player’s IP on join)
**Source:** [Sqouidly](https://github.com/Sqouidly/EpicGuardPlus)
**License:** GPL-3.0 (with Apache-2.0 portions from AntiVPN)
EpicGuard
# 🛡 EpicGuard
[](https://github.com/4drian3d/EpicGuard/stargazers) [](https://github.com/4drian3d/EpicGuard/network) [](https://github.com/4drian3d/EpicGuard/issues) [](https://github.com/4drian3d/EpicGuard/blob/master/LICENSE) [](https://github.com/4drian3d/EpicGuard/actions/workflows/gradle.yml) 
A simple AntiBot plugin for newest Minecraft versions.
## ✅ Supported platforms / Latest release requirements
* [Paper 1.20.1+](https://papermc.io/) *(all paper forks are supported)*
* [Velocity 3.3+](https://papermc.io/software/velocity)
* Java **17**
## ✨ Features
* A total of **8** configurable antibot checks:
* Geographical check – country/city blacklist or whitelist.
* VPN/Proxy check – configurable services and caching.
* Nickname check – block certain nickname patterns using regex.
* Reconnect check – require re-joining the server with an identical pair of address and nickname.
* Server list check – require pinging the server before connecting (adding it to the server list).
* Settings check – make sure that player sends a settings packet after joining (vanilla client behaviour).
* Lockdown – temporarily block incoming connections if there are too many of them.
* Name similarity check (BETA)
* Account limit.
* SQLite/MySQL support.
* Live actionbar statistics.
* Automatic whitelisting.
* Console filter.
[](https://www.bisecthosting.com/4drian3d?r=ModEpicGuard)
## 📚 Commands & Permissions
To be able to use commands, give yourself the **epicguard.admin** permission.
On different platforms there are additional aliases available, such as **/guardvelocity** or **/epicguardpaper**
| Command | Description |
|———————————————-|————————————————————————|
| /guard help | Displays all available commands. |
| /guard reload | Reloads config and messages. |
| /guard whitelist | Whitelist/unwhitelist an address or nickname. |
| /guard blacklist | Blacklist/unblacklist an address or nickname. |
| /guard analyze | Displays detailed information about the specified address or nickname. |
| /guard status | Toggles live attack information on actionbar. |
| /guard save | Forces save to the database. |
## 🔧 Using EpicGuard API in your project:
The api is not very advanced, and there is not much you can do with it for now.
Gradle (Kotlin)
“`kotlin
repositories {
// Snapshots
maven(“https://s01.oss.sonatype.org/content/repositories/snapshots/”)
// Releases
mavenCentral()
}
dependencies {
compileOnly(“com.github.4drian3d:epicguard-api:[VERSION HERE]”)
}
“`
Gradle (Groovy)
“`groovy
repositories {
maven {
url = ‘https://s01.oss.sonatype.org/content/repositories/snapshots/’
}
mavenCentral()
}
dependencies {
compileOnly ‘com.github.4drian3d:epicguard-api:[VERSION OR COMMIT ID HERE]’
}
“`
Maven
“`xml
sonatype-oss-snapshots1
https://s01.oss.sonatype.org/content/repositories/snapshots/
com.github.4drian3d
epicguard-api
[VERSION HERE]
provided
“`
Using the API
Make sure that EpicGuard is fully loaded before your plugin.
[Click to see the API class](https://github.com/4drian3d/EpicGuard/blob/master/core/src/main/java/me/xneox/epicguard/core/EpicGuardAPI.java)
“`java
// Importing the API class.
import me.xneox.epicguard.core.EpicGuardAPI;
import me.xneox.epicguard.core.manager.AttackManager;
public class EpicGuardAPIExample {
// Accessing the EpicGuardAPI instance.
EpicGuardAPI api = EpicGuardAPI.INSTANCE;
// Obtaining the AttackManager instance:
AttackManager attackManager = api.attackManager();
// Checking if server is under attack.
boolean isUnderAttack = attackManager.isUnderAttack();
// checking current connections per second.
int cps = attackManager.connectionCounter();
// Checking user’s country:
String countryId = api.geoManager().countryCode(“127.0.0.1”);
}
“`
## 🕵️ Privacy disclaimers
* This plugin connect to various external services, to fully work as intended.
* [MaxMind’s Geolite2 databases](https://dev.maxmind.com/geoip/geoip2/geolite2) (country and city) are downloaded at the first startup and updated every week. Geolocation of your users is checked locally on your server.
* *In the default configuration*, IP addresses of connecting users are sent to https://proxycheck.io/ to check if they’re not using a proxy or a VPN.
* IPs and nicknames associated with them are stored in the local database *(as plain text(!))*.
* This plugin periodically checks the latest version released in this repository. *This feature can be disabled.*
* *There is no metrics system or any other kind of data collection.*
This is an [updated version](https://github.com/awumii/EpicGuard#%EF%B8%8F-maintained-fork-can-be-found-at-httpsgithubcom4drian3depicguard) of EpicGuard for recent versions of Paper, Waterfall and Velocity.
EnderPearlFix
Fixes an issue with pearls causing them to completely phase through an entity and not land on the entity which is a major issue for mace pvp due to a widely used method called Pearl tagging which requires the pearl to land on the player.
Enchant Limit
Limits enchants on anvils and enchanting tables, which means if you tried to apply a limited enchant it will change it to the limit, command enchants not included.
Absolutely no bypasses, loopholes or work arounds. Fully limited.
/enchantlimit (can also just run /enchantlimit to open the gui)
/enchantlimitadmin (it just tab completes, also on plugin version 1.0.2+ only)
versions below 1.21.8 arent tested so if they dont work please tell me
Any issues can be sent on my discord server.
EasyBuild(oceanstudio)
# EasyBuild (委托插件)
## 由OceanStudio开发
## 插件简介(中文)
EasyBuild 是一个“委托建筑”管理插件,让管理员发布建筑任务,玩家在指定区域承包、施工、提交验收,并自动发放经济奖励。
支持进入/建造权限控制、合作伙伴、工期与奖励、可点击消息与GUI、可视化列表、传送与详情查看。
安装要求
依赖插件:必须安装 Vault;可选安装 XConomy(若安装则优先通过命令结算)。
经济插件:任意与 Vault 兼容的经济实现(例如 EssentialsX Economy、CMIEconomy 等),或直接使用 XConomy。
放置插件:将 easybuild-–.jar 放到 plugins/,重启服务。
### 快速开始
确认控制台出现“已连接到Vault经济系统”或“检测到XConomy插件”提示。
管理员用命令创建委托区域与参数。
玩家进入委托区域用命令承包并开始施工。
完工后玩家提交验收,管理员在区域内执行验收决定,系统自动发放奖励并通知相关玩家。
主要命令(玩家)
cbwt 承包委托:站在委托区域内执行,承包后状态变为“建设中”。
wtwg 提交完工:将状态设为“已完工”,等待管理员验收。
fcwt 放弃委托:释放当前承包,使其回到“未承包”。
wt 查看委托列表:可点击打开详情。
wtinfo <委托ID> 查看委托详情:显示状态、坐标、工期、奖励等,并提供传送按钮。
wttp <委托ID> 传送到委托位置:传送到区域中心的安全位置。
wtadd <玩家名> 添加合作伙伴:承包人可添加1名合作伙伴共同施工。
wtqx 权限管理菜单:在区域内打开GUI,设置进入/建造权限为“关闭/开启/自定义白名单”。
主要命令(管理员/OP,需 easybuild.admin)
wtcj <名称> <工期天数> <报酬> <描述> 创建委托区域与任务。
示例:/wtcj 100,64,200 150,100,250 小店建设 7 1000 请建造一个小商店
坐标格式为数字三元组 x,y,z,世界取执行者当前世界。
yswt 在委托区域内验收“已完工”委托:
y 通过:弹出可点击按钮进行“确认发放奖励/修改奖金金额/设置验收成功语句”。
n 未通过:弹出可点击按钮进行“结束建设并发送原因/延期建设/设置未通过语句”。
wtset <委托名称> 管理菜单:交互式设置状态或延长工期。
wtdel <委托名字> 删除委托:直接移除指定委托。
内部按钮命令(仅通过可点击按钮触发):confirm_review、modify_reward、terminate_commission、extend_commission、set_approval_message、set_rejection_message。
权限与区域保护
进入与建造限制仅在“建设中”状态生效;“未承包”和“已完工”不限制。
权限模式:
进入权限:OPEN 所有人;CLOSED 仅建设者(承包人+合作伙伴);CUSTOM 建设者 + 指定白名单。
建造权限:同上模式,单独设置。
在区域内执行 wtqx 打开权限GUI,选择关闭/开启或输入白名单玩家名(支持多个,空格分隔)。
经济与验收
奖励发放采用“承包人与合作伙伴平分”(总额 ÷ 人数)。
经济结算优先使用 XConomy 命令;失败则使用 Vault API;格式化金额采用经济插件格式。
验收通过后会自动向承包人和合作伙伴发送消息;玩家上线会收到未读消息提醒。
管理员可在验收界面修改发放金额或设置验收成功/未通过的自定义语句。
数据与配置
数据目录:plugins/EasyBuild/
commissions.yml 委托数据(区域、状态、工期、奖励、权限白名单、验收消息等)。
messages.yml 玩家通知消息(加入时推送未读)。
config.yml 基础配置,包含 language。
多语言:内置 zh_CN, en_US, ru_RU, ja_JP, ko_KR,从 JAR 的 lang/messages_.yml 读取;缺失时回退 zh_CN。
修改语言:在 config.yml 设置 language: en_US 等,重启服务器生效。
常见问题
“不在任何委托区域内”:需要站在管理员创建的坐标范围内。
“已承包无法承接其他委托”:同一玩家同时仅能承包一个“建设中”委托。
“经济功能不可用”:安装并启用 Vault + 经济插件或 XConomy,检查控制台初始化日志。
“坐标格式错误”:请严格使用 x,y,z 三段数字,勿含空格与其他字符。
兼容性说明
——
## Overview
EasyBuild is a “commissioned building” plugin: admins define a build area and task, players contract it on-site, build, submit for review, and receive automatic payouts.
Includes entry/build permission control, partners, duration and rewards, clickable chat/UI, list view, teleport, and detailed info.
Requirements
Dependencies: Vault is required; XConomy is optional (used first if present).
Economy: Any Vault-compatible economy (EssentialsX Economy, CMIEconomy, etc), or XConomy.
Install: Drop easybuild-–.jar into plugins/, then restart.
### Quick Start
Check console for “Connected to Vault” or “Detected XConomy”.
Admin creates a commission with region and parameters.
Player enters the area, contracts, and starts building.
When done, player submits completion; admin reviews inside the region; system pays out and notifies.
Player Commands
cbwt Contract commission: run inside the area; sets status to “In Progress”.
wtwg Submit completion: moves to “Completed”, awaiting admin review.
fcwt Abandon commission: releases current contract back to “Uncontracted”.
wt List commissions: clickable entries to open details.
wtinfo Show details: status, coords, duration, reward; includes teleport button.
wttp Teleport to the commission area center safely.
wtadd Add a partner: contractor can add up to one partner.
wtqx Permission GUI: open in-area to set entry/build modes “Closed/Open/Custom whitelist”.
Admin Commands (easybuild.admin)
wtcj
Example: /wtcj 100,64,200 150,100,250 ShopBuild 7 1000 Build a small store
yswt Review inside the area:
y approve: clickable actions for “confirm payout/modify reward/set approval message”.
n reject: clickable actions for “terminate with reason/extend duration/set rejection message”.
wtset Management menu: interactive status change or duration extension.
wtdel Delete a commission immediately.
Internal button commands: confirm_review, modify_reward, terminate_commission, extend_commission, set_approval_message, set_rejection_message.
Permissions & Protection
Entry/build restrictions apply only in “In Progress”; “Uncontracted/Completed” are unrestricted.
Modes:
Entry: OPEN everyone; CLOSED builders only; CUSTOM builders + whitelist.
Build: same modes independently.
Use wtqx inside the area to open GUI and set modes or input whitelist player names.
Economy & Review
Rewards split evenly among contractor and partner(s).
Settlement first tries XConomy commands; falls back to Vault API; amounts formatted via the economy plugin.
Approved reviews send messages to contractor/partners; unread messages display on player join.
Admin can modify payout or set custom approval/rejection messages.
Data & Configuration
Directory: plugins/EasyBuild/
commissions.yml commission data (region, status, duration, reward, permission lists, messages).
messages.yml player notifications (pushed on join).
config.yml contains language.
Languages: zh_CN, en_US, ru_RU, ja_JP, ko_KR via lang/messages_.yml inside JAR; fallback to zh_CN.
Change language in config.yml with language: en_US and restart.
FAQ
“Not in any commission area”: stand within an admin-defined region.
“Already contracted another commission”: one active “In Progress” commission per player.
“Economy not available”: install and enable Vault + economy or XConomy; check console init logs.
“Coordinate format error”: strictly use x,y,z triplets without spaces.
Compatibility
Designed for Bukkit/Spigot API platforms (Spigot/Paper/Purpur/Folia/Bukkit).
Proxy (Velocity/BungeeCord/Waterfall) and mod platforms (Forge/NeoForge/Fabric/Quilt) require separate adaptation; provided JARs there are archival builds and not fully functional today.