Code Monkey home page Code Monkey logo

mc-name-gen's Introduction

This is a bulk name checker for Minecraft. You can enter a list of names and check whether they are available. Main features include reading in .txt files and using a minimal number of requests so you can check more names before you are timed out.

Using the Mojang bulk api 10 names can be check with one request. Mojang allows 600 requests every 10 minutes so with this program you can check 6000 names every 10 minutes. (While theoretically possible we currently only see about 1560 names every 10 minutes. Why exactly this happends is under investigation. #2)

Installation:

You can either download the executable directly from the execs folder or you can install Node.js and npm to run the program directly. Using Node has the bennefit that you can see the code and be sure that there is no spooky buisiness. You can then also alter the program if you want. However, downloading the executable is easyer if you don't already have Node installed.

Downloading the executable:

It's very easy. You just go to the execs folder on the github page or use this link: https://github.com/UPSman123/MC-name-gen/tree/Executables/execs. Then download the file for your operating system. You can then run the executable and it should work. I will add that I have only tested the Linux version. If you are having difficulty know that installing Node is always an option and not as difficult as you might think. Alternatively you can contact me on GitHub or send an email ([email protected]).

Using Node.js and npm:

  • To run this program on Node you need to have it installed. You will also need npm but that is automatically included. You can install it from the official website (https://nodejs.org/en/download/) but I sugest using a guide (https://phoenixnap.com/kb/install-node-js-npm-on-windows).
  • You can check whether you have it installed by opening a terminal and typing node --version if it returns something like v16.4.1 then it installed correctly.
  • You can now download the program. on the GitHub page click on the Code button in the top right and select 'Download ZIP'.
  • You now need to extract the zip into a folder.
  • Once you installed Node, open a terminal inside the project folder. (This can be done by going to the folder in your file manager and right clicking. There should be an option to 'open in terminal')
  • In the terminal type npm install (and press Enter). This will install all the dependencies needed. This might take a few minutes.
  • Once the dependencies are installed type node . (and press Enter). This open the program in Node. The page will automatically open in your browser and is ready to be used.
  • To close the program it should be sufficient to close the browser tab. If for some reason node continues to run in the terminal it is no problem to close the terminal or interupt the program.

Usage:

  1. Start by running the executable. This starts the server and opens a browser window with the application.
  2. You can input names either by typing them into the text field. You can also copy them or drag in a .txt file.
    • Names should be seperated by new lines or spaces.
  3. Once you inserted all the names click Go. This will start the checking process.
  4. After the program is done a new text field will appear bellow the input field. This contains the available names.
  5. There will also be a Select button next to the output field. This will select the available names for easy copying.

If you entered too many names Mojang will give you a timeout before all the names are procesed. In this case the names which have been processed will be removed from the input field leaving the rest. If you want to process the rest of the names you should wait 10 minutes for the timeout to pass.

Future plans:

  • I want to a feature to automatically generate names. I'll probably allow for different methods of generation because people have different preferences in names.
  • I want to add an option to automatically send the next batch of names every 10 minutes so you don't have to come back every 10 minutes. The ground work for this is already in place. I basically just need to set a timer in frontend.js

Dependencies:

  • get-port 5.1.1: This is a simple way to find an open port on you computer. This is nessesary for the browser and node to communicate.
  • node-fetch 2.6.1: This allows node to make the requests to the Mojang api.
  • node-static 0.7.11: This is a simple static web server used to load the index.html page.
  • open 8.2.1: This allows node to open the page automatically.
  • websocket 1.0.34: This is also necessary for the browser and node to communicate.

mc-name-gen's People

Contributors

upsman123 avatar

Stargazers

 avatar

Watchers

 avatar

mc-name-gen's Issues

Get notification when timeout is over

Currently you only get an alert when the timeout is over. If you're not on the page when this happens you don't immediately see the alert. It would be nicer if this is replaced with a notification so you are always notified no mater what you're doing.

Feature request: A chrome extension which checks names at the 'set-profile-name' page for more accurate results.

https://www.minecraft.net/profile is used to change your IGN. When entering your name it gives actual accurate information on whether it is available as opposed to the standard api (https://api.mojang.com/profiles/minecraft). It is probably also a lot slower so you would only use it for names which made it through the standard api. Making a tool for this would still be a lot faster than checking hundreds of mediocre names by yourself.

Create a generic way to handle calling the Mojang api

I'm creating a bunch of different methods for calling the Mojang api. It would be nice to do this in seperate functions instead of changing the current code every time.

This generic interface should probably be a promise which takes a callback. This callback gets called each time new available names are found. The promise should resolve when either all names have been processed or a timeout has been received.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.