Anti-VPN 4.9.31

Get the best; save money on overpriced plugins and block VPN users!

  1. egg82
    Native Minecraft Version:
    1.13
    Tested Minecraft Versions:
    • 1.8
    • 1.9
    • 1.10
    • 1.11
    • 1.12
    • 1.13
    • 1.14
    Source Code:
    https://github.com/egg82/AntiVPN
    antivpn.png

    Looking for the Bungee version? Find it here!
    Looking for the Velocity version? Find it here!

    playeripapi-installation-tab.png
    The first time Anti-VPN is run it will take some time to start up. this is normal, and will very rarely (if ever) take that long again.

    Wiki
    Installation instructions can be found on the wiki here. It it highly recommended to read the wiki.

    playeripapi-config-tab.png
    Confused? Check the wiki!
    Code (Text):
    # How the plugin stores long-term data
    storage:
      # The storage method
      #
      # Options:
      # - MySQL (remote)
      # - SQLite (local)
      method: 'sqlite'

      data:
        # Address and port of the remote database (if applicable)
        address: '127.0.0.1:3306'
        # The name of the database Anti-VPN will store data in
        # If you're using remote options, this must be created beforehand
        database: 'avpn'
        # Table prefix for all Anti-VPN tables
        prefix: 'antivpn_'
        # Database credentials (if applicable)
        username: ''
        password: ''
        # Whether or not to use SSL
        ssl: false

        # MongoDB options- obviously don't need to worry about these if not using MongoDB ;)
        mongodb:
          # Connection prefix for all Anti-VPN connections
          collection-prefix: ''
          # MongoDB ClientConnectionURI
          connection-uri: ''

      settings:
        # The maximum size of the database connection pool
        # Determines the max number of connections to the database
        max-pool-size: 2
        # The minimum size of the satabase connection pool
        # Determines the min number of connections kept alive to the database
        min-idle: 2
        # The maximum lifetime of a connection in the pool
        # Should be at least 30 seconds less than any database or infrastructure-imposed connection time limit
        max-lifetime: 1800000 # 30 minutes
        # The maximum number of milliseconds that the plugin will wait for a new connection from the pool before timing out
        timeout: 5000 # 5 seconds

        # Extra connection properties
        properties:
          unicode: true
          encoding: 'utf8'

    # Redis is a very fast cache accessible by multiple servers
    # If you don't want to constantly hit your database for queries, try enabling and configuring this
    # You will need to install the (external) Redis server software if you haven't already
    # https://redis.io/
    redis:
      enabled: false
      # Address and port of the remote Redis server
      address: '127.0.0.1:6379'
      # Redis credentials
      password: ''

    # RabbitMQ is a messaging queue that will allow the plugin to push instant updates across multiple servers
    # You will need to install the (external) RabbitMQ server software if you haven't already
    # https://www.rabbitmq.com/
    rabbitmq:
      enabled: false
      # Address and port of the remote RabbitMQ server
      address: '127.0.0.1:5672'
      # RabbitMQ credentials
      username: 'guest'
      password: 'guest'

    # Where VPN-checking sources are defined
    # Beware the more sources that are included (and fail) the worse the performance and the more the lag
    sources:
      # The amount of time to globally cache results across all sources
      # This should be as high as possible to avoid rate-limits but as low as possible to ensure results are always up-to-date and accurate
      cacheTime: '6hours'

      # The order to try results in
      order:
      - 'iphub'
      - 'proxycheck'
      - 'iphunter'
      - 'getipintel'
      - 'ipqualityscore'
      - 'vpnblocker'
      - 'ip2proxy'
      - 'teoh'
      - 'shodan'
      - 'ipwarner'

      # https://iphub.info/
      # Results updated Jul 7, 2019
      # Error rate: 0%
      # NordVPN detection rate: 85.71%
      # Cryptostorm detection rate: 100%
      # False-flagged homes: 0%
      iphub:
        enabled: false
        # API key to use (Required for this service, free one available at https://iphub.info/apiKey/newFree )
        key: ''
        # The block type at which an IP is considered "bad"
        block: 1

      # https://proxycheck.io
      # Results updated Jul 7, 2019
      # Error rate: 0%
      # NordVPN detection rate: 80.95%
      # Cryptostorm detection rate: 100%
      # False-flagged homes: 0%
      proxycheck:
        enabled: true
        # Optional API key to use
        key: ''

      # https://www.iphunter.info/
      # Results updated Jul 7, 2019
      # Error rate: 0%
      # NordVPN detection rate: 95.24%
      # Cryptostorm detection rate: 90%
      # False-flagged homes: 40%
      iphunter:
        enabled: false
        # API key to use (Required for this service, free one available at https://www.iphunter.info/user/register )
        key: ''
        # The block type at which an IP is considered "bad"
        block: 1

      # https://www.getipintel.net/
      # Results updated Sep 6, 2018
      # Error rate: 5%
      # NordVPN detection rate: 90.48%
      # Cryptostorm detection rate: 100%
      # False-flagged homes: 40%
      getipintel:
        enabled: true
        # Contact e-mail in case things go wrong. Required
        contact: '[email protected]'
        # Threshold above which an IP is considered "bad"
        threshold: 0.98

      # https://www.ipqualityscore.com/
      # Results updated Jul 7, 2019
      # Error rate: 0%
      # NordVPN detection rate: 90.48%
      # Cryptostorm detection rate: 90%
      # False-flagged homes: 40%
      ipqualityscore:
        enabled: false
        # API key to use (Required for this service, free one available at https://www.ipqualityscore.com/create-account )
        key: ''
        # Threshold above which an IP is considered "bad"
        threshold: 0.65

      # https://vpnblocker.net/usage
      # Results updated Jul 7, 2019
      # Error rate: 0%
      # NordVPN detection rate: 66.67%
      # Cryptostorm detection rate: 95%
      # False-flagged homes: 10%
      vpnblocker:
        enabled: true
        # Optional API key to use
        key: ''

      # https://www.ip2location.com/web-service/ip2proxy
      # Results updated Jul 18, 2019
      # Error rate: 0%
      # NordVPN detection rate: 100%
      # Cryptostorm detection rate: 60%
      # False-flagged homes: 0%
      ip2proxy:
        enabled: true
        # API key to use (Required for this service, free one available using 'demo' or at https://www.ip2location.com/register?id=1006 )
        key: 'demo'

      # https://ip.teoh.io/vpn-detection
      # Results updated Jul 7, 2019
      # Error rate: 10%
      # NordVPN detection rate: 61.90%
      # Cryptostorm detection rate: 100%
      # False-flagged homes: 0%
      teoh:
        enabled: true

      # https://www.shodan.io/
      # Results updated Jul 7, 2019
      # Error rate: 94.52%
      # NordVPN detection rate: 95.24%
      # Cryptostorm detection rate: 60%
      # False-flagged homes: 0%
      shodan:
        enabled: false
        # API key to use (Required for this service)
        key: ''

      # https://ipwarner.com/
      ipwarner:
        enabled: false
        # API key to use (Required for this service, free one available at https://ipwarner.com/register )
        key: ''

    action:
      # The kick message to display to players who are using VPNs
      # If left blank, will not kick the player
      kick-message: '&cPlease disconnect from your proxy or VPN before re-joining!'
      # The command that CONSOLE will run for players who are using VPNs
      # Use %player% as a placeholder for the player's (real) name
      # Use %uuid% as a placeholder for the player's uuid
      # If left blank, will not run anything
      command: ''

      algorithm:
        # The algorithm method
        #
        # Options:
        # - Cascade
        #   The plugin will go down the "sources" list, sequentially, until a valid source is found
        #   It will then query that source and return the result
        #   This will result in essentially "the first valid result" being returned
        # - Consensus
        #   The plugin will try every source in the "sources" list at once
        #   It will then strip invalid results, and calculate the ratio of results from the remaining sources
        #   This will result in essentially "the ratio of valid results" being returned
        method: 'cascade'

        # Only used for "consensus" mode
        # The minimum ratio of APIs that must agree before a player is kicked
        # For example, if set to "0.6" then at least 60% of sources must agree that the IP is a VPN
        # The value can range from 0 to 1, and will be clipped at those values
        min-consensus: 0.6

      # IPs to ignore when checking for VPNs
      ignore:
      - '127.0.0.1'
      - 'localhost'
      - '::1'

    # The amount of time to cache lookups in-memory
    # Higher values require more memory
    # Lower values will hit Redis/SQL/APIs more frequently
    # Generally the default is good enough to prevent many sequential lookups from choking resources, but still keep memory usage low
    cacheTime: '1minute'
    # When true, logs some extra output to the console so you can see if/why things might be failing
    debug: false
    # The number of threads to use for web operations
    threads: 4

    stats:
      # Whether or not to send anonymous usage statistics to bStats
      # True: Send anonymous stats; let the author know how well the plugin is doing and how it's used!
      # False: Do not send stats and make the author sad :(
      usage: true
      # Whether or not to send anonymous errors to the author
      # True: Send errors anonymously to Rollbar and/or GameAnalytics so the author can fix them!
      # False: Do not send errors and wonder why any bugs you encounter haven't beeen fixed
      errors: true

    update:
      # Whether or not to automatically check for updates and notify the console if found
      check: true
      # Whether or not to notify players with the avpn.admin permission node
      notify: true

    # Config version, no touchy plz
    version: 3.9
    playeripapi-commands-tab.png
    /avpn reload - Reloads the plugin configuration. This will disconnect and reconnect (if appropriate) any services configured in the config.yml file.
    /avpn test <ip> - Test an IP through the various (enabled) services. Note that this forces a check so will use credits every time it's run.
    /avpn check <ip> - Check an IP using the default system. This will return exactly the same value as any other API call.
    /avpn score <source> - Scores a particular source based on a pre-made list of known good and bad IPs. Note that this forces a check so will use credits every time it's run.

    playeripapi-permissions-tab.png
    avpn.admin - allows access to the /avpn reload, /avpn test, /avpn check, and /avpn score commands
    avpn.bypass - players with this node bypass the filter entirely

    playeripapi-donations-tab.png
    Please consider donating to support this free plugin!
    PP_logo_h_150x38.png

    playeripapi-legal-tab.png
    According to the GDPR, you must specify that you are storing IP information to your players in a privacy policy when using this plugin (actually you need that if you're running a vanilla server without this plugin because of server logs). Depending on how data provided from this API is used, you may be required to manually remove some data from the databases.
    Disclaimer: I am a plugin developer, not a lawyer. This information is provided as a "best guess" and is not legal advice.

    playeripapi-api-tab.png
    API documentation can be found on the wiki here.

    stopforumspam
    Error rate: 0%
    NordVPN detection rate: 38.1%
    Cryptostorm detection rate: 10%
    False-flagged homes: 0%
    Lazo and hou19960228 like this.

Recent Reviews

  1. __Vekster007__
    __Vekster007__
    5/5,
    Version: 4.9.31
    I'm using the version for Bungeecord, but this plugin is still great!
    Need to write at least 80 characters in the feedback on the SpigotMC website, I have just no more words!
    [I don't know much English, I used a translator.]
  2. JackTheBoy8
    JackTheBoy8
    5/5,
    Version: 4.9.31
    Amazing plugin, but would be better if you could add multiple commands for the "Action" part :D
    1. egg82
      Author's Response
      Thanks for the review! I've been looking into a command list for actions :)
  3. Kylo_renZockt
    Kylo_renZockt
    5/5,
    Version: 4.9.31
    Very Nice Plugin and works even better with the New updates. I just have one wish could you add Color code Support for the kick message. That would be very nice. 500 Stars Perfekt Plugin. And if you want can you add more sources to the list. Just a quastion
    1. egg82
      Author's Response
      Thanks for the review! I can take a look at color code support and I'm always looking for more sources.
  4. Tree182
    Tree182
    1/5,
    Version: 4.9.31
    Error with the Mysql and got ignored for over a week by the dev when trying to report the error so I would not recommend.
    1. egg82
      Author's Response
      Thank you for the honest review!

      I haven't been ignoring issues or yourself in particular, I promise. I'm only one dev working on a fair number of projects that many people use, and the issues that come up tend to need quite a bit of time to fix (the issue you mention is coming to Anti-VPN soon- 2FA+ is having a similar problem and thus getting the update first as a test)

      I do understand the frustration, though. If you can wait a bit longer, I'll fix the issue soon. In the meantime try SQLite until MySQL is fixed.
  5. Nort721
    Nort721
    5/5,
    Version: 4.9.31
    What a great plugin, this is the best AntiVPN plugin I have ever seen and the fact that it's free its already amazing I really want spigot to be filled more with plugins like this that actually work and are codded correctly, if you could try to try+catch the normal console error that pops some times it would be great since sometimes my console gets really spammed, other then that thank you for the plugin!
    1. egg82
      Author's Response
  6. Johncortes9
    Johncortes9
    5/5,
    Version: 4.9.31
    it's a really good plugin, it works perfectly and with good performance, i was having a little problem and they fixed it really fast, they are really good devs too, 100% recommended :D
    1. egg82
      Author's Response
      Thank you very much for the review!
  7. mmolitor87
    mmolitor87
    5/5,
    Version: 4.9.31
    I have a super small server population, so completely unconfigured it works great for me. As my population grows I will explore the services and configure them for more checks.

    I have had only one instance where it would not let a legitimate member online when no VPN was being used, but that let me confirm the bypass permission does indeed work.

    Nothing like this will ever be perfect, but this plugin is as close as it gets. The dev has great explanations and instructions to get noobs and techy savvy people alike going in the same direction.

    Oh, and the plugin supports SQL, so that's pretty awesome.
    1. egg82
      Author's Response
      Thanks for the review! Am always trying :D
  8. KaoticEvil
    KaoticEvil
    5/5,
    Version: 4.9.31
    Works just as advertised. Simple setup, out-of-the-box config works well, but worth the time to sign up for a couple of the free API keys linked in the config file.
    1. egg82
      Author's Response
      Thank you for the review! It's definitely worth setting up a couple extra services.
  9. Porkchop
    Porkchop
    5/5,
    Version: 4.9.31
    How does this detect vpns? i don't want it to accidentally block a legit player from joining my server.
    1. egg82
      Author's Response
  10. Soarin
    Soarin
    5/5,
    Version: 4.9.31
    Works out the box, has a lot of configs and extra IP checklists you can enable if you need to.
    It already blocked a VPN'd alt account from a banned player
    1. egg82
      Author's Response
      Thanks for the review!