![\"github-singular\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/cozy\/social\/github-singular_vector.svg\")
![\"modrinth\"](\"https:\/\/cdn.jsdelivr.net\/npm\/@intergrav\/devins-badges@3\/assets\/cozy\/available\/modrinth_vector.svg\")
<\/p>\n <\/p>\n
# IPLogin<\/p>\n
**IPLogin** is plugin that allows server owners to restrict access to their servers based on IP address. This plugin will work with PaperMC and PaperMC forks, but won’t work with Spigot or CraftBukkit. Why are you using them anyway?<\/p>\n
## Important Notice<\/p>\n
1. If you are updating to **IPLogin 2.7** you will need to manually transfer the data from `name-to-ip-map.txt` to `name-to-ip.yml`. To do this you must add a space between the `:` and the IP.<\/p>\n
2. If you are updating to **IPLogin 2.8** from **2.7** you will need to delete the config.yml file before starting the server with the plugin.<\/p>\n
3. If you are updating to **IPLogin 2.8** from any version older than **2.7** you will need to do both steps 2 and 1.<\/p>\n
### Example:<\/p>\n
Turn `Player:127.0.0.1` into `Player: 127.0.0.1`<\/p>\n
## Features<\/p>\n
– Restrict server access based on IP address or username
\n – Ban\/Kick alts or impersonators or users with a certain username
\n– Option to allow specific IP addresses to bypass the restriction
\n – Players with a dynamic IP
\n – Players that often login from other locations
\n– Easy setup and configuration
\n– Custom player log<\/p>\n
## Getting Started<\/p>\n
To use **IPLogin**, simply download and install the version of **IPLogin** for your PaperMC server’s version. It is recommended to install the latest version of **IPLogin**.<\/p>\n
When a player first joins the server, their IP will be associated with their username. From now on, the plugin will check anyone with that player’s username to see if they match the stored IP.<\/p>\n
By default, **IPLogin** will kick all players who do not have a matching IP address in the `name-to-ip.yml` file. You can add an `*` next to a player’s name to allow them to access the server with any IP. This is useful when someone has a dynamic IP or often logs in from other locations.<\/p>\n
#### Example:<\/p>\n
`Player: *`
\n`Player: 127.0.0.1`<\/p>\n
## Commands<\/p>\n
`\/allowalts` prints a message with the value of `allow-alts` I probably won’t make a command for every option in the config, but be sure to let me know if you would like that feature!<\/p>\n ## Configuration<\/p>\n Once you’ve installed the plugin, you can configure it by editing the `config.yml` file, which is located in `plugins\/IPLogin`. The file should look like this: The username filter has 2 modes: the first one kicks\/bans the player if their username contains the exact filter and the second one kicks\/bans them if their username in lower case matches the filter. You can add specific usernames to the exceptions list.<\/p>\n #### Example Mode: `2` The basic logger announces bans\/kicks in chat and the custom logger saves them to `log.yml` where it stores the username, time, IP, reason, type and if the player is an alt the owner of the IP.<\/p>\n #### Example<\/p>\n “` ## Security<\/p>\n **IPLogin** provides a simple and effective way to restrict server access based on IP address. However, it is important to remember that IP addresses can be easily changed. For example, someone can use _a free VPN_ to change their IP **to a random one**. Therefore, **IPLogin** should not be relied upon as the sole method of securing your server, you should also have moderators.<\/p>\n ## Support<\/p>\n If you have any questions or issues with **IPLogin**, you can use the issue tracker on GitHub.<\/p>\n ## Credits<\/p>\n **IPLogin** was developed by TheOnlySD12 and is licensed under the **MIT License**. Special thanks to the following people for their contributions to the project:<\/p>\n – Me (Code Review) I hope you enjoy using **IPLogin**! Please don’t hesitate to use the issue tracker if you have any feedback or suggestions.<\/p>\n","protected":false},"excerpt":{"rendered":" Basic Plugin for IP based auth<\/p>\n","protected":false},"featured_media":86291,"template":"","meta":{"_minecraft_slug":"iplogin","_minecraft_project_id":"iyhdtuuo","_minecraft_author":"TheOnlySD12","_minecraft_license":"MIT","_minecraft_downloads":2198,"_minecraft_follows":11,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"iplogin.zip","_minecraft_size_bytes":23499,"_minecraft_version_count":5,"_minecraft_updated_at":"2026-05-16T06:04:41.642149Z","_minecraft_date_created":"2023-01-07T21:23:10.276891Z","_minecraft_date_modified":"2023-04-25T17:54:12.054566Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/iplogin","_minecraft_icon_attachment_id":86291,"_minecraft_imported_at":"2026-06-04T22:20:38+00:00","_minecraft_import_hash":"57e13ea66e97cc264228d38459e268c3","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,128,92],"mod_loader":[132,133],"minecraft_version":[54,55,56,57,58,59,36,60,93,94],"class_list":["post-86290","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4"],"yoast_head":"\n
\n`\/allowalts
\n`\/setip
\n`\/setip
\n“`
\nlogger:
\n basic: true
\n custom: true
\nname-filter:
\n enabled: false
\n ban: false
\n message: Your name is not allowed on this server.
\n mode: 1
\n filter:
\n – example
\n exceptions:
\n – example2
\nallow-alts: false
\nban-alts: false
\nalts-message: Alts are not allowed.
\nban-impersonators: false
\nimpersonators-message: Impersonators are not allowed.
\nwelcome-back-message: ‘Welcome back, ‘
\nwelcome-message: ‘Welcome, ‘
\n“`
\nHere you can change the messages for alts and impersonators, you can make the plugin kick or ban impersonators or kick or ban alts, you can even allow alts.<\/p>\n
\nMode: `1`
\nFilter: `example1`, `example2`
\nExceptions: `myexample1`, `myexample2`
\nPlayers that get kicked\/banned : `Notexample1`, `Theexample2`, `example12`, `myexample1`, `myexample2`
\nPlayers that don’t get kicked\/banned: `Example1`, `Example2`, `exAmple21`<\/p>\n
\nFilter: `example1`, `example2`
\nExceptions: `MyExample1`, `MyExample2`
\nPlayers that get kicked\/banned : `Notexample1`, `Theexample2`, `example12`, `Example1`, `Example2`, `exAmple21`, `MyExample1`, `MyExample2`
\nPlayers that don’t get kicked\/banned: `3xample1`, `Ex4mple2`, `exAmpl321`<\/p>\n
\nexample:
\n 23\/06\/1940 12:00:00:
\n IP: 127.0.0.1
\n Reason: Impersonator
\n Type: Kick
\nexample2:
\n 23\/06\/1940 12:00:00:
\n IP: 127.0.0.1
\n Reason: Username filter
\n Type: Kick
\nexample3:
\n 23\/06\/1940 12:00:00:
\n IP: 127.0.0.1
\n Reason: Alt
\n Type: Kick
\n Owner(s):
\n – example0
\n“`<\/p>\n
\n– Myself (Ideas)
\n– I (Testing)<\/p>\n