Skip to content
This repository has been archived by the owner on Apr 13, 2022. It is now read-only.
/ namemc Public archive

The unofficial Node JS API for looking up Minecraft users on Name MC

License

Notifications You must be signed in to change notification settings

JoshMerlino/namemc

Repository files navigation

namemc

Node.js CI njsscan sarif

The unofficial Node JS package for looking up Minecraft users on Name MC.

Name MC has updated their HTML structure. All versions below v1.6.5 are now broken

This package is not affiliated with Name MC or Minecraft in any way


Documentation:

Caveats

  1. This package is powered by Web Scraping, meaning that if Name MC were to suddenly change the HTML layout on their page it would cause the package to break until I were update it.
  2. Name MC will rate-limit you after a certian amount of requests. In my opinion, they're very generous about this, after spamming an obscene amount of requests, the most I got limited for was 5 seconds. The package will reject the promise if you are being rate limited.
  3. On top of point #2, this package does not cache the response from Name MC. If you are getting rate limited over and over, you might want to implement some cache system that prevents the same name from being resolved more than once per hour and using a cached result.

API

If you need to use this in a browser and arent using a bundler, you can send API requests to my server to resolve names. Endpoints and their info can be found on the wiki.