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)
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.
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]).
- 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 likev16.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.
- Start by running the executable. This starts the server and opens a browser window with the application.
- 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.
- Once you inserted all the names click
Go
. This will start the checking process. - After the program is done a new text field will appear bellow the input field. This contains the available names.
- 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.
- 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
- 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.